IWMMEXTR – Monitor Environment Extract

The purpose of this service is to extract information about the monitoring environment which was previously passed through IWM4MINI/IWMMRELA. When IWMMRELA was invoked for a management monitoring environment, owner token, owner data and abnormal conditions are always available. Arrival time, user ID 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 IWMMRELA, 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 only be specified, if a work unit has been started by IWMMSTRT.

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