Extend special catalog by another catalog file
Component: | BS2000 |
Functional area: | Pubset and MRSCAT management |
Domain: | MULTI-CATALOG-AND-PUBSET-MANAGEMENT |
Privileges: | TSOS |
Function
The ADD-CATALOG-FILE command enables systems support to extend the special catalog of an SM pubset.
When the command executes, another catalog file is created for the special catalog selected. The file name of the new catalog file has the following format:
:<catid>:$TSOS.TSOSCAT#xnn
where:
x | designates the special catalog (M, J or P; see CATALOG operand) |
nn | consecutive numbering of the special catalog (00 through 99) |
The numbering of the special catalogs never has any gaps. No file with this name may already exist.
The command can only be issued on the master processor.
Format
Operands
PUBSET-ID = <cat-id 1..4>
Designates the pubset for which a special catalog is to be extended.
CATALOG = *MIGRATED / *JV / *PRIVATE
Defines which special catalog is to be extended.
CATALOG = *MIGRATED
The catalog for the migrated files and the no space files is extended, i.e. a file with the format :<catid>:$TSOS.TSOSCAT.#Mnn is created.
CATALOG = *JV
The catalog for the job variables is extended, i.e. a file with the format :<catid>:$TSOS.TSOSCAT.#Jnn is created.
CATALOG = *PRIVATE
The catalog for the private disk and tape files is extended, i.e. a file with the format :<catid>:$TSOS.TSOSCAT.#Pnn is created.
Return codes
(SC2) | SC1 | Maincode | Meaning/Guaranteed messages |
|---|---|---|---|
0 | CMD0001 | Command executed without error | |
32 | CMD0221 | Internal error | |
64 | DMS0312 | Catalog not known in system | |
64 | DMS0501 | Catalog is not available in the system | |
64 | DMS134C | MRSCAT cannot be determined | |
64 | DMS13BB | Pubset is not master or not an SM pubset | |
64 | DMS13BC | File of the same name already exists | |
64 | DMS13BE | Catalog is not known in the catalog index | |
128 | DMS0506 | Change of master running |