Previous Topic

Next Topic

Book Contents

Book Index

FROM DAYS and UNTIL DAYS are entered

The FROM DAYS and UNTIL DAYS subparameters, together with the FROM TIME and TO TIME subparameters, can be used to define a window of opportunity for job submission that will take place on a future date, at a time more than 24 hours in the future.

If the FROM DAYS and UNTIL DAYS subparameters are entered, the job's submission window is calculated as follows:

If either the FROM TIME or UNTIL TIME subparameter is missing, that is, not specified, the New Day Processing time is used as the default for the missing value.

To create a submission window from a particular date and time until the date and time of New Day processing, enter the desired FROM TIME and leave UNTIL TIME blank.

For all examples in this section, assume an ODATE of September 5.

Example

FROM TIME    2200 +  1  DAYS    UNTIL TIME (blank)   +  3  DAYS

creates a submission window from Control-M working date September 6 at 10:00 P.M. until New Day Processing time on Control-M working date September 8th.

To create a submission window from a particular date and time of New Day processing until a particular date and time, enter the desired UNTIL TIME and leave FROM TIME blank.

Example

FROM TIME  (blank) +  1  DAYS    UNTIL TIME 1300  +   3 DAYS

creates a submission window from New Day processing on Control-M working date September 6 until 1:00 P.M. on Control-M working date September 8.

When both a FROM TIME and an UNTIL TIME value are specified, the relationship of the New Day Processing time to these values (on a physical clock) determines the submission window. The logic is as follows:

If, when you move forward on the physical clock from the New Day Processing time, you arrive at the FROM TIME before you arrive at the UNTIL TIME, it means that New Day processing does not fall between the FROM TIME and UNTIL TIME. In this case, the submission window runs from the FROM TIME to the UNTIL TIME, regardless of when the job was ordered.

Example

Assume a New Day Processing time of 8:00 A.M.:

FROM TIME  1400 +  1  DAYS    UNTIL TIME 2200  +  3  DAYS

creates a submission window from 2:00 P.M. on Control-M working date September 6 until 10:00 P.M. on Control-M working date September 8, a period of 56 hours.

Example

Assume a New Day Processing time of 10 P.M.:

FROM TIME  2300 +  1  DAYS    UNTIL TIME 0500  +  3  DAYS

creates a submission window from 11:00 P.M. on Control-M working date September 6 until 5:00 A.M. on Control-M working date September 8, a period of 54 hours.

Example

Assume a New Day Processing time of 10:30 P.M.:

FROM TIME  2300 +  1  DAYS    UNTIL TIME 2200  +  3  DAYS

creates a submission window from 11:00 P.M. on Control-M working date September 6 until 10:00 P.M. on Control-M working date September 8, a period of 47 hours.

If, when you move forward on the physical clock from the New Day Processing time, you arrive at the UNTIL TIME before you arrive at the FROM TIME, it means that New Day processing falls between the FROM TIME and UNTIL TIME.

Batch jobs are frequently scheduled for submission during the night. Therefore, when the New Day Processing time intervenes between the FROM TIME and the UNTIL TIME, it is likely that, following New Day Processing, the site still wants the job to be submitted up until the UNTIL TIME, without first waiting for the FROM TIME of the new day. For this reason, if the New Day Processing time comes between the FROM TIME and the UNTIL TIME, then regardless of when the job was ordered, the job is eligible for submission from both:

Example

Assume New Day Processing time of 4:00 A.M.:

FROM TIME  2300 +  1  DAYS    UNTIL TIME 0600  +  3  DAYS

creates a submission window from 11:00 P.M. on Control-M working date September 6 until 4:00 A.M. on Control-M working date September 8, and from 4:00 A.M. on Control-M working date September 8 until 6:00 A.M. on Control-M working date September 8, giving a net submission window from 11:00 P.M. on Control-M working date September 6 until 6:00 A.M. on Control-M working date September 8.

The character > in the UNTIL TIME subparameter indicates that Control-M must attempt to submit the job at the FROM TIME if specified, and if this is not possible, Control-M must submit the job as soon afterwards as possible, even at a later date (unless the MAXWAIT period has expired).

On Control-M screens 2 and 3, if the UNTIL TIME is >, the UNTIL DAYS subparameter can not be entered.

Example

Assume a New Day Processing time of 8:00 A.M.:

FROM TIME  2200 +  1  DAYS    UNTIL TIME >    +    DAYS

creates a submission window that begins at 10:00 P.M. on Control-M working date September 6.   If the job has not been submitted by the end of the day, it can be submitted at any time from the beginning of the following day.

The FROM parameter is ignored when a job is rerun or restarted on a subsequent day.

Specifying the same time and day in both the FROM TIME/DAYS subparameters and the UNTIL TIME/DAYS subparameters has the same impact as entering no value in both fields.

Example

Submit the job after midnight:

Figure 326 TIME + DAYS Parameter Example

JOB: OPGENBKP LIB CTM.PROD.SCHEDULE TABLE: BACKUP

COMMAND ===> SCROLL===> CRSR

+----------------------------------------------------------------------------+

SCHENV SYSTEM ID NJE NODE

SET VAR

CTB STEP AT NAME TYPE

DOCMEM OPGENBKP DOCLIB CTM.PROD.DOC

===========================================================================

DAYS DCAL

AND/OR

WDAYS WCAL

MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y

DATES

CONFCAL SHIFT RETRO Y MAXWAIT 00 D-CAT

MINIMUM PDS

DEFINITION ACTIVE FROM UNTIL

===========================================================================

IN

CONTROL

RESOURCE

PIPE

FROM TIME 0000      +  1  DAYS    UNTIL TIME      +     DAYS

DUE OUT TIME        +     DAYS    PRIORITY   SAC   CONFIRM            

In this example, if New Day Processing time is 6:00 A.M., this job can only be submitted between the hours of midnight and 6:00 A.M. on Control-M working date September 6.

Parent Topic

TIME + DAYS: Runtime Scheduling Parameter