Explanation: ALL, BACKUP, DAILY, ML2, SPILL, and
VOLUME(volser) are mutually exclusive, required parameters
specifying the types of tape volumes to be recycled.
ALL specifies that DFSMShsm should recycle
all eligible daily, ML2, and spill tape volumes.
BACKUP specifies that both daily and spill
backup tapes are to be used as input in the RECYCLE processing.
DAILY specifies that DFSMShsm should recycle
all eligible tape daily backup volumes.
Subparameter |
Explanation |
day |
DAILY(day) specifies
that DFSMShsm should recycle all eligible tape volumes assigned to
that day in the backup cycle. For day, substitute a decimal
number to represent the day in the backup cycle assigned to the tape
daily backup volume. You use the DEFINE BACKUP command to define the
backup cycle. |
ML2 specifies that DFSMShsm should recycle
all eligible tape migration level 2 volumes. If the SETSYS ML2PARTIALSNOTASSOCIATEDGOAL(nnn) parameter has been specified with a value other than NOLIMIT
and the number of ML2 partial tapes not currently associated as output
for any migration or recycle task and meeting the recycle criteria
is greater than nnn then DFSMShsm recycles the excess over nnn, that is, those tapes with the least percent of valid data.
A partial is a tape that is not full and not empty.
SPILL specifies that DFSMShsm should recycle
all eligible tape spill backup volumes.
VOLUME(volser) specifies the volume
to be recycled. For volser, substitute the serial number
of the volume to be recycled. When you specify a volume serial number,
DFSMShsm does not check whether the specific tape volume is eligible
for recycling. This allows you to recycle tapes that are not full
or that were otherwise not selected by generic recycle.
Defaults: None.
Note: - If you specify a generic request, a connected set is eligible
for recycling only if the following conditions are met for all volumes
in the set:
- The tape volume is a migration level 2 tape or a backup tape,
but not an unassigned backup tape.
- The tape volume is either marked full, or a partial ML2 tape that
is not connected to any other tape and not currently associated with
any migration or recycle output task.
- The tape volume is marked full.
- The percentage of valid data is equal to or less than the applicable
value. This percentage is specified with the PERCENTVALID parameter,
the SETSYS ML2RECYCLEPERCENT parameter, or the SETSYS RECYCLEPERCENT
parameter. When these parameters are not specified, the DFSMShsm
default is 20%.
- The volume has not previously failed recycle processing, or if
it has failed, now contains no valid data.
- The TTOC for the volume is complete.
- The volume does not have a disaster alternate volume.
- Dump volumes are not recycled.
- For performance reasons, DFSMShsm does not update the OCDS TTOC
every time a data set is migrated or backed up to a tape volume.
If DFSMShsm abends, an I/O error occurs, or a system fails, the OCDS
TTOC may not be updated. If you specify the RECYCLE command to recycle
a tape volume that has missing TTOC entries, message ARC0378I is issued,
indicating that the tape media and the OCDS TTOC have a mismatch.
Use the AUDIT MEDIACONTROLS FIX command to resolve the problem. For
more information, see MEDIACONTROLS VOLUMES and MEDIACONTROLS(SDSP) VOLUMES: Requesting an audit of control information.