LIB/TSO Interface › LIB/TSO Commands › LIBEXP

LIBEXP

The LIBEXP command:

• Returns a module to an CA Librarian master file that was retrieved through a LIBGET command with the READONLY option specified.
• Updates the control information of a module.
• Updates a module without having to retrieve it from the master file through the LIBGET command. If used in this way, you must create a data set containing an updated version of the module and identify the data set in the LIBEXP command.

Note: Because the LIBEXP command bypasses the TLICD, potentially conflicting updates are possible. To avoid this, management can choose to disable this command at your site.

The LIBEXP command updates only one module at a time and assumes that the module is on an CA Librarian master file.

This command has the following format:

{LIBEXP}
{LIBX  }

Required Operands

{module-name }

{pds-name(member)}

Options

[  GETVERS CLEARID NOTSO         ]
[                                ]
[  NEWPSWD(password) HSTD        ]
[                                ]
[ [ARC[(date)]]                  ]
[ [   [(Lx) ]]                   ]
[ [   [(-y) ]]                   ]
[ [NOARC      ]                  ]
[ [ARCOFF     ]                  ]
[ [ARCLR(date)]                  ]
[                                ]
[ [CHKINC  ]  NOCHK   NOAUDIT    ]
[ [NOCHKINC]                     ]
[                                ]
[  DESC('module-description')    ]
[                                ]
[  HIST('history-information')   ]
[                                ]
[ [KEEPTSO  ]   LANG(lan)        ]
[ [NOKEEPTSO]                    ]
[                                ]
[ [LIST  ]                       ]
[ [NOLIST]                       ]
[                                ]
[  PASSWORD(password)            ]
[                                ]
[  PGMR(programmer-name)         ]
[                                ]
[ [RESEQ ] [SEQ(s,l,i,v)      ]  ]
[ [NORESEQ]                      ]
[                                ]
[ [RENAME(module-name)]          ]
[ [COPY(module-name) ]           ]
[                                ]
[ [SOURCE(master-file-name)   ]  ]
[ [DSSOURCE{(dsn-of-master) } ]  ]
[ [        {('dsn-of-master')}]  ]
[                                ]
[                  [TERMMSG]     ]
[                  [PERMMSG]     ]
[                  [TEMPMSG]     ]
[                                ]
[ [TSODSN{(data-set-name) }]     ]
[ [      {('data-set-name')   }] ]
[ [      {(pds-name(member))  }] ]
[ [      {('pds-name(member)')}] ]
[                                ]
[  TSOSIZE(nnnnnn)     type      ]
[                                ]
[ VERS(mmdd[hhmm])               ]

module-name

Specifies the name of the module the LIBEXP command returns or updates.

If you specify the NOTSO option, LIBEXP assumes you are attempting to update the module’s control information.

If you do not specify NOTSO, it assumes you are attempting to use the contents of a data set or PDS member to update a module. If you specify a module name but do not specify NOTSO and do not explicitly identify the data set to use to update the module through the TSODSN option, the LIBEXP command constructs the name for you. It does so by using the specified module name as the user-supplied name, prefixing it with your user-prefix. The descriptive-qualifier is derived from the type option entry, any language code stored with the module, or the system default. For example, if you enter: user-prefix.MYMOD.ASM

Note: You can let the command derive the name of the data set to use to update the module only if the data set is a sequential data set whose name adheres to TSO naming conventions.

pds-name(member)

Use this operand if you are using a member of a partitioned data set to update a module. Enter the user-supplied name of the PDS and the name of the member. The LIBEXP 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 type stored with the module or the system default type is used. The member name also identifies the module to update.

Note: You can only use this operand 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 specify the name of the module and identify the PDS and member through the TSODSN option.

The following examples show typical uses of the LIBEXP command.