Program statistics

This section contains the following statistics:

Information about Java™ programs that run in a JVM is not included in the Program statistics, because JVM programs are not loaded by CICS®. For this information, see JVM program statistics.

Programs: Resource statistics

These statistics fields contain the resource data collected by the loader for each program. They are available online using the EXEC CICS COLLECT STATISTICS PROGRAM command, and are mapped by the DFHLDRDS DSECT.

Table 114. Programs: Resource statistics
DFHSTUP name Field name Description
Program name LDRPNAME is the name of the program.

Reset characteristic: not reset

 

Times used LDRTU is the number of times CICS tasks within the system have issued load requests to the loader domain to obtain access to a usable instance of this program. These load requests may cause the loader domain to issue an MVS™ LOAD.

Reset characteristic: reset to zero

 

Fetch count LDRFC is the number of times the loader domain has issued an MVS LOAD request to load a copy of the program from the DFHRPL library concatenation into CICS managed storage.

Reset characteristic: reset to zero

 

NOT IN THE DFHSTUP REPORT LDRFT is the time taken to perform all fetches. The DSECT field contains a four-byte value that expresses the time in 16-microsecond units.

Reset characteristic: reset to zero

 

Average fetch time Calculated by DFHSTUP is the average time taken to perform a fetch of the program. The DFHSTUP report expresses this time as minutes:seconds.decimals.

Reset characteristic: reset to zero

 

RPL offset LDRRPLO is the offset into the DFHRPL DD concatenation of the library from which the program was last loaded or is loaded when next required non-LPA resident modules only.
Note:
The offset values begin with zero for the first partitioned data set in the concatenation and thus this field may not be used to deduce whether a copy of the program is available to the loader domain.

Reset characteristic: not reset

 

NEWCOPY count LDRTN is the number of times a NEWCOPY has been requested against this program.

Reset characteristic: reset to zero

 

Program size LDRPSIZE is the size of the program in bytes, if known (otherwise zero).

Reset characteristic: not reset

 

Times removed LDRRPC is the number of times an instance of this program has been removed from CICS managed storage due to the actions of the Dynamic Program Storage Compression (DPSC) mechanism.

Reset characteristic: reset to zero

 

Location LDRLOCN is the location of the current storage resident instance of the program, if any. It has one of the values shown in Table 115 below.

Reset characteristic: not reset

 

Table 115. Values for Location (LDRLOCN)
DFHSTUP value DSECT value Meaning
NONE LDRNOCO (X'00') No current copy

 

CDSA LDRCDCO (X'01') Current copy in the CDSA

 

SDSA LDRSDCO (X'08') Current copy in the SDSA

 

LPA LDRLPACO (X'03') Current copy in the LPA

 

ECDSA LDRECDCO (X'04') Current copy in the ECDSA

 

ESDSA LDRESDCO (X'09') Current copy in the ESDSA

 

ERDSA LDRERDCO (X'06') Current copy in the ERDSA

 

RDSA LDRRDCO (X'0A') Current copy in the RDSA

 

Programs: Summary resource statistics

Summary statistics are not available online.

These statistics fields contain the summary resource data statistics for the loader for each program.

Table 116. Programs: Summary resource statistics
DFHSTUP name Description
Program name is the name of the program.

 

Times used is the total number of times CICS tasks within the system have issued load requests to the loader domain to obtain access to a usable instance of this program. These load requests may cause the loader domain to issue MVS LOAD requests to obtain access to usable instances of this program.

 

Fetch count is the total number of times the loader domain has issued an MVS LOAD request to load a copy of the program from the DFHRPL library concatenation into CICS managed storage.

 

Average fetch time is the average time taken to perform a fetch of the program. The DFHSTUP report expresses this time as minutes:seconds.decimals.

 

NEWCOPY count is the total number of times a NEWCOPY has been requested against this program.

 

Times removed is the total number of times an instance of this program has been removed from CICS managed storage due to the actions of the Dynamic Program Storage Compression (DPSC) mechanism.

 

Related reference
Back to full list of statistics and DFHSTUP reports
Appendix A. CICS statistics tables
Interpreting these statistics
Interpreting program statistics
DFH0STAT reports for these statistics
Programs Report
Program Totals Report
DFHRPL Analysis Report
Programs by DSA and LPA Report
[[ Contents Previous Page | Next Page Index ]]