IWM4MREG – Register a Resource For Monitoring

The IWM4MREG service registers a resource for delay monitoring. The service allows the caller to identify a resource which may be involved in delays to work requests. The caller's home address space is assumed to be the owner of the resource to be monitored. The system may decide to increase or decrease the size of the resource to balance the associated delays.

The resource to be monitored may require the caller to provide one or more exits to interact with the system. These exits are called in the same system key and non-cross memory environment as the program which registers the resource. The exit always receives control in AMODE31, regardless of the mode in which IWM4MREG was invoked.

The system implicitly deregisters a resource due to repetitive errors in calling exits associated with the resource. In this case, the invocation to deregister finds that the associated resource token is invalid and returns with a warning return code.

The system also cleans up its resources associated with the registration when the address space which owns the resource goes through address space termination. Therefore, no deregistration is required or honored for this case.