Changes to statistics records

There are changes to CICS® statistics records. These are usually because of new domains, or they are a result of enhancements to CICS. As a result, a number of statistics DSECTs have new or changed fields. The changed DSECTs are:

Copybook
For functional area
DFHA17DS
File resource statistics.
DFHD2GDS
CICS DB2® connection global statistics.
DFHD2RDS
CICS DB2 entry resource statistics.
DFHDSGDS
Dispatcher global statistics.
DFHEJBDS
Enterprise beans
DFHEJRDS
Enterprise Java™ CorbaServer resource statistics.
DFHLGSDS
Log stream resource statistics.
DFHMNTDS
Transaction performance monitoring resource statistics.
DFHPGRDS (new DSECT)
JVM programs
DFHPIPDS (new DSECT)
Pipeline resource statistics
DFHPIWDS (new DSECT)
Webservice resource statistics
DFHSJGDS
The JVM pool
DFHSJRDS (new DSECT)
JVM profiles
DFHSMSDS
Storage above 16MB
DFHSORDS
TCP/IP service resource statistics.
DFHSTGDS
Statistics domain global statistics.
DFHWBRDS
Urimap resource statistics
DFHWBSDS
Urimap global statistics

Existing application programs are unaffected by the changes if they use the old versions of the following changed DSECTS:

This is because the new fields are added to the end and do not affect the offsets of the unchanged fields. (Not all of these DSECTS existed at all earlier releases of CICS, but if you were using one or more of them, your application will simply not see the new fields.)

The changes to DFHDSGDS DFHMNTDS 1and DFHSJGDS are such that the old DSECTs are not compatible with the new DSECT, and application programs using these DSECTs must be recompiled. (Again, a reminder that not all of these DSECTS existed at all earlier releases of CICS, but if you were using one or more of them, this statement applies to you.)

Collecting statistics for Java programs that run in a JVM

Statistics for Java programs that run in a JVM are collected separately from statistics for other programs, because the JVM programs are not loaded by CICS. CICS does not collect statistics for JVM programs when a COLLECT or PERFORM STATISTICS PROGRAM command is issued; to see them, you need to use the COLLECT or PERFORM STATISTICS JVMPROGRAM command instead.

However, when you browse program names using the INQUIRE PROGRAM command, JVM programs are found. If you have an application that collects statistics for programs by browsing with the INQUIRE PROGRAM command, and then issuing the COLLECT STATISTICS PROGRAM command for the program names that it finds, the application will now receive a "not found" response when it attempts to collect statistics for any JVM programs. (Previously, zeros would have been returned as statistics values for these programs.)

To avoid receiving this response, make the application check the RUNTIME value for each program name that it finds. If the RUNTIME value is JVM, the application should not issue the COLLECT STATISTICS PROGRAM command for that program name. If you want to see the statistics for programs with a RUNTIME value of JVM, you can make the application issue the COLLECT STATISTICS JVMPROGRAM command for those programs. Note that the statistics information that is collected for JVM programs is not the same as that collected for other programs.

New and revised values in DFHSTIDS (statistics record identifiers)

The revised list of the statistics record identifiers, as described in the common statistics record copybook, DFHSTIDS, is shown in the CICS Customization Guide.

The values in that list, which are new or revised for CICS TS Version 3 Release 1, are shown in Figure 3.

Figure 3. New Statistics data record copybooks related to STID name and value
STID      STID
Symbolic  Value  Copybook      Type of record
name
 
STIWBG      101  DFHWBEDS      URIMAPs (Global) ID
STIWBR      104  DFHWBRDS      URIMAPs (Resource) ID
STIPIR      105  DFHPIRDS      PIPELINE (Resource) ID
STIPIW      106  DFHPIWDS      WEBSERVICE (Resource) ID

For details of all the statistics, and all the supporting copybooks, see the CICS Performance Guide.


1.
Data is not written to SMF by DFHMNTDS. It is only relevant when used through the COLLECT STATISTICS interface.

[[ Contents Previous Page | Next Page Index ]]