DELAY - IBM Mainframe

The DELAY command generates a processing delay for a task. This command suspends processing of the issuing task until a specified time of day or for a specified time interval. The command when executed will supersede any previously initiated POST command for the task. This option is generally not used when response time is an issue; instead the commands POST and WAIT EVENT are better alternatives. With either the FOR or UNTIL options there are two ways to enter the time function. The first is to use a combination of at least two of the following parameters HOURS, MINUTES, or SECONDS together to build the time delay function. When using this option the MINUTES and SECONDS options range is 0:60. The second way is using only one of the parameters by itself using a different range value listed below. An example would be MINUTES (123), which would be interpreted as 2 hours and 3 minutes. Any omitted parameter (s) will default to zero.

The syntax of the DELAY command is given below:

syntax of the DELAY command

syntax of the DELAY command

The above command will delay the execution of the task 'uniqcode' for 10 hours and 30 minutes. The options of the delay command are given below:

  • FOR - Total time for the delay to occur. HOURS (hh) - A fullword binary value, with the range 0-99.
  • INTERVAL (hhmmss) - Value can be a literal in the form hhmmss where leading zero can be omitted, or the value can be a packed decimal value defined as PIC S9(7) COMP-3. This option defines the interval elapse time. The expiration time is calculated by CICS adding the current clock time to the value specified when the command is executed. The default is INTERVAL(O). Note: The C/370 language does not support this option.
  • MINUTES (mins) - A fullword binary value in the range 0-59 when used in combination with either one of the other options HOURS or SECONDS. When used as a single option excluding the HOURS or SECONDS then the range is 0-5999. An example of this is MINUTES (65) could be interpreted as 1 hour and 5 minutes.
  • REQID (name) - Name is a 1-8 character request identifier associated with the command. (Should be unique) The name is used as a temporary storage identifier. This option can be used when creating another task, which contains the ability of cancelling an unexpired DELAY command.
  • SECONDS (sees) Fullword binary value with a range of 0-59, or 0-359.
  • TIME (hhmmss) - Specifies the time of day until which the task is suspended. The C/370 language does not support this option.
  • UNTIL - Specifies the delay time duration before the task resumes execution.
    Handle Conditions:
  • EXPIRED - The time specified has already expired when the command is issued. The default action is to ignore the condition.
  • INVREQ-Occurs for any of the following reasons:
    1. Command is invalid for processing by CICS
    2. Out of range specification error for hours
    3. Out of range specification error for minutes
    4. Out of range specification error for seconds

All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM Mainframe Topics