CSD INSTALL

Install a list, a group, or a single resource definition in a group, from the CSD.

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).

CSD INSTALL syntax for a list

Read syntax diagramSkip visual syntax diagramCSDINSTALLLIST( data-value)

CSD INSTALL syntax for a resource definition or group

Read syntax diagramSkip visual syntax diagramCSDINSTALLRESTYPE( cvda)ATOMSERVICEBUNDLEDB2CONNDB2ENTRYDB2TRANDOCTEMPLATEDUMPCODEENQMODELFILEIPCONNJOURNALMODELJVMSERVERLIBRARYLSRPOOLMAPSETMQCONNPARTITIONSETPARTNERPIPELINEPROCESSTYPEPROFILEPROGRAMTCPIPSERVICETDQUEUETERMINALTRANCLASSTRANSACTIONTSMODELTYPETERMURIMAPWEBSERVICERESID( data-value)GROUP( data-value)

Conditions: CSDERR, INCOMPLETE, INVREQ, NOTAUTH, NOTFND

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 CSD INSTALL command performs the following operations:
  • Install a single resource from a group in the CSD.
  • Install a whole group from the CSD.
  • Install a list from the CSD.
If a whole group or list is installed, some of the individual resources might fail to install. In this case, the INCOMPLETE condition is raised and the relevant warning and error messages are written to the CSDE transient data queue.

Single resource INSTALL is not supported for CONNECTION, SESSIONS, or TERMINAL pools. INSTALL GROUP or INSTALL LIST commands enable a CONNECTION or TERMINAL pool to be installed with one command.

A syncpoint is implicit in CSD INSTALL processing, except when an exception condition is detected early in processing the command. Uncommitted changes to recoverable resources made up to that point in the task are committed if the command is successful, and rolled back if not.

If resource definition overrides support is in use, resource overrides are applied to relevant resources when those resources are installed. See How it works: Resource definition overrides. These resource overrides do not change the CSD.

Options

GROUP(data-value)
Specifies the 8-character name of the group to be installed, or the group that contains the individual resource definition to be installed.
LIST(data-value)
Specifies the 8-character name of the list to be installed.
RESID(data-value)
Specifies the 8-character name of the individual resource definition to be installed. Resource names such as TRANSACTION that are only 4 characters in length must be padded with four blanks and passed in an 8-character field.
RESTYPE(cvda)
Specifies the type of resource to be installed. CVDA values are the resource type names.

Conditions

CSDERR
RESP2 value:
1
The CSD cannot be read.
4
The CSD is being used by another CICS® system and is not configured for sharing.
5
Insufficient VSAM strings (CSDSTRNO system initialization parameter value) are available to run the EXEC CICS CSD command.
INCOMPLETE
RESP2 value:
1
The installation of a complete group or list was only partially successful.
INVREQ
RESP2 values:
1
The resource type that is specified for RESTYPE is not valid.
2
The GROUP option contains one or more characters that are not valid.
3
The LIST option contains one or more characters that are not valid.
4
The RESID option contains one or more characters that are not valid.
200
The command was run in a program that is defined with an EXECUTIONSET value of DPLSUBSET, or in a program invoked from a remote system by a distributed program link without the SYNCONRETURN option.
n
An error occurred while adding the specified resource to the running system because of the current state of the system.
See RESP2 values for CREATE and CSD commands for information on RESP2 values.
NOTAUTH
RESP2 value:
100
The user who is associated with the issuing task is not authorized to use this command.
NOTFND
RESP2 values:
1
The specified resource definition cannot be found.
2
The specified group cannot be found.
3
The specified list cannot be found.