LIBRARY - Public: Resource statistics

You can retrieve statistics for public LIBRARY resources by using the EXEC CICS EXTRACT STATISTICS LIBRARY system command. They are mapped by the DFHLDBDS DSECT.

These statistics fields contain the resource data collected by the loader for each dynamic program LIBRARY concatenation.

Statistics for public LIBRARY resources are mapped by the DFHLDBDS DSECT. For private LIBRARY resources for applications that are deployed on platforms, these statistics are mapped by the DFHLDYDS DSECT, which has information about the application for which the LIBRARY resource was loaded. For details of the DSECT and DFHSTUP report for private LIBRARY resources, see LIBRARY - Private: Resource statistics.

Table 1. LIBRARY - Public: Resource statistics
DFHSTUP name	Field name	Description
LIBRARY name	LDB_LIBRARY_NAME	The name of the library. Reset characteristic: not reset
Search position	LDB_LIBRARY_SEARCH_POS	The current absolute position of this library in the overall library search order. The first enabled library in the search order will have a search position of 1, the next library will have a search position of 2, and so on. The search position is not the same as the ranking, although its value is determined by the relative ranking values of the various library resources in the system. The search position values, relative to other library resources with the same ranking value, are indeterminate, but their search position values relative to each other are retained across a warm or emergency restart. The relative search position values of library resources with the same ranking are not guaranteed to be the same after a cold or initial start. If the library is disabled, the search position is 0, indicating that the library does not participate in the overall search. Reset characteristic: not reset
Ranking	LDB_LIBRARY_RANKING	Indicates where this library appears in the overall library search order, relative to other library concatenations. A lower number indicates that this library is searched for programs to load before other library resources with higher ranking numbers. Reset characteristic: not reset
Critical	LDB_LIBRARY_CRITICAL	Indicates whether the library is critical to CICS starting. The values are as follows: Yes The LIBRARY is critical to CICS starting. If the LIBRARY cannot be successfully installed during CICS startup for any reason, then a `GO` or `CANCEL` message is issued. The operator decides whether to override the critical status and allow CICS to start. If CICS is allowed to continue, the LIBRARY is installed in a DISABLED status, unless installation was not possible at all; for example, because of a short-on-storage condition. If the reply is to continue with the startup, the LIBRARY is not recataloged as NONCRITICAL, so the critical status is explicitly set to NONCRITICAL if it is decided that the LIBRARY is not to be regarded as critical in future. No The LIBRARY is not critical to CICS startup. If the LIBRARY cannot be successfully installed during CICS startup, the LIBRARY is left in an installed but disabled state and a warning message is issued, but CICS startup continues. Reset characteristic: not reset
Enable status	LDB_LIBRARY_ENABLE_STATUS	Identifies whether the LIBRARY is included in the overall LIBRARY search order. The values are as follows: DISABLED The LIBRARY is disabled, and is not currently included in the LIBRARY search order. The data sets in this LIBRARY concatenation are not searched for program artifacts to load. DISABLING A request to disable the LIBRARY was received, but is still being processed. ENABLED The LIBRARY is enabled, and is currently included in the LIBRARY search order. The data sets in this LIBRARY concatenation searched for program artifacts to load. ENABLING A request to enable the LIBRARY was received, but is still being processed. DISCARDING A request to discard the LIBRARY from the CICS system was received, but is still being processed. Reset characteristic: not reset
Program loads	LDB_LIBRARY_PROG_LOADS	The number of times the loader has issued an MVS LOAD request to load programs from the DFHRPL or dynamic LIBRARY concatenation into CICS-managed storage. Reset characteristic: reset to zero
Not in DFHSTUP report	LDB_LIBRARY_DEFINE_SOURCE	The source of the resource definition. Its value depends on the change agent. For more information, see Summary of the resource signature field values. Reset characteristic: not reset
Not in DFHSTUP report	LDB_LIBRARY_CHANGE_TIME	The time stamp (STCK) in local time of the CSD record change. Reset characteristic: not reset
Not in DFHSTUP report	LDB_LIBRARY_CHANGE_USERID	The user ID that ran the CHANGE_AGENT. Reset characteristic: not reset
Not in DFHSTUP report	LDB_LIBRARY_CHANGE_AGENT	The agent that was used to make the last change. Reset characteristic: not reset
Not in DFHSTUP report	LDB_LIBRARY_INSTALL_AGENT	The agent that installed the resource. Reset characteristic: not reset
Not in DFHSTUP report	LDB_LIBRARY_INSTALL_TIME	The time stamp (STCK) in local time when the resource was installed. Reset characteristic: not reset
Not in DFHSTUP report	LDB_LIBRARY_INSTALL_USERID	The user ID that installed the resource. Reset characteristic: not reset
Number Dsnames	LDB_LIBRARY_NUMDSNAMES	The number of data sets in the LIBRARY concatenation. For a dynamically defined LIBRARY, this number indicates the non blank DSNAMExx values, and cannot be a value larger than 16. For the statically defined DFHRPL, this number indicates the data sets in the concatenation, and can be a value larger than 16. Reset characteristic: not reset
Concatenation	Not in the DSECT; added when report is formatted	The concatenation number of the data set in the LIBRARY concatenation. Reset characteristic: not reset
LIBRARY Dsname	LDB_DSNAME	The 44-character name of each data set in the LIBRARY concatenation. If this library is dynamically defined, these are the data sets specified on the LIBRARY definition, all but one of which can be blank. If this DFHRPL is the statically defined one, these are the first 16 data sets in the DFHRPL concatenation, or as many data sets as are specified up to 16, with the remaining DSNAMExx fields being blank. Reset characteristic: not reset

The resource statistics fields for the resource signature

The resource signature captures details about when the resource is defined, installed, and last changed. The resource statistics field names for the resource signature end in CHANGE_AGENT, CHANGE_TIME, CHANGE_USERID, DEFINE_SOURCE, INSTALL_AGENT, INSTALL_TIME, and INSTALL_USERID. For detailed information about the content of the resource signature fields, see Summary of the resource signature field values.