Explanation: BACKUP, DUMP, MIGRATION, and PRIMARY are
mutually exclusive, required parameters specifying what type of volume
to delete.
BACKUP specifies that a backup volume is
reassigned as an unassigned volume or, if the PURGE subparameter is
specified, deleted from DFSMShsm control.
DUMP specifies that a dump volume is disassociated
from the dump class to which it is currently assigned and all record
of its contents is discarded. In addition, the PURGE or REASSIGN
subparameters can be specified to remove the volume from the control
of DFSMShsm or to retain the associated dump class respectively.
If the volume specified is part of a valid dump copy, all volumes
containing part of the same dump copy are treated similarly.
MIGRATION specifies that a migration volume
is changed as follows:
- In the case of a migration level 1 volume, the volume is deleted
from DFSMShsm control.
- In the case of a DASD migration level 2 volume, the volume is
no longer associated with its key range and is available for selection.
If the optional PURGE subparameter is specified, the volume is removed
from the control of DFSMShsm.
- In the case of a tape migration level 2 volume, the volume is
marked as not selected and is therefore available unless full. If
the optional PURGE subparameter is specified, the volume is removed
from the control of DFSMShsm if no valid data exists on the volume.
Note: In the preceding cases, DFSMShsm determines from the
serial number whether the volume you have identified with the volser positional
parameter is a migration level 1 volume or a migration level 2 volume.
PRIMARY specifies that a primary volume (a
volume added using the ADDVOL command or an SMS-managed volume) is
deleted from DFSMShsm control. DFSMShsm removes the record of the
deleted volume from the MCDS.
Defaults: None.
Note: - If you issue the BACKUP parameter of the DELVOL command while
the backup volume is in use, the command fails.
- If you issue the MIGRATION parameter of the DELVOL command while
automatic volume space management or automatic secondary space management
is running, the command fails.
- If you issue the PRIMARY parameter of the DELVOL command while
that volume is being processed by automatic space management, automatic
backup, or automatic dump, the command fails.
- If you issue the DUMP parameter of the DELVOL command while automatic
dump is running, the command fails.
- If you use the MIGRATION parameter of the DELVOL command to delete
a migration level 2 tape volume that has incomplete data set information
saved in the OCDS TTOC record, the command fails.