The LIBGET command copies a module from a CA Librarian master file into a data set or PDS member. You can use an existing data set or member or allow the LIBGET command to create one.
Modules retrieved from a master file through LIBGET are referred to as outstanding modules. You must return outstanding modules to the master file through the LIBSAVE command.
When a module is retrieved through LIBGET, an entry is made on The LIB/TSO Control Directory (TLICD). The TLICD is a directory of all the modules that were copied from CA Librarian master files into TSO data sets through the LIBGET command. When the outstanding modules are returned through the LIBSAVE command to their respective CA Librarian master files, their entries on the TLICD file are automatically deleted.
The number of module entries allowed per user on the TLICD file is determined at installation. When the limit is reached, the user can either replace one entry by another, without updating the module the entry references or free an entry by terminating the LIBGET command and returning a module to the master file through the LIBSAVE command.
When you specify the READONLY option, the module is copied into a TSO data set, but no entry is made on the TLICD file.
This command has the following format:
{LIBGET}
{LIBG }
Required Operands
{module-name}
{pds-name(member)}
Options
[ GETVERS ]
[ ]
[ ARC[(date)] ARCINC[(date)] ]
[ [(Lx) ] [(Lx) ] ]
[ [(-y) ] [(-y) ] ]
[ ]
[ [INCLUDE{(RESEQ) } ] ]
[ [ {(NORESEQ)} ] ]
[ [NOINCLUDE ] ]
[ [INCASIS ] ]
[ ]
[ PASSWORD(password) ]
[ ]
[ READONLY ]
[ ]
[ [SOURCE(master-file-name) ] ]
[ [DSSOURCE{(dsn-of-master) }] ]
[ [ {('dsn-of-master')}] ]
[ ]
[ [TSODSN{(data-set-name) }] ]
[ [ {('data-set-name') }] ]
[ [ {(pds-name(member)) }] ]
[ [ {('pds-name(member)')}] ]
[ ]
[ TSOSIZE(nnnnnn) type ]
[ ]
[ VERS(mmdd[hhmm]) [VAR ] ]
[ [NOVAR] ]
Identifies the name of the module to retrieve from the CA Librarian master file.
If you do not identify the data set where the module is copied through the TSODSN option, the LIBGET command constructs the name for you. It uses the specified module name as the user-supplied name, prefixing it with your user-prefix.
The descriptive qualifier is derived from either the type entry specified on the command, any language code stored with the module, or the system default. For example:
LIBGET MYMOD ASM
Copies the module into a data set with the following name:
user-prefix.MYMOD.ASM
Identifies the module to retrieve from CA Librarian master file and copy to a TSO partitioned data set member. If you enter the user‑supplied name of the PDS and the name of the member to use, the LIBGET command constructs the full data set name by prefixing the user-supplied name with your user-prefix and appending the specified type entry to the name.
If you do not specify a type, the language code stored with the module is converted into the equivalent type and is used. If there is no language code or it is not recognizable to /lib, the system default type is used. The member name is used as the module name.
Note: You can only use this option for partitioned data sets whose names adhere to TSO naming conventions. If you are using a member of a PDS whose name deviates from TSO naming conventions (or if the module-name is different from the member name), you must use the module-name operand to identify the module and you must use the TSODSN option to identify the PDS and member name.
The following examples show some typical uses of the LIBGET command.
|
Copyright © 2003 CA.
All rights reserved.
|
|