Private programs: Resource statistics
You can retrieve statistics for private programs for applications that are deployed on platforms by using the EXEC CICS EXTRACT STATISTICS PROGRAM command. Statistics for private programs for applications that are deployed on platforms are mapped by the DFHLDPDS DSECT. These resource statistics contain the resource data collected by the loader for each private program for applications deployed on platforms.
For public programs, their resource statistics are mapped by the DFHLDRDS DSECT. For details of the DSECT and DFHSTUP report for public programs, see Public programs: Resource statistics. Programs that are defined as application entry points are not identified in the program loader statistics.
| DFHSTUP name | Field name | Description |
|---|---|---|
| Platform | LDP_PLATFORM_NAME | The name of the platform where the application that uses the private programs is deployed.
Reset characteristic: not reset |
| Application | LDP_APPLICATION_NAME | The name of the application that uses the private programs. Reset characteristic: not reset |
| Major version | LDP_APPL_MAJOR_VER | The major version number of the application that uses the private programs. Reset characteristic: not reset |
| Minor version | LDP_APPL_MINOR_VER | The minor version number of the application that uses the private programs. Reset characteristic: not reset |
| Micro version | LDP_APPL_MICRO_VER | The micro version number of the application that uses the private programs.
Reset characteristic: not reset |
| Program name | LDPPNAME | The name of the program. Reset characteristic: not reset |
| Times used | LDPTU | 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 | LDPFC | 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 | LDPFT | 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 | LDPRPLO | 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 | LDPTN | The number of times a NEWCOPY has been requested against this program.
Reset characteristic: reset to zero |
| Program size | LDPPSIZE | The size of the program in bytes, if known (otherwise zero). Reset characteristic: not reset |
| Times removed | LDPRPC | 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 | LDPLOCN | 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 | LDPLBNM | The name of the LIBRARY from which the program was loaded. Reset characteristic: not reset |
| LIBRARY Dsname | LDPLBDNM | The name of the data set in the LIBRARY from which the program was
loaded. Reset characteristic: not reset |
| Operation | LDP_OPERATION_NAME | For programs that are declared as application entry points, the application
operation that is named for the application entry point. Reset characteristic: not reset |
| DFHSTUP value | DSECT value | Meaning |
|---|---|---|
| NONE | LDPNOCO (X'00') | No current copy |
| CDSA | LDPCDCO (X'01') | Current copy in the CDSA |
| PCDSA | LDPPCDCO (X'0B') | Current copy in the PCDSA |
| PUDSA | LDPPUDCO (X'0C') | Current copy in the PUDSA |
| SDSA | LDPSDCO (X'08') | Current copy in the SDSA |
| LPA | LDPLPACO (X'03') | Current copy in the LPA |
| ECDSA | LDPECDCO (X'04') | Current copy in the ECDSA |
| EPCDSA | LDPEPCDCO (X'0D') | Current copy in the EPCDSA |
| EPUDSA | LDPEPUDCO (X'0E') | Current copy in the EUPDSA |
| ESDSA | LDPESDCO (X'09') | Current copy in the ESDSA |
| ERDSA | LDPERDCO (X'06') | Current copy in the ERDSA |
| RDSA | LDPRDCO (X'0A') | Current copy in the RDSA |