LIBRARYs, including DFHRPL - LIBRARY
The LIBRARY (LIBRARY) views display information about currently installed LIBRARYs. A LIBRARY represents a PDS/PDSE or sequence of concatenated PDS/PDSEs containing program entities that make up an application or group of applications, although the actual contents are determined by the systems programmer. DFHRPL is a special example of a LIBRARY that cannot be altered in a running CICS system.
Supplied views
To access from the main menu, click:
| View | Notes |
|---|---|
| LIBRARY EYUSTARTLIBRARY.DETAIL1 |
Detailed information about the resource signature. |
| LIBRARY EYUSTARTLIBRARY.DETAILED |
Detailed information about a selected LIBRARY. |
| LIBRARY EYUSTARTLIBRARY.DISABLE |
Disable the LIBRARY. When disabled, a LIBRARY is not included in the LIBRARY search order. The data sets in this LIBRARY concatenation will not be searched for program artifacts to load. Note: The LIBRARY named DFHRPL cannot be disabled or discarded. |
| LIBRARY EYUSTARTLIBRARY.DISCARD |
Discard a LIBRARY from the CICS system where it is installed. A LIBRARY must be disabled before it can be discarded. Note: The LIBRARY named DFHRPL cannot be disabled or discarded. |
| LIBRARY EYUSTARTLIBRARY.ENABLE |
Enable the LIBRARY. When enabled, a LIBRARY is included in the LIBRARY search order. The data sets in this LIBRARY concatenation will be searched for program artifacts to load. Note: If an ENABLE fails, the LIBRARY remains disabled. |
| LIBRARY EYUSTARTLIBRARY.SET |
Set LIBRARY attributes according to new values specified in input fields. |
| LIBRARY EYUSTARTLIBRARY.TABULAR |
Tabular information about currently installed LIBRARYs. |
Actions
| Action | Description |
|---|---|
| DISABLE | Disable the LIBRARY. When disabled, a LIBRARY is not included in the LIBRARY search order. The data sets in this LIBRARY concatenation will not be searched for program artifacts to load. Note: The LIBRARY named DFHRPL cannot be disabled or discarded. |
| DISCARD | Discard a LIBRARY from the CICS system where it is installed. A LIBRARY must be disabled before it can be discarded. Note: The LIBRARY named DFHRPL cannot be disabled or discarded. |
| ENABLE | Enable the LIBRARY. When enabled, a LIBRARY is included in the LIBRARY search order. The data sets in this LIBRARY concatenation will be searched for program artifacts to load. Note: If an ENABLE fails, the LIBRARY remains disabled. |
| GET | (Optional) Specify the name of the platform from which installed libraries should be displayed. |
| SET | Set LIBRARY attributes according to new values specified in input fields. |
Fields
| Field | Attribute name | Description |
|---|---|---|
| BAS resource definition version | BASDEFINEVER | The BAS version number of this definition. |
| Last modification agent | CHANGEAGENT | The change agent identifier that made the last modification.
|
| Last modification agent release | CHANGEAGREL | The CICS release level of the agent that made the last modification to the resource definition. |
| Last modification time | CHANGETIME | The local date and time when the definition was last changed. |
| Last modification user ID | CHANGEUSRID | The user ID that made the last modification to the resource definition. |
| Critical status | CRITSTATUS | Specifies whether the LIBRARY is critical to the start up of CICS. Values are:
|
| Source of the resource definition | DEFINESOURCE | The source of the definition, depending on which agent made the last change. |
| Creation time | DEFINETIME | The local date and time when the resource definition record was created on DFHCSD or EYUDREP. |
| Enable status | ENABLESTATUS | Indicates whether the LIBRARY is included in the overall LIBRARY search order. Values are:
|
| Installation agent | INSTALLAGENT | The install agent identifier that made the installation.
|
| Installation time | INSTALLTIME | The local date and time when the definition was installed. |
| Installation user ID | INSTALLUSRID | The user ID that installed the resource definition. |
| LIBRARY name | NAME | The name of the LIBRARY. |
| Number of DSNAMEs | NUMDSNAMES | The number of data sets in the LIBRARY concatenation. For a dynamically defined LIBRARY, this will be the number of non-blank DSNAMExx values, and cannot be a value larger than 16. For the statically defined DFHRPL, this will be the number of data sets in the concatenation, and can be a value larger than 16. |
| Program load count | PGMLOADCNT | The number of program loads from data sets in this LIBRARY. |
| Ranking | RANKING | The number which determines where this LIBRARY will appear in the overall search order, when enabled. A lower number indicates that this LIBRARY will be searched for programs to load before other LIBRARY resources with higher ranking numbers. The ranking can be thought of as being somewhat analogous to the concatenation number of a data set within a LIBRARY concatenation, although it differs in allowing duplicate values. RANKING can take values between 1 and 99, with a default of 50. A value of 10 is reserved for DFHRPL, the static LIBRARY, and cannot be specified. If this LIBRARY contains a discrete application in one or more data sets, then its ranking relative to other LIBRARY resources is not usually significant, and the default ranking value can be accepted. Exceptions to this are where this LIBRARY contains a program artifact which is required to replace one that also appears in another LIBRARY, in which case the ranking of this LIBRARY needs to be a smaller value than that of the other LIBRARY to ensure that the program artifact is loaded from this LIBRARY. The DFHRPL concatenation is assigned a predefined ranking of 10. This value cannot be changed. It allows dynamically defined LIBRARY resources to be placed before the DFHRPL concatenation in the overall search order by giving them a ranking value smaller than 10. Note:
|
| Search position | SEARCHPOS | The current absolute position of this LIBRARY in the overall LIBRARY search order. The first LIBRARY in the search order will have a SEARCHPOS of 1, the next LIBRARY will have a SEARCHPOS of 2, and so on. The SEARCHPOS 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. If the LIBRARY is disabled then the SEARCHPOS will be 0 indicating that the LIBRARY does not participate in the overall search. |