User`s guide

LIBRARY
If you enter a global symbol name and press
RETURN
, RT–11 extracts the entire
module of which that global symbol is a part. To terminate the sequence, press
RETURN
by itself in response to the prompt. The following example shows how
to extract the module ATAN from the library called NEWLIB.OBJ and store it
in file ATAN.OBJ on DU1:
.LIBRARY/EXTRACT
RET
Library? NEWLIB
RET
File ? DU1:ATAN
RET
Global ? ATAN
RET
Global ?
RET
/INSERT
Inserts an object module into an existing library. Although you can insert object
modules that have duplicate names, this practice is not recommended because
of the difficulty involved in replacing or updating these modules. Note that
/INSERT is the default operation. If you do not specify any option, insertion
takes place.
The following example inserts the modules contained in the files THIRD.OBJ
and FOURTH.OBJ into the library called OLDLIB.OBJ:
.LIBRARY/INSERT OLDLIB THIRD,FOURTH
/LIST[:filespec]
Obtains a directory listing of an object library.
The following example obtains a directory listing of OLDLIB.OBJ on the terminal
(the printer is the default device):
.LIBRARY/LIST:TT: OLDLIB
The directory listing displays global symbols. A plus sign (+) in the module
column indicates a continued line. See the Librarian (LIBR) utility chapter in
the RT–11 System Utilities Manual for a procedure to include module names in
the directory listing.
You can also use /LIST with other options (except /MACRO) to obtain a
directory listing of an object library after you create or modify it. The following
command, for example, inserts the modules contained in the files THIRD.OBJ
and FOURTH.OBJ into the library called OLDLIB.OBJ; it then displays a
directory listing of the library on the terminal:
.LIBRARY/INSERT/LIST:TT: OLDLIB THIRD,FOURTH
You cannot obtain a directory listing of a macro library, using the librarian.
You can use EDIT/INSPECT of the resultant library and search for all the lines
that contain .MACRO. Note that nested macro definitions do not appear in the
directory.
Make sure when you use /LIST with LIBRARY that you use it on the command
side of the command string and not after the file specification.
RT–11 Command Descriptions 159