Programs report

The Programs report is produced using a combination of the EXEC CICS INQUIRE PROGRAM and EXEC CICS EXTRACT STATISTICS PROGRAM commands. The statistics data was mapped by the DFHLDRDS DSECT.

Information about Java™ programs that run in a JVM is handled differently from information about other programs, because JVM programs are not loaded by CICS®. For JVM programs, the Programs Report shows only the program name, execution key, and use count. This information is obtained using the EXEC CICS EXTRACT STATISTICS JVMPROGRAM command. For full information about JVM programs, see JVM Programs report.

Table 1. Fields in the Programs report
Field Heading Description
Program Name The name of the program.

Source field: EXEC CICS INQUIRE PROGRAM

Data Loc The storage location that the program is able to accept.

Source field: EXEC CICS INQUIRE PROGRAM DATALOCATION

Exec Key The access key in which the program will execute.

Source field: EXEC CICS INQUIRE PROGRAM EXECKEY

Times Used 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.

Source field: LDRTU

Times Fetched The number of times the loader domain has issued an MVS LOAD request to load a copy of the program from the DFHRPL or dynamic LIBRARY concatenation into CICS managed storage.

Source field: LDRFC

Total Fetch Time The time taken to perform all fetches for this program.

Source field: LDRFT

Average Fetch Time The average time taken to perform a fetch of the program.

Source field: (LDRFT / LDRFC)

LIBRARY name The name of the LIBRARY from which the program was just loaded (non-LPA resident modules only).

Source field: LDRLBNM

LIBRARY Offset The offset into the DFHRPL or dynamic LIBRARY concatenation of the data set from which the program was last loaded (non-LPA resident modules only). If this field is blank, it indicates that the program has never been loaded, or that it has not been loaded from the LIBRARY. A value of zero appearing in the report indicates that the program has been loaded at least once from the LIBRARY, and has an offset value of zero.

Source field: LDRRPLO

Times Newcopy The number of times a NEWCOPY has been requested against this program.

Source field: LDRTN

Times Removed 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.

Source field: LDRRPC

Program Size The size of the program in bytes, if known (otherwise zero).

Source field: LDRPSIZE

Program Location The location of the current storage resident instance of the program, if any. It has one of the following values:
  • None - No current copy
  • CDSA - Current copy is in the CDSA
  • PCDSA - Current copy is in the PCDSA
  • SDSA - Current copy is in the SDSA
  • RDSA - Current copy is in the RDSA
  • ECDSA - Current copy is in the ECDSA
  • EPCDSA - Current copy is in the EPCDSA
  • ESDSA - Current copy is in the ESDSA
  • ERDSA - Current copy is in the ERDSA
  • LPA - Current copy is in the LPA
  • ELPA - Current copy is in the ELPA

Source field: LDRLOCN