CREATE LIBRARY

Create a LIBRARY resource in the local CICS® region.

Syntax

Warning: System commands are powerful as they provide information about the state of the system and allow changes to be made to it. System commands should be used only by authorized applications and users.

Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).

CREATE LIBRARY

CREATE LIBRARY attribute values

data set names

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

NOHANDLE, RESP, and RESP2 are common options that can be added to all EXEC CICS commands to process error conditions. They are not explicitly included in the command syntax diagram and option descriptions. For information about these common options and EXEC CICS command syntax, see EXEC CICS command format and programming considerations.

Description

The CREATE LIBRARY command installs a LIBRARY resource with the attributes specified on the command. It does not use a resource definition stored in the CSD.

When you use the CREATE LIBRARY command to create a LIBRARY resource, the LIBRARY name must not be the same as the name of any other public LIBRARY resource in the CICS region. If the local region already has a public LIBRARY resource with the name you specify, the new definition replaces the old one, providing the old LIBRARY is disabled, otherwise the command is rejected. A LIBRARY resource that was defined and installed in a CICS bundle cannot be replaced using this command.

When you define a LIBRARY resource in a CICS bundle that is packaged and installed as part of an application deployed on a platform, CICS creates a private LIBRARY resource for the application, so the resource name does not have to be unique in the CICS region. For more information about public resources and private resources, see Private resources for application versions.

See Using EXEC CICS CREATE commands to define resources for other general rules that govern CREATE commands.

The CREATE commands are not audited because their actions are recorded by other messages.

Options

ATTRIBUTES(data-value)

Specifies the attributes of the LIBRARY resource being added. The list of attributes must be coded as a single character string using the syntax shown in LIBRARY attributes. See The ATTRIBUTES option for general rules for specifying attributes, and LIBRARY resources for details about specific attributes.

ATTRLEN(data-value)

Specifies the length in bytes of the character string supplied in the ATTRIBUTES option, as a halfword binary value. The length can be from 0 to 32767.

LIBRARY(data-value)

Specifies the 8-character name of the LIBRARY resource to be added to the CICS region.

LOGMESSAGE(cvda)

Specifies whether CICS logs the attributes used for the resource that is created. CVDA values are as follows:

LOG: The resource attributes are logged to the CSDL transient data queue.
NOLOG: The resource attributes are not logged.

Note: The audit log messages for LIBRARY resources are written to CSLB regardless of the value of LOGMESSAGE.

Conditions

ILLOGIC

RESP2 values:

2: The command cannot be executed because an earlier change which affects the LIBRARY search order has not yet completed.

INVREQ

RESP2 values:

n

There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of the processing. Most of the RESP2 values issued by the EXEC CICS CREATE command are associated with a message that is written to transient data queue CSMT. The RESP2 values and the corresponding message numbers are shown in a table in RESP2 values for CREATE and CSD commands.

Syntax errors can be caused by the following:

An invalid LIBRARY name.
A ranking value is out of the range 1-99.
A ranking value is the reserved value of 10.
No DSNAMExx attribute is specified (at least 1 data set name must be provided).
The LIBRARY name provided is a reserved name.

Errors during the discard or resource definition phase can be caused by the following:

Insufficient storage to create internal control structures for the LIBRARY.
Data set allocation failed.
Data set concatenation failed.
The LIBRARY failed to open.
An existing LIBRARY of the same name already exists and is not disabled.
Write to the CICS catalog failed.

7

The LOGMESSAGE CVDA value is not valid.

200

The command was executed in a program defined with an EXECUTIONSET value of DPLSUBSET or a program was invoked from a remote system by a distributed program link without the SYNCONRETURN option.

500

Install failed because an existing LIBRARY of the same name exists, and could not be replaced because it is not disabled.

LENGERR

RESP2 values:

1: The length you have specified in ATTRLEN is negative.

NOTAUTH

RESP2 values:

100: The user associated with the issuing task is not authorized to use this command.
103: The CICS region does not have read access to one of the data sets that make up the LIBRARY concatenation.