Discovering information about LIBRARY resources in a CICS system

Discover information about LIBRARY resources.

About this task

Discover information about LIBRARY resources, such as the following:
  • Which LIBRARY resources are installed in CICS®.
  • The current search order through the active LIBRARY resources in CICS ; for example, installed and enabled LIBRARY resources.
  • The relative positions of two LIBRARY concatenations in the search order.
  • Which LIBRARY resources are critical.
  • The data sets that are defined to a LIBRARY concatenation.

A dynamic program LIBRARY concatenation that is defined and installed as part of an application deployed on a platform is private to that version of that application. You can inquire on or browse private resources using the EXEC CICS INQUIRE LIBRARY system programming command. By default, CICS searches for the resources that are available to the program where the EXEC CICS INQUIRE LIBRARY command is issued. You can also choose to browse private resources for a specified application. For more information about browsing private resources, including examples of browsing in a different application context, see Browsing resource definitions.

Procedure

  • In a running CICS system, issue the EXEC CICS INQUIRE LIBRARY command, or for public LIBRARY resources only, use the INQUIRE LIBRARY command in the CEMT transaction.
    If you do not specify a LIBRARY or properties, your inquiry shows all installed LIBRARY resources that are available to the program where the EXEC CICS INQUIRE command is issued. If you specify some properties of the LIBRARY resources, a subset of installed LIBRARY resources are shown. If you name a specific LIBRARY, details for that LIBRARY are shown. The detailed view of a LIBRARY shows the data sets in its concatenation.
  • In the CICSPlex® SM WUI, from the main menu, click CICS operations > Program operations views > LIBRARYs, including DFHRPL.
    Click the Number of DSNAMEs field name to display the LIBRARY data set names records.
  • In the CICS Explorer® , click Operations on the menu bar and select LIBRARYs , or select LIBRARY DS Name to display the LIBRARY data set names records.
    If you are connected to a CICS system, the resources displayed in the view are the resources in that system. If you are connected to a CICSplex, the resources displayed in the view depend on the browse scope you have set.
  • For an application that is deployed on a platform, in the Cloud Explorer view in the CICS Explorer, double-click the installed application to open the application descriptor editor. Select the Resources tab, then select the Libraries tab to view the private LIBRARY resources for the application.
    You can filter the resources by the CICS system where they are installed, or by the CICS bundle where they are defined.
    Select the Library DS Names tab to view the DD names that z/OS has generated for the LIBRARY concatenation of data sets for the private LIBRARY resources.

Results

The inquiry shows the critical status and enablement status of the LIBRARY resources, their rankings, and also their absolute position in the overall search order. Disabled LIBRARY resources appear in the list but do not participate in the search order. You can compare the search position numbers of two LIBRARY concatenations to determine which is before the other in the overall search order.