CSD REMOVE

Remove a group from a list in the CSD.

CSD REMOVE

Read syntax diagramSkip visual syntax diagramCSDREMOVEGROUP( data-value)LIST( data-value)

Conditions: CSDERR, INVREQ, LOCKED, NOTAUTH, NOTFND

Description

The CSD REMOVE command removes a group from a list.

The group and all its resource definitions still exist in the CSD file. When the last group is removed from a list, the list no longer exists in the CSD file.

When a group is deleted, you can request that the group is removed from all lists that contained it. When the last group is removed from a list, the list is deleted.

A syncpoint is implicit in CSD REMOVE 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 removed.
LIST(data-value)
Specifies the 8-character name of the list from which the group is to be removed.

Conditions

CSDERR
RESP2 values:
1
The CSD cannot be read.
2
The CSD is read only.
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.
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.
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
RESP2 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 values:
2
The specified group cannot be found.
3
The specified list cannot be found.