CICS monitoring record formats

This section describes the formats of CICS® monitoring SMF type 110 records in detail. You need this information if you write your own program to analyze the monitoring data. CICS writes several types of SMF 110 record. Each type, or subtype as it is known, can be identified using the record subtype field in the SMF header. The subtype values are as follows:

For more information about SMF journaling records, refer to CICS logging and journaling. For more information about SMF statistics records, refer to Writing statistics collection and analysis programs.

The three components of a CICS monitoring record are an SMF header, an SMF product section, and a CICS data section. Each of these is described in the sections that follow.

Figure 91. Format of an SMF type 110 monitoring record
 The picture shows a rectangle representing an SMF type 110 monitoring record. It is split into three parts: an SMF header, an SMF product section, and a CICS data section.

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 simply by coding:

DFHMNSMF

The MNSMFDS DSECT has the format shown in Figure 92.

Figure 92. 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
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    XL20          RESERVED
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 OPTIONS
SMFMNJBN 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
Notes:
  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. For an explanation of the setting of the other bits, refer to the z/OS MVS System Management Facilities (SMF) manual.
  2. Fields SMFMNDCA SMFMNDCL, and SMFMNDCN apply to performance class records only.
  3. For dictionary class monitoring records (described in 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 four 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.

CICS data section

The CICS data section can be made up of a dictionary data section, a performance data section, or an exception data section. You can identify which of these you are dealing with by looking at the value of field SMFMNCL in the SMF product section. Each of the data section types is described in the following sections.

Dictionary data sections

Dictionary data sections describe all the fields in the performance data records that are gathered during this CICS run. They describe all the system-provided data fields (whether you have excluded any or not), plus any user-provided data fields, which CICS takes at initialization time from the MCT entries you have coded. This means that the descriptions of the system-provided data fields never change, though the user data fields can be changed each time CICS is initialized. The contents of the dictionary data sections cannot be changed while CICS is running.

Dictionary data sections contain a variable number of 26-byte dictionary entries. Each dictionary entry provides the following information about a single performance record data field:

CMODNAME
The identifier of the group to which the field belongs
CMODTYPE
The field type
CMODIDNT
The field identifier
CMODLENG
The length of the field
CMODCONN
The connector value assigned to the field
CMODOFST
The offset of the field
CMODHEAD
The informal name of the field.

You can map the dictionary entries by generating a DSECT with the DFHMCTDR macro as shown in Figure 93.

Figure 93. CICS monitoring dictionary entry DSECT
DFHMCTDR TYPE=(PREFIX,CMO)
CMO is the default label prefix.  The DSECT is as follows:

CMODNAME DS    CL8     + 0    NAME OF OWNER (entry name)
CMODTYPE DS    C       + 8    OBJECT TYPE
*                           'S' = STOPWATCH (CLOCK)
*                           'A' = ACCUMULATOR (COUNT)
*                           'C' = BYTE-STRING FIELD
*                           'T' = TIMESTAMP (STCK FORMAT)
*                           'P' = PACKED-DECIMAL FIELD
CMODIDNT DS    CL3     +9     ID WITHIN TYPE
*                             CLOCK-, COUNT-, OR FIELD-NO.
CMODLENG DS    H       +12    LENGTH OF OBJECT
CMODCONN DS    XL2     +14    ASSIGNED CONNECTOR
CMODOFST DS    XL2     +16    ASSIGNED OFFSET
CMODHEAD DS    CL8     +18    INFORMAL NAME
CMODNEXT EQU   *

Whenever the monitoring of performance class data is switched on, whether at CICS initialization or while CICS is running, a dictionary data section is written. So, if the monitoring of performance class data is switched on and off three times during a single CICS run, there are three separate, but identical, dictionary data sections for that run. The dictionary data section is passed to SMF, together with any performance data sections, when the first buffer of performance data sections for a performance class data monitoring session is output to SMF. Any offline utility should use the most recent dictionary record encountered when processing CICS monitoring records.

The format of dictionary data sections is shown in Figure 94. A list of the default CICS dictionary entries is given in Figure 95.

Figure 94. Format of the CICS monitoring dictionary data section
 The picture shows three rectangles, one above the other. The top rectangle represents an SMF type 110 monitoring record. It consists of three sections: an SMF header, an SMF product section, and a dictionary data section. The middle rectangle is an expansion of the dictionary data section in the top rectangle. It consists of a number of dictionary entries, numbered 1 to n. The bottom rectangle is an expansion of one of the dictionary entries in the middle rectangle. It consists of the following fields:   Field owner Field type Field identifier Field length Field connector Field offset Field title

Start of changeFigure 95. Default CICS dictionary entries
FIELD-NAME    SIZE  CONNECTOR OFFSET    NICKNAME
DFHTASK C001     4  X'0001'   X'0000'   TRAN
DFHTERM C002     4  X'0002'   X'0004'   TERM
DFHCICS C089     8  X'0003'   X'0008'   USERID
DFHTASK C004     4  X'0004'   X'0010'   TTYPE
DFHCICS T005     8  X'0005'   X'0014'   START
DFHCICS T006     8  X'0006'   X'001C'   STOP
DFHTASK P031     4  X'0007'   X'0024'   TRANNUM
DFHTASK A109     4  X'0008'   X'0028'   TRANPRI
DFHTASK C166     8  X'0009'   X'002C'   TCLSNAME
DFHTERM C111     8  X'000A'   X'0034'   LUNAME
DFHPROG C071     8  X'000B'   X'003C'   PGMNAME
DFHTASK C097    20  X'000C'   X'0044'   NETUOWPX
DFHTASK C098     8  X'000D'   X'0058'   NETUOWSX
DFHCICS C130     4  X'000E'   X'0060'   RSYSID
DFHCICS A131     4  X'000F'   X'0064'   PERRECNT
DFHTASK T132     8  X'0010'   X'0068'   RMUOWID
DFHCICS C167     8  X'0011'   X'0070'   SRVCLSNM
DFHCICS C168     8  X'0012'   X'0078'   RPTCLSNM
DFHTASK C163     4  X'0013'   X'0080'   FCTYNAME
DFHTASK A164     8  X'0014'   X'0084'   TRANFLAG
DFHTERM A165     4  X'0015'   X'008C'   TERMINFO
DFHTERM C169     4  X'0016'   X'0090'   TERMCNNM
DFHTASK C124     4  X'0017'   X'0094'   BRDGTRAN
DFHTASK C190    16  X'0018'   X'0098'   RRMSURID
DFHCBTS C200    36  X'0019'   X'00A8'   PRCSNAME
DFHCBTS C201     8  X'001A'   X'00CC'   PRCSTYPE
DFHCBTS C202    52  X'001B'   X'00D4'   PRCSID
DFHCBTS C203    52  X'001C'   X'0108'   ACTVTYID
DFHCBTS C204    16  X'001D'   X'013C'   ACTVTYNM
DFHSOCK C244    16  X'001E'   X'014C'   CLIPADDR
DFHTASK C082    28  X'001F'   X'015C'   TRNGRPID
DFHTERM C197     8  X'0020'   X'0178'   NETID
DFHTERM C198     8  X'0021'   X'0180'   RLUNAME
DFHSOCK C245     8  X'0022'   X'0188'   TCPSRVCE
DFHSOCK A246     4  X'0023'   X'0190'   PORTNUM
DFHTASK C194   128  X'0024'   X'0194'   OTSTID
DFHEJBS C311     4  X'0025'   X'0214'   CBSRVRNM
DFHTASK C064     4  X'0026'   X'0218'   TASKFLAG
DFHPROG C113     4  X'0027'   X'021C'   ABCODEO
DFHPROG C114     4  X'0028'   X'0220'   ABCODEC
DFHCICS C112     4  X'0029'   X'0224'   RTYPE
DFHTERM A034     4  X'002A'   X'0228'   TCMSGIN1
DFHTERM A083     4  X'002B'   X'022C'   TCCHRIN1
DFHTERM A035     4  X'002C'   X'0230'   TCMSGOU1
DFHTERM A084     4  X'002D'   X'0234'   TCCHROU1
DFHTERM A067     4  X'002E'   X'0238'   TCMSGIN2
DFHTERM A085     4  X'002F'   X'023C'   TCCHRIN2
DFHTERM A068     4  X'0030'   X'0240'   TCMSGOU2
DFHTERM A086     4  X'0031'   X'0244'   TCCHROU2
DFHTERM A135     4  X'0032'   X'0248'   TCM62IN2
DFHTERM A137     4  X'0033'   X'024C'   TCC62IN2
DFHTERM A136     4  X'0034'   X'0250'   TCM62OU2
DFHTERM A138     4  X'0035'   X'0254'   TCC62OU2
DFHTERM A069     4  X'0036'   X'0258'   TCALLOCT
DFHSTOR A054     4  X'0037'   X'025C'   SCUGETCT
DFHSTOR A105     4  X'0038'   X'0260'   SCUGETCT
DFHSTOR A117     4  X'0039'   X'0264'   SCCGETCT
DFHSTOR A120     4  X'003A'   X'0268'   SCCGETCT
DFHSTOR A033     4  X'003B'   X'026C'   SCUSRHWM
FIELD-NAME    SIZE  CONNECTOR OFFSET    NICKNAME
DFHSTOR A106     4  X'003C'   X'0270'   SCUSRHWM
DFHSTOR A116     4  X'003D'   X'0274'   SC24CHWM
DFHSTOR A119     4  X'003E'   X'0278'   SC31CHWM
DFHSTOR A095     8  X'003F'   X'027C'   SCUSRSTG
DFHSTOR A107     8  X'0040'   X'0284'   SCUSRSTG
DFHSTOR A118     8  X'0041'   X'028C'   SC24COCC
DFHSTOR A121     8  X'0042'   X'0294'   SC31COCC
DFHSTOR A144     4  X'0043'   X'029C'   SC24SGCT
DFHSTOR A145     4  X'0044'   X'02A0'   SC24GSHR
DFHSTOR A146     4  X'0045'   X'02A4'   SC24FSHR
DFHSTOR A147     4  X'0046'   X'02A8'   SC31SGCT
DFHSTOR A148     4  X'0047'   X'02AC'   SC31GSHR
DFHSTOR A149     4  X'0048'   X'02B0'   SC31FSHR
DFHSTOR A087     4  X'0049'   X'02B4'   PCSTGHWM
DFHSTOR A139     4  X'004A'   X'02B8'   PC31AHWM
DFHSTOR A108     4  X'004B'   X'02BC'   PC24BHWM
DFHSTOR A142     4  X'004C'   X'02C0'   PC31CHWM
DFHSTOR A143     4  X'004D'   X'02C4'   PC24CHWM
DFHSTOR A122     4  X'004E'   X'02C8'   PC31RHWM
DFHSTOR A162     4  X'004F'   X'02CC'   PC24RHWM
DFHSTOR A161     4  X'0050'   X'02D0'   PC31SHWM
DFHSTOR A160     4  X'0051'   X'02D4'   PC24SHWM
DFHFILE A036     4  X'0052'   X'02D8'   FCGETCT
DFHFILE A037     4  X'0053'   X'02DC'   FCPUTCT
DFHFILE A038     4  X'0054'   X'02E0'   FCBRWCT
DFHFILE A039     4  X'0055'   X'02E4'   FCADDCT
DFHFILE A040     4  X'0056'   X'02E8'   FCDELCT
DFHFILE A093     4  X'0057'   X'02EC'   FCTOTCT
DFHFILE A070     4  X'0058'   X'02F0'   FCAMCT
DFHDEST A041     4  X'0059'   X'02F4'   TDGETCT
DFHDEST A042     4  X'005A'   X'02F8'   TDPUTCT
DFHDEST A043     4  X'005B'   X'02FC'   TDPURCT
DFHDEST A091     4  X'005C'   X'0300'   TDTOTCT
DFHTEMP A044     4  X'005D'   X'0304'   TSGETCT
DFHTEMP A046     4  X'005E'   X'0308'   TSPUTACT
DFHTEMP A047     4  X'005F'   X'030C'   TSPUTMCT
DFHTEMP A092     4  X'0060'   X'0310'   TSTOTCT
DFHMAPP A050     4  X'0061'   X'0314'   BMSMAPCT
DFHMAPP A051     4  X'0062'   X'0318'   BMSINCT
DFHMAPP A052     4  X'0063'   X'031C'   BMSOUTCT
DFHMAPP A090     4  X'0064'   X'0320'   BMSTOTCT
DFHPROG A055     4  X'0065'   X'0324'   PCLINKCT
DFHPROG A056     4  X'0066'   X'0328'   PCXCTLCT
DFHPROG A057     4  X'0067'   X'032C'   PCLOADCT
DFHPROG A072     4  X'0068'   X'0330'   PCLURMCT
DFHPROG A073     4  X'0069'   X'0334'   PCDPLCT
DFHPROG A286     4  X'006A'   X'0338'   PCDLCSDL
DFHPROG A287     4  X'006B'   X'033C'   PCDLCRDL
DFHPROG A306     4  X'006C'   X'0340'   PCLNKCCT
DFHPROG A307     4  X'006D'   X'0344'   PCXCLCCT
DFHPROG A308     4  X'006E'   X'0348'   PCDPLCCT
DFHPROG A309     4  X'006F'   X'034C'   PCRTNCCT
DFHPROG A310     4  X'0070'   X'0350'   PCRTNCDL
DFHJOUR A058     4  X'0071'   X'0354'   JNLWRTCT
DFHJOUR A172     4  X'0072'   X'0358'   LOGWRTCT
DFHTASK A059     4  X'0073'   X'035C'   ICPUINCT
DFHTASK A066     4  X'0074'   X'0360'   ICTOTCT
DFHTASK A065     4  X'0075'   X'0364'   ICSTACCT
DFHTASK A345     4  X'0076'   X'0368'   ICSTACDL
FIELD-NAME    SIZE  CONNECTOR OFFSET    NICKNAME
DFHTASK A346     4  X'0077'   X'036C'   ICSTRCCT
DFHTASK A347     4  X'0078'   X'0370'   ICSTRCDL
DFHSYNC A060     4  X'0079'   X'0374'   SPSYNCCT
DFHCICS A025     4  X'007A'   X'0378'   CFCAPICT
DFHFEPI A150     4  X'007B'   X'037C'   SZALLOCT
DFHFEPI A151     4  X'007C'   X'0380'   SZRCVCT
DFHFEPI A152     4  X'007D'   X'0384'   SZSENDCT
DFHFEPI A153     4  X'007E'   X'0388'   SZSTRTCT
DFHFEPI A154     4  X'007F'   X'038C'   SZCHROUT
DFHFEPI A155     4  X'0080'   X'0390'   SZCHRIN
DFHFEPI A157     4  X'0081'   X'0394'   SZALLCTO
DFHFEPI A158     4  X'0082'   X'0398'   SZRCVTO
DFHFEPI A159     4  X'0083'   X'039C'   SZTOTCT
DFHCBTS A205     4  X'0084'   X'03A0'   BARSYNCT
DFHCBTS A206     4  X'0085'   X'03A4'   BARASYCT
DFHCBTS A207     4  X'0086'   X'03A8'   BALKPACT
DFHCBTS A208     4  X'0087'   X'03AC'   BADPROCT
DFHCBTS A209     4  X'0088'   X'03B0'   BADACTCT
DFHCBTS A210     4  X'0089'   X'03B4'   BARSPACT
DFHCBTS A211     4  X'008A'   X'03B8'   BASUPACT
DFHCBTS A212     4  X'008B'   X'03BC'   BARMPACT
DFHCBTS A213     4  X'008C'   X'03C0'   BADCPACT
DFHCBTS A214     4  X'008D'   X'03C4'   BAACQPCT
DFHCBTS A215     4  X'008E'   X'03C8'   BATOTPCT
DFHCBTS A216     4  X'008F'   X'03CC'   BAPRDCCT
DFHCBTS A217     4  X'0090'   X'03D0'   BAACDCCT
DFHCBTS A218     4  X'0091'   X'03D4'   BATOTCCT
DFHCBTS A219     4  X'0092'   X'03D8'   BARATECT
DFHCBTS A220     4  X'0093'   X'03DC'   BADFIECT
DFHCBTS A221     4  X'0094'   X'03E0'   BATIAECT
DFHCBTS A222     4  X'0095'   X'03E4'   BATOTECT
DFHWEBB A231     4  X'0096'   X'03E8'   WBRCVCT
DFHWEBB A232     4  X'0097'   X'03EC'   WBCHRIN
DFHWEBB A233     4  X'0098'   X'03F0'   WBSENDCT
DFHWEBB A234     4  X'0099'   X'03F4'   WBCHROUT
DFHWEBB A235     4  X'009A'   X'03F8'   WBTOTCT
DFHWEBB A236     4  X'009B'   X'03FC'   WBREPRCT
DFHWEBB A237     4  X'009C'   X'0400'   WBREPWCT
DFHWEBB A238     4  X'009D'   X'0404'   WBEXTRCT
DFHWEBB A239     4  X'009E'   X'0408'   WBBRWCT
DFHWEBB A224     4  X'009F'   X'040C'   WBREADCT
DFHWEBB A225     4  X'00A0'   X'0410'   WBWRITCT
DFHDOCH A226     4  X'00A1'   X'0414'   DHCRECT
DFHDOCH A227     4  X'00A2'   X'0418'   DHINSCT
DFHDOCH A228     4  X'00A3'   X'041C'   DHSETCT
DFHDOCH A229     4  X'00A4'   X'0420'   DHRETCT
DFHDOCH A230     4  X'00A5'   X'0424'   DHTOTCT
DFHDOCH A240     4  X'00A6'   X'0428'   DHTOTDCL
DFHSOCK A242     4  X'00A7'   X'042C'   SOBYENCT
DFHSOCK A243     4  X'00A8'   X'0430'   SOBYDECT
DFHSOCK A289     4  X'00A9'   X'0434'   SOEXTRCT
DFHSOCK A290     4  X'00AA'   X'0438'   SOCNPSCT
DFHSOCK A291     4  X'00AB'   X'043C'   SOCPSCT
DFHSOCK A292     4  X'00AC'   X'0440'   SONPSHWM
DFHSOCK A293     4  X'00AD'   X'0444'   SOPSHWM
DFHSOCK A294     4  X'00AE'   X'0448'   SORCVCT
DFHSOCK A295     4  X'00AF'   X'044C'   SOCHRIN
DFHSOCK A296     4  X'00B0'   X'0450'   SOSENDCT
DFHSOCK A297     4  X'00B1'   X'0454'   SOCHROUT
FIELD-NAME    SIZE  CONNECTOR OFFSET    NICKNAME
DFHSOCK A298     4  X'00B2'   X'0458'   SOTOTCT
DFHSOCK A301     4  X'00B3'   X'045C'   SOMSGIN1
DFHSOCK A302     4  X'00B4'   X'0460'   SOCHRIN1
DFHSOCK A303     4  X'00B5'   X'0464'   SOMSGOU1
DFHSOCK A304     4  X'00B6'   X'0468'   SOCHROU1
DFHDATA A179     4  X'00B7'   X'046C'   IMSREQCT
DFHDATA A180     4  X'00B8'   X'0470'   DB2REQCT
DFHTASK A251     4  X'00B9'   X'0474'   TCBATTCT
DFHTASK A252     4  X'00BA'   X'0478'   DSTCBHWM
DFHEJBS A312     4  X'00BB'   X'047C'   EJBSACCT
DFHEJBS A313     4  X'00BC'   X'0480'   EJBSPACT
DFHEJBS A314     4  X'00BD'   X'0484'   EJBCRECT
DFHEJBS A315     4  X'00BE'   X'0488'   EJBREMCT
DFHEJBS A316     4  X'00BF'   X'048C'   EJBMTHCT
DFHEJBS A317     4  X'00C0'   X'0490'   EJBTOTCT
DFHWEBB A331     4  X'00C1'   X'0494'   WBREDOCT
DFHWEBB A332     4  X'00C2'   X'0498'   WBWRTOCT
DFHWEBB A333     4  X'00C3'   X'049C'   WBRCVIN1
DFHWEBB A334     4  X'00C4'   X'04A0'   WBCHRIN1
DFHWEBB A335     4  X'00C5'   X'04A4'   WBSNDOU1
DFHWEBB A336     4  X'00C6'   X'04A8'   WBCHROU1
DFHWEBB A337     4  X'00C7'   X'04AC'   WBPARSCT
DFHWEBB A338     4  X'00C8'   X'04B0'   WBBRWOCT
DFHWEBB A340     4  X'00C9'   X'04B4'   WBIWBSCT
DFHWEBB A341     4  X'00CA'   X'04B8'   WBREPRDL
DFHWEBB A342     4  X'00CB'   X'04BC'   WBREPWDL
DFHCHNL A321     4  X'00CC'   X'04C0'   PGTOTCCT
DFHCHNL A322     4  X'00CD'   X'04C4'   PGBRWCCT
DFHCHNL A323     4  X'00CE'   X'04C8'   PGGETCCT
DFHCHNL A324     4  X'00CF'   X'04CC'   PGPUTCCT
DFHCHNL A325     4  X'00D0'   X'04D0'   PGMOVCCT
DFHCHNL A326     4  X'00D1'   X'04D4'   PGGETCDL
DFHCHNL A327     4  X'00D2'   X'04D8'   PGPUTCDL
DFHCHNL A328     4  X'00D3'   X'04DC'   PGCRECCT
DFHTASK S007     8  X'00D4'   X'04E0'   USRDISPT
DFHTASK S008     8  X'00D5'   X'04E8'   USRCPUT
DFHTASK S014     8  X'00D6'   X'04F0'   SUSPTIME
DFHTASK S102     8  X'00D7'   X'04F8'   DISPWTT
DFHTASK S255     8  X'00D8'   X'0500'   QRDISPT
DFHTASK S256     8  X'00D9'   X'0508'   QRCPUT
DFHTASK S257     8  X'00DA'   X'0510'   MSDISPT
DFHTASK S258     8  X'00DB'   X'0518'   MSCPUT
DFHTASK S269     8  X'00DC'   X'0520'   RODISPT
DFHTASK S270     8  X'00DD'   X'0528'   ROCPUT
DFHTASK S262     8  X'00DE'   X'0530'   KY8DISPT
DFHTASK S263     8  X'00DF'   X'0538'   KY8CPUT
DFHTASK S264     8  X'00E0'   X'0540'   KY9DISPT
DFHTASK S265     8  X'00E1'   X'0548'   KY9CPUT
DFHTASK S259     8  X'00E2'   X'0550'   L8CPUT
DFHTASK S266     8  X'00E3'   X'0558'   L9CPUT
DFHTASK S260     8  X'00E4'   X'0560'   J8CPUT
DFHTASK S261     8  X'00E5'   X'0568'   S8CPUT
DFHTASK S267     8  X'00E6'   X'0570'   J9CPUT
DFHTASK S271     8  X'00E7'   X'0578'   X8CPUT
DFHTASK S272     8  X'00E8'   X'0580'   X9CPUT
DFHTASK S249     8  X'00E9'   X'0588'   QRMODDLY
DFHTASK S250     8  X'00EA'   X'0590'   MAXOTDLY
DFHTASK S277     8  X'00EB'   X'0598'   MAXJTDLY
DFHTASK S282     8  X'00EC'   X'05A0'   MAXXTDLY
FIELD-NAME    SIZE  CONNECTOR OFFSET    NICKNAME
DFHTASK S281     8  X'00ED'   X'05A8'   MAXSTDLY
DFHTASK S268     8  X'00EE'   X'05B0'   DSTCBMWT
DFHTASK S247     8  X'00EF'   X'05B8'   DSCHMDLY
DFHCICS S103     8  X'00F0'   X'05C0'   EXWTTIME
DFHTERM S009     8  X'00F1'   X'05C8'   TCIOWTT
DFHFILE S063     8  X'00F2'   X'05D0'   FCIOWTT
DFHJOUR S010     8  X'00F3'   X'05D8'   JCIOWTT
DFHTEMP S011     8  X'00F4'   X'05E0'   TSIOWTT
DFHTERM S100     8  X'00F5'   X'05E8'   IRIOWTT
DFHDEST S101     8  X'00F6'   X'05F0'   TDIOWTT
DFHPROG S115     8  X'00F7'   X'05F8'   PCLOADTM
DFHTASK S125     8  X'00F8'   X'0600'   DSPDELAY
DFHTASK S126     8  X'00F9'   X'0608'   TCLDELAY
DFHTASK S127     8  X'00FA'   X'0610'   MXTDELAY
DFHTASK S129     8  X'00FB'   X'0618'   ENQDELAY
DFHTASK S123     8  X'00FC'   X'0620'   GNQDELAY
DFHTERM S133     8  X'00FD'   X'0628'   LU61WTT
DFHTERM S134     8  X'00FE'   X'0630'   LU62WTT
DFHFEPI S156     8  X'00FF'   X'0638'   SZWAIT
DFHTASK S170     8  X'0100'   X'0640'   RMITIME
DFHTASK S171     8  X'0101'   X'0648'   RMISUSP
DFHSYNC S173     8  X'0102'   X'0650'   SYNCTIME
DFHFILE S174     8  X'0103'   X'0658'   RLSWAIT
DFHFILE S175     8  X'0104'   X'0660'   RLSCPUT
DFHTASK S128     8  X'0105'   X'0668'   LMDELAY
DFHTASK S181     8  X'0106'   X'0670'   WTEXWAIT
DFHTASK S182     8  X'0107'   X'0678'   WTCEWAIT
DFHTASK S183     8  X'0108'   X'0680'   ICDELAY
DFHTASK S184     8  X'0109'   X'0688'   GVUPWAIT
DFHTEMP S178     8  X'010A'   X'0690'   TSSHWAIT
DFHFILE S176     8  X'010B'   X'0698'   CFDTWAIT
DFHSYNC S177     8  X'010C'   X'06A0'   SRVSYWTT
DFHTASK S191     8  X'010D'   X'06A8'   RRMSWAIT
DFHTASK S195     8  X'010E'   X'06B0'   RUNTRWTT
DFHSYNC S196     8  X'010F'   X'06B8'   SYNCDLY
DFHSOCK S241     8  X'0110'   X'06C0'   SOIOWTT
DFHDATA S186     8  X'0111'   X'06C8'   IMSWAIT
DFHDATA S187     8  X'0112'   X'06D0'   DB2RDYQW
DFHDATA S188     8  X'0113'   X'06D8'   DB2CONWT
DFHDATA S189     8  X'0114'   X'06E0'   DB2WAIT
DFHTASK S253     8  X'0115'   X'06E8'   JVMTIME
DFHTASK S254     8  X'0116'   X'06F0'   JVMSUSP
DFHSOCK S299     8  X'0117'   X'06F8'   SOOIOWTT
DFHTASK S192     8  X'0118'   X'0700'   RQRWAIT
DFHTASK S193     8  X'0119'   X'0708'   RQPWAIT
DFHSYNC S199     8  X'011A'   X'0710'   OTSINDWT
DFHTASK S273     8  X'011B'   X'0718'   JVMITIME
DFHTASK S275     8  X'011C'   X'0720'   JVMRTIME
DFHTASK S285     8  X'011D'   X'0728'   PTPWAIT
DFHTASK S279     8  X'011E'   X'0730'   DSMMSCWT
End of change

Note:
The "field types" in Figure 95 are:
A
Count
C
Byte-string
P
Packed decimal number
S
Clock
T
Time stamp.

Performance data sections

Each performance data section is made up of a string of field connectors, followed by one or more performance data records. All of the performance records produced by a single CICS run have the same format, and each record is, by default, Start of change1848End of change bytes long. However, the length of the performance records changes if you add user data at user EMPs, or if you exclude any system-defined data from the monitoring process. All of the system-defined data fields in the performance records are described in the CICS Performance Guide. The format of the performance data section is shown in Figure 96.

Figure 96. Format of the performance data section
 The picture shows three rectangles, one above the other. The top rectangle represents an SMF type 110 monitoring record. It consists of three sections: an SMF header, an SMF product section, and a performance data section. The middle rectangle is an expansion of the performance data section in the top rectangle. It consists of a field connectors field, followed by a number of performance records, numbered 1 to n. The bottom rectangle is an expansion of one of the performance records in the middle rectangle. It consists of a number of data fields, marked 'Data for field 1' to 'Data for field n'.

Relationship of the dictionary record to the performance records

Following the performance records’ SMF product section, and before the performance records themselves, is a string of field connectors. The purpose of the field connectors is to tell you which fields are going to occur in the performance records produced by this CICS run. Each field connector corresponds to one field in each of the succeeding performance records. The first field connector corresponds to the first field, the second to the second field, and so on. Each field connector also corresponds to a single dictionary entry in the associated dictionary record: the connector value is equal to the value of CMODCONN in the corresponding dictionary entry. In this way, each performance record field is connected to the dictionary entry that describes it. A useful technique for calculating the offset of a particular dictionary entry is to take the connector, subtract one, and multiply the result by the length of a single dictionary entry.

Thus, the string of field connectors is the key to the dictionary. And without the dictionary, reporting and analysis programs cannot interpret the performance data.

The successive performance records can be regarded as rows in a table, with each column corresponding to one type of field within the records. Each field connector then describes the contents of one column. This view of the data is helpful when designing tabular reports, which are often arranged in this way.

Figure 97 illustrates the relationship between the dictionary record, the field connectors, and the performance records.

Figure 97. Relationship between the dictionary record and the performance records. In this example, the data that is defined by Dictionary Entry 3 has been excluded, so there is no field connector value for it and it does not appear in the performance records.
 The picture shows a dictionary record consisting of dictionary entries numbered 1 to n. Below the dictionary record is a string of field connectors, also numbered 1 to n. Below this are several performance records, each consisting of data fields numbered 1 to n. Field connector 1 connects dictionary entry 1 to data field 1 in the performance records. Field connector 2connects dictionary entry 2to data field 2in the performance records, and so on. The data that is defined by dictionary entry 3 has been excluded, so there is no field connector value for it and it does not appear in the performance records.
How the string of field connectors is constructed

When CICS is initialized, a unique connector value is assigned to every dictionary entry. CICS then examines the MCT entries for this run to see if you have excluded any system-defined performance data. If you have, the offset values for their corresponding dictionary entries are set to X'FFFF'. CICS then constructs a sequence of field connectors that excludes those with offsets of X'FFFF'. In this way, the connectors tell you which system- and user-data fields are going to occur in your performance records for this run. If you have not excluded any system-defined performance data, there is one field connector for every dictionary entry.

Please note the following:

Field connectors
link the fields in a performance record with their dictionary entries. They are unique values that are assigned at initialization time. They may, therefore, change from one run of CICS to the next.
Field identifiers
allow you to exclude specific system-defined performance data from being collected during a CICS run. They are unique within a group name and record type, and they do not change between CICS runs. There is more information about field identifiers in the CICS Resource Definition Guide.
Field offsets
in the performance record allow you to build a table for fast selection of required fields in your monitoring data processing programs.

Exception data sections

The format of an exception data record (including the SMF header and SMF product section) is shown in Figure 98. The exception data section contains a single exception record representing one exception condition.

Figure 98. Format of an SMF exception data record
 The picture shows an SMF exception data record consisting of an SMF header, an SMF product section, and an exception data section.

The format of the exception data section can be mapped by the DSECT MNEXCDS, which you can generate using the DFHMNEXC macro as follows:

MNEXCDS DFHMNEXC PREFIX=EXC

The label ‘MNEXCDS’ is the default DSECT name, and EXC is the default PREFIX value, so you could also generate the DSECT simply by coding

DFHMNEXC

The MNEXCDS DSECT has the format shown in Figure 99.

Figure 99. CICS monitoring exception record DSECT
MNEXCDS  DSECT
EXCMNTRN DS    CL4                TRANSACTION IDENTIFICATION
EXCMNTER DS    XL4                TERMINAL IDENTIFICATION
EXCMNUSR DS    CL8                USER IDENTIFICATION
EXCMNTST DS    CL4                TRANSACTION START TYPE
EXCMNSTA DS    XL8                EXCEPTION START TIME
EXCMNSTO DS    XL8                EXCEPTION STOP TIME
EXCMNTNO DS    PL4                TRANSACTION NUMBER
EXCMNTPR DS    XL4                TRANSACTION PRIORITY
         DS    CL4                RESERVED
EXCMNLUN DS    CL8                LUNAME
         DS    CL4                RESERVED
EXCMNEXN DS    XL4                EXCEPTION NUMBER
EXCMNRTY DS    CL8                EXCEPTION RESOURCE TYPE
EXCMNRID DS    CL8                EXCEPTION RESOURCE ID
EXCMNTYP DS    XL2                EXCEPTION TYPE
EXCMNWT  EQU   X'0001'            WAIT
EXCMNBWT EQU   X'0002'            BUFFER WAIT
EXCMNSWT EQU   X'0003'            STRING WAIT
         DS    CL2                RESERVED
EXCMNTCN DS    CL8                TRANSACTION CLASS NAME
EXCMNSRV DS    CL8                SERVICE CLASS NAME
EXCMNRPT DS    CL8                REPORT CLASS NAME
EXCMNNPX DS    CL20               NETWORK UNIT-OF-WORK PREFIX
EXCMNNSX DS    XL8                NETWORK UNIT-OF-WORK SUFFIX
EXCMNTRF DS    XL8                TRANSACTION FLAGS
EXCMNFCN DS    CL4                TRANSACTION FACILITY NAME
EXCMNCPN DS    CL8                CURRENT PROGRAM NAME
EXCMNBTR DS    CL4                BRIDGE TRANSACTION ID
EXCMNURI DS    XL16               RRMS/MVS UNIT OF RECOVERY ID
EXCMNRIL DS    F                  EXCEPTION RESOURCE ID LENGTH
EXCMNRIX DS    XL256              EXCEPTION RESOURCE ID (EXTENDED)
EXCMNNID DS    CL8                NETWORK ID 
EXCMNRLU DS    CL8                REAL LUNAME
         END OF EXCEPTION RECORD...

For further information about exception class data, see the CICS Performance Guide, which lists all the system-defined data that can be produced by CICS monitoring.

Transaction resource data sections

Each transaction resource data section is made up of one or more transaction resource data records. All the transaction resource data records produced by a single CICS run have the same format, with a resource record header followed by a resource data section for each resource being monitored. Thus, the length of each record is dependent on the number of resources being monitored. For example, each file resource adds 96 bytes, which means that if you specify FILE=10 in the DFHMCT TYPE=INITIAL macro, the file resource data section can have up to 960 bytes of file resource data. Each temporary storage queue also adds 96 bytes to a record. The FILE operand in the MCT sets a limit to the number of files that resource data can be collected for any one transaction. The TSQUEUE operand in the MCT sets a limit to the number of temporary storage queues that resource data can be collected for any one transaction. All the system-defined data fields in the transaction resource monitoring records are described in the CICS Performance Guide. The format of the transaction resource monitoring records is shown in Figure 100.

Figure 100. Format of the resource monitoring data section
 The picture shows three rectangles, one above the other. The top rectangle represents an SMF type 110 monitoring record. It consists of three sections: an SMF header, an SMF product section, and a transaction resource data section. The middle rectangle is an expansion of the transaction resource data section in the top rectangle. It consists of a number of transaction resource data records, numbered 1 to n. The bottom rectangle is an expansion of one of the transaction resource  records in the middle rectangle. It consists of a number of data fields, marked 'Data for field 1' to 'Data for field n'.

You can map the transaction resource data section using the DFHMNRDS copybook, details of which are shown in Figure 101.

Figure 101. CICS transaction resource monitoring record DSECT
DFHMNRDS DSECT  ,                      Transaction resource monitoring record
MNR_LENGTH     DS  H                   Length of resource data  
MNR_ID_EQUATE  EQU 79                  Monitoring domain id mask
MNR_ID         DC  AL2(MNR_ID_EQUATE)  Monitoring domain id     
MNR_VERSION    EQU X'02'               DSECT version mask       
MNR_DSECT_VERS DS  CL1                 DSECT version number     
               DS  CL3                 Reserved                 
*                                                               
MNR_HEADER     DS  0XL32               Header Data              
MNR_HDRLEN     DS  H                   Length of header data    
               DS  XL2                 Reserved                 
               DS  XL8                 Reserved                 
MNR_TRN        DS  H                   Number of record triplets
               DS  XL2                 Reserved                                  
MNR_ISO        DS  XL4                 Offset to ID data               
MNR_ISL        DS  XL2                 Length of ID entry              
MNR_ISN        DS  XL2                 Number of ID entries            
MNR_FSO        DS  XL4                 Offset to File data             
MNR_FSL        DS  XL2                 Length of File entry            
MNR_FSN        DS  XL2                 Number of File entries          
MNR_TSO        DS  XL4                 Offset to TSQueue data          
MNR_TSL        DS  XL2                 Length of TSQueue entry         
MNR_TSN        DS  XL2                 Number of TSQueue entries       
MNR_HDR_LENGTH EQU *-MNR_HEADER        Header data length              
         SPACE ,                                                       
MNR_ID_DATA    DSECT                   Identification Data Entry       
MNR_ID_TRANID  DS  CL4                 Transaction id                  
MNR_ID_TERMID  DS  CL4                 Terminal id                     
MNR_ID_USERID  DS  CL8                 User id                         
MNR_ID_STYPE   DS  CL4                 Transaction Start type          
MNR_ID_START   DS  XL8                 Transaction Start time          
MNR_ID_STOP    DS  XL8                 Transaction Stop time           
MNR_ID_TASKNO  DS  XL4                 Transaction Sequence Number     
MNR_ID_LUNAME  DS  CL8                 VTAM Luname                     
MNR_ID_PGMNAME DS  CL8                 First program name              
MNR_ID_UOW_PX  DS  XL20                Network Unit-of-Work Prefix     
MNR_ID_UOW_SX  DS  XL8                 Network Unit-of-Work Suffix     
MNR_ID_RSYSID  DS  CL4                 Remote sysid routed to          
MNR_ID_TRN_FLAGS DS  XL8               Transaction flags               
MNR_ID_FCTYNAME  DS  CL4               Transaction Facility name       
MNR_ID_RTYPE     DS  CL4               Resource Record Type            
MNR_ID_TERMINFO  DS  0XL4              Terminal Information            
MNR_ID_NATURE    DS  XL1               Nature                          
MNR_ID_NATURE_NOTAPPLIC EQU X'00'          Not applic                  
MNR_ID_NATURE_TERMINAL  EQU X'01'          Terminal                    
MNR_ID_NATURE_SESSION   EQU X'02'          Session                     
MNR_ID_SESSTYPE  DS  XL1               Session Type                    
MNR_ID_SESSTYPE_NOTAPPLIC EQU X'00'        Not applic                  
MNR_ID_SESSTYPE_IRC       EQU X'01'        IRC                         
MNR_ID_SESSTYPE_IRC_XM    EQU X'02'        IRC XM                      
MNR_ID_SESSTYPE_IRC_XCF   EQU X'03'        IRC XCF                     
MNR_ID_SESSTYPE_LU61      EQU X'04'        LU61                        
MNR_ID_SESSTYPE_LU62_SING EQU X'05'        LU62 SINGLE                 
MNR_ID_SESSTYPE_LU62_PARA EQU X'06'        LU62 PARALLEL               
MNR_ID_ACMETH    DS  XL1               Access method                   
MNR_ID_ACMETH_NOTAPPLIC EQU X'00'          Not applic                  
MNR_ID_ACMETH_VTAM      EQU X'01'          VTAM                        
Start of changeMNR_ID_ACMETH_BTAM      EQU X'02'          BTAM (No longer supported)  
End of changeMNR_ID_ACMETH_BSAM      EQU X'03'          BSAM                        
Start of changeMNR_ID_ACMETH_TCAM      EQU X'04'          TCAM (TCAM local terminals noEnd of change 
                                           longer supported) 
MNR_ID_ACMETH_TCAMSNA   EQU X'05'          TCAMSNA                     
MNR_ID_ACMETH_BGAM      EQU X'06'          BGAM                        
MNR_ID_ACMETH_CONSOLE   EQU X'07'          CONSOLE                     
MNR_ID_DEVCODE   DS  XL1               Device type code                
*                                          See TYPETERM RDO attribute  
MNR_ID_TERMCNNM  DS  CL4               Terminal Connection name        
MNR_ID_RES_FLAGS DS  0XL4              Resource flags                  
MNR_ID_RES_FLAG1 DS  XL1               Resource flag 1                 
MNR_FILE_LIMIT_EXCEEDED  EQU X'80'     Resource File limit exceeded    
MNR_TSQUEUE_LIMIT_EXCEEDED EQU X'40'   Resource TSQueue limit exceeded 
               DS  XL3                 Reserved                        
               DS  XL8                 Reserved                        
               DS  XL8                 Reserved                        
               DS  XL8                 Reserved                        
MNR_ID_LENGTH  EQU *-MNR_ID_DATA       Identification entry data length
         SPACE ,                                                       
MNR_FILE_ENTRY DSECT                   File Entry                      
MNR_FILE_NAME  DS  CL8                 File name                       
MNR_FILE_GET   DS  XL8                 File Get time/count             
MNR_FILE_PUT   DS  XL8                 File Put time/count             
MNR_FILE_BRWSE DS  XL8                 File Browse time/count          
MNR_FILE_ADD   DS  XL8                 File Add time/count             
MNR_FILE_DEL   DS  XL8                 File Delete time/count          
MNR_FILE_TOTAL DS  XL8                 File Total time/count           
MNR_FILE_AM_RQ DS  XL4                 File Access Method request count
               DS  XL4                 Reserved                        
MNR_FILE_IO_WT DS  XL8                 File I/O wait time              
MNR_RLS_FILE_IO_WT DS  XL8             RLS File I/O wait time          
MNR_CFDT_IO_WT DS  XL8                 CFDT I/O wait time              
               DS  XL8                 Reserved                        
MNR_FILE_LEN   EQU *-MNR_FILE_ENTRY    File entry data length          
         SPACE ,                                                       
MNR_TSQUEUE_ENTRY     DSECT            TSQueue Entry                   
MNR_TSQUEUE_NAME      DS  CL16         TSQueue Name                    
MNR_TSQUEUE_GET       DS  XL8          TSQueue Get time/count          
MNR_TSQUEUE_PUT_AUX   DS  XL8          TSQueue Put Aux time/count      
MNR_TSQUEUE_PUT_MAIN  DS  XL8          TSQueue Put Main time/count     
MNR_TSQUEUE_TOTAL     DS  XL8          TSQueue Total time/count        
                      DS  XL4          Reserved                        
MNR_TSQUEUE_GET_ITEML DS  XL4          TSQueue Get Item length         
MNR_TSQUEUE_PUT_AUX_ITEML  DS XL4      TSQueue Put Aux Item length     
MNR_TSQUEUE_PUT_MAIN_ITEML DS XL4      TSQueue Put Main Item length    
                      DS  XL8          Reserved                        
MNR_TSQUEUE_IO_WT     DS  XL8          TSQueue I/O wait time           
MNR_SHR_TSQUEUE_IO_WT DS  XL8          Shared TSQueue I/O wait time    
                      DS  XL8          Reserved                        
MNR_TSQUEUE_LEN EQU *-MNR_TSQUEUE_ENTRY TSQueue entry data length             
[[ Contents Previous Page | Next Page Index ]]