CANCEL Command

Use the CANCEL command to delete restore requests that CA VM:Backup has not yet started processing.

When you use the CANCEL command, you bypass all user screens.

You can only cancel requests that have not started processing. If the status of a restore request is either Waiting or On hold, you can cancel the request. To view the status of a job, use the QUERY REQUESTS command.

The command has the following syntax:

CANcel {ALL | jobid}

Definitions

ALL: Cancels all of your pending restore requests.
jobid: Specifies the job identification number, assigned by CA VM:Backup when the job is submitted, of a single job to cancel. You do not have to specify the leading zeros. To view a job's jobid, use the QUERY REQUESTS command.

Examples

Cancel command examples.

To cancel a pending restore request (jobid 00000012) you no longer want CA VM:Backup to process, enter:
```
vmbackup cancel 12
```
CA VM:Backup responds with the following message:
```
RESTORE REQUEST 00000012 HAS BEEN CANCELED.
```
```
vmbackup cancel all
```

To cancel all requests that CA VM:Backup has not yet started, enter:

vmbackup cancel all

CA VM:Backup responds with these messages:

RESTORE REQUEST 00000002 HAS BEEN CANCELED. RESTORE REQUEST 00000003 HAS BEEN CANCELED. ALL YOUR OUTSTANDING REQUESTS HAVE BEEN CANCELED.