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.
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 selectsGO
, 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 selectsGO
, 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.