CSD INSTALL

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

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)ATOMSERVICEBUNDLEDB2CONNDB2ENTRYDB2TRANDOCTEMPLATEENQMODELFILEIPCONNJOURNALMODELJVMSERVERLIBRARYLSRPOOLMAPSETMQCONNPARTITIONSETPARTNERPIPELINEPROCESSTYPEPROFILEPROGRAMTCPIPSERVICETDQUEUETERMINALTRANCLASSTRANSACTIONTSMODELTYPETERMURIMAPWEBSERVICERESID( data-value)GROUP( data-value)

Conditions: CSDERR, INCOMPLETE, INVREQ, NOTAUTH, NOTFND

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

Options

GROUP(data-value)
Specifies the 8-character name of the group to be installed, or the group containing 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 4 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 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 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 due to the current state of the system.
See RESP2 values for EXEC CICS CREATE and EXEC CICS CSD commands for information on RESP2 values.
NOTAUTH
RESP2 value:
100
The user 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.