CICS statistics record format

This section describes the format of CICS® statistics SMF type 110 records in detail. You need this information if you write your own program to analyze the statistics data. The three components of a CICS statistics record are an SMF header, an SMF product section, and a CICS data section, as shown in Figure 102. Each of these is described in the sections that follow.

Figure 102. Format of an SMF type 110 statistics record
 The picture shows a rectangle, representing an SMF type 110 statistics record, divided 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 statistics data relates, which, in the case of CICS statistics, is the CICS region, the TS data sharing server, the CFDT server, or the named counter sequence number server. Both the SMF header and the SMF product section can be mapped by the DSECT STSMFDS, which you can generate using the DFHSTSMF macro as follows:

STSMFDS DFHSTSMF PREFIX=SMF

The label ‘STSMFDS’ is the default DSECT name, and SMF is the default PREFIX value, so you could also generate the DSECT simply by coding DFHSTSMF.

The STSMFDS DSECT has the format shown in Figure 103.

Figure 103. Format of the SMF header and product section for statistics records
*        START THE SMF HEADER
*
STSMFDS  DSECT
SMFSTLEN DS    XL2           RECORD LENGTH
SMFSTSEQ DS    XL2           SEGMENT DESCRIPTOR
SMFSTFLG DS    X             OPERATING SYSTEM INDICATOR (see note 1)
SMFSTRTY DC    X'6E'         RECORD TYPE 110 FOR CICS
SMFSTTME DS    XL4           TIME RECORD MOVED TO SMF
SMFSTDTE DS    XL4           DATE RECORD MOVED TO SMF
SMFSTSID DS    XL4           SYSTEM IDENTIFICATION
SMFSTSSI DS    CL4'CICS'     SUBSYSTEM IDENTIFICATION
SMFSTSTY DS    XL2           RECORD SUBTYPE X'0002' FOR STATISTICS
*                                                   (see note 4)
SMFSTTRN DS    XL2           NUMBER OF TRIPLETS
         DS    XL2           RESERVED
SMFSTAPS DS    XL4           OFFSET TO PRODUCT SECTION
SMFSTLPS DS    XL2           LENGTH OF PRODUCT SECTION
SMFSTNPS DS    XL2           NUMBER OF PRODUCT SECTIONS
SMFSTASS DS    XL4           OFFSET TO DATA SECTION
SMFSTASL DS    XL2           LENGTH OF DATA SECTION
SMFSTASN DS    XL2           NUMBER OF DATA SECTIONS
*
*        THIS CONCLUDES THE SMF HEADER
*
*        START THE SMF PRODUCT SECTION
*
SMFSTRVN DS    XL2           RECORD VERSION
SMFSTPRN DS    CL8           PRODUCT NAME (GENERIC APPLID)
SMFSTSPN DS    CL8           PRODUCT NAME (SPECIFIC APPLID)
SMFSTMFL DS    XL2           RECORD MAINTENANCE INDICATOR
         DS    XL2           RESERVED
         DS    XL2           RESERVED
SMFSTDTK DS    XL4           DOMAIN TOKEN
SMFSTDID DS    CL2           DOMAIN ID
SMFSTRQT DS    CL3           USS/EOD/REQ/INT STATISTICS TYPE
SMFSTICD DS    CL3           YES IF INCOMPLETE DATA RECORDED
SMFSTDAT DS    CL8           COLLECTION DATE MMDDYYYY
SMFSTCLT DS    CL6           COLLECTION TIME HHMMSS
SMFSTINT DS    CL6           INTERVAL HHMMSS. See note 3.
SMFSTINO DS    XL4           INTERVAL NUMBER. See note 3.
SMFSTRTK DS    XL8           REQUEST TOKEN
SMFSTLRT DS    CL6           LAST RESET TIME HHMMSS
SMFSTCST DS    XL8           CICS START TIME
SMFSTJBN DS    CL8           JOBNAME
SMFSTRSD DS    XL4           JOB DATE
SMFSTRST DS    XL4           JOB TIME
SMFSTUIF DS    CL8           USER IDENTIFICATION
SMFSTPDN 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 (SMFSTFLG). 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. 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, and CICS statistics.
  3. Fields SMFSTINT and SMFSTINO are only relevant if SMFSTRQT is ‘INT’. Otherwise both values should be ignored.
  4. For TS data sharing, the record subtype is X'0003' and certain fields are not set or are used in a different way. SMFSTPRN and SMFSTSPN contain the server prefix (DFHXQ) and the pool name.
  5. For coupling facility data table (CFDT) servers, the record subtype is X'0004' and certain fields are not set or are used in a different way. SMFSTPRN and SMFSTSPN contain the server prefix (DFHCF) and the coupling facility data table pool name.
  6. For named counter sequence number servers, the record subtype is X'0005' and certain fields are not set or are used in a different way. SMFSTPRN and SMFSTSPN contain the server prefix (DFHNC) and the pool name.

CICS statistics data section

The format of the CICS statistics data section is shown in Figure 104.

Figure 104. Format of the statistics data section
 The picture shows a rectangle, representing an SMF type 110 statistics record, divided into three parts--an SMF header, an SMF product section, and a statistics data section. The statistics data section consists of multiple statistics records.

If the data records are incomplete, the flag field SMFSTICD is set to ‘YES’. In this case, the statistics data section is not present.

For complete data records, the statistics data section is made up of one or more statistics data records. There are different formats of data records. Each has a common format for the first 5 bytes. These 5 bytes are described in the extract from copy book DFHSTIDS in Figure 105.

Figure 105. Extract from copy book DFHSTIDS
DFHSTIDS DSECT                    Statistics record header
*
         DS    0F                 Fullword alignment
STILEN   DS    H                  Length of the record
STID     DS    AL2                Statistics identifier
STIVERS  DS    CL1                Statistics record version
STILEN
is the length of the data record.
STID
identifies which type of statistics record you have (see Figure 106).

You can use the STID symbolic name or value to determine which copy book to use when processing the statistics data records. For details about the relationship between the STID name or value and the copy book, see Figure 106. For further guidance information about the fields within the statistics data records, see the CICS Performance Guide.

STIVERS
takes the value ‘1’ for this release of CICS.
Figure 106. Statistics data record copy books related to STID name and value
  STID      STID
  Symbolic  Value  Copy book     Type of record
  name
 
  STISMDSA    2    DFHSMSDS      Storage manager DSA id
  STISMD      5    DFHSMDDS      Storage mgr domain subpool id
  STISMT      6    DFHSMTDS      Storage manager task subpool id
  STIXMG      10   DFHXMGDS      Transaction manager (Globals) id
  STIXMR      11   DFHXMRDS      Transaction manager (Trans) id
  STIXMC      12   DFHXMCDS      Transaction manager (Tclass) id
  STIFEPIP    16   DFHA22DS      FEPI pool id
  STIFEPIC    17   DFHA23DS      FEPI connection id
  STIFEPIT    18   DFHA24DS      FEPI target id
  STIVT       21   DFHA03DS      VTAM stats id
  STIPAUTO    23   DFHPGGDS      Program Autoinstall id
  STIAUTO     24   DFHA04DS      Terminal Autoinstall stats id
  STILDR      25   DFHLDRDS      Loader (Resid) id
  STIDBUSS    28   DFHDBUDS      DBCTL USS id
  STILDG      30   DFHLDGDS      Loader (Globals) id
  STITCR      34   DFHA06DS      Terminal control (resid) id
  STILSRR     39   DFHA08DS      LSRPOOL pool stats (resid) id
  STILSRFR    40   DFHA09DS      LSRPOOL File statistics (by file)
  STITDQR     42   DFHTQRDS      TDQUEUE (Resid) id
  STITDQG     45   DFHTQGDS      TDQUEUE (globals) id
  STITSQ      48   DFHTSGDS      TSQUEUE statistics id
  STICONSR    52   DFHA14DS      ISC/IRC system entry (resid) id
  STICONSS    54   DFHA21DS      ISC connection - system security
  STIDS       60   DFHDSGDS      Dispatcher stats id
  STIUSG      61   DFHUSGDS      User domain stats id
  STITM       63   DFHA16DS      Table manager statistics id
  STIDST      64   DFHDSTDS      Dispatcher TCB (global)id 
  STIDSR      65   DFHDSRDS      Dispatcher TCB (resid)id 
  STIST       66   DFHSTGDS      Statistics statistics id
  STIFCR      67   DFHA17DS      File Control (resid) id
  STICONMR    76   DFHA20DS      ISC/IRC mode entry (resid) id
  STIM        81   DFHMNGDS      Monitoring stats (global) id
  STIMNR      84   DFHMNTDS      Monitoring stats (Resid) id
  STITDR      85   DFHTDRDS      Transaction dump (resid) id
  STITDG      87   DFHTDGDS      Transaction dump (global) id
  STISDR      88   DFHSDRDS      System dump (resid) id
  STISDG      90   DFHSDGDS      System dump (global) id
  STILGG      92   DFHLGGDS      Logstream stats (global) id
  STILGR      93   DFHLGRDS      Logger stats (resid) id
  STILGS      94   DFHLGSDS      Logstream stats (resid) id
  STINQG      97   DFHNQGDS      Enqueue mgr stats (global) id
  STIRMG      99   DFHRMGDS      Recovery mgr stats (global) id
  Start of changeSTIWBG     101   DFHWBGDS      URIMAPs (global) id
  STID2G     102   DFHD2GDS      DB2 connection stats (global) id
  STID2R     103   DFHD2RDS      DB2 entry stats (resource) id
  STIWBR     104   DFHWBRDS      URIMAPs (resource) id
  STIPIR     105   DFHPIRDS      PIPELINE (resource) id
  STIPIW     106   DFHPIWDS      WEBSERVICE (resource) idEnd of change
  STISOG     107   DFHSOGDS      TCP/IP (global) id
  STISOR     108   DFHSORDS      TCPIP services (resource) id
  STIIIR     111   DFHIIRDS      REQUESTMODEL (resource) id
  STIEJR     114   DFHEJRDS      CORBA Server (resource) id
  STIEJB     115   DFHEJBDS      Bean stats (resource) id
  STISJG     117   DFHSJGDS      JVMPOOL stats (global) id
  STISJR     118   DFHSJRDS      JVMPROFILE stats (resource) id

The TS data sharing statistics use no symbolic names, but relate to the STID values as follows:  

Figure 107. TS data sharing statistics related to STID
  STID      STID
  Symbolic  Value  Copy book     Type of record
  name
 
   -         121   DFHXQS1D      TS server list structure stats id
   -         122   DFHXQS2D      TS buffer stats id
   -         123   DFHXQS3D      TS storage stats id

The coupling facility data table server statistics use no symbolic names, but relate to the STID values as follows:  

Figure 108. Coupling facility data table server statistics related to STID
  STID      STID
  Symbolic  Value  Copy book     Type of record
  name
 
   -         126   DFHCFS6D      CFDT server list stats
   -         127   DFHCFS7D      CFDT buffer stats id
   -         128   DFHCFS8D      CFDT request stats id
   -         129   DFHCFS9D      CFDT storage stats id

The named sequence number server statistics use no symbolic names, but relate to the STID values as follows:  

Figure 109. Named sequence server statistics related to STID
  STID      STID
  Symbolic  Value  Copy book     Type of record
  name
 
   -         124   DFHNCS4D      NC server list structure stats id
   -         125   DFHNCS5D      NC server storage stats id

Related concepts
Writing a program to collect CICS statistics
Related tasks
Processing the output from CICS statistics
Related reference
Using an XSTOUT global user exit program to filter statistics records
[[ Contents Previous Page | Next Page Index ]]