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:
  1. 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.
  2. Fields SMFMNDCA SMFMNDCL, and SMFMNDCN apply to performance class records only.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.


dfht3_smf_hdr_prod.html | Timestamp icon Last updated: Sunday, 4 June 2017