Previous Topic: Record SyntaxNext Topic: CMSAUDIT Record (CMS TMCs Only)


Parameter Descriptions

The following provides a description of each parameter:

reject-actions

Specifies the actions CA VM:Tape takes when the reject threshold, as specified by the ATTEMPTS parameter, is exceeded. After performing the reject action, CA VM:Tape resets the reject count to zero. You must specify at least one of the following reject actions, but you can specify as many as four. If you specify NONE, you cannot specify any other reject actions.

AUDIT nnn

Specifies that a type 3 audit Record with a condition code (AUREJ field) value of nnn is to be written to the Audit file when the volume reject count has exceeded the reject threshold. If this is the only action specified, the volume continues to be available for scratch use.

DELETE

Specifies that the volume is to be marked as deleted when the volume reject count has exceeded the reject threshold. The volume is unavailable for scratch use until the delete bit (DELETED) in the TMC is set to OFF.

EDIT field value

Inserts the specified value in the site-defined EDITDEF field when the volume reject count has exceeded the reject threshold. The volume is unavailable for scratch use until the field value is changed.

NONE

Specifies that no action is to be taken when the volume reject count has exceeded the reject threshold. The volume continues to be available for scratch use.

OUTCODE code

Inserts the specified code into the volume's OUTCODE field in the TMC. The volume is unavailable for scratch use until the OUTCODE field is cleared.

[ ACCEPT ]

Specifies that a scratch volume other than the requested volume can be mounted to satisfy the scratch mount request. The volume mounted must be from the same scratch pool as the volume originally requested. Mounting a different volume still causes the reject count for the requested volume to be updated. If you do not specify the ACCEPT parameter, the mount must be satisfied with the requested volume.

Note: CA VM:Tape lets you control Autopick facility processing at the scratch pool level. Use of that feature is recommended over use of the ACCEPT parameter. Refer to AUTOPICK Record for information on controlling Autopick processing.

[ ATTEMPTS [nnn] ]

Specifies the reject threshold. The reject threshold is the number of times a volume must be rejected before the specified reject actions are performed. The default is 3. There is no maximum.

[ CANCEL ]

Specifies that if no scratch volumes are available to satisfy a mount request, the request is canceled. If you do not specify the CANCEL parameter, the request will wait indefinitely until you manually cancel the request or you supply a scratch volume.

[ EXTRA ]

Specifies that CA VM:Tape is to reserve an extra tape drive for CA VM:Backup jobs. Specify this parameter when both of the following conditions are true:

CA VM:Tape uses the extra drive to mount the next tape for a CA VM:Backup job so that CA VM:Backup can read its label and write the information in the trailer of the current tape. If you do not specify the EXTRA parameter, the job will not be able to continue until an additional drive becomes available.

Do not specify the EXTRA parameter if the CA VM:Backup RESERVE configuration file Record is set ON and CA VM:Backup pools are using the Autopick facility. When Autopick is enabled an extra drive is unnecessary because CA VM:Tape picks the next tape for a CA VM:Backup job and provides CA VM:Backup with the label information. If you specify the EXTRA parameter the extra drive will remain idle while the job processes.

If CA VM:Backup is not configured to reserve drives (the CA VM:Backup RESERVE Record is set OFF), CA VM:Tape ignores the EXTRA parameter.