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 |