Initiating recycle processing

You can direct DFSMShsm to recycle a single connected set or to recycle entire categories of volumes. Some commands that recycle tape volumes are:

RECYCLE ALL EXECUTE

RECYCLE ALL EXECUTE LIMIT(nnnn)

RECYCLE ALL EXECUTE PERCENTVALID(pct)

RECYCLE ALL EXECUTE SELECT(INCLUDE(RANGE(include_range_list))
   - EXCLUDE(RANGE(exclude_range_list)))

RECYCLE ML2 EXECUTE

RECYCLE ML2 EXECUTE PERCENTVALID(pct)

RECYCLE ML2 VERIFY TAPELIST(FULLDSNAME(tapelist_dsn))

RECYCLE DAILY EXECUTE

RECYCLE DAILY EXECUTE PERCENTVALID(pct)

RECYCLE DAILY EXECUTE PERCENTVALID(pct) CHECKFIRST(N)

RECYCLE DAILY(day) EXECUTE

RECYCLE DAILY(day) EXECUTE PERCENTVALID(pct)

RECYCLE BACKUP EXECUTE

RECYCLE BACKUP DISPLAY TAPELIST (PREFIX(tapelist_prefix))

RECYCLE SPILL EXECUTE

RECYCLE SPILL EXECUTE PERCENTVALID(pct)

RECYCLE VOLUME(volser) EXECUTE

RECYCLE ALL OUTDATASET(dsname) EXECUTE

The BACKUP parameter allows both daily and spill backup tapes to be selected for input.

The EXECUTE parameter causes DFSMShsm to perform the recycle function of moving valid data sets onto other tape volumes.

The LIMIT parameter quiesces the recycle process after the specified number of tapes are returned to scratch. DFSMShsm calculates the total number of tapes returned by subtracting the number of output tapes used from the number of input tapes freed.

The SELECT parameter adds increased granularity to the RECYCLE eligibility tests. The include_range_list and exclude_range_list values help determine which tape volumes are candidates to be recycled. These values may be useful whenever you are addressing tape media conversion issues.

When a large number of tapes need to be manually pulled from shelves, the optional TAPELIST parameter produces a list of those tapes. The list is composed of pull groups, which are subsets of tapes, with each group in volume-serial sequence. The pull groups are listed in the sequence in which recycle processing will most likely request them. This projected sequence may differ from the actual processing sequence due to other factors affecting recycle processing, including, but not limited to: running more than one recycle task, unrecoverable errors, a mixture of device types or connected sets containing more than five volumes.

An alternative VERIFY parameter specifies the same lists as EXECUTE TAPELIST, but does not move any data sets. An alternative DISPLAY parameter specifies a single list in volume-serial sequence, but does not move any data sets.

The OUTDATASET parameter allows you to send RECYCLE messages and, if specified, the DISPLAY output to an output DASD data set rather than to SYSOUT.

The PREFIX and FULLDSNAME parameters allow you to send the tape list output to a DASD data set, rather than to SYSOUT.

For the RECYCLE VOLUME form of the command, DFSMShsm does not check the volume to see whether the amount of valid data is equal to or less than the percent of valid data or any other selection criteria specified in either the RECYCLE command or the SETSYS command; DFSMShsm recycles the volume's connected set, no matter how much of the data on the volume is invalid.

For the forms of the command using recycle categories of volumes (or all DFSMShsm-owned tape volumes), DFSMShsm automatically checks each connected set to determine whether it is eligible to be recycled. A volume is eligible for recycling only if the following conditions are met:

The tape volume is an ML2 tape or a backup tape, but not an unassigned backup tape.
A backup tape volume is marked full, or an ML2 volume is either marked full or is a partial tape not associated with any migration or recycle task and not connected to a predecessor tape.
The percentage of valid data on the volume's connected set 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 SELECT criteria, if specified, must be met. That is, all tapes of a connected set must be within the INCLUDE RANGE and none in the EXCLUDE RANGE.
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 that has been flagged as a disaster alternate volume.

Each volume in an eligible connected set containing data is mounted, and all valid data is transferred to other tape volumes. When the first volume has had all of its valid data transferred, the next volume processed from that category has all of its valid data transferred to the same target volume until the target volume becomes full.

DFSMShsm recycles ML2 volumes to ML2 volumes. It recycles both daily backup volumes and spill backup volumes to spill backup volumes.

DFSMShsm selects and maintains different target tape volumes for recycle, data set migration, volume backup, and volume migration processing. This allows you to run migration, backup, and recycle at the same time.

If you specify PERCENTVALID(0), DFSMShsm selects only those tapes that are already empty but have not yet been returned to scratch. You may want to use PERCENTVALID(0) at those times when tape operators are not available.

Note: Tape drives will not be allocated if you specify PERCENTVALID(0).