IWMRCOLL – Collecting Workload Activity Data

With the IWMRCOLL macro, a performance monitor can get the following workload activity information:

• Resource consumption information
• Response time and distribution information
• General delay information
• Subsystem work manager delay state information

For a detailed description, refer to Using the Workload Reporting Services.

To help the caller keep track of changes in workload management, this service returns a token, ANSTOKN. ANSTOKN is a required input on all subsequent calls to IWMRCOLL. When a change occurs in workload management, for example, when a new policy is activated, IWMRCOLL returns a new token value. The caller’s code should check the reason codes to see if the ANSTOKN has changed since the last call to IWMRCOLL. If the token has changed, the performance monitor should reset its reporting interval. If the token has not changed, the performance monitor can continue with its existing reporting interval.

There are also some ENF event codes to keep track of changes in workload management. For information about the ENF codes, see z/OS MVS Programming: Authorized Assembler Services Reference EDT-IXG.

The caller must provide a storage area in the ANSAREA=ansarea and the length of that area in the ANSLEN=anslen for IWMRCOLL to place the workload activity information. This area may reside in either address space related storage or dataspace storage. IWMRCOLL returns the information, which is mapped by IWMWRCAA.

You must also specify the MINLEN and MAXLEN parameters. IWMRCOLL fills in the minimum and maximum amount of storage required for the answer area.

The caller should issue the IWMPQRY macro for active service policy information to map the workload activity information.

If the caller does not provide enough storage to contain all of the workload activity data, no data is returned. IWMRCOLL returns the minimum length of the storage required in the ANSLEN field, and issues the appropriate return and reason code.