LIBRARY resources

Use the LIBRARY resource to define the physical and operational characteristics of a dynamic program LIBRARY concatenation.

The LIBRARY definition includes attributes that provide the name of the data set, or sets, within the LIBRARY resource and other details about the operational status of the LIBRARY.

DFHRPL is a special example of a LIBRARY which cannot be altered in a running CICS® system, and does not appear as a resource in CEDA.

Data sets in a dynamic program LIBRARY concatenation can reside in the extended addressing space (EAS) of an extended address volume (EAV) DASD volume.

There is no 'group commit' for LIBRARY resources. Each LIBRARY in a CSD group is committed separately when the group is installed. To achieve an effect similar to group install, you can use the Disabled status to install a set of LIBRARY resources which would then be SET to an Enablestatus of Enabled when all resources are installed.

LIBRARY resources in CICS bundles

You can use a CICS bundle to create, edit, and install a LIBRARY resource definition. If you create a LIBRARY resource in this way, you must use the CICS bundle to manage the lifecycle of that resource, and you cannot manage the resource independently. You can inquire on a LIBRARY resource that is dynamically generated by a CICS bundle, by using the EXEC CICS INQUIRE LIBRARY or CEMT INQUIRE LIBRARY command. However, you cannot issue SET or DISCARD commands against a LIBRARY resource that is dynamically generated by a CICS bundle. You must issue the commands against the BUNDLE resource, and CICS applies them to the LIBRARY resource.

For more information about defining resources in CICS bundles, see Defining CICS bundles.

Private LIBRARY resources for applications

The LIBRARY resource is supported as a private resource for an application version. Each version of an application should include a private LIBRARY resource that represents a version-specific data set containing the load modules for the application.

For a private LIBRARY resource that is defined in a CICS bundle that is packaged and installed as part of an application bundle or application binding bundle, the name of the LIBRARY resource is not used as the DD name for the LIBRARY concatenation of data sets. Instead, CICS requests a unique DD name for the LIBRARY concatenation of data sets when the application is installed on the platform. The resource name can therefore be the same as LIBRARY names used elsewhere in the installation, or by different versions of the application. CICS issues message DFHLD0518 to state the DD name that z/OS® has generated for the LIBRARY concatenation. You can also view the data set names for an installed application in the CICS Explorer®.

For more information about private resources, see Private resources for application versions.