The SET command establishes basic environmental parameters for the current run of RECYCLE. Multiple SET parameters can be coded in a comma separated list spanning multiple lines or with multiple SET statements.
SET MODE(SIMulate|LIVE|SYNTAX),
LINECOUNT(nn),
CART3480(nnnnnnnn),
CART3490(nnnnnnnn),
CART3590(nnnnnnnnnn),
DEBUG,
UNITRETENTION,
MOUNTTIMEOUT(nnn)
[TAPECONSOLIDATIONRATIO(n)]
The following gives details about each line of the syntax:
(Optional)
Default value: LIVE
SIMULATE runs RECYCLE in a test mode to do the following actions:
Specifying LIVE causes RECYCLE to actually move the Virtual Volumes on the selected Backstore tapes and update the corresponding control and catalog information.
Note: LIVE is the default.
Specifying SYNTAX instructs RECYCLE to perform a syntax check of the remaining control card commands.
(Optional)
Default value: 60
The LINECOUNT(nn) parameter determines the number of lines per page printed on output reports. The default value is 60 if LINECOUNT is not specified.
(Optional)
Default value: 400
The CART3480 parameter specifies the estimated megabytes capacity for 3480 tape cartridge devices. Leading zeroes are not required. This parameter is used for the following tasks:
(Optional)
Default value: 800
The CART3490 parameter specifies the estimated megabytes capacity for 3490 tape cartridge devices. Leading zeroes are not required. This parameter is used for the following tasks:
(Optional)
Default value: 10000
The CART3590 parameter specifies the estimated megabytes capacity for 3590 tape cartridge devices. Leading zeroes are not required. This parameter is used for the following tasks:
Note: The output physical tape format during a simulate run is determined by the input Backstore tape type. If the input tapes are 3490s, the output estimates will be for 3490s.
(Optional)
The DEBUG parameter activates logging and sort informational message printing for this execution of RECYCLE. If the CA Vtape logger is not active, no logging will be done. The sort informational messages will be printed to the SYSTSPRT DD.
(Optional)
The UNITRETENTION parameter informs RECYCLE that the same input tape unit should be used for all input physical tapes mounted for all the RECYCLE commands in the job step.
Unit retention remains active for the duration of the RECYCLE job step unless the following occurs:
This parameter allows auto-cartridge loaders of manual tape drives to be preloaded with the input physical tapes documented in the Recycle Volume Pull List Report (SVTRC190.A). This permits unattended operation when executing RECYCLE with the TapeManagementSystem attribute set to NONE to prevent subgroup reassignment or when recycling subgroups individually.
To keep unit retention active for the duration of the job step, use the DEVTYPE parameter to limit physical tape selection to a specific device type or split the Recycle Volume Pull List Report by device type. Executing RECYCLE during periods when recall activity is low will reduce the chance of unit retention being terminated.
Important! Do not define the UNITRETENTION parameter for automated tape libraries because RECYCLE must wait for the input tape to rewind to continue processing the next input tape. Using this option for automated tape libraries will have a negative performance impact on RECYCLE processing.
(Optional)
Default value: 0
The MOUNTTIMEOUT(nnn) parameter, which can be abbreviated as MTO, defines the elapsed time from 0 to 999 minutes that RECYCLE will wait for a Backstore input volume to be mounted. If the volume is not mounted within the time defined by MOUNTTIMEOUT, then RECYCLE cancels the mount request and continues processing subsequent Backstore input mount requests.
Specifying 0 for the MOUNTTIMEOUT value turns off elapsed time monitoring of Backstore input volume mount requests.
Note: To prevent the unnecessary skipping of input volumes, the value set should be high enough to allow for the average time to mount a tape, robotic or manual, plus a reasonable amount of delay time to find an errant tape.
(Optional)
Default value: 0
The Recycle TapeConsolidationRatio or TCR parameter defines a ratio of input Backstore tapes that must be freed for each Primary or Duplex output tape written. The parameter implies an n:1 ratio.
If the ratio defined by the TCR parameter cannot be achieved for a RECYCLE GROUP command, an informational message is issued to the Command Processor Report SVTRC100 and to the JOBLOG. Recycle will skip this RECYCLE command and proceed to the next command.
The TCR parameter can be specified as a SET parameter and as a RECYCLE GROUP parameter. When specified on a SET command, the TCR value is active for all RECYCLE GROUP commands coded in the same job step. When specified on a RECYCLE GROUP command, the TCR value only applies to that command. If specified on a SET command and on a RECYCLE GROUP command in the same job step, the TCR value coded on the RECYCLE GROUP command overrides that of the SET command.
The default value of 0 indicates that TCR is not active.
The projected TCR ratio is based on the values specified for the CART3480, CART3490, and CART3590 parameters. You need to ensure that the values specified are correct for your media otherwise the projected TCR ratios will be skewed. A skewed projected TCR ratio may cause Recycle to skip a group that should have been recycled or recycle a group that should have been skipped.
The values specified should include the average compression that the Backstore tapes normally achieve. If the Backstore tapes are 3590 20 GB cartridges which average 4:1 or 75% compression, then the value specified should be 80 GBs -- CART3590(80000).
Note: Using TapeConsolidationRatio(2) will free a minimum of two input tapes for each output Primary or Duplex tape written.
|
Copyright © 2013 CA Technologies.
All rights reserved.
|
|