![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to library.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / man / man1|
Return to library.1 CVS log | Up to [Research Unix] / researchv10dc / man / man1 |
1.1 root 1: .TH LIBRARY 1
2: .SH NAME
3: library \- send information requests to appropriate organization
4: .PD
5: .SH SYNOPSIS
6: .B library [-1234567] [request string]
7: .PD
8: .SH DESCRIPTION
9: .I library
10: sends document/information requests to the
11: appropriate organization within the Library Network.
12: It also handles a variety of requests for other AT&T organizations
13: (e.g., Engineering Information Services).
14: It requires the user to discriminate between seven classes of requests
15: as indicated by the menu it displays:
16: .sp
17: .nf
18: 1) Order by number - this includes nearly everything announced
19: by the AT&T Library Network (e.g. TMs, bulletin items) or handled
20: by the Engineering Information Services (e.g. J docs, CPSs).
21: 2) Order item not announced by the AT&T Library Network. Available:
22: Buy a copy of a book; Address labels; Technical Reports;
23: Internal document by date (id unknown); Photocopies;
24: Subscribe to a journal; foreign language services.
25: 3) Subscribe or unsubscribe to a bulletin (e.g. Mercury, CTP)
26: 4) Submit a database search. Examples of available databases:
27: book catalog, internal documents, AT&T personnel, released papers
28: 5) Request human assistance / interaction. Type(s) available:
29: General AT&T Library Network assistance; Reference question.
30: 6) Request AT&T Library Network information/services. Examples:
31: LINUS info, products/services descriptions, loan/reserve status
32: 7) Read AT&T Library Network email transmissions
33:
34: .fi
35: Note that the first class includes anything announced by the Library Network operated by AT&T Bell Laboratories.
36: .PP
37: The main menu level of
38: .I library
39: can be skipped by giving
40: the number of the desired option (1 - 7)
41: as the first parameter to the
42: \f2library\f1.
43: .PP
44: The secondary menu levels in
45: .I library
46: (presently in options 2, 4, 5 and 6)
47: can be bypassed by selecting the desired option as the second
48: parameter.
49: For example, to do order a photocopy, use the
50: command
51: .ce
52: library -2 -p
53: .PP
54: Similarly, if you want to do a search of the personnel database,
55: you can do the command line
56: .ce
57: library -4 -p waldstein, r k
58: .PP
59: Requests for objects that can be meaningfully described with one
60: line can be entered on the command line.
61: This includes the things orderable by options 1, 3, 4, and 6.
62: Note that library tries in this case to function with a minimum
63: of interaction.
64: For example, if you request a TM this way,
65: you will not be given a chance to enter remarks connected with the request.
66: .PP
67: When permitted, the command line requests can include more than one item
68: (presently only options 1 and 3 support this).
69: An example command line is
70: .ce
71: library -1 123456-851234-56tm 5d123 ad-123456
72: .PP
73: In options 2, 5, and 6,
74: .I library
75: will prompt for a variety of information of varying complexity.
76: A period (.) at any point in this session will delete the
77: request being entered.
78: Blank lines (just hit return) will cause optional information to
79: be left out of the request.
80: A line consisting of tilde e (\~e) will, when a long response is
81: permitted, put you into an editor.
82: This editor defaults to ed(1).
83: However, if the environment variable EDITOR is set, the specified
84: editor is used.
85: A line consisting of tilde r (\~r) will, when a long response is
86: permitted, read in the indicated file.
87: .PP
88: Option 7 is a misfit, in that it is primarily a reader, not a
89: request transmitter; although it does allow requesting items.
90: This option is intended for reading electronic transmissions
91: from the library network: primarily responses to option 4 search
92: requests and ASAP (specialized searches like electronic Mercury).
93: A convenient way to use option 7 is to invoke it via a pipe
94: from mail(1), mailx(1) or post(1).
95: .ce
96: | 3 "library -7"
97: This assumes that mail message 3 consists of a search result.
98: The quote marks are required due to post(1) and mailx(1) syntax.
99: .PP
100: Break causes
101: .I library
102: to exit
103: without sending any requests.
104: .PP
105: In general for more information about what the library command can
106: do, go into each option and enter a question mark.
107: This will cause a description of how the option works and
108: what it can request.
109: .PP
110: Several other pieces of information can be passed
111: to
112: .I library
113: to ease and improve its usage.
114: This information is looked up in a file called .lib (or the file indicated
115: by the LIBFILE shell variable).
116: It expects this file to contain lines of the form:
117: .sp
118: .ti 10
119: ID: \f2individual's PAN or Social Security Number\f1
120: .ti 10
121: libname: \f2individual's last name\f1
122: .ti 10
123: liblog: \f2name of log file\f1
124: .ti 10
125: libcntl: \f2control information\f1
126: .ti 10
127: reader: \f2reader control information\f1
128: .ti 10
129: liblocal: \f2control information\f1
130: .PP
131: If this file is not found or lines of this form are not found,
132: then
133: .I library
134: prompts for name and ID (PAN or SS#).
135: .PP
136: This information can also be passed to
137: .I library
138: as the shell parameters: LIBID, LIBNAME, LIBLOG, LIBCNTL, and LIBLOCAL.
139: .PP
140: .I library
141: keeps a log of requests sent via library if a line in the .lib
142: file exists giving a log file name, i.e., if you have in
143: your .lib file a line of the form
144: .ce
145: liblog: \f2name of log file\f1
146: .PP
147: .I library
148: keeps a log of requests in that file.
149: This file is created in a form that can be read and manipulated
150: by the
151: .I mail
152: command.
153: To read or modify the log file, type
154: .ce
155: mail -f \f2name of log file\f1
156: .PP
157: .I library
158: creates the log file in your HOME directory unless the file name
159: given starts with a slash (/).
160: .I library
161: will automatically check option 1 requests
162: for duplicates in the log file.
163: .PP
164: The libcntl information is sent with the request to the program
165: that receives the requests for the library networks.
166: Control information containing the letter ``a''
167: will cause an acknowledgement to be mailed back to you that
168: your request has been received.
169: Control information of the form ``m\f2number\f1''will determine the
170: maximum number of items retrieved by a search request.
171: For example, a control line of the form
172: .sp
173: .ce
174: libcntl: am100
175: .PP
176: will cause requests to be acknowledged and a maximum of 100 retrieved
177: search items to be mailed back to you.
178: .PP
179: The reader control information is intended to let you personalize
180: the way
181: .I library
182: option 7 works for you.
183: Each letter after the colon indicates a different option turned
184: on or off.
185: Presently available are the following:
186: .RS
187: .TP 5
188: b
189: causes library -7 to leave a
190: blank line between records when more than one is displayed on the screen.
191: .TP 5
192: c
193: causes
194: .I library
195: to confirm that you want the entered requests transmitted.
196: It does this at the end of the session, before finishing.
197: .TP 5
198: n
199: is an interesting features causing no introductory menu
200: of available announcements to be displayed.
201: The reader then goes straight into the first announcement to be read,
202: and moves directly from one announcement to the next, without
203: displaying the menu of those available at each stage.
204: .RE
205: .PP
206: The liblocal information is used to control the execution of
207: .I library.
208: Presently the only meaningful control is \f2x\fP.
209: This causes library(1) to assume you are an expert and the
210: prompts are generally much shorter.
211: .PP
212: .I library
213: also uses your .lib file to save various repetitious responses
214: for its own use.
215: These will prevent you from having to duplicate responses.
216: .PD
217: .SH BUGS
218: .I library
219: checks upon input whether the request is reasonable.
220: New styles of request numbers require program modification
221: before they are valid.
222: .PD
223: .SH FILES
224: .PD 0
225: .TP 15
226: $HOME/.lib
227: This optional file contains a PAN and name for
228: .I library
229: to use.
230: .TP 15
231: /usr/lib/library/library.help
232: The help message displayed by library.
233: .PD
234: .SH "SEE ALSO"
235: mail(1), post(1), mailx(1)
236: .\" @(#)library.1 1.12 11/26/90 RnD added
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.