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