DELETE-VOLUME-SET-LIST

Delete volume set list

Component:	BS2000
Functional area:	Pubset and MRSCAT management
Domain:	MULTI-CATALOG-AND-PUBSET-MGMT
Privileges:	TSOS

Function

The DELETE-VOLUME-SET-LIST command enables systems support to delete volume set lists from the volume set list catalog. If more than one volume set list is specified, the SELECT operand can be used to restrict the set of volume set lists being deleted to those containing specific volume sets. The DIALOG-CONTROL operand defines the conditions under which a dialog is conducted to verify that objects are to be deleted.

The SM pubset must have been imported to the local system (in exclusive or shared mode). 

Format

DELETE-VOLUME-SET-LIST

VOLUME-SET-LIST-NAME = *ALL / <composed-name 1..8 with-wild>
,PUBSET = <cat-id 1..4>
,SELECT = *ALL / *BY-VOLUME-SET(...)
	*BY-VOLUME-SET(...)
		|	ENTRY = list-poss(255): <cat-id 1..4>
,DIALOG-CONTROL = *STD / *NO / *ERROR / *LIST-CHANGE / *MORE-THAN-ONE-LIST

Operands

VOLUME-SET-LIST-NAME = *ALL / <composed-name 1..8 with-wild>
Specifies which volume set lists to delete.

VOLUME-SET-LIST-NAME = *ALL
The volume set lists to delete are all those which are assigned to the pubset specified in the PUBSET operand and which also meet the selection criteria defined in the SELECT operand.

VOLUME-SET-LIST-NAME = <composed-name 1..8 with-wild>
Name of the volume set list that is to be deleted. Wildcards can be used to select more than one volume set list.

The volume set lists to delete are all those specified here which are assigned to the pubset specified in the PUBSET operand and which also meet the selection criteria defined in the SELECT operand.

PUBSET = <cat-id 1..4>
Catalog ID of the associated SM pubset. The SM pubset must have been imported to the local system (in exclusive or shared mode).

SELECT = *ALL / *BY-VOLUME-SET(...)
Specifies whether the set of volume set lists specified in the VOLUME-SET-LIST-NAME operand is to be restricted by selection criteria.

SELECT = *BY-VOLUME-SET(...)
The selection is to be restricted to volume set lists which contain any of the volume sets specified next.

ENTRY = list-poss(255): <cat-id 1..4>
Volume set ID.
Up to 255 volume sets can be listed.

DIALOG-CONTROL = *STD / *NO / *ERROR / *LIST-CHANGE / *MORE-THAN-ONE-LIST
Specifies whether and under what conditions a verification dialog is to be conducted with the user during the deletion process.
The verification dialog mechanism is available only in interactive mode, though that does include procedures. In batch mode all values have the same effect as *NO.

Systems support can intervene with the following inputs:

Y	the specified volume set list or set of volume set lists will then be deleted.
N	the specified volume set list or set of volume set lists will not be deleted.
T	processing of the command will be terminated.
S	the specified volume set list or set of volume set lists will be displayed. The verification dialog will then be repeated.
?	the possible responses will be listed, with an explanation of each.

DIALOG-CONTROL = *STD
The default *STD setting is equivalent to *MORE-THAN-ONE-FILE in an interactive dialog (when SYSCMD is connected to the terminal) and to *NO in procedures and in batch mode.

DIALOG-CONTROL = *NO
Systems support cannot intervene in DELETE-VOLUME-SET-LIST processing; all the specified volume set lists will be deleted (without a verification dialog).

DIALOG-CONTROL = *ERROR
If deletion of the selected volume set lists proceeds without error, all the volume set lists will be deleted immediately, as when *NO is specified (i.e. no verification dialog). However, if a correctable error occurs during deletion, then a verification dialog takes place for each volume set list which it was not possible to delete.
In batch mode this value has the same effect as *NO.

DIALOG-CONTROL = *LIST-CHANGE
A verification dialog is conducted for each volume set list selected.
In batch mode this value has the same effect as *NO.

DIALOG-CONTROL = *MORE-THAN-ONE-LIST
If exactly one volume set list is specified or identified by the selection criteria, this will be deleted immediately. If more than one volume set list is to be deleted, a verification dialog is conducted for the set which is to be deleted.
In batch mode this value has the same effect as *NO. 

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	DMS1482	Error accessing volume set list catalog
	64	DMS1484	Volume set list catalog invalid
	64	DMS1485	Pubset not known
	64	DMS1486	Pubset is not a system-managed pubset
	64	DMS1487	Pubset not available
	64	DMS148B	Volume set list not defined
	64	DMS1490	Storage class management not available for this pubset
	64	DMS149B	No volume set lists meet the selection criteria
	64	DMS149C	No volume set list exists for the specified pubset
	129	DMS148D	Not enough class 4/5 memory
	129	DMS148E	Error on MSCF connection to master
	129	DMS148F	GCF subsystem not ready