DSSR gate, WAIT_MVS function

The WAIT_MVS function of DSSR gate causes a task to wait on an ECB, or list of ECBs, to be posted via the MVS™ POST service.

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
BATCH
Optional Parameter
States whether requests are to be batched.
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
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 wait state of the task to the z/OS® Workload Manager (WLM).
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
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.


dfhs3_DSSRwait_mvs.html | Timestamp icon Last updated: Monday, 5 June 2017