RECYCLEOUTPUT: Limiting the selection and allocation of an output volume during recycle processing

Explanation: RECYCLEOUTPUT(BACKUP MIGRATION) is an optional parameter that you use to limit the selection and allocation of an output volume during recycle processing.

Tape Library Relationship: A UNITNAME can be used for filtering in the ACS routines. If you specify the unittype for this command, it will be sent to the ACS routines in SMS for the RECYCLEOUTPUT function.

Subparameter Explanation
BACKUP(unittype) During recycle processing of a tape backup volume, only tape spill backup volumes that can be mounted and written on the specified type of unit are used for output. In addition, when the tape spill backup volume is allocated for output during recycle processing, the volume is allocated using the unit name specified with the BACKUP subparameter of the RECYCLEOUTPUT parameter, overriding the unit name specified on the ADDVOL command for the tape spill backup volume.
MIGRATION(unittype) During recycle processing of a tape level 2 migration volume, only tape level 2 migration volumes that can be mounted and written on the specified type of unit will be used for output. In addition, when the tape level 2 migration volume is allocated for output during recycle processing, the volume is allocated using the unit name specified with the MIGRATION subparameter of the RECYCLEOUTPUT parameter, overriding the unit name specified on the ADDVOL command for the tape level 2 migration volume.

For unittype, specify a generic or esoteric unit name. The following generic unit names are acceptable: 3480, 3480X, 3490, and 3590-1. If an esoteric unit name is specified, it must have been previously defined to DFSMShsm using the USERUNITTABLE parameter of the SETSYS command.

SMS relationship: Parameter has the same meaning when applied to SMS-managed or non-SMS-managed DASD volumes or data sets.

SETSYS default: If unittype is not specified with the BACKUP parameter, there is no restriction on the type of tape spill backup volume that can be selected for output during the recycle processing of a tape backup volume. If unittype is not specified here and a scratch tape is required, the value specified for SETSYS UNITNAME is used when an output tape is allocated for a backup volume.

If unittype is not specified with the MIGRATION parameter, there is no restriction on the type of tape level 2 migration volume that can be selected for output during the recycle processing of a tape level 2 migration volume. If unittype is not specified here and a scratch tape is required, the value specified for SETSYS MIGUNITNAME is used when an output tape is allocated for a migration volume.

If the RECYCLEOUTPUT parameter is specified without any subparameters, no changes are made to the current DFSMShsm values.

DFSMShsm default: None.