Previous Topic: TRANSFER CommandNext Topic: Output Destinations

Command Reference › WHEN Command

WHEN Command

The WHEN command lets you list the times that a request runs. If you specify no options, the server displays up to 999 scheduled initiations for today.

When requestname [( "Options"]



Options:

["Selection options"]
["Output options"] 
["Miscellaneous options"]



Selection options:

[FRom mm/dd/yy]
[NExt number]
[UNtil mm/dd/yy]

Output options:

[File filename] [PRint] [STack {FIFO │ LIFO}] [Term]



Miscellaneous options:

[Password password]
[SOrt]
[User userid]

Definitions

requestname

Specifies the name of a request for which you want to list the run times. Use an asterisk to display all request names, or a trailing asterisk to list requests with similar names.

FROM mm/dd/yy

Specifies the date from which you want to list the run times for the request. The default is the current date.

NEXT number

Specifies how many initiations to list. The default is 999. The number of requests displayed is limited by the date range you specify. See Controlling the Number of Runs Displayed for more information about using this option.

UNTIL mm/dd/yy

Specifies the last date for which requests are to be displayed. If FROM is specified without UNTIL, the UNTIL date defaults to the FROM date.

FILE filename

Writes the output of the WHEN command to the file filename VMSCHED A1. If you do not specify the FILE option, the output is displayed on your terminal.

PRINT

Sends the output from the WHEN command to your virtual printer. If the PRINT option is not specified, the output displays on your terminal.

STACK { FIFO | LIFO }

Specifies that output is to be stacked first in, first out (FIFO), or last in, first out (LIFO) in your program stack.

TERM

Displays the output on your terminal. TERM is the default if no other output option is specified.

USER userid

Specifies the user ID whose requests’ run times are to be listed. The default is the user ID that issued the WHEN command. If you specify another user ID, the CP logon password must be specified unless you have NOPASS authorization.

PASSWORD password

Specifies the CP logon password for the user ID whose requests are being queried. The password must be specified when you are listing run times for another user ID’s requests. Your CA VM:Schedule system administrator can specify that users are not allowed to enter the password in the option string; instead, you are required to use the prompting procedure for password entry. You do not have to supply your password when listing times for requests you scheduled on your own user ID.

SORT

Sorts the list of scheduled requests by date and time. This option is useful when using pattern matching to display multiple request names. By default, repeat initiations within a given request name are already shown in order of date and time.

Description

The WHEN command lists the times that a request runs. If you specify no options, CA VM:Schedule displays up to 999 scheduled initiations for today.

Examples