IWM4MRLT macro — Relate monitoring environments (PBs)

The calling subsystem work manager can use IWM4MRLT to relate two different monitoring environments that are associated with the same work request. IWM4MRLT 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 IWM4MRLT when you do not have direct access to the information required by IWM4MINI. If the caller has the monitoring for a parent environment that is previously established for the same work request, you provide it in the PARENTMONTKN / PARENTMONTKN64 parameter. If the caller does not pass the monitoring token, you can use PARENTP=FINDACTIVE to specify that the parent monitoring environment is the active monitoring environment owned by the address space and which is associated with the TCB provided via PARENTTCB.

IWM4MRLT must be used together with IWM4MXFR 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 can use the token/data to keep your own information.