SMF header and SMF product section
The SMF header describes the system creating the output. The SMF product section identifies the subsystem to which the monitoring data relates, which, in the case of CICS® monitoring (and also of CICS statistics), is the CICS region.
Both the SMF header and the SMF product section can be
mapped by the DSECT MNSMFDS, which you can generate using the DFHMNSMF
macro as follows:
MNSMFDS DFHMNSMF PREFIX=SMF
The
label ‘MNSMFDS' is the default DSECT name, and SMF is the default
PREFIX value, so you could also generate the DSECT by coding: DFHMNSMF
The
MNSMFDS DSECT has the format shown in Figure 1. Figure 1. Format
of the SMF header and product section for monitoring records
* START OF THE SMF HEADER
*
MNSMFDS DSECT
SMFMNLEN DS XL2 RECORD LENGTH
SMFMNSEG DS XL2 SEGMENT DESCRIPTOR
SMFMNFLG DS X OPERATING SYSTEM INDICATOR (see note 1)
SMFMNRTY DC X'6E' RECORD 110 FOR CICS
SMFMNTME DS XL4 TIME RECORD MOVED TO SMF
SMFMNDTE DS XL4 DATE RECORD MOVED TO SMF
SMFMNSID DS CL4 SYSTEM IDENTIFICATION
SMFMNSSI DS CL4 SUBSYSTEM IDENTIFICATION
SMFMNSTY DS XL2 RECORD SUBTYPE - MONITORING USES TYPE 1
SMFMNTRN DS XL2 NUMBER OF TRIPLETS
DS XL2 RESERVED
SMFMNAPS DS XL4 OFFSET TO PRODUCT SECTION
SMFMNLPS DS XL2 LENGTH OF PRODUCT SECTION
SMFMNNPS DS XL2 NUMBER OF PRODUCT SECTIONS
SMFMNASS DS XL4 OFFSET TO DATA SECTION
SMFMNASL DS XL2 LENGTH OF DATA SECTION
SMFMNASN DS XL2 NUMBER OF DATA SECTIONS
*
* THIS CONCLUDES THE SMF HEADER
*
*
* START OF THE SMF PRODUCT SECTION
*
SMFMNRVN DS XL2 RECORD VERSION (CICS)
SMFMNPRN DS CL8 PRODUCT NAME (GENERIC APPLID)
SMFMNSPN DS CL8 PRODUCT NAME (SPECIFIC APPLID)
SMFMNMFL DS XL2 RECORD MAINTENANCE INDICATOR
DS XL2 RESERVED
SMFMNCL DS XL2 CLASS OF DATA
* 1 = DICTIONARY
* 3 = PERFORMANCE
* 4 = EXCEPTION
* 5 = TRANSACTION RESOURCE
* 6 = IDENTITY
SMFMNDCA DS XL4 OFFSET TO CICS FIELD CONNECTORS
SMFMNDCL DS XL2 LENGTH OF EACH CICS FIELD CONNECTOR
SMFMNDCN DS XL2 NUMBER OF CICS FIELD CONNECTORS
SMFMNDRA DS XL4 OFFSET TO FIRST CICS DATA RECORD
SMFMNDRL DS XL2 LENGTH OF EACH CICS DATA RECORD
SMFMNDRN DS XL2 NUMBER OF CICS DATA RECORDS
*
DS XL18 RESERVED
SMFMNCRL DS XL2 COMPRESSED RECORD LENGTH (see note 7)
SMFMNTAD DS XL4 LOCAL TOD CLOCK ADJUSTMENT VALUE
SMFMNLSO DS XL8 LEAP SECOND OFFSET TOD FORMAT
SMFMNDTO DS XL8 LOCAL TIME/DATE OFFSET
DS XL1 RESERVED
SMFMNOPN DS XL1 MONITORING OPTIONSSMFMNJBN DS CL8 JOBNAME
SMFMNRSD DS XL4 JOB DATE
SMFMSRST DS XL4 JOB TIME
SMFMNUIF DS CL8 USER IDENTIFICATION
SMFMNPDN DS CL8 OPERATING SYSTEM PRODUCT LEVEL
*
* THIS CONCLUDES THE SMF PRODUCT SECTION
Note:
- CICS sets only the subsystem-related bits of the operating system indicator flag byte in the SMF header (SMFMNFLG). SMF sets the remainder of the byte according to the operating system level and other factors.
- Fields SMFMNDCA SMFMNDCL, and SMFMNDCN apply to performance class records only.
- For dictionary class monitoring records, see Dictionary data sections, the fields SMFMNDRA, SMFMNDRL,
and SMFMNDRN in the SMF product section have the following meaning:
- SMFMNDRA
- Offset to the first dictionary entry.
- SMFMNDRL
- Length of a single dictionary entry.
- SMFMNDRN
- Number of dictionary entries within the CICS data section.
- For performance class and exception class monitoring records,
the fields SMFMNDRA, SMFMNDRL, and SMFMNDRN, in the SMF product section
have the following meaning:
- SMFMNDRA
- Offset to the first performance or exception class record.
- SMFMNDRL
- Length of each performance or exception class record.
- SMFMNDRN
- Number of performance class records in the data section, but for exception class records this value is always 1.
- For transaction resource monitoring records, the fields SMFMNDRA,
SMFMNDRL, and SMFMNDRN, in the SMF product section have the following
meaning:
- SMFMNDRA
- Offset to the first transaction resource monitoring record.
- SMFMNDRL
- This value is always zero because the transaction resource records in the data section are variable length. The length of each record is in the halfword field MNR_LENGTH at the start of each record.
- SMFMNDRN
- Number of transaction resource monitoring records in the data section.
- The copy book DFHSMFDS is also provided and can be used to map the SMF header and the SMF product sections of all six subtypes of SMF 110 records written by CICS journaling, CICS monitoring, CICS statistics, the TS data sharing server, the coupling facility data table (CFDT) server, and the named counter sequence number server.
- The SMFMNCRL field indicates whether the CICS data section in this monitoring SMF 110 record contains compressed data. A zero value in this field indicates that the CICS data section in the record does not contain compressed data. A non-zero value in this field indicates that the CICS data section in the record does contain compressed data, and that the z/OS Data Compression and Expansion Services must be used to expand the data section before processing. For more information on data compression, see Data compression for monitoring records.