DSSR gate, SUSPEND function

The SUSPEND function of DSSR gate causes a running task to be suspended.

Input Parameters

PURGEABLE
The purgeable status of the task.
Values for the parameter are as follows:
  • NO
  • YES
SUSPEND_TOKEN
The suspend token to be deleted.
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 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
ASSOCIATION_TOKEN
Optional parameters
The association token
ASSOCIATION_TYPE
Optional parameters
The association type. either NONE, WAIT or ASSOC

Output Parameters

REASON
The following values are returned when RESPONSE is INVALID:
  • ALREADY_SUSPENDED
  • CLEAN_UP_PENDING
  • INVALID_SUSPEND_TOKEN
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.
COMPLETION_CODE
Optional Parameter
is a completion code supplied by the resumed task.


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