CICS statistics in DSECTs and DFHSTUP report

The main reference information for the CICS® statistics lists them as they are presented in the report from the DFHSTUP utility, and in the statistics DSECTs.

All five types of CICS statistics record (interval, end-of-day, requested, requested reset, and unsolicited) present information as SMF records. The numbers used to identify each SMF statistics record are given in the DFHSTIDS copybook. Programming information about the formats of CICS statistics records is given in Writing statistics collection and analysis programs.

Statistics areas are listed alphabetically. Each area of CICS statistics is listed in the following format:

DFHSTUP name Field name Description
DFHSTUP name is the name as it appears on the DFHSTUP report. Field name is the name as it appears in the DSECT mapping this data. Description is a brief description of the statistics field.
Reset characteristic: Reset characteristic of the statistics field at a statistics interval collection. The values can be:
  • Not reset
  • Reset to zero
  • Reset to 1
  • Reset to current values (this applies to peak values only)
  • An alternative value (these are documented).

For resource types that are supported as private resources for applications deployed on platforms, statistics for both public and private resources are reported in the output from the DFHSTUP utility. The statistics for public resources and the statistics for private resources are mapped by separate DSECTs, and are also reported separately by DFHSTUP.

The Statistics Utility Program (STUP) provides a summary report facility that can be selected using a DFHSTUP control parameter. Information on how to run DFHSTUP is given in Statistics utility program (DFHSTUP) in the CICS Operations and Utilities Guide. When selected, the summary report is placed after all other reports. The DFHSTUP summary report facility summarizes (totals, peaks, and averages) the interval, unsolicited, requested reset and end-of-day statistics on an applid by applid basis. Requested statistics are not involved in the production of the summary report.

The summary report feature uses all of the appropriate statistic collections contained on the SMF data set. Therefore, depending on when the summary report feature is executed and when the SMF data set was last cleared, summary reports may be produced covering an hour, a week, or any period of time. Note that due to the potential magnitude of the summary data, it is not recommended that a summary period extend beyond one year.

Because the summary statistics are computed offline by the DFHSTUP utility, the summary statistics are not available to online users. Due to the potential magnitude of the summary data, and due to limited page width, summary data may be represented as a scaled value. For example, if the total number of terminal input messages is 1234567890, this value is shown as 1234M, where 'M' represents millions. Other scaling factors used are 'B' for billions and 'T' for trillions. Scaling is only performed when the value exceeds 99999999, and only then when page width is limited, for example in terminal statistics.

Table 1. CICS statistics areas
Statistic type Topic
Atom feeds Atom feed statistics
Autoinstall global statistics Autoinstall statistics
Bundle BUNDLE statistics
Capture specification CAPTURESPEC statistics
CICS DB2® CICS DB2 statistics
DBCTL session termination DBCTL session termination statistics
Dispatcher domain Dispatcher domain statistics
Document templates Document template statistics
Dump domain — system dump Dump domain: System dump statistics
Dump domain — transaction dump Dump domain: Transaction dump statistics
Enqueue domain Enqueue domain statistics
EP adapter EPADAPTER statistics
Event binding EVENTBINDING statistics
Event process EVENTPROCESS statistics
Front end programming interface (FEPI) Front end programming interface (FEPI) statistics
File control File control statistics
IPCONN IPCONN statistics
ISC/IRC system and mode entry ISC/IRC system and mode entry statistics
ISC/IRC attach time entry ISC/IRC attach time entry statistics
Journalname Journalname statistics
JVM server JVMSERVER statistics
JVM programs JVM program statistics
LIBRARY LIBRARY statistics
Loader domain Loader domain statistics
Logstream Logstream statistics
LSRpool LSR pool statistics
Monitoring Monitoring domain statistics
MQCONN IBM MQ Connection statistics
PIPELINE definitions PIPELINE definition statistics
Program Program statistics
Program autoinstall Program autoinstall statistics
Program definitions Program definition statistics
Recovery manager Recovery manager statistics
Statistics domain Statistics domain statistics
Storage manager Storage manager statistics
Table manager Table manager statistics
TCP/IP TCP/IP global and TCP/IP Service statistics
Temporary storage Temporary storage statistics
Terminal control Terminal control statistics
Transaction class (TCLASS) Transaction class (TCLASS) statistics
Transaction manager Transaction statistics
Transient data Transient data statistics
URIMAP definitions URIMAP definition statistics
User domain User domain statistics
Web services Web service statistics
WebSphere® MQ connection IBM MQ Connection statistics
XMLTRANSFORM XMLTRANSFORM statistics
z/OS® Communications Server (VTAM®) SNA statistics