SET LIBRARY

Change the attributes of a LIBRARY resource.

SET LIBRARY

Read syntax diagramSkip visual syntax diagramSET LIBRARY( data-value)CRITICALST( cvda)CRITICALNONCRITICALENABLESTATUS( cvda)ENABLEDDISABLEDRANKING( data-value)

Conditions: INVREQ, NOTAUTH, NOTFIND

For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

Description

The SET LIBRARY command allows you to change some of the attributes of a particular LIBRARY resource installed in your CICS system.

You cannot use the SET LIBRARY command for LIBRARY resources that were defined and installed in a CICS® bundle. If you attempt to modify a dynamically generated LIBRARY resource that was installed by a CICS bundle, an INVREQ response with a RESP2 value of 300 is issued.
  • 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 using the resource editor in the 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.

Options

CRITICALST(cvda)
specifies whether the LIBRARY is critical to the start up of CICS. Values are set for the next warm or emergency restart only, not for the next cold or initial start. CVDA values are:
CRITICAL
The LIBRARY is critical to CICS startup. If the LIBRARY 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 or not. If CICS is allowed to continue, the LIBRARY is installed in a DISABLED status, unless install was not possible at all; for example, due to a short-on-storage condition.

If the reply is to continue with the startup, the LIBRARY will not be recatalogued as NONCRITICAL, so the critical status should be explicitly set to NONCRITICAL if it is decided that the LIBRARY should 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, then the LIBRARY will be left in an installed but disabled state and a warning message will be issued, but CICS startup will continue.
LIBRARY(data-value)
specifies the 8-character name of the LIBRARY whose attributes are being changed
ENABLESTATUS(cvda)
specifies whether the LIBRARY will be included in the overall LIBRARY search order. CVDA values are:
DISABLED
The LIBRARY will not be included in the LIBRARY search order. The data sets in this LIBRARY concatenation will not be searched for program artifacts to load. Setting a LIBRARY to DISABLED will cause CICS to close the LIBRARY concatenation and to deconcatenate and unallocate the data sets in the LIBRARY
ENABLED
The LIBRARY will be included in the LIBRARY search order. The data sets in this LIBRARY concatenation will be searched for program artifacts to load.
Note: When a LIBRARY is disabled the information about where a program was loaded from becomes invalid, so when the LIBRARY is re-enabled a NEWCOPY or PHASEIN has to be issued before the program can be loaded again.
RANKING(data-value)
A fullword binary value containing a decimal number between 1 and 99 that specifies where this LIBRARY should appear in the overall LIBRARY search order relative to other LIBRARY concatenations. A lower number indicates that this LIBRARY will be searched for programs to load before other LIBRARY resources with higher ranking numbers. DFHRPL has a reserved ranking value of 10, and this ranking value cannot be specified for a dynamic LIBRARY.

LIBRARYs will appear in the search order, in order of ranking. LIBRARYs 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.

You should not change the ranking of more than one LIBRARY resource in the same SET command. The change to the ranking of one of the LIBRARY resources can suppress the changes to other LIBRARY resources.

Conditions

INVREQ
RESP2 values:
2
ENABLESTATUS has an invalid CVDA value.
3
CRITICALST has an invalid CVDA value.
4
RANKING value is out of range (less than 1 or greater than 99).
5
RANKING value is the reserved value of 10.
6
SET operations are not permitted for the static LIBRARY concatenation, DFHRPL.
7
The LIBRARY has not been enabled because one of the following occurred:
  • The LIBRARY failed to open.
  • Allocation of one or more of the data sets in the LIBRARY failed.
  • The LIBRARY concatenation failed.
7
A failure was encountered while attempting to de-concatenate the data sets during a LIBRARY disable operation.
8
A failure occurred while attempting to deallocate one or more of the data sets in the LIBRARY during a disable operation.
10
A failure occurred while attempting to close the LIBRARY during a disable operation.
300
You specified an operation that is invalid for a resource that is installed by a BUNDLE resource.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
Start of change101End of change
Start of changeThe CICS region does not have read access to one of the data sets that make up the LIBRARY concatenation. End of change
NOTFIND
RESP2 values:
1
The named LIBRARY cannot be found.