Public programs: Resource statistics
You can retrieve statistics for public programs by using the EXEC CICS EXTRACT STATISTICS PROGRAM command. Statistics for public programs are mapped by the DFHLDRDS DSECT. Program resource statistics for public programs contain the resource data collected by the loader for each public program.
For private programs for applications that are deployed on platforms, their resource statistics are mapped by the DFHLDPDS DSECT, which has information about the application for which the program was loaded. For details of the DSECT and DFHSTUP report for private programs, see Private programs: Resource statistics. Programs that are defined as application entry points are not identified in the program loader statistics.
| DFHSTUP name | Field name | Description |
|---|---|---|
| Program name | LDRPNAME | The name of the program. Reset characteristic: not reset |
| Times used | LDRTU | 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 | The number of times the loader domain has issued an MVS LOAD request to load a copy of the
program from the static DFHRPL or dynamic LIBRARY concatenation into CICS managed storage. Reset characteristic: reset to zero |
| NOT IN THE DFHSTUP REPORT | LDRFT | 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 | 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 |
| Lbry ofst | LDRRPLO | The offset into the static DFHRPL or dynamic LIBRARY DD concatenation
of the data set from which the program is currently loaded or will be 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 | The number of times a NEWCOPY has been requested against this program.
Reset characteristic: reset to zero |
| Program size | LDRPSIZE | The size of the program in bytes, if known (otherwise zero). Reset characteristic: not reset |
| Times removed | LDRRPC | 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 |
| Current Location | LDRLOCN | The location of the current storage resident instance of the program, if any. It
has one of the values shown in Table 2. Reset characteristic: not reset |
| LIBRARY name | LDRLBNM | The name of the LIBRARY from which the program was loaded. Reset characteristic: not reset |
| LIBRARY Dsname | LDRLBDNM | The name of the data set in the LIBRARY from which the program was
loaded. 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 |