IWM4MXTR macro — Monitor environment extract service

The purpose of this service is to extract information about the monitoring environment which was previously passed through IWM4MINI/IWM4MRLT. When IWM4MRLT was invoked for a management monitoring environment, owner token, owner data and abnormal conditions are always available. Arrival time, userid, and transaction name are only available when IWM4MINI was previously invoked. Arrival time, however is only available for management monitoring environments.

When the service class token is requested for a management monitoring environment, the value may represent a token from a prior active policy. Furthermore, when the monitoring environment was established via IWM4MRLT, the token may be zero, which does not represent a valid service class or report class. IWMWQRY may be used to obtain the service and/or report class name, along with other information about these classes. The SERVCLS keyword is not applicable for report-only monitoring environments. The returned token is zero, which does not represent a valid service class.

The ENCLAVE_TOKEN and ASID keywords are only applicable for report-only monitoring environments.

The EWLM_S_CURCORR keyword should be specified only, if a work unit has been started by IWM4MSTR.

When no output keywords are specified, the service merely checks whether a monitoring environment was established and passes short form checking.