IWMMRELA – Relate Monitoring Environment Service

The calling subsystem work manager can use IWMMRELA to relate two different monitoring environments that are associated with the same work request. IWMMRELA initializes a monitoring environment, called a dependent monitoring environment, and associates it with a previously established monitoring environment, called a parent monitoring environment.

You can use IWMMRELA when you do not have direct access to the information required by IWM4MINI. If the caller has the monitoring token for a parent monitoring environment that is previously established for the same work request, you should provide it in the PARENTMONTKN parameter. If the caller does not pass the parent monitoring token, you can use PARENTP=FINDACTIVE to specify that the parent monitoring environment is the active monitoring environment owned by the home address space and which is associated with the TCB provided via PARENTTCB.

IWMMRELA must be used together with IWMMXFER to ensure that the dependent monitoring environment is a valid representation for the work request.

Optionally, with this macro, you can use the OWNER_TOKEN and OWNER_DATA parameters to use the monitoring environment for your own purposes. You could use the token/data to keep your own information.