CSD ADD

Description

The CSD ADD command adds a group to a list, optionally specifying the position in the list using the BEFORE or AFTER options. If you do not specify BEFORE or AFTER, the group is added to the end of the list.

A syncpoint is implicit in CSD ADD 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

AFTER(data-value)

Specifies the 8-character name of an existing group in the list after which the group is added.

BEFORE(data-value)

Specifies the 8-character name of an existing group in the list before which the group is added.

GROUP(data-value)

Specifies the 8-character name of the group to be added to the list. You can add a group to a list even if there are no resources in the group.

LIST(data-value)

Specifies the 8-character name of the list to which the group is added. If the list does not already exist, a new one is created.

Conditions

CSDERR

RESP2 value:

1

The CSD cannot be read

2

The CSD is READONLY.

3

The CSD is full

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.

DUPRES

RESP2 value:

1

The group already exists in this list.

2

The specified group did not exist but a list of the same name is already present in the CSD. The group could not be added

3

The specified list did not exist but a group of the same name is already present in the CSD. The list could not be created.

INVREQ

RESP2 values:

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.

5

The BEFORE option contains one or more characters that are not valid.

6

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

LOCKED

RESP 2 values

1

The list is locked to another user and cannot be updated.

2

The list is IBM-protected.

NOTAUTH

RESP2 value:

100

The user associated with the issuing task is not authorized to use this command.

NOTFND

RESP2 value:

4

The specified BEFORE or AFTER group does not exist in the list.