DSSR gate, WAIT_OLDW function
The WAIT_OLDW function of DSSR gate causes a task to wait on an ECB, or list of ECBs, that can be posted via the MVS™ POST service or by setting the POST bit (X'40' in the first byte). This function is supported only in QR mode.
Input Parameters
- ECB_ADDRESS
- The address of the ECB for the task.
- ECB_LIST_ADDRESS
- The address of a list of ECBs for the task.
- PURGEABLE
- The purgeable status of the task.
- Values for the parameter are as follows:
- NO
- YES
- DEADLOCK_ACTION
- Optional Parameter
- Describes whether the suspended task should be purged if deadlock is detected, and if so, how it should be purged.
- DELAY
- Optional Parameter
- An interval (in units as specified by TIME_UNIT) during which the task is not dispatched if CICS® has other work to do.
- DISPATCH_BEFORE_WAIT
- Optional Parameter
- Indicates whether the suspended task is prepared to wait across a partition exit.
- Values for the parameter are as follows:
- NO
- YES
- INTERVAL
- Optional Parameter
- An interval (in units as specified by TIME_UNIT) after which the task is given back control if it has not been resumed by a DSSR RESUME call.
- RESOURCE_NAME
- Optional Parameter
- The name of the resource that the task is suspended on.
- RESOURCE_TYPE
- Optional Parameter
- The type of resource that the task is suspended on.
- RETRY
- Optional Parameter
- Indicates whether the dispatcher is to retry the suspend operation, if the running task is not suspended by a preceding suspend operation.
- Values for the parameter are as follows:
- NO
- YES
- SPECIAL_TYPE
- Optional Parameter
- Identifies the special task CSTP.
- Values for the parameter are as follows:
- CSTP
- TEMP_HIGH_PRIORITY
- Optional Parameter
- Indicates whether the task is to get a temporary priority boost at the completion of the suspend.
- Values for the parameter are as follows:
- NO
- YES
- TIME_UNIT
- Optional Parameter
- Identifies the time units specified on the INTERVAL and DELAY parameters where present.
- Values for the parameter are as follows:
- MILLI_SECOND
- SECOND
- WLM_WAIT_TYPE
- Optional Parameter
- Indicates the reason for the wait state of the task to the z/OS® Workload Manager.
- Values for the parameter are as follows:
- CMDRESP
- CONV
- DISTRIB
- IDLE
- IO
- LOCK
- MISC
- OTHER_PRODUCT
- SESS_LOCALMVS
- SESS_NETWORK
- SESS_SYSPLEX
- TIMER
Output Parameters
- REASON
- The following values are returned when RESPONSE is INVALID:
- ALREADY_WAITING
- INVALID_ECB_ADDR
- INVALID_MODE
- The following values are returned when RESPONSE is PURGED:
- TASK_CANCELLED
- TIMED_OUT
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.