LIBRARY - Private: Resource statistics

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

These statistics fields contain the resource data collected by the loader for each dynamic program LIBRARY concatenation for applications that are deployed on platforms.

Statistics for private LIBRARY resources for applications that are deployed on platforms are mapped by the DFHLDYDS DSECT. For public LIBRARY resources, these statistics are mapped by the DFHLDBDS DSECT. For details of the DSECT and DFHSTUP report for public LIBRARY resources, see LIBRARY - Public: Resource statistics.

Table 1. LIBRARY - Private: Resource statistics
DFHSTUP name Field name Description
Platform LDY_LIBRARY_PLATFORM_NAME The name of the platform where the application that uses the private LIBRARY resources is deployed.

Reset characteristic: not reset

 

Application LDY_LIBRARY_APPLICATION_NAME The name of the application that uses the private LIBRARY resources.

Reset characteristic: not reset

 

Major version LDY_LIBRARY_APPL_MAJOR_VER The major version number of the application that uses the private LIBRARY resources.

Reset characteristic: not reset

 

Minor version LDY_LIBRARY_APPL_MINOR_VER The minor version number of the application that uses the private LIBRARY resources.

Reset characteristic: not reset

 

Micro version LDY_LIBRARY_APPL_MICRO_VER The micro version number of the application that uses the private LIBRARY resources.

Reset characteristic: not reset

 

LIBRARY name LDY_LIBRARY_NAME The name of the LIBRARY resource.

Reset characteristic: not reset

 

Search position LDY_LIBRARY_SEARCH_POS

The current absolute position of this library in the overall library search order. The first enabled library in the search order has a search position of 1, the next library has 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 LDY_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 LDY_LIBRARY_CRITICAL This attribute does not apply to private LIBRARY resources for applications deployed on platforms.

Reset characteristic: not reset

 

Enable status LDY_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 LDY_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 LDY_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 LDY_LIBRARY_CHANGE_TIME The time stamp (STCK) in local time of the CSD record change.

Reset characteristic: not reset

 

Not in DFHSTUP report LDY_LIBRARY_CHANGE_USERID The user ID that ran the CHANGE_AGENT.

Reset characteristic: not reset

 

Not in DFHSTUP report LDY_LIBRARY_CHANGE_AGENT The agent that was used to make the last change.

Reset characteristic: not reset

 

Not in DFHSTUP report LDY_LIBRARY_INSTALL_AGENT The agent that installed the resource.

Reset characteristic: not reset

 

Not in DFHSTUP report LDY_LIBRARY_INSTALL_TIME The time stamp (STCK) in local time when the resource was installed.

Reset characteristic: not reset

 

Not in DFHSTUP report LDY_LIBRARY_INSTALL_USERID The user ID that installed the resource.

Reset characteristic: not reset

 

Number Dsnames LDY_LIBRARY_NUMBER_DSNAMES 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 LDY_LIBRARY_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.