CANCEL Command

The CANCEL command cancels any further initiations of a single request, or cancels all requests for a specified user ID.

CANcel {requestname | *} [([User userid] [Password password]]

Definitions

requestname: Specifies the name of the request you want to cancel. Once a request is canceled, you can use that request name again for a new request. Use an asterisk to cancel all requests for the specified user ID. To specify all request names that match the characters preceding the asterisk, use a trailing asterisk in the request name as a wildcard character.
USER userid: Specifies the user ID of the virtual machine whose requests are being canceled. If you do not specify the USER option, the default is your user ID.
PASSWORD password: Specifies the CP logon password of the virtual machine whose requests are being canceled. If the CANCEL command is invoked through the CP SMSG command, the password must be explicitly specified on the command line. Some sites do not allow users to specify a logon password directly on the CA VM:Schedule command line. If your site has this limitation, the server prompts you to enter the password after you issue the command.

Description

The CANCEL command cancels any further initiations of a single request or all requests for a specified user ID. The record of each canceled request remains in the request database for the number of days specified by your site. To find out how long canceled requests remain in the database, use the CONFIG command. Request database purging occurs at midnight or the next time the server starts.

If you run the CANCEL command on a request and later you decide to retain the request, remove the CANCEL flag from the request. To retain a request, remove the CANCEL flag before the system purges the request from the request database.

To remove the CANCEL flag from a request, do one of the following actions:

Execute the CHANGE command against the request. Make an arbitrary change to the request.
Change the request through the CA VM:Schedule screens.

Example

To cancel all further initiations of your request PROD, enter the following command:

vmsched cancel prod

Example

To cancel all requests that belong to LYDIA, enter the following command:

vmsched can * (user lydia