RECYCLE Command

RECYCLE Utility › Running RECYCLE › RECYCLE Command

RECYCLE Command

The RECYCLE command specifies the selection criteria for each group or subgroup process, or a single physical tape VOLSER. You can specify multiple commands for each execution of the utility.

When multiple requests are specified, they are processed in the order specified. To run multiple requests concurrently, create a separate job for each RECYCLE request.

Syntax

RECYCLE GROUP(nn),
         SUBGROUP(*|S|M|L),
         SOURCE(PRIMARY|DUPLEX),
         TARGET(*|P|PRIMARY|D|DUPLEX|B|BOTH),
         PERCENT(nnnnn),
         MAXVOLS(nnnnnn),
         DEVTYPE(*|3480|3490|3590),
         PRIORITY(SML|SLM|MSL|MLS|LMS),
         TAPECONSOLIDATIONRATIO(n)
RECYCLE PHYSICAL(volser),
         SOURCE(PRIMARY|DUPLEX),
         TARGET(*|P|PRIMARY|D|DUPLEX|B|BOTH)

The following gives details about each line of the syntax:

GROUP(nn) - (Required for group-based RECYCLE)

Use the GROUP(nn) parameter to specify the group number to be processed. Each command processes a single Backstore group. Only Virtual Volumes from a single group are stored on any one physical tape (Virtual Volumes from different groups or subgroups are not placed on the same Backstore tape). RECYCLE processing is serialized at a group level. If RECYCLE determines that another job is trying to process the same group, it will print an error message and continue processing at the next command.

SUBGROUP(* |S |M |L)

(Optional)

Default value: L

Use the SUBGROUP(* |S |M |L) parameter to specify a subgroup to be selected for processing. Use an asterisk (*) to select all subgroups. Specify S, M, or L to include Backstore tapes from the SHORT, MEDIUM, or LONG retention period subgroups. RECYCLE keeps all Virtual Volumes for each subgroup on separate Backstore tapes.

Example of SUBGROUP selection:

SUBGROUP(*)
SUBGROUP(L)

PHYSICAL(volser) - (Required for VOLSER-based RECYCLE)

Use the PHYSICAL(volser) parameter to specify one physical tape VOLSER to be processed. Each command processes a single VOLSER.

Note: When the PHYSICAL parameter is coded, the group, SUBGROUP, DEVTYPE, PRIORITY, PERCENT, and MAXVOLS parameters are ignored and a message is issued for each ignored parameter. For example:

SVTSZ190I GROUP IGNORED ON SINGLE VOLUME RECYCLE

SOURCE(PRIMARY|DUPLEX|REPAIR)

(Optional)

Default value: PRIMARY

The SOURCE(PRIMARY|DUPLEX|REPAIR) parameter indicates the source of the input Backstore tapes to be used for processing as follows:

PRIMARY instructs RECYCLE to read primary Backstore tapes.
DUPLEX instructs RECYCLE to read duplex Backstore tapes.
REPAIR is used with the PHYSICAL parameter to recreate a damaged or lost PRIMARY or DUPLEX physical tape as follows:
- If physical tape vvvvvv belongs to a group supporting DUPLEX and SOURCE(REPAIR) is specified, the corresponding mirror or backup physical tape is mounted and processed instead of physical tape vvvvvv.
- If the group does not support DUPLEX, physical tape vvvvvv is mounted, moving all the readable data to the output tape.
- If Virtual Volumes are bypassed because the move process cannot be completed, they remain catalogued to physical tape vvvvvv.
- If further attempts to recover the Virtual Volumes fail, they should be scratched in the Tape Management System and in CA Vtape.

Note: Duplex Backstore tapes are only created for CA Vtape groups with a Duplex attribute coded in their group definitions. If DUPLEX is specified in a RECYCLE job for a group that does not have the Duplex attribute coded, an error message is produced.

TARGET(* |PRIMARY |DUPLEX |BOTH)

(Optional)

Default value: * (asterisk)

RECYCLE can create primary output, duplex output, or both types of Backstore tapes. An asterisk (*) indicates that the Backstore tapes created by RECYCLE are to be the same type as the input Backstore tapes. PRIMARY or DUPLEX indicates that the output data sets are to be primary or duplex, regardless of the input data set. BOTH specifies that the primary and duplex copy are to be created regardless of input type.

Note: A duplex tape can only be created if the group being processed has the DUPLEX attribute coded.

PERCENT(nnnnnn)

(Optional)

Default value: 999999

The PERCENT(nnnnnn) parameter determines the used space threshold selection criteria to be used in determining which Backstore tapes are to be processed. Selection is determined based on the percentage of used space on a Backstore tape. If not specified, 999999 is used, which indicates that all Backstore tapes, regardless of utilization percentage, are to be selected. PERCENT(40) selects Backstore tapes from the specified group having less than 40 percent unexpired data (60 percent or more of the data on the tape is expired).

When SUBGROUP(*) is used with PERCENT, the PERCENT value coded is for the entire tape. When a specific subgroup is recycled with PERCENT, the PERCENT value coded is for that subgroup's data on a tape. For example, a backstore tape that is 60% full, where 40% of the data is for subgroup medium and 20% of the data is for subgroup long, will not be selected by RECYCLE when PERCENT(40),SUBGROUP(*), but will be selected when PERCENT(40),SUBGROUP(M) or SUBGROUP(L) is used.

Note: The PERCENT parameter is ignored when a PINCLUDE DD is coded in the RECYCLE JCL.

MAXVOLS(nnnnnn)

(Optional)

Default value: 999999

The MAXVOLS(nnnnnn) parameter specifies a maximum number of input Backstore tapes to process. This parameter is a way of limiting the elapsed run time. For example, specify MAXVOLS(50) to limit RECYCLE processing to 50 tapes.

The following are additional considerations:

MAXVOLS can be overridden by RECYCLE processing. If a Virtual Volume spans multiple Backstore tapes, all of the tapes are processed even if this causes RECYCLE to exceed the MAXVOLS parameter.
The MAXVOLS parameter is ignored when a PINCLUDE DD is coded in the RECYCLE JCL.

DEVTYPE(* |3480 |3490 |3590)

(Optional)

Default value: 3480

The DEVTYPE(* |3480 |3490 |3590) parameter specifies a Backstore tape device type to select for processing. DEVTYPE(3490) selects only input Backstore tapes with that device type.

Use this parameter to recycle physical volumes from one device type to another.

Note: DEVTYPE can be overridden by RECYCLE processing. If a Virtual Volume spans multiple Backstore tapes of different device types, all of the tapes are processed, even if this causes RECYCLE to override the DEVTYPE parameter.

PRIORITY(SML |SLM |MSL |MLS |LSM |LMS)

(Optional)

Default value: LMS

The PRIORITY(SML |SLM |MSL |MLS |LSM |LMS) parameter specifies the preference or processing order for selecting subgroups. If not specified, RECYCLE selects and processes subgroups in LONG, MEDIUM, SHORT order. To modify this processing order, specify an alternate processing sequence. When used in combination with the MAXVOLS parameter, this parameter helps to ensure that the most important subgroup volumes are selected for processing first. For example, specifying PRIORITY(MLS) indicates that the subgroups should be processed in MEDIUM, LARGE and then SHORT order.

TAPECONSOLIDATIONRATIO(0-9)

(Optional)

Default value: 0

The value of the TapeConsolidationRatio or TCR parameter implies an n:1 ratio that is used to define the minimum number of input Backstore Volumes that must be freed in relationship to the number of projected PRIMARY or DUPLEX output volumes written.

The default value assigned to the Recycle Group TCR parameter is defined by the Recycle SET Command parameter or if not specified is assumed to be 0 (zero).

The TCR parameter is applied after the PERCENT and MAXVOLS parameters.