CEMT INQUIRE LIBRARY

Retrieve information about LIBRARY resources.

In the CICS Explorer, the Libraries operations view provides a functional equivalent to this command.

Description

The CEMT INQUIRE LIBRARY command returns information about the LIBRARY resources that are defined to your system.

You can reset the options either by typing the SET command or by overtyping at the appropriate place on the INQUIRE screen.

A dynamic program LIBRARY concatenation that is defined as part of an application installed on a platform is private to that version of that application. A LIBRARY concatenation is private if the LIBRARY resource is defined in a CICS® bundle that is packaged and installed as part of an application, either as part of the application bundle, or as part of the application binding bundle. Private LIBRARY concatenations are not visible when you use the CEMT INQUIRE PROGRAM command. To inquire on or browse private LIBRARY concatenations, use the CICS Explorer® or the EXEC CICS INQUIRE LIBRARY system programming command.

The resource signature

You can use this command to display the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.

Input

Press the Clear key to clear the screen. You can start this transaction in two ways:
  • Type CEMT INQUIRE LIBRARY (or suitable abbreviations for the keywords). The resulting display lists the current status. LIBRARY resources are listed in ranking order, and by time of install in libraries of equal ranking.
  • Type CEMT INQUIRE LIBRARY (or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information required.
You can tab to the highlighted or blank fields and overtype them with the values required.
(data-value)
Specifies the name of the LIBRARY resource. If you omit the LIBRARY name, the ALL option is assumed by default.

CEMT INQUIRE LIBRARY

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE LIBRARY ALL( value)SEARCHPOS( value)RANKING( value)NUMDSNAMES( value)ENABLEDDISABLEDNONCRITICALCRITICALDSNAME01( value)DSNAME02( value)DSNAME03( value)DSNAME04( value)DSNAME05( value)DSNAME06( value)DSNAME07( value)DSNAME08( value)DSNAME09( value)DSNAME10( value)DSNAME11( value)DSNAME12( value)DSNAME13( value)DSNAME14( value)DSNAME15( value)DSNAME16( value)INSTALLTIME( date time)INSTALLUSRID( value)CREATESPICSDAPIGRPLISTSYSTEMDEFINESOURCE( value)DEFINETIME( date time)CHANGETIME( date time)CHANGEUSRID( value)CREATESPICSDAPICSDBATCHDREPAPISYSTEMCHANGEAGREL( value)

Displayed fields

CHANGEAGENT(value)
Displays a value that identifies the agent that made the last change to the resource definition. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:
CREATESPI
The resource definition was last changed by an EXEC CICS CREATE command.
CSDAPI
The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.
CSDBATCH
The resource definition was last changed by a DFHCSDUP job.
DREPAPI
The resource definition was last changed by a CICSPlex SM BAS API command.
SYSTEM
The resource definition was last changed by the CICS or CICSPlex system.
CHANGEAGREL(value)
Displays the 4-digit number of the CICS release that was running when the resource definition was last changed.
CHANGETIME(date time)
Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
CHANGEUSRID(value)
Displays the 8-character user ID that ran the change agent.
CRITICALST(value)
Indicates whether the library is critical to the startup of CICS:
CRITICAL
The LIBRARY is critical to CICS startup. If the LIBRARY cannot be successfully installed during CICS startup, a GO or CANCEL message is issued and the operator must decide whether to override the criticality and allow CICS to start. If the operator selects GO, the library is installed in a disabled status unless installation is not possible at all; for example, because of a short-on-storage condition. If the reply is to continue with the startup, the library is not recatalogued as NONCRITICAL, so the critical status must be explicitly set to NONCRITICAL if you decide that the LIBRARY will not be regarded as CRITICAL in future.
NONCRITICAL
The LIBRARY is not critical to CICS startup. If the LIBRARY cannot be successfully installed during CICS startup, the LIBRARY is left in an installed but disabled state and a warning message is issued, but CICS startup continues.
LIBRARY(data-value)
Specifies the 8-character name of the LIBRARY about which you are inquiring. If you omit the program name, the ALL option is assumed by default.
DEFINESOURCE(value)
Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.
DEFINETIME(date time)
Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
DSNAME01-16(value)
Return the names of data sets 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 statically-defined, 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.
If there are more than 16 data sets in the DFHRPL concatenation, you can use either a CICSPlex® SM LIBDSN view to list all of the data sets or the DSNAMELIST option on the EXEC CICS INQUIRE LIBRARY command.
ENABLESTATUS(value)
Indicates whether the LIBRARY is included in the overall LIBRARY search order:
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.
DISABLING
A request to disable the LIBRARY has been 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 will be searched for program artifacts to load.
ENABLING
A request to enable the LIBRARY has been received, but is still being processed.
DISCARDING
A request to discard the LIBRARY from the CICS system has been received, but is still being processed.
INSTALLAGENT(value)
Displays a value that identifies the agent that installed the resource. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:
BUNDLE
The resource was installed by a bundle deployment.
CREATESPI
The resource was installed by an EXEC CICS CREATE command.
CSDAPI
The resource was installed by a CEDA transaction or the programmable interface to DFHEDAP.
GRPLIST
The resource was installed by GRPLIST INSTALL.
SYSTEM
The resource was installed by the CICS or CICSPlex SM system.
INSTALLTIME(date time)
Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
INSTALLUSRID(value)
Displays the 8-character user ID that installed the resource.
NUMDSNAMES(value)
Specifies the number of data sets in the LIBRARY concatenation. For a dynamically defined LIBRARY, this value is the number of non blank DSNAMExx values, and cannot be a value larger than 16. For the statically defined DFHRPL, this value is the number of data sets in the concatenation, and can be a value larger than 16.
RANKING(value)
Specifies 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. However libraries of equal RANKING will appear in the search order in the order in which they were installed or created in the local CICS system, with a library that was installed earlier appearing before one that was installed later.
SEARCHPOS(data-area)
Returns the current absolute position of this LIBRARY in the overall LIBRARY search order. The first LIBRARY in the search order has a SEARCHPOS of 1, the next LIBRARY has 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.