Using the IWMRQRY Service

The IWMRQRY service provides sampled data on address spaces including:

• Address space state samples
• Server information

  To see when an address space is serving more than one service class, information is provided for server address spaces in the general execution delay portion of the IWMWRCAA. This information includes:

  • The service classes being served by an address space.
  • The number of samples of address spaces serving a particular service class. For example, address space ACSFOR1 is seen serving service class CICSSLOW 60 times, and service class CICSFAST 40 times.

The data returned is mapped by the IWMWRQAA data area. It represents the data collected during one sampling interval, an instantaneous, non-cumulative snapshot of the address space. The data is not tied to a particular job. Products using IWMRQRY must decide whether to accumulate this latest state data with prior samples.

An asynchronous ENF signal is issued whenever a new copy of IWMWRQAA information is available. The performance monitor can use the ENF signal to determine when to issue IWMRQRY.

Table 20 shows a sample sequence of what to do to get address space information using IWMRQRY.