HP OpenVMS Systems Documentation

HP OpenVMS Command Definition, Librarian, and Message Utilities Manual

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.

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.

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.

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.

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.

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.

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

$ 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.

$ 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.

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.

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.

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

$ 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.

$ 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.

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

$ 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.

$ LIBRARY/VAX/SHARE/CREATE SHARLIB      

This LIBRARY command creates a VAX shareable image library called SHARLIB.OLB.

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.