|
|
|
|
|
Sets time limits for submitting the job.
Additional information |
Description |
|---|---|
Usage |
Optional |
Format |
If not left blank, the From and To sub-parameters must contain valid times expressed in 24‑hour format (HH:MM). By default, valid times are from 00:00 through 23:59. However, if Time Synonym (in File/Options>Job Properties) is checked, valid times are from New Day time until New Day Time plus 23:59. For example, if New Day time is 8:00 A.M., the range of valid times is from 08:00 until 31:59. Alternatively, if From contains a valid time value, To can contain the > character. For more information, see below. The From value can be specified without a To value. The opposite is also true. |
Variable Name |
None |
Alternate names |
Control‑M/EM Utilities:
Control-M Report:
Control‑M/Server Utilities:
Control‑M for z/OS:
Control‑M/EM API:
|
Sub-parameters |
|
Time |
HH:MM For z/OS jobs, includes the day |
Any time on next day |
Optional sub-parameter, valid only for Control-M for z/OS that enables you to set a range of days after the original scheduling date of the job during which the job can be submitted. From + num days defines the beginning of the range and Until + num days defines the end of the range, where the variable num is a number of days after the Odate (original scheduling date) of the job. Valid values for num are any number from 1 through 120. |
End of day |
Optional sub-parameter that enables you to set the job to be submitted by the end of day. |
Allow submission past next new day |
Optional sub-parameter that enables you to set the job to be submitted after its original scheduling date. |
EXAMPLE: Submit the job between 9 A.M. and 6 P.M.
Time From 09:00 + days Until 18:00 + days
Submit the job at any time after 6 P.M.
Time From 18:00 + days Until > + days
In this example, the job can be submitted at any time after 6 P.M. on the day of submission. If the job has not yet been submitted when the New Day time at the site arrives, it is submitted as soon as possible, even at a later date, until the period set by the Keep Active for parameter expires.
The New Day time at the site is 6:00 A.M. Submit the job after the New Day time, but no later than 7:30 A.M.
Time From + days Until 07:30 + days
In this example, the job can only be submitted between 6:00 A.M. and 7:30 A.M. If the job is still on the Active Jobs database on the following day, it will again be submitted between 6:00 A.M. and 7:30 A.M. on that day.
The New Day time at the site is 6:00 A.M. Submit the job at any time between midnight and the New Day time.
Time From 00:00 + days Until + days
In this example, the job can only be submitted between midnight and 6:00 A.M.
The New Day time at the site is 1:00 A.M. Submit the job at any time between 11:00 P.M. and 6:00 A.M.
Time From 23:00 + days Until 06:00 + days
In this example, the job is eligible for submission between 11:00 P.M. and 1:00 A.M., and between 1:00 A.M. and 6:00 A.M.
The New Day time at the site is 1:00 A.M. and the Odate is September 6. Submit the job at any time between 11:00 P.M. on September 9, and 6:00 A.M. on the sixth day after the Odate of the job
Time From 23:00 + 003 days Until 06:00 + 006 days
The New Day time at the site is 1:00 A.M. Submit the job at any time between 11:00 P.M. on the third day after the Odate of the job, and the New Day time on the sixth day after the Odate of the job
Time From 23:00 + 003 days Until + 006 days
In this example, the job is eligible for submission between 11:00 P.M. on the third day after the Odate of the job and 1:00 A.M. on the sixth day after the Odate of the job.
The New Day time at the site is 1:00 A.M. Submit the job at any time between 11:00 P.M. on the third day after the Odate of the job, and 1:00 A.M. on the sixth day after the Odate of the job
Time From + 003 days Until 06:00 + 006 days
In this example, the job is eligible for submission between 1:00 A.M. on the third day after the Odate of the job and 6:00 A.M. on the sixth day after the Odate of the job.
The New Day time at the site is 1:00 A.M. Submit the job at any time between 1:00 A.M. on the third day after the Odate of the job, and 1:00 A.M. on the sixth day after the Odate of the job
Time From + 003 days Until + 006 days
In this example, the job is eligible for submission at any time between 1:00 A.M. on the third day after the Odate of the job and 1 A.M. at the end of the sixth working day after the Odate of the job.
The New Day time at the site is 8:00 A.M., and the Time synonym option in File/Options>Job Properties is checked. Submit the job at any time from one hour after the start of the New Day until one hour before the next New Day.
Time From 09:00 + days Until 31:00 + days
In this example, the job is eligible for submission between 9:00 A.M. until 7:00 A.M. the next morning. Because the Time Synonym option is checked, 7:00 A.M. the next morning is indicated as the sum of (24:00 + 7:00) = 31:00.
Parent Topic |