LIBRARY definitions - LIBDEF

The Library definition (LIBDEF) views display information about dynamic program library definitions. It is intended that each LIBRARY represents a discrete application, with the program artifacts required by that application being held in a small number of data sets. If an application requires more than 16 data sets, then an additional LIBRARY resource or resources can be defined with ranking values which ensure the data sets are searched in the required order if the ordering is significant. The enablement status could be used to ensure that the collection of LIBRARY resources is introduced into the search order in the required manner.

Supplied views

To access from the main menu, click:

Administration views > CICS resource definitions > LIBRARY definitions

Table 1. Views in the supplied **LIBRARY definitions** (LIBDEF) view set
View	Notes
LIBRARY definitions EYUSTARTLIBDEF.ADDTOGRP	Add one or more LIBRARY definitions to a resource group.
LIBRARY definitions EYUSTARTLIBDEF.CREATE	Create a LIBRARY definition and add it to the data repository.
LIBRARY definitions EYUSTARTLIBDEF.DETAILED	Detailed information about a selected LIBRARY definition.
LIBRARY definitions EYUSTARTLIBDEF.INSTALL	Install a LIBRARY definition in an active system.
LIBRARY definitions EYUSTARTLIBDEF.REMOVE	Remove a LIBRARY definition from the data repository.
LIBRARY definitions EYUSTARTLIBDEF.TABULAR	Tabular information about all LIBRARY definitions for the current context.

Actions

Table 2. Actions available for LIBDEF views
Action	Description
ADDTOGRP	Add one or more LIBRARY definitions to a resource group.
CREATE	Create a LIBRARY definition and add it to the data repository.
CSDCOPY	Copy a CICS CSD resource definition.
CSDINSTALL	Install a CICS CSD resource definition into an active system.
INSTALL	Install a LIBRARY definition in an active system.
REMOVE	Remove a LIBRARY definition from the data repository.
UPDATE	Update a LIBRARY definition in the data repository.

Fields

Table 3. Fields in LIBDEF views
Field	Attribute name	Description
Last modification agent	CHANGEAGENT	The change agent identifier that made the last modification. CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command. CSDBATCH - The resource was last changed by a DFHCSDUP job. DREPAPI - Resource was last changed by a CICSPlex SM API command. N_A - Resource was created or last updated prior to CICS TS Version 4 Release 1 and support for resource signatures.
Last modification agent release	CHANGEAGREL	The CICS release level of the agent that made the last modification.
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.
Time created	CREATETIME	The local date and time when the definition was created.
Critical status	CRITICAL	Specifies whether the LIBRARY is critical to the startup of CICS. Values are: YES The LIBRARY is critical to CICS startup. If the LIBRARY cannot be successfully installed during CICS startup for any reason, then a GO or CANCEL message will be issued. This will allow the operator to decide whether to override the criticality and allow CICS to start or not. If CICS is allowed to continue, the LIBRARY will be installed in a 'disabled' status, unless installation was not possible at all; for example, due to a short-on-storage condition. If the reply is to continue with the startup, the LIBRARY will not be recatalogued as NONCRITICAL, so the critical status should be explicitly set to NONCRITICAL if it is decided that the LIBRARY should not 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, then the LIBRARY will be left in an installed but disabled state and a warning message will be issued, but CICS startup will continue.
CSD group	CSDGROUP	The name of the CSD group for this CICS resource definition. This field is ignored for BAS definitions.
Version	DEFVER	The version number of the BAS resource definition, from 1 to 15. This field is ignored for CICS CSD resource definitions.
Description code page	DESCCODEPAGE	The code page of the description field. This field is ignored for CICS CSD resource definitions.
Description	DESCRIPTION	A description of the LIBRARY definition.
Data set name 01	DSNAME01	The first data set in the concatenation, if specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distributed across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 02	DSNAME02	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 03	DSNAME03	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 04	DSNAME04	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 05	DSNAME05	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 06	DSNAME06	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 07	DSNAME07	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 08	DSNAME08	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 09	DSNAME09	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 10	DSNAME10	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 11	DSNAME11	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 12	DSNAME12	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 13	DSNAME13	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 14	DSNAME14	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 15	DSNAME15	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Data set name 16	DSNAME16	The next data set in the concatenation, if specified, or first if no previous DSNAMEnn is specified. This must be a valid 44-character fully qualified dataset name, and a disposition status of SHR is assumed. At least one DSNAMEnn must be specified, but this does not have to use the first position (DSNAME01), and the data set names can be distribute across the DSNAME01 to DSNAME16 attributes in a way which would make it easy to insert additional data set names into the definition.
Name	NAME	The 8-character name of the LIBRARY resource.
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: It should be regarded as a temporary situation to have LIBRARY resources with a ranking that places them before DFHRPL in the search order. Although the predefined DFHRPL ranking of 10 is intended to discourage the placing of LIBRARY resources before DFHRPL in the search order, it does not limit the total number of LIBRARY resources that can be placed before DFHRPL providing the ranking between the LIBRARY resources themselves is not significant. A ranking of less than 10 will trigger a message, where possible, to inform the user that this LIBRARY will appear ahead of DFHRPL in the search order. A ranking of less than 10 will not take effect until the program is first loaded, or a NEWCOPY or PHASEIN request is issued, to cause the program to be loaded from the dynamic LIBRARY in preference to DFHRPL, unless the program is not in the DFHRPL concatenation, in which case there would be no reason to use a ranking of less than 10.
Enabled status	STATUS	Indicates whether the LIBRARY is included in the overall LIBRARY search order. Values are: DISABLED The 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. ENABLED The LIBRARY is included in the LIBRARY search order. The data sets in this LIBRARY concatenation will be searched for program artifacts to load.
User data area 1	USERDATA1	Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 2	USERDATA2	Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 3	USERDATA3	Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.