── STARTTIME ── = ──<starttime spec>───────────────────────────────────┤
<starttime spec>
──┬─<time>───────────────┬─┬────────────────────────────┬──────────────┤ │─ + ──<time interval>─┘ ├─ TODAY ────────────────────┤ │ ├─ TOMORROW ─────────────────┤ │ └─ ON ─┬─<date>──────────────┤ │ └─ + ──<day interval>─│ ├─<date>───────────────┬─ AT ─┬─<time>────────────────┤ └─ + ───<day interval>─┘ └─ + ──<time interval>──┘
┌◄────────────┐ ┌◄─────────────┐ ──┴─/2\─<digit>─┴─ : ─┴─/2*\─<digit>─┴─────────────────────────────────┤
──┬─<mm>── / ──<dd>── / ─┬─<yy>───────────┬────────────────────────────┤ │ └─<yyyy>─────────┤ ├─ <yyddd> ─────────────────────────────┤ ├─ <yyyyddd> ───────────────────────────┤ ├─ TODAY ───────────────────────────────┤ ├─ TOMORROW ────────────────────────────┤ └─<day of week>─┬───────────────────────┤ └─<month, day and year>─┘
<day of week>
──┬─ SUNDAY ────┬──────────────────────────────────────────────────────┤ ├─ MONDAY ────┤ ├─ TUESDAY ───┤ ├─ WEDNESDAY ─┤ ├─ THURSDAY ──┤ ├─ FRIDAY ────┤ └─ SATURDAY ──┘
<mm>
<dd>
┌◄─────────────────┐ ──┴─ /2\ ── <digit> ─┴─────────────────────────────────────────────────┤
┌◄──────────────────┐ ──┴─ /2*\ ── <digit> ─┴─────────────────────────────────────────────────┤
┌◄──────────────────┐ ──┴─ /4*\ ── <digit> ─┴────────────────────────────────────────────────┤
<yyddd>
┌◄──────────────────┐ ──┴─ /5*\ ── <digit> ─┴────────────────────────────────────────────────┤
<yyyyddd>
┌◄──────────────────┐ ──┴─ /7*\ ── <digit> ─┴────────────────────────────────────────────────┤
<month, day and year>
┌◄────────────────────────┐ ──┬─────┬─┴─┬─/1*\─<day of month>─┬─┴──────────────────────────────────► └─ , ─┘ └─/1*\─<month>────────┘ ►─┬─────┬─┬─<yy>───┬───────────────────────────────────────────────────┤ └─ , ─┘ └─<yyyy>─┘
<month>
──┬─ JANUARY ───┬──────────────────────────────────────────────────────┤ ├─ FEBRUARY ──┤ ├─ MARCH ─────┤ ├─ APRIL ─────┤ ├─ MAY ───────┤ ├─ JUNE ──────┤ ├─ JULY ──────┤ ├─ AUGUST ────┤ ├─ SEPTEMBER ─┤ ├─ OCTOBER ───┤ ├─ NOVEMBER ──┤ └─ DECEMBER ──┘
Explanation
The STARTTIME specification delays job initiation until the specified start time.
The time construct specifies the time of day on a 24-hour clock. The time and time interval constructs are of the form HH: MM, where HH specifies the hour (or number of hours) and MM specifies the minute (or number of minutes). HH must be less than 24, and MM must be less than 60. The minute values must be 2-digit numbers. If a time interval is specified, that time interval is added to the current time.
The day, hour, and month values can either be a 1-digit or a 2-digit number.
The date construct can be input either in the Gregorian format: mm/dd/yy or mm/dd/yyyy, or the Julian format: yyddd or yyyyddd. If a 5-digit Julian date is used as the STARTTIME value, the first two digits signify the year and the last three digits signify the day of the year. If a 7-digit Julian date is used, the first four digits signify the year (including the century) and the last three digits signify the day of the year. For example, if you input either 19293 or 2019293, they will both equal day 293 of 2019.
-
A two-digit year is interpreted as a year between 65 years ago and 34 years in the future. However, a year prior to 1970 is invalid.
-
For the STARTTIME specification, years prior to 2000 are invalid.
If a day interval is specified, that number of days is added to the current date.
If the time is specified without a date or day interval, the current date is used.
If TODAY is specified, the current date is used.
If TOMORROW is specified, one day is added to the current date.
If a day of the week is specified, then enough days are added to the current date to start the job on the next day of the week that was specified.
If a day of the week and a month, day, and year are specified then the system verifies that the specified date falls on the specified day of week and that date is used.
The FS (Force Schedule) system command can be used to cause job initiation to proceed immediately, without waiting for the specified start time. For a description of the FS command, refer to the System Commands Reference.
Examples
The following job begins execution after 10:00 p.m. on March 20, 1990:
?BEGIN JOB EXAMPLE1; STARTTIME = 22:00 ON 03/20/90; . . . ?END JOB.
The following job begins execution a minimum of 1 hour and 30 minutes after entering the system:
?BEGIN JOB EXAMPLE2; STARTTIME = +1:30; . . . ?END JOB.
The following job is executed on host BLUE and begins execution after 11:00 a.m. according to the system clock on host BLUE:
?AT BLUE BEGIN JOB; STARTTIME = 11:00; . . . ?END JOB.
If the current day is Saturday, then the following job begins after 1:00 a.m. 7 days later than the current date. Otherwise, the job begins after 1:00 a.m. on the next date that falls on a Saturday.
?BEGIN JOB EXAMPLE1; STARTTIME = 1:00 ON SATURDAY; . . . ?END JOB.
The following job begins execution after 2:00 p.m. on November 24, 2008.
?BEGIN JOB EXAMPLE1; STARTTIME = 14:00 ON MONDAY, NOVEMBER 24, 2008; . . . ?END JOB.