Previous Topic: Batch JobsNext Topic: CICS SMF User Exit


Processing the CICS SMF Records - APCCJSMF

The CICS SMF feature needs SMF Type 110 records with subtype 1 (CICS Monitoring). From these records, Class of Data = 1 (Dictionary) is used for verifying the existence and locating the offset of the relevant data. Class of Data = 3 (Performance) records contain one or more transaction-specific data according to the layout found in the dictionary record. These types of records must be activated and written to SMF data sets.

Starting with the CICS SMF feature for a specific CICS system is only possible after the startup of the region. Performance Management Assistant stores a dictionary information record containing the timestamp and processes only those transaction performance records after the stored timestamp.

Every time Performance Management Assistant recognizes a new dictionary record for a specific CICS system, the information about the relevant fields is compared to the stored information. If there are no changes, the new dictionary record is ignored. When there are changes in the dictionary, Performance Management Assistant stores a new dictionary information record containing the new timestamp. All records after the timestamp are processed with the new layout, where older ones are processed with the layout for this specific time period. This assures the correct functionality even when SMF data sets are not processed in the correct time sequence.

The CICS SMF features uses the following fields from the Monitor Control Table:

Performance Group

Informal Name

Description

DFHTASK

TRAN

Name of the transaction

DFHTASK

TTYPE

Start type of the transaction

DFHCICS

START

Time that the user task was attached

DFHCICS

STOP

Time that the user task was detached

DFHDATA

IMSREQCT

Number of IMS (DBCTL) requests that were issued by the user task

DFHDATA

DB2REQCT

Number of DB2® (EXEC SQL and IFI) requests that were issued by the user task

DFHTASK

USRDISPT

Total elapsed time that the user task was dispatched

DFHTASK

USRCPUT

Processor time that the user task was dispatched

DFHTASK

SUSPTIME

Total elapsed time that the user task was suspended by the dispatcher

DFHCICS

USERID

User identification at task creation

It is recommended that all of these fields are included on every CICS system that is used for the CICS SMF feature. If they are not present, the corresponding fields are either initialized or the record is ignored (if there is no information for transaction name and/or start time).