CEMT SET LIBRARY

Change the attributes of a LIBRARY resource.

Description

SET LIBRARY changes the ranking, critical status and enablement status of a dynamic program LIBRARY concatenation.

You can use the CEMT transaction to modify only LIBRARY resources that are defined in the CICS® system definition (CSD) file and installed in the running CICS system. You cannot use the CEMT SET LIBRARY command to change the status of a LIBRARY resource that was defined and installed in a CICS bundle.
  • You can control the status of dynamically generated LIBRARY resources by enabling or disabling the BUNDLE resources that installed them.
  • You can modify the definition of dynamically generated LIBRARY resources by using the resource editor in CICS Explorer®. To update the definition, replace the old version of the CICS bundle with the new one, following the instructions in Working with bundles in the CICS Explorer product documentation. CICS bundles that were deployed on their own or with a platform can be updated individually. If the CICS bundle was deployed as part of an application or with an application binding, update the whole application.

Syntax

Press the Clear key to clear the screen. There are two ways of starting this transaction:
  • Type CEMT SET LIBRARY followed by the name of the LIBRARY resource. CEMT displays the current status. You can then tab to the highlighted or blank fields and overtype them with the required values.
  • Type CEMT SET LIBRARY followed by the name of the LIBRARY resource, followed by one or more attribute settings that you want to change.

Typing ? at the beginning of either the first or second line gives a syntax prompt. Resetting the values takes effect immediately.

CEMT SET LIBRARY

Read syntax diagramSkip visual syntax diagramCEMT SET LIBRARY( value)CRITICALNONCRITICALENABLEDDISABLEDRANKING( value)

Options

CRITICAL
The LIBRARY concatenation is critical to CICS startup. If the LIBRARY resource cannot be successfully installed during CICS startup for any reason, then a GO or CANCEL message is issued. The operator can decide whether to override the criticality and allow CICS to start. If the operator selects GO, the LIBRARY is installed with a status of DISABLED, unless install is not possible, for example, due to a short-on-storage condition.
Note: If the operator selects GO, the LIBRARY resource is not automatically redefined as NONCRITICAL. If the LIBRARY concatenation should be regarded as noncritical in the future, manually set the critical status to NONCRITICAL.
DISABLED
The LIBRARY concatenation is not included in the LIBRARY search order. The data sets in this LIBRARY concatenation are not searched for program artifacts to load. When you set a LIBRARY resource to DISABLED, CICS closes the LIBRARY concatenation and de-concatenates and unallocates the data sets in the LIBRARY concatenation.
Note: When a LIBRARY resource is disabled, the information about where a program was loaded from becomes invalid. When the LIBRARY resource is enabled again, you must issue a NEWCOPY or PHASEIN command before the program can be loaded again.
ENABLED
The LIBRARY concatenation is included in the LIBRARY search order. The data sets in this LIBRARY concatenation are searched for program artifacts to load.
NONCRITICAL
The LIBRARY concatenation is not critical to CICS startup. If the LIBRARY resource cannot be successfully installed during CICS startup, then the LIBRARY resource is left in an installed but disabled state. A warning message is issued, but CICS startup continues.
RANKING(value)
Specifies where this LIBRARY concatenation appears in the overall LIBRARY search order relative to other LIBRARY concatenations. The value can be in the range 1 - 99. LIBRARY concatenations appear in the search order in order of ranking. A lower number means that this LIBRARY concatenation is searched for programs to load before other LIBRARY concatenations with higher ranking numbers. DFHRPL has a reserved RANKING value of 10, and this RANKING value cannot be specified for dynamic program LIBRARY concatenations.

LIBRARY concatenations with an equal RANKING value appear in the search order in the order in which they were installed or created in the local CICS system. A LIBRARY concatenation that was installed earlier appears before one that was installed later.

value
Specifies the 1 - 8 character name of the LIBRARY resource.