Previous Topic: GETRPT CommandNext Topic: IMPORT Command


HOLD Command

Authorization: OPERATOR

To interrupt or temporarily halt the execution of a specified job, use the HOLD command. You can place a job on hold at any time before or during processing except when a job is compiling. Jobs placed on hold with the HOLD command are left in the job queue with a status of on hold. (Use the QUERY REQUESTS command to view the status of a job.)

If you put a job on hold before it begins processing, CA VM:Backup starts the job from the beginning when you release it. If you put a job on hold during processing, the point at which CA VM:Backup restarts the job depends on the type of job and other conditions. The following list indicates how CA VM:Backup handles interrupted jobs when you release them.

AUTOCAT job

Last completed catalog

Backup, restore, MPC, or REINIT job, restart recovery not enabled

Beginning

Backup job, restart recovery enabled

Last completed domain on last completed tape for each tape stream

Restore job, restart recovery enabled

Last completed domain; restarts restores of incompletely restored domains from beginning of domain

MPC job, restart recovery enabled

Last domain from input tape that was successfully copied to output tapes

REINIT job, restart recovery enabled

Last reinitialized tape

There are two special cases for backup jobs:

When restarted, all jobs appear as though they were never interrupted, with one exception. If CA VM:Backup restarts a backup, restore, or MPC job using restart recovery, file-level detail information for domains processed before the point where the job restarted is missing from all reports except the keyword data report.

Note: For more information about the restart recovery process, see Restart Recovery. For more information about releasing held jobs, see RELEASE Command.

This command has the following format:

Hold jobid

Definitions

jobid

Specifies the job identification number, assigned by CA VM:Backup when the job is submitted, of the job to put on hold. You do not have to specify the leading zeros. To view a job ID, use the QUERY REQUESTS command.

Examples

To place backup job 00000024 on hold, enter:

vmbackup hold 24