Explanation: EXECUTE, VERIFY, and DISPLAY are
mutually exclusive, required parameters that specify whether to recycle,
print tape lists, or list volumes that meet eligibility criteria (percent
valid) for recycling.
EXECUTE specifies that DFSMShsm should recycle
a specific tape volume, a category of backup volumes, tape migration
level 2 volumes, or a combination of all volumes. Volumes that meet
the eligibility criteria are recycled. To recycle volumes that do
not meet the eligibility criteria, you must prepare the volumes for
recycle by following the specified actions.
VERIFY specifies that DFSMShsm produces one
set of tape volume serial numbers that are listed twice: in two different
formats and in one output data set. Customers can use the first list
as a
pull list and the second list as a
mount list.
- Pull list: One or more tape groups of the
requested category (ML2, SPILL, and so forth ) to be pulled from tape
storage. Each group is ordered by volume serial. The groups are
in the order in which RECYCLE will most likely request that tapes
be mounted when the RECYCLE EXECUTE command is issued. Volumes in
a connected set are not split between groups. Empty tapes are included
and identified as such, but are not mounted during RECYCLE processing.
Pull lists are used by operators to fetch and transport the required
tapes during RECYCLE processing.
- Mount list: A list of all tapes to be recycled
for a given category, ordered by the reuse capacity. This is the
order in which recycle most likely requests the tapes be mounted.
However, this projected mount order may differ from the actual mount
order due to other factors affecting recycle processing including,
but not limited to, running more than 1 recycle task, unrecoverable
errors, a mixture of device types within the mount list, or connected
sets containing more than 5 volumes. The volumes in a connected set
are identified and listed together. Empty tapes are included and
identified as such, but are not mounted during RECYCLE processing.
Mount lists aid tape operators with the mounting order of tapes that
are being recycled.
Both of these lists are dynamically allocated to either a SYSOUT
data set or to the data set having the prefix that you specified with
the TAPELIST PREFIX(tapelist_prefix) parameter or to the
fully qualified data set name that you specified with the TAPELIST
FULLDSNAME(tapelist_dsn) parameter. The data set is deallocated
when the command completes.
DISPLAY gives you a formatted list in volume
serial sequence of the tape volumes eligible for recycling that meet
the percent valid criteria. The list is dynamically allocated to either
a SYSOUT data set or the data set specified by the OUTDATASET parameter.
If you request DISPLAY for a specific tape volume, you will get a
list of the connected set containing that volume. DFSMShsm sends
a message containing the information to your terminal or optionally
directs this information to a data set specified by the OUTDATASET
parameter.
When you specify the VERIFY or DISPLAY parameters, the total output
includes one or more of the following volumes:
- Eligible tape daily backup volumes assigned to a particular day
(or to all days) in the backup cycle
- Eligible tape spill backup volumes
- Eligible tape migration level 2 volumes
When you specify the VERIFY or DISPLAY parameters, DFSMShsm does
not ask for any tapes to be mounted.
Defaults: None.
Note: - If you are a customer without an ATL but with a relatively small number of tapes that you must pull manually
from shelf storage, use the DISPLAY parameter.
However, if you
are a customer without an ATL but with a large number
of tapes that you must pull manually, the VERIFY parameter (or EXECUTE
TAPELIST) is a better choice.
- With the VERIFY parameter, the number of volumes in a pull group
(and the total number of volumes to be pulled) can be specified with
the optional TAPELIST parameter.
- If you specify the VERIFY parameter with a single volume, DFSMShsm
treats the command as if you had specified DISPLAY.