IMS support for IBM z/OS Workload Interaction Correlator

Previously, diagnosing IMS performance issues could be challenging because analysis of IMS and other z/OS components and middleware was performed in silo. . In addition, analysis of the correlation between IMS and other participating z/OS components required specialized skills and manual work.

To address the issues, IMS support for IBM z/OS Workload Interaction Correlator is introduced. IBM z/OS Workload Interaction Correlator gathers statistical data from participating applications, and generates synchronized, standardized, summarized data across z/OS and middleware stack. IMS data is collected as part of the unified workload insights, which enable system administrators to reduce downtime without additional subject matter experts or specialized mainframe skills. For each workload, the performance data is captured at 5-second intervals, and exceptional jobs and activities are recorded so that you can identify abnormal jobs.

This enhancement is delivered with APAR/PTF PH15062/UI. With PH15062, IMS becomes a participating application.

IMS registers with IBM z/OS Workload Interaction Correlator during initialization and delivers statistical data to it through a z/OS System Management Facility (SMF) exit. 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.

IBM z/OS Workload Interaction Correlator generates SMF type 98 records with subtype 1025 to record these statistics. A new macro DFSSR98A maps the SMF type 98 subtype 1025 records.

DFSSR98A is also used by the z/OS Workload Interaction Navigator in the generation of graphical reports.

Hardware requirements

For the IMS support of IBM z/OS Workload Interaction Correlator added by APAR PH15062 to be effective, IMS must be running on a z14 (machine type 3906) processor, or a higher z/OS processor. IMS with APAR PH15062 may still run on a lower version processor. However, message DFS7431I will be issued and no statistics will be saved.

Software requirements

IMS must be running on a z/OS 2.3 or above operating system that has z/OS APAR OA57165 installed. IMS with PH15062 might still run on an earlier release of z/OS or on a z/OS system that does not have APAR OA57165 installed. However, DFS7431I will be issued and no statistics will be saved.

Changes to troubleshooting for IMS

For a complete list of all of the new, changed, and deleted messages, and abend codes in IMS 15, see Message and code changes in IMS 15.

Documentation changes

The following table lists the publications that contain new or changed topics for the New function name enhancement. Publications that are not impacted by this enhancement are not included in the table.