Change volume set list catalog
Component: | BS2000 |
Functional area: | Pubset and MRSCAT management |
Domain: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privileges: | TSOS |
Function
The CHANGE-VOLUME-SET-LIST-CATALOG command allows systems support to change the volume set list catalog.
The command can also be used to dynamically load the volume set list catalog if it was corrupt when the SM pubset was imported and so could not be loaded at that time (message DMS1484).
The file named :<sm-pubset-catid>:$TSOS.SYSCAT.VSETLST contains the current volume set list catalog. If the catalog is to be changed using CHANGE-VOLUME-SET-LIST-CATALOG, the new catalog must be stored as SYSCAT.VSETLST.BAK (with the same user and catalog IDs). When the command is executed, the original catalog is saved as SYSCAT.VSETLST.<date>.<time>, where <date> is the date (in yyyy-mm-dd format) and <time> is the time (in hhmmss format) when the catalog was changed. The new catalog is renamed to SYSCAT.VSETLST and thus becomes the current volume set list catalog.
The procedure for dynamically loading and changing the volume set list catalog is as follows:
Create a file named SYSCAT.VSETLST.BAK in the control volume set. It is best to create the file in VOLRES, so that the control volume set can also be reduced in size later.
Using HSMS, transfer the contents of a backup copy of the volume set list catalog to SYSCAT.VSETLST.BAK.
Run the CHANGE-VOLUME-SET-LIST-CATALOG command. The volume set list catalog will then be dynamically loaded from SYSCAT.VSETLST.BAK.
Format
CHANGE-VOLUME-SET-LIST-CATALOG |
PUBSET = <cat-id 1..4> |
Operands
PUBSET = <cat-id 1..4>
Designates the pubset for which the volume set list catalog is to be changed or dynamically loaded.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No errors | |
1 | CMD0202 | Syntax error in command | |
32 | CMD0221 | Internal system error | |
64 | CMD0216 | No authorization for command | |
64 | DMS1485 | Pubset not known | |
64 | DMS1486 | Pubset is not a system-managed pubset | |
64 | DMS1487 | Pubset not available | |
64 | DMS1490 | Storage class management not available for this pubset | |
64 | DMS1484 | Volume set list catalog invalid | |
64 | DMS1482 | Error accessing volume set list catalog | |
64 | DMS1499 | Catalog SYSCAT.VSETLST.BAK not in control volume set | |
64 | DMS1495 | Catalog SYSCAT.VSETLST.BAK invalid | |
64 | DMS1496 | Catalog SYSCAT.VSETLST.BAK does not exist | |
129 | DMS148D | Not enough class 4/5 memory | |
129 | DMS148E | Error on HIPLEX MSCF connection to master | |
129 | DMS148F | GCF subsystem not ready |