Explanation: EMPTY, FULL, NOTFULL, ASSOCIATED, NOTASSOCIATED,
ERRORALTERNATE, and
RECYCLETAKEAWAY are mutually
exclusive optional subparameters of SELECT. The FULL, NOTFULL, ASSOCIATED,
NOTASSOCIATED, ERRORALTERNATE, and
RECYCLETAKEAWAY subparameters
apply only to the LIST TTOC command. The EMPTY subparameter applies
to the following commands:
- LIST BACKUPVOLUME
- LIST DATASETNAME
- LIST MIGRATIONLEVEL2(TAPE)
- LIST TTOC
- EMPTY
- specifies a list of empty tape backup volumes or empty tape level
2 migration volumes. If you specify SELECT(EMPTY) with LIST DATASETNAME
MCDS, then DFSMShsm will list only those migrated data sets that were
empty when they were migrated.
- FULL
- specifies a list of tape volumes that are not available for selection
(marked full). This subparameter provides a means of identifying
the full backup and migration tape volumes.
- NOTFULL
- specifies a list of tape volumes that are available for output
selection including those that are empty, as well as those that have
some data but are not marked full. By using NOTFULL, you have the
capability of identifying those tapes that could be the first ones
added to a library and made available for backup or migration.
- ASSOCIATED
- specifies a listing of only those ML2 partial (not empty and not
full) tape volumes currently associated for output by specific migration
or recycle tasks.
- NOTASSOCIATED
- specifies a listing of only those ML2 partial tape volumes available
for an initial allocation and not currently associated for output
by any migration or recycle task.
- ERRORALTERNATE
- displays the volumes that encountered errors and were subsequently
marked full when the SETSYS DUPLEX (MIGRATION(Y (ERRORALTERNATE(MARKFULL)
environment was specified.
- RECYCLETAKEAWAY
- displays the volumes that were not completely recycled because
they were taken away.
Defaults: None.
Note: - These subparameters cannot be used when volser is
part of the command.
- The FULL and NOTFULL subparameters are ignored when used with
the RECALLTAKEAWAY subparameter of SELECT.
- When EMPTY is specified with the BACKUPVOLUME parameter, DASD
backup volumes are not listed. EMPTY is ignored when it is specified
with MIGRATIONLEVEL2(DASD). You must use the TAPE parameter for the
EMPTY subparameter to work.
- When EMPTY is specified with the DATASETNAME MIGRATIONCONTROLDATASET
parameter, the list excludes PDS and PDSE data sets.
- The ASSOCIATED and NOTASSOCIATED subparameters are ignored when
listing TTOCs for backup tape volumes.