Previous Topic: Command SyntaxNext Topic: Standard Output


Parameter Descriptions

The following provides a description of each parameter:

[ grace ]

For cycle-controlled tapes, specifies the number of days to wait before scratching eligible tapes. By default, there is no grace period; CA VM:Tape scratches tapes as soon as they become eligible.

[ DIsk [ filemode ] ]

Specifies that CA VM:Tape is to store copies of the TMC volume records for tapes that are eligible to be scratched in a file before scratching the tapes. The file is called SCRATCH LIST. You may want to create this file so you can run a Generalized Report Writer (GRW) report against it.

By default, CA VM:Tape creates the SCRATCH LIST file on the minidisk accessed at filemode A1; you can specify another filemode. If the SCRATCH LIST file already exists on the minidisk, CA VM:Tape appends the records to the existing file.

Note: Do not use the DISK option if you are running the SCRATCH command from the CA VM:Tape service virtual machine. If you do, CA VM:Tape scratches the tapes but does not create the SCRATCH LIST file, and the SCRATCH command does not complete.

For more information about creating a GRW report, see Administration Guide.

[ PRint | NOPrint ]

Specifies whether CA VM:Tape is to create a file that lists the tapes that have been scratched and send it to the printer at the completion of the SCRATCH command. The file is called SCRATCH REPORT. If you specify PRINT, CA VM:Tape creates the file. If you specify NOPRINT, CA VM:Tape does not create the file.

Important! If you run the SCRATCH command with the PRINT option from the CA VM:Tape service virtual machine, the scratch listing is included in the CA VM:Tape print log, making the listing extremely difficult to use.