Parameters

The parameters are explained as follows:

name

An optional symbol, starting in column 1, that is the name on the IWMMCHST macro invocation. The name must conform to the rules for an ordinary assembler language symbol.

,COMPCODE=YES

,COMPCODE=NO

An optional parameter, which indicates whether completion status for this service is needed. The default is COMPCODE=YES.

,COMPCODE=YES

indicates that completion status is needed.

,COMPCODE=NO

indicates that completion status is not needed. Registers 0, 15 cannot be used as reason code and return code registers upon completion of the macro expansion. For this reason neither RETCODE NOR RSNCODE may be specified when COMPCODE(NO) is specified.

,MONTKN=montkn

A required input parameter, which contains the delay monitoring token

To code: Specify the RS-type address, or address in register (2)-(12), of a 32-bit field.

,RESOURCE=LATCH

,RESOURCE=LOCK

,RESOURCE=IO

,RESOURCE=CONV

,RESOURCE=DISTRIB

,RESOURCE=SESS_LOCALMVS

,RESOURCE=SESS_NETWORK

,RESOURCE=SESS_SYSPLEX

,RESOURCE=TIMER

,RESOURCE=OTHER_PRODUCT

,RESOURCE=MISC

,RESOURCE=SSL_THREAD

,RESOURCE=REG_THREAD

,RESOURCE=REG_TO_WRKTB

,RESOURCE=TYPE1

,RESOURCE=TYPE2

,RESOURCE=TYPE3

,RESOURCE=TYPE4

,RESOURCE=TYPE5

When STATE=WAITING is specified, a required parameter, which indicates the resource that the work manager is waiting for on behalf of the work request described by the monitoring environment.

,RESOURCE=LATCH

indicates that the work manager is waiting on a latch.

,RESOURCE=LOCK

indicates that the work manager is waiting on a lock.

,RESOURCE=IO

indicates that the work manager is waiting on an activity related to an I/O request. This may either be an actual I/O operation or some function associated with an IO request that cannot be more precisely determined by the work manager, for example, locks, buffers, etc.

,RESOURCE=CONV

indicates that the work manager is waiting on a conversation. This may be used in conjunction with IWMMSWCH to identify where the target is located.

,RESOURCE=DISTRIB

indicates that the work manager is waiting on a distributed request. This says at a high level that some function or data must be routed prior to resumption of the work request. This is to be contrasted with Waiting on Conversation, which is a low level view of the precise resource that is needed. A distributed request could involve waiting on a conversation as part of its processing.

,RESOURCE=SESS_LOCALMVS

indicates that the work manager is waiting to establish a session somewhere in the current MVS™ image.

,RESOURCE=SESS_NETWORK

indicates that the work manager is waiting to establish a session somewhere in the network.

,RESOURCE=SESS_SYSPLEX

indicates that the work manager is waiting to establish a session somewhere in the sysplex.

,RESOURCE=TIMER

indicates that the work request is waiting on a timer.

,RESOURCE=OTHER_PRODUCT

indicates that the work manager is waiting on another product to complete its function.

,RESOURCE=MISC

indicates that the work manager is waiting on some unidentified resource, possibly among the previous categories.

,RESOURCE=SSL_THREAD

indicates that the work manager is waiting on an SSL thread.

,RESOURCE=REG_THREAD

indicates that the work manager is waiting on a regular processing thread.

,RESOURCE=REG_TO_WRKTB

indicates that the work manager is waiting for the registration to a worktable.

,RESOURCE=TYPE1

indicates that the work manager is waiting for resource type 1.

,RESOURCE=TYPE2

indicates that the work manager is waiting for resource type 2.

,RESOURCE=TYPE3

indicates that the work manager is waiting for resource type 3.

,RESOURCE=TYPE4

indicates that the work manager is waiting for resource type 4.

,RESOURCE=TYPE5

indicates that the work manager is waiting for resource type 5.

,RESTKN=restkn

,RESTKN=NORESTKN

An optional input parameter, which contains the token of the managed resource previously registered with register resource (IWMMREG). The default is NORESTKN, which indicates that no resource token is provided.

NORESTKN preserves the existing resource token, if any.

To code: Specify the RS-type address, or address in register (2)-(12), of an 8-character field.

,RETCODE=retcode

An optional output parameter into which the return code is to be copied from GPR 15.

To code: Specify the RS-type address of a fullword field, or register (2)-(12).

,RSNCODE=rsncode

An optional output parameter into which the reason code is to be copied from GPR 0.

To code: Specify the RS-type address of a fullword field, or register (2)-(12).

,RUNTIME_VER=SHORT_FORM

,RUNTIME_VER=MINIMAL

An optional parameter, which indicates what level of runtime verification will be performed. The default is RUNTIME_VER=SHORT_FORM.

,RUNTIME_VER=SHORT_FORM

indicates that checking should verify that a monitoring environment is established and passes a short form of verification prior to being used.

,RUNTIME_VER=MINIMAL

indicates that checking will only be done to verify that a monitoring environment may be established, assuming that it would be valid and useable if established.

STATE=FREE

STATE=ACTIVE

STATE=ACTIVE_APPL

STATE=READY

STATE=IDLE

STATE=WAITING

A required parameter, which indicates the current state for the work request.

STATE=FREE

indicates that the work manager has no work request associated with the monitoring environment.

STATE=ACTIVE

indicates that there is a program executing on behalf of the work request described by the monitoring environment. This is an indication from the perspective of the work manager using this service, who should not try to factor in MVS decisions in preempting work, etc.

STATE=ACTIVE_APPL

indicates that there is an application program executing on behalf of the work request described by the monitoring environment. This is an indication from the perspective of the work manager using this service, who should not try to factor in MVS decisions in preempting work. This state represents the application activity in contrast to the active (subsystem) state.

STATE=READY

indicates that there is a program ready to execute on behalf of the work request described by the monitoring environment, but the work manager has given priority to another work request.

STATE=IDLE

indicates that the work manager has no work requests that it is allowed to service within the monitoring environment. This represents a delay that is not under the control of the work manager itself and which it cannot eliminate. This may be caused by limits imposed by the installation or by the nature of the work request itself.

STATE=WAITING

indicates that the work manager is waiting for a resource on behalf of the work request described by the the monitoring environment.