The time at which a time-controlled function is to be started is known as the expiration time. You can specify expiration times absolutely, as a time of day (using the TIME option), or as an interval that is to elapse before the function is to be performed (using the INTERVAL option). For DELAY commands, you can use the FOR and UNTIL options; and for POST and START commands, you can use the AFTER and AT options. See the CICS® Application Programming Reference manual for programming information about these commands.
You use an interval to tell CICS when to start a transaction in a specified number of hours, minutes, and seconds from the current time. A nonzero INTERVAL value always indicates a time in the future--the current time plus the interval you specify. The hours may be 0-99, but the minutes and seconds must not be greater than 59. For example, to start a task in 40 hours and 10 minutes, you would code:
EXEC CICS START INTERVAL(401000)
You can use an absolute time to tell CICS to start a transaction at a specific time, again using hhmmss. For example, to start a transaction at 3:30 in the afternoon, you would code:
EXEC CICS START TIME(153000)
An absolute time is always relative to the midnight before the current time and may therefore be earlier than the current time. TIME may be in the future or the past relative to the time at which the command is executed. CICS uses the following rules:
EXEC CICS START TIME(123000)
This command, issued at 05:00 or 07:00 on Monday, expires at 12:30 on the same day.
EXEC CICS START TIME(020000)
This command, issued at 05:00 or 07:00 on Monday expires immediately because the specified time is within the preceding six hours.
EXEC CICS START TIME(003000)
This command, issued at 05:00 on Monday, expires immediately because the specified time is within the preceding six hours. However, if it is issued at 07:00 on Monday, it expires at 00:30 on Tuesday, because the specified time is not within the preceding six hours.
EXEC CICS START TIME(230000)
This command, issued at 02:00 on Monday, expires immediately because the specified time is within the preceding six hours.
If you do not specify an expiration time or interval option on DELAY, POST, or START commands, CICS responds using the default of INTERVAL(0), which means immediately.
Because each end of an intersystem link may be in a different time zone, you should use the INTERVAL form of expiration time when the transaction to be started is in a remote system.
If the system fails, the times associated with unexpired START commands are remembered across the restart.