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.
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.
* 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
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 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:
You can map the dictionary entries by generating a DSECT with the DFHMCTDR macro as shown in Figure 93.
DFHMCTDR TYPE=(PREFIX,CMO)
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.
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
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, 1848
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.
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.
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:
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.
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.
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.
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.
You can map the transaction resource data section using the DFHMNRDS copybook, details of which are shown in Figure 101.
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
MNR_ID_ACMETH_BTAM EQU X'02' BTAM (No longer supported)
MNR_ID_ACMETH_BSAM EQU X'03' BSAM
MNR_ID_ACMETH_TCAM EQU X'04' TCAM (TCAM local terminals no
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