The STARTTIME (Start Time) command assigns a starting date and time to jobs in a queue.

Syntax

 ─<mix number list>─STARTTIME── = ─┬─<time>─┬────────────┬─────┤
                                   │        ├─TODAY──────┤
                                   │        ├─TOMRROW────┤
                                   │        └─ON─<date>──┤
                                   └─<date>──AT──<time>──┘

<date>

 ─┬─<mm>──/──<dd>──/──┬─<yy>───┬─────┬───┤
  │                   └─<yyyy>─┘     │
  ├─TODAY────────────────────────────┤
  ├─TOMRROW──────────────────────────┤
  └─<day of week>─┬──────────────────┤
                  └─<month and year>─┘

<month and year>

        ┌◄─────────── , ──────────┐   
─┬─────┬┴┬─ /1*\ ─<day of month>─┬┴┬─────┬─┬─<yy>───┬────┤
 └─ , ─┘ └─ /1*\ ─<month>────────┘ └─ , ─┘ └─<yyyy>─┘
     

<day of week>

  ├─SUNDAY──────┬──────────────────────┤
  ├─MONDAY──────┤
  ├─TUESDAY─────┤
  ├─WEDNESDAY───┤
  ├─THURSDAY────┤
  ├─FRIDAY──────┤
  └─SATURDAY────┘  

<day of month>

An integer from 1 through 31.

<month>

  ├─JANUARY─────┬──────────────────────┤
  ├─FEBRUARY────┤
  ├─MARCH───────┤
  ├─APRIL───────┤
  ├─MAY─────────┤
  ├─JUNE────────┤
  ├─JULY────────┤
  ├─AUGUST──────┤
  ├─SEPTEMBER───┤
  ├─OCTOBER─────┤
  ├─NOVEMBER────┤
  └─DECEMBER────┘  

Explanation

<time>

Sets the start time of the jobs in the mix number list to the specified time on the current date. 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.

<time> TODAY

<time> TOMORROW

<time> ON <date>

<date> AT <time>

Sets the start time of the jobs in the mix number list to the given time and date. If the date includes only the day of the week, the next occurrence of that day is used (for example, if today is Thursday 1st, specifying Friday sets the start time to Friday 2nd and specifying Thursday sets it to Thursday 8th).

The date construct must be input in the Gregorian format: mm/dd/yy or mm/dd/yyyy.

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.

Examples

7132 STARTTIME = 21:12 ON 3/22/2009

7132 STARTTIME = 21:12 ON SUNDAY, 22 MARCH, 2009

7132 STARTTIME = 10:00 ON SATURDAY

7132 STARTTIME = 10:00 TOMORROW

Considerations for Use

This command can be used whether or not the job already has a start time associated with it. If the job reaches the front of the queue and its specified start time is later than the current time, it stays at the head of the queue but is not started. The CONTROLLER selects the first job in the queue whose start time is earlier than or the same as the current time or that has no start time. That job is the next job to be run from the queue. The changes made by this command to a job in a queue are retained over a halt/load of the system.

Jobs that are given start times do not have any special status in the queuing mechanism. They are subject to the same controls, such as mix limits, as other jobs in the queues. If the JOBDESC file is removed, all queued jobs, including those with start times, are also removed.

The start time of a job, if any, is displayed in response to the SQ (Show Queue) command.