Modify volume set list definition
Component: | BS2000 |
Functional area: | Pubset and MRSCAT management |
Domain: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privileges: | TSOS |
Function
The MODIFY-VOLUME-SET-LIST command enables systems support to modify a defined volume set list. Volume sets can be added and removed. A volume set list can hold a maximum of 255 volume sets. It is also possible to modify the brief explanatory text.
The SM pubset for which the volume set list definition is to be modified must have been imported to the local system (in exclusive or shared mode).
Format
MODIFY-VOLUME-SET-LIST |
VOLUME-SET-LIST-NAME = <composed-name 1..8> ,PUBSET = <cat-id 1..4> ,REMOVE-VOLUME-SET = *NO / *ALL / list-poss(255): <cat-id 1..4> ,ADD-VOLUME-SET = *NO / list-poss(255): <cat-id 1..4> ,VOLUME-SET-LIST-INFO = *UNCHANGED / *NONE / <c-string 1..720 with-low> |
Operands
VOLUME-SET-LIST-NAME = <composed-name 1..8>
Name of a defined volume set list which is to be modified.
PUBSET = <cat-id 1..4>
Identifies the SM pubset for which the volume set list now being modified is defined.
REMOVE-VOLUME-SET = *NO / *ALL / list-poss(255): <cat-id 1..4>
Indicates whether volume sets are to be removed from the volume set list.
REMOVE-VOLUME-SET = *NO
No volume sets are to be removed.
REMOVE-VOLUME-SET = *ALL
All the volume sets are to be removed from the volume set list.
REMOVE-VOLUME-SET = list-poss(255): <cat-id 1..4>
The specified volume sets are to be removed from the volume set list. Up to 255 volume sets can be listed.
ADD-VOLUME-SET = *NO / list-poss(255): <cat-id 1..4>
Indicates whether volume sets are to be added to the volume set list.
ADD-VOLUME-SET = *NO
No volume sets are to be added.
ADD-VOLUME-SET = list-poss(255): <cat-id 1..4>
The specified volume sets are to be added to the volume set list. Up to 255 volume sets can be listed. Up to 255 volume sets can be assigned to a volume set list. This ceiling must not be exceeded.
The command does not check that the specified volume sets really belong to the SM pubset. Volume sets specified both in REMOVE-VOLUME-SET and in ADD-VOLUME-SET will still be on the volume set list when the command has finished executing.
VOLUME-SET-LIST-INFO = *UNCHANGED / *NONE / <c-string 1..720 with-low>
Specifies whether the brief explanatory text about the volume set list is to be modified. The default is *UNCHANGED, which means that any existing text is retained.
VOLUME-SET-LIST-INFO = *NONE
Any existing explanatory text is to be deleted.
VOLUME-SET-LIST-INFO = <c-string 1..720 with-low>
The brief text entered here is incorporated as a description of the volume set list. Any existing text will be overwritten.
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 to issue command | |
64 | DMS148B | Volume set list not defined | |
64 | DMS148C | Maximum number of volume set entries exceeded | |
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 | |
129 | DMS148D | Not enough class 4/5 memory | |
129 | DMS148E | Error on MSCF connection to master | |
129 | DMS148F | GCF subsystem not ready |