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.
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.
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
|
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
|
Summary statistics are not available online.
These statistics fields contain the summary resource data statistics for the loader for each program.
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.
|