MIGRATIONVOLUME, MIGRATIONLEVEL1, MIGRATIONLEVEL2, and VOLUME: Listing migration volumes

Explanation: MIGRATIONVOLUME, MIGRATIONLEVEL1, MIGRATIONLEVEL2, and VOLUME are mutually exclusive, required parameters you specify to request a list of selected information for migration volumes. These parameters can also be used as subparameters of the SELECT parameter.

MIGRATIONVOLUME
specifies that you want a list of the volume entries for all migration volumes.
MIGRATIONLEVEL1
specifies that you want a list of volume entries for migration level 1 volumes.
You can narrow down the kind of migration level 1 volumes you list using the optional SELECT parameter:
SELECT(NOOVERFLOW)
lists the volume entries for all NOOVERFLOW ML1 volumes.
SELECT(OVERFLOW)
lists the volume entries for all OVERFLOW ML1 volumes.

Defaults: If you specify MIGRATIONLEVEL1 alone (without the SELECT subparameter), which is the default, you will get a list of all migration level 1 volumes.

MIGRATIONLEVEL2
specifies that you want a list of the volume entries for all migration level 2 volumes.
DASD
lists the volume entries for all DASD migration level 2 volumes is generated.
TAPE
lists the volume entries for all tape migration level 2 volumes is generated.
VOLUME
specifies that you want a list of all primary and migration volumes. VOLUME(volser) specifies that you want a list of a particular primary or migration volume. For volser, substitute the serial number of the specific volume you want listed. Both SMS and non-SMS volumes can be listed.

When using VOLUME(volser) as a subparameter of SELECT and when volser is specified as a backup volume, the output contains a list of the latest backup versions on the volumes.

Defaults: If you specify VOLUME without volser, DFSMShsm lists all the primary and migration volumes it owns or manages. If you specify PRIMARYVOLUME without volser, DFSMShsm lists all primary volumes it owns or manages.

Note:
  1. When you specify any of these parameters, DFSMShsm does not list information about the data sets on the primary or migration volume, and DFSMShsm does not give you any information about the amount of space left on the volume. To find out how much space is left on a primary or migration level 1 volume, use the SPACE parameter of the QUERY command.