Programs - Public: Resource statistics
You can retrieve statistics for public programs by using the EXEC CICS EXTRACT STATISTICS PROGRAM system command. They are mapped by the DFHLDRDS DSECT.
Statistics for public programs are mapped by the DFHLDRDS DSECT. For private programs for applications that are deployed on platforms, these 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 Programs - Private: 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
|