Define volume set list for SM pubset
Component: | BS2000 |
Functional area: | Pubset and MRSCAT management |
Domain: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privileges: | TSOS |
Function
The CREATE-VOLUME-SET-LIST command allows systems support to define a new volume set list for a system-managed pubset (SM pubset). The SM pubset must have been imported to the local system (in exclusive or shared mode).
An entry for the new volume set list is added to the current volume set list catalog (:<sm-pubset-catid>:$TSOS.SYSCAT.VSETLST). Up to 255 volume sets can be assigned to a volume set list. If the volume set list is associated with a storage class (see the VOLUME-SET-LIST operand in the CREATE- or MODIFY-STORAGE-CLASS command), files in that storage class will if possible be stored in volume sets from the assigned volume set list
The SHOW-VOLUME-SET-LIST command provides information about the composition of volume set lists.
A volume set list can have volume sets added to or removed from it with the MODIFY-VOLUME-SET-LIST command, and its entry can be removed from the volume set list catalog with the DELETE-VOLUME-SET-LIST command.
Systems support can use the CHANGE-VOLUME-SET-LIST-CATALOG command to change or, in the event of an error, dynamically load the volume set list catalog.
Format
CREATE-VOLUME-SET-LIST |
VOLUME-SET-LIST-NAME = <composed-name 1..8> ,PUBSET = <cat-id 1..4> ,VOLUME-SET = *NONE / list-poss (255): <cat-id 1..4> ,VOLUME-SET-LIST-INFO = *NONE / <c-string 1..720 with-low> |
Operands
VOLUME-SET-LIST-NAME = <composed-name 1..8>
Defines a name for the new volume set list.
PUBSET = <cat-id 1..4>
Specifies the catalog ID of the SM pubset for which the volume set list is being created. The pubset must have been imported to the local system (in exclusive or shared mode).
VOLUME-SET = *NONE / list-poss(255): <cat-id 1..4>
Specifies which volume sets are to be assigned to the volume set list.
VOLUME-SET = *NONE
No volume sets are to be assigned to the volume set list at this time.
VOLUME-SET = list-poss(255): <cat-id 1..4>
The specified volume sets are to be assigned to the volume set list. Up to 255 volume sets can be listed.
The command does not check that the specified volume sets belong to the SM pubset for which the volume set list is being created.
VOLUME-SET-LIST-INFO = *NONE / <c-string 1..720 with-low>
Systems support can compose a brief text describing the volume set list. It will typically relate to differences between volume set lists
The default is *NONE, i.e. there is to be no explanatory text.
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 | DMS1489 | Volume set list already defined | |
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 |