Previous Topic: Resource Limit OptionsNext Topic: Shift and Range Options

Command Reference › SCHEDULE Command › Restrictions › Initiation Limits Options

Initiation Limits Options

FOR number

Specifies the number of times that you want to run the request. Requests scheduled with the FOR option must also include an ON, AGAIN, or EVERY option.

TOTIME hh:mm:ss

Specifies the latest time of day at which a request scheduled to repeat with the EVERY option is to initiate.

UNTIL mm/dd/yy

Specifies a date that limits the automatic rescheduling of the request. The request will run up to and including the UNTIL date.

All dates that you specify with the UNTIL option must contain a month and a day. If you omit the year, the default is the current year. The latest date that you can specify is December 31, 2041. CA VM:Schedule interprets the years 00-41 as 2000-2041.

UNTIL options

Runs a request up to, and including a given day, or week of a particular week, month, or quarter. The following table presents the UNTIL options:

Option

Purpose

dayname

Runs the request until the end of the named day ( MON, TUE, WED, THU, FRI, SAT, and SUN). For example, to run a request through the end of the first Monday in November use these UNTIL options:

until f mon nov

WE

Runs the request until the end of the specified weekend day

W

Runs the request until the beginning of the specified week (through Monday). For example, to run a request through the end of Monday of the last week in July, use these UNTIL options:

until l w jul

B

Runs the request until the end of the specified business day

weeknumber

Runs the request until the nnnth week (3-digit weeks) from this week. For example, if on Monday you want to schedule a request to run daily up to and including Tuesday of the following week, use these UNTIL options:

until 1 tue 001

M

Runs the request until the end of the specified day or week of the current month. For example, to run a request through the end of the third week of this month, use these UNTIL options:

until 3 w m

monthname

Runs the request until the end of the specified day or week of the named month (such as JAN or FEB). For example, to run a request through the second weekend day in January, use these UNTIL options:

until 2 we jan

Q

Runs the request until the end of the specified day or week of the current quarter. For example, to run a request through the end of the last business day of this quarter, use these UNTIL options:

until l b q

nQ

Runs the request until the end of the specified day or week of the nth quarter. For example, to run a request through the end of Monday of the last week of the fourth quarter, use these UNTIL options:

until l w 4q