How IBM Z Performance and Capacity Analytics processes CMF data

The data sections of the following CMF records consist of records of identical format that relate to one of these monitoring classes:
  • Dictionary data (class 1)
  • Accounting data (class 2) for CICS/MVS only
  • Performance data (class 3)
  • Exception data (class 4)

Dictionary data describes fields in CMF-generated performance data sections. CICS writes a new dictionary record whenever performance monitoring is activated. The DRL2CICS record procedure updates the CICS_DICTIONARY table with any new dictionary records. As it processes a CMF record, IBM Z Performance and Capacity Analytics loads into memory SMF log dictionary records and any dictionary records stored in CICS_DICTIONARY.

IBM Z Performance and Capacity Analytics uses the most recently generated dictionary section (that matches the MVS system ID, CICS system ID, and class values) to resolve field values in each performance record. As shown in Figure 1, DRL2CICS creates a common transaction performance record (SMF_CICS_T) from the CICS transaction performance records.

Figure 1. How CMF performance records are processed

The log collector uses the DRL2CICS record procedure to map field values for data in accounting, performance, and exception records to intermediate records mapped by these record definitions:

SMF_CICS_A
Maps accounting records that IBM Z Performance and Capacity Analytics generates from CICS/MVS accounting records
SMF_CICS_T
Maps transaction performance records that IBM Z Performance and Capacity Analytics generates from CICS/MVS, CICS/ESA, and CICS/TS performance records
SMF_CICS_E2
Maps exception records that IBM Z Performance and Capacity Analytics generates from CICS/MVS exception records

The CICS/ESA or CICS/TS exception data section is a single, fixed-length record, mapped by the SMF_110_E record definition. Update definitions store exception data in the IBM Z Performance and Capacity Analytics common table EXCEPTION_T, but some rows in this table are also created from exceptional conditions in CICS/ESA and CICS/TS statistics records.

IBM Z Performance and Capacity Analytics stores data in Db2 columns that correspond to most fields found in CICS performance data. If you need to add fields to CMF performance records, remember to update the IBM Z Performance and Capacity Analytics CICS_FIELD control table with your fields, and add fields in the SMF_CICS_T record definition with the offset and length that you specify in CICS_FIELD. The CICS_FIELD table is loaded using the SQL statements in the DRLxxx.SDRLDEFS (DRLTCIFI) member. Use this member as a template for additional entries. The SMF_CICS_T record definition is in the DRLxxx.SDRLDEFS (DRLRS110) member. For more information about SMF records and data fields that CMF produces for CICS refer to the CICS/ESA Customization Guide or the CICS/MVS Customization Guide.

The log collector uses the DRL4CICS record procedure to map field values for data in transaction resource monitoring records (class 5). The output record to map these fields is SMF_CICS_TR.

Figure 2. How CICS/TS transaction resource records are processed by the CICS Performance feature