SKIP Command

The SKIP command lets you skip one or more subsequent initiations of a request.

SKip requestname [number] [([User userid][Password password]]

Definitions

requestname

Specifies the name of the request that you want to skip.

number

Specifies the number of initiations that you want to skip.

Default: 1

USER userid

Specifies the user ID of the virtual machine whose request you want to skip. This parameter is required to skip initiations of requests that are scheduled to execute on a user ID other than your own.

PASSWORD password

Specifies the CP logon password for the virtual machine whose request you want to skip. Your CA VM:Schedule system administrator can specify that users cannot enter the password in the options string, but instead must be prompted for passwords. If you use prompting, you cannot use CP SMSG to issue the command.

Description

The SKIP command skips one or more subsequent initiations of a request. The SKIP command is not valid for requests that are scheduled for only a single initiation. Use the DELAY or CANCEL commands to avoid the initiation of these requests.

You cannot use the SKIP command to skip the initiation of requests scheduled with the RELEASE option.

You can determine the next scheduled execution date and time with the QUERY command. The QUERY command displays the next actual initiation time after accounting for the skipped initiations.

If either of these conditions occur, the server cancels a request automatically:

The number of initiations skipped causes the scheduled date to exceed the maximum rescheduling date you specified with the SCHEDULE command UNTIL option.
The number of initiations skipped exceeds the remaining initiation limit that you specified with the SCHEDULE command FOR option.

Example

To skip the next two initiations of request PROD01, enter the following command:

vmsched skip prod01 2