 |
HP OpenVMS Command Definition, Librarian, and Message Utilities
Manual
/LOG
Controls whether the LIBRARY command verifies each library operation.
Format
/LOG
/NOLOG
Description
If you specify /LOG, the LIBRARY command displays the module name,
followed by the library operation performed, followed by the library file specification.
Other applications of the /LOG qualifier appear in the descriptions of /DELETE
and /REPLACE.
Example
|
$ LIBRARY/REMOVE=(LIB_EXTRCT_MODS,LIB_INPUT_MAC)/LOG LIBRAR
|
This LIBRARY command requests the removal of the global symbols LIB_EXTRCT_MODS
and LIB_INPUT_MAC from the object library LIBRAR.OLB. The /LOG qualifier
requests that the removal of the symbols be confirmed by messages.
/MACRO
Indicates that the library specified is a macro library.
Format
/MACRO
Description
When you specify the /MACRO qualifier, the library file type defaults
to .MLB and the input file type defaults to .MAR.
Example
|
$ LIBRARY/MACRO/INSERT MONTHS APRIL
|
This LIBRARY command inserts modules from APRIL.MAR into the macro library
MONTHS.MLB.
/MODULE
Names a text module that you want to replace or insert into a text
library. It also modifies the input file specification parameter.
Format
/MODULE= module-name
module-name
The name of the module to be inserted in the library.
Description
When you insert text modules into a library, the input file you specify
is assumed to be a single module. Therefore, the file name of the input file
specification becomes the module name. If you want the file you are inserting
to have a module name different from its input file name, use the /MODULE qualifier
to name the added module.
You can also use the /MODULE qualifier to enter a text module interactively.
If you specify the logical name SYS$INPUT as the input file and use the /MODULE
qualifier, the LIBRARY command inserts the text you enter from the terminal
into the specified library module. To terminate the terminal input, press
Ctrl/Z.
Remember that the /MODULE qualifier is an input file qualifier; it assumes
that you are either replacing or inserting a new text module. Therefore,
the qualifiers that remove modules---/EXTRACT, /DELETE, /REMOVE---are incompatible
with /MODULE.
Note that you must place the /MODULE qualifier after the input file you
specify.
Example
|
$ LIBRARY/INSERT/TEXT TSTRING SYS$INPUT/MODULE=TEXT1
|
This LIBRARY command inserts a module named TEXT1 into the text library
TSTRING.TLB. The input is taken from SYS$INPUT.
/NAMES
When /LIST is specified for an object module library, controls whether
the LIBRARY command lists the names of all symbols in the global symbol table
as well as the module names in the module name table.
Format
/NAMES
(Alpha and VAX)/NAMES [= option] (I64 only)
/NONAMES
(default)
option
The option keywords pertain to I64 systems only and can be one of the following
keywords:
| Keyword |
Explanation |
| BYMODULE |
Lists each module followed by a list of the symbols in the global
symbol table that are associated with that module. This is the default
listing format when no keyword is given with the /NAMES qualifier. |
| BYSYMBOL |
Lists each symbol in the global symbol table followed by a list of
modules with which the symbol is associated, in precedence order. |
Description
The /NAME qualifier lists the symbol names and the module names along
with their association with each other. The default, /NONAMES, does not list
the symbol names.
If you specify /NAME=BYSYMBOL, each symbol name is displayed followed by
the modules with which the symbol is associated using the following format:
symbol "symbol name" Global: module-name . . . UxWk: module-name . . . Group Global: module-name . . . Group UxWk: module-name . . . symbol "symbol name" UxWk: module-name . . .
|
Note
If you specify /NAMES and the library is a macro,
help, or text library, no symbol names are displayed. |
Example
|
$ LIBRARY/LIST/NAMES/ONLY=$ONE/WIDTH=80 SYMBOLIB
|
This LIBRARY command requests a full listing of the module $ONE, contained
in the object library SYMBOLIB.OLB. The /WIDTH qualifier requests that the
global symbol display be limited to 80 characters per line.
/OBJECT
Indicates that the library specified is an object module library.
Format
/OBJECT
Description
Libraries are assumed to be object module libraries unless you specify
the /SHARE, /MACRO, /TEXT, or /HELP qualifier. The library file type for object
module libraries defaults to .OLB and the input file type defaults to .OBJ.
On OpenVMS VAX systems, the /OBJECT qualifier creates a VAX library by default.
Note that you cannot have VAX modules and Alpha modules in the same library
file. For more information, see the description of the /VAX
(VAX and Alpha only) qualifier.
On OpenVMS Alpha systems, the /OBJECT qualifier creates an Alpha library
by default. Note that you cannot have Alpha modules and VAX modules in the
same library file. For more information, see the description of the /ALPHA
qualifier.
On OpenVMS I64 systems, the /OBJECT qualifier creates only ELF object libraries.
Example
|
$ LIBRARY/OBJECT/INSERT MONTHS APRIL
|
This LIBRARY command inserts modules from APRIL.OBJ into the object library
MONTHS.OLB. The /OBJECT qualifier is optional.
/ONLY
Specifies the individual modules on which the LIBRARY command can
operate.
Format
/ONLY= (module-name[,...])
module-name
The module on which the LIBRARY command can operate.
Description
When you use the /ONLY qualifier, the LIBRARY command lists or cross-references
only those modules specified.
If you specify more than one module, separate the module names with commas
and enclose the list in parentheses.
The /ONLY qualifier must be used with the /LIST or /CROSS_REFERENCE qualifier.
Wildcard characters are allowed in the module name specification.
Example
|
$ LIBRARY/LIST/NAMES/ONLY=$ONE/WIDTH=80 SYMBOLIB
|
This LIBRARY command requests a full listing of the module $ONE, contained
in the object library SYMBOLIB.OLB. The /WIDTH qualifier requests that the
symbol display be limited to 80 characters per line.
/OUTPUT
When used with the /EXTRACT, /COMPRESS, /CROSS_REFERENCE, or /DATA
qualifier, specifies the file specification of the output file.
Format
/OUTPUT= file-spec
file-spec
The file specification of the output file.
Description
For /EXTRACT, the output file contains the modules extracted from
a library; for /COMPRESS, the output file contains the compressed library;
for /CROSS_REFERENCE, the output file contains the cross-reference listing;
for /DATA, the output file contains the data-reduced or data-expanded library.
No wildcard characters are allowed in the file specification.
If you omit the file type in the file specification, a default is used depending
on the library function qualifier and, in some cases, the library type qualifier,
as follows:
Qualifier |
Library Type
Qualifier |
Default
File Type |
/COMPRESS or
/DATA |
/HELP
/MACRO
/OBJECT
/TEXT
/SHARE |
.HLB
.MLB
.OLB
.TLB
.OLB |
| /CROSS_REFERENCE |
--- |
.LIS |
| /EXTRACT |
/HELP
/MACRO
/OBJECT
/TEXT
/SHARE |
.HLP
.MAR
.OBJ
.TXT
.EXE |
Examples
| #1 |
$ LIBRARY/EXTRACT=(ALLOCATE,APPEND)/OUTPUT=MYHELP SYS$HELP:HELPLIB.HLB
|
This LIBRARY command specifies that the modules ALLOCATE and APPEND be extracted
from the help library HELPLIB.HLB and output to the file MYHELP.HLP.
| #2 |
$ LIBRARY/CROSS_REFERENCE=ALL/OUTPUT=SYS$OUTPUT LIBRAR
|
This LIBRARY command requests a cross-reference listing of the object library
LIBRAR.OLB. The cross-reference listing is displayed at the terminal. The
listing includes cross-references by symbol, by value, and by module.
/REMOVE
Requests the LIBRARY command to delete one or more entries from the
global symbol table in a library.
Alpha and VAX:
Format
/SINCE[=time]1
time
Limits the modules to be listed to those inserted in the library since a specified
time.
You can specify an absolute time or a combination of absolute and delta
times. For details about specifying times, see the HP OpenVMS DCL Dictionary.
Description
This qualifier is used with the /LIST qualifier. If you omit the
/SINCE qualifier, you obtain all the modules regardless of the date. If you
specify /SINCE without a date or time, the default is to provide the modules
inserted since today.
Example
|
$ LIBRARY/HELP/LIST/SINCE=:12 ERRMSG
|
This LIBRARY command displays information about help modules added to ERRMSG.HLB
since noon today.
/SQUEEZE
Controls whether the LIBRARY command compresses individual macros
before adding them to a macro library.
Format
/SQUEEZE
)/NOSQUEEZE
)
Description
When you specify /SQUEEZE, which is the default, trailing blanks,
trailing tabs, and comments are deleted from each macro before its insertion
in the library.
Use /SQUEEZE only with the /CREATE, /INSERT, and /REPLACE qualifiers to
conserve space in a macro library. If you want to retain the full macro,
specify /NOSQUEEZE.
Example
|
$ LIBRARY/MACRO/NOSQUEEZE/INSERT MYMACS MYMACS
|
This LIBRARY command inserts the macros in MYMACS.MAR into the library MYMACS.MLB.
Trailing blanks, trailing tabs, and comments are not deleted from each macro
before its insertion into the library.
/TEXT
Indicates that the library specified is a text library.
Format
/TEXT
Description
When you use the /TEXT qualifier, the library file type defaults
to .TLB and the input file type defaults to .TXT.
Examples
| #1 |
$ LIBRARY/INSERT/TEXT TSTRING SYS$INPUT/MODULE=TEXT1
|
This LIBRARY command inserts a module named TEXT1 into the text library
TSTRING.TLB. The input is taken from SYS$INPUT.
| #2 |
$ LIBRARY/INSERT/TEXT TSTRING TEXT2
|
This LIBRARY command inserts the contents of the file TEXT2.TXT into the
text library TSTRING.TLB. The name of the inserted module is TEXT2.
/VAX (VAX and Alpha only)
Directs LIBRARIAN to work with an OpenVMS
VAX object library when used with the /OBJECT qualifier or to work with an
OpenVMS VAX shareable image library when used with the /SHARE qualifier. When
used with the /CREATE qualifier, LIBRARIAN creates an OpenVMS VAX library of
either an object or shareable image type depending whether /OBJECT or /SHARE
is specified.
The default is /ALPHA on OpenVMS Alpha systems and /VAX on OpenVMS VAX systems.
The OpenVMS I64 Librarian does not accept this qualifier because the I64
Librarian works exclusively with I64 libraries.
Format
/VAX
Description
On OpenVMS Alpha systems, use the /VAX qualifier to create and manipulate
OpenVMS VAX object and shareable image libraries. Because the formats of macro,
help, and text libraries on OpenVMS Alpha systems are identical to those on
OpenVMS VAX systems, using the /VAX qualifier with the /MACRO, /HELP, and /TEXT
qualifiers has no effect.
Note
You cannot have both OpenVMS Alpha and OpenVMS VAX
object modules in one object library, nor can you have OpenVMS Alpha
and OpenVMS VAX shareable images in the same shareable image library. |
Examples
| #1 |
$ LIBRARY/VAX/CREATE TESTLIB ERRMSG.OBJ,STARTUP.OBJ
|
This LIBRARY command creates a VAX object module library named TESTLIB.OLB
and places the files ERRMSG.OBJ and STARTUP.OBJ as modules in the library.
| #2 |
$ LIBRARY/VAX/SHARE/CREATE SHARLIB
|
This LIBRARY command creates a VAX shareable image library called SHARLIB.OLB.
/WIDTH
Controls the screen display width (in characters) for listing global
symbol names.
Format
/WIDTH =
n
The width of the screen display.
Description
Specify the /WIDTH qualifier with the /NAMES qualifier to limit the
line length of the /NAMES display.
The default display width is the width of the listing device. The maximum
width is 132.
Example
|
$ LIBRARY/LIST/NAMES/ONLY=$ONE/WIDTH=80 SYMBOLIB
|
This LIBRARY command requests a full listing of the module $ONE, contained
in the object library SYMBOLIB.OLB. The /WIDTH qualifier requests that the
global symbol display be limited to 80 characters per line.
|
