The DELAY command This command lets you suspend the issuing task until the time interval has expired, or a specific time of day has arrived...
This command lets you suspend the issuing task until the time interval has expired, or a specific time of day has arrived.
EXEC CICS DELAY
{
INTERVAL(hhmmss)
TIME(hhmmss)
FOR [HOURS(hh)] [MINUTES(mm)] [SECONDS(ss)]
UNTIL [HOURS(hh)] [MINUTES(mm)] [SECONDS(ss)]
}
[ REQID(name) ]
END-EXECOptions:
INTERVAL Specifies the duration for the delay. You can code a literal in the form hhmmss. If you specify a data area it must be a PIC S9(7) COMP-3 field and the value must be in the form 0hhmmss.
TIME Specifies a time of the day when the delay will end. You can code a literal in the form hhmmss. If you specify a data area it must be a PIC S9(7) COMP-3 field and the value must be in the form 0hhmmss.
FOR Specifies in HOURS, MINUTES and SECONDS the delay.
UNTIL Specifies in HOURS, MINUTES and SECONDS the time of the day when the delay will end.
HOURS, Each is a PIC S9(8) COMP full word. Hours can be from 0-99
MINUTES, minutes can be from 0 to 59 or 0 to 5999
SECONDS. Seconds can be from 0 to 59 or 0 to 359999
If INTERVAL, TIME, FOR and UNTIL are omitted, INTERVAL(0) is assumed.
REQID Specifies a one to eight character name used to uniquely identify this delay command.
Conditions:
EXPIRED The TIME or UNTIL option has already expired. The default action is to return control immediately to your program.
INVREQ The command is not valid or the hours, minutes or seconds are out of range. Default action is to terminate the task.
Notes:
- One good use of the DELAY command is to retry operations that have failed due to transient conditions. Such operations are worth a retry after a suitable delay. This delay, or momentary suspension of task execution can be achieved by the DELAY command. One trivial use is to momentarily suspend a transaction that is notorious for consuming resources. This makes for better sharing of resources across transactions.
No comments
Post a Comment