Write catalog entry to file
Component: | BS2000 |
Functional area: | Pubset and MRSCAT management |
Domain: | MULTI-CATALOG-AND-PUBSET-MANAGEMENT |
Privileges: | TSOS |
Function
The LIST-CATALOG-ENTRY command is designed to facilitate diagnosis of errors in a catalog entry. Systems support can have the entire catalog entry, including the extents, written to file for a particular file or job variable.
The command can be entered from any system in the network for shared pubsets.
Format
Operands
NAME = <filename 1..54>
Name of the file or job variable whose catalog entry is to be output. The name must contain the catalog and user IDs.
OBJECT = *FILE / *JV
Specifies whether the command is to be executed for the catalog entry of a file or job variable.
OUTPUT = <filename 1..54>
Name of the file to which the catalog entry is to be written.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed without error | |
32 | CMD0221 | Internal error | |
64 | DMS0501 | Catalog is not available in the system | |
64 | DMS0505 | Error in computer communication | |
64 | DMS0512 | Catalog is not known in the system | |
64 | DMS1343 | A change of master is currently running for the pubset | |
64 | DMS0333 | File not cataloged | |
64 | JVS0433 | JV not cataloged |
Format of the output
A header contains the fully qualified file name, a flag for the file or job variable, the pubset type and the catalog name (important for SM pubset).
Subsequently, the catalog entry is output in hexadecimal, printable form together with its extents, contiguous parts being output contiguously.