z/OS Workload Interaction Correlator

The IBM® z/OS® Workload Interaction Correlator is a priced feature that provides the collection of workload data for IMS systems and other participating z/OS components and middleware to diagnose performance issues across the z/OS stack. It generates System Management Facilities (SMF) type 98 records and graphical representations for further analysis. With this feature, you can get a summary view of activities of the IMS workload.

With IMS support for IBM z/OS Workload Interaction Correlator, IMS becomes a participating application. For every normally complete transaction, Message Processing Program (MPP) regions and Java™ message processing (JMP) regions record both elapsed time and CPU time in a standard form and in an IBM System z® Integrated Information Processor (zIIP form). z/OS System Management Facility (SMF) then logs type 98 records with subtype 1025 to record these statistics. z/OS Workload Interaction Navigator can be used to generate graphical displays of the data.

A new macro DFSSR98A contains layouts of the IMS-specific portion of the type 98 subtype 1025 SMF record. The macro can be used by z/OS Workload Interaction Navigator to generate graphical reports. DFSSR98A is classified as diagnosis, modification, and tuning information (DMTI).

To enable IMS to write IBM z/OS Workload Interaction Correlator SMF 98 subtype 1025 records, you must specify the parameter WIC in the z/OS SMFPRMxx parmlib member, and request SMF 98.1025 records to be written.

To prevent IMS from writing IBM z/OS Workload Interaction Correlator SMF 98 subtype 1025 records while writing other SMF 98 subtypes, you must exclude SMF 98.1025 records from being written in your SMFPRMxx parmlib member. For example, you might specify:

TYPE(98(1:1024,1026:2000))

in SMFPRMxx to have SMF write all SMF 98 subtypes 1 - 2000 except for type 1025.

You can dynamically enable and disable IMS writing function of SMF 98.1025 records by using the SET SMF command to change between SMF parmlib members with different options. This can be used to change the collection state of the SMF 98.1025 record while IMS is up.

To learn more about how to enable and disable IMS to write IBM z/OS Workload Interaction Correlator, see IBM Documentation for z/OS.

IMS registers with IBM z/OS Workload Interaction Correlator in the control region initialization. If IBM z/OS Workload Interaction Correlator is not active when IMS starts, that instance of IMS will not write SMF 98 subtype 1025 records, even if IBM z/OS Workload Interaction Correlator is started later. To have IMS write SMF 98 subtype 1025 records, ensure that IBM z/OS Workload Interaction Correlator is active when IMS is started.