CSD INSTALL
Install a list, a group, or a single resource definition in a group, from the CSD.
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.
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.
- 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.