CSD DELETE

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

Read syntax diagramSkip visual syntax diagramCSDDELETERESTYPE( cvda)ATOMSERVICEBUNDLECONNECTIONCORBASERVERDB2CONNDB2ENTRYDB2TRANDJARDOCTEMPLATEDUMPCODEENQMODELFILEIPCONNJOURNALMODELJVMSERVERLIBRARYLSRPOOLMAPSETMQCONNPARTITIONSETPARTNERPIPELINEPROCESSTYPEPROFILEPROGRAMREQUESTMODELSESSIONSTCPIPSERVICETDQUEUETERMINALTRANCLASSTRANSACTIONTSMODELTYPETERMURIMAPWEBSERVICERESID( data-value)GROUP( data-value)LISTACTION( cvda) REMOVE

Conditions: CSDERR, INVREQ, LOCKED, 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 DELETE command performs the following operations:
  • Delete a single resource from a group in the CSD.
  • Delete a whole group from the CSD.

A syncpoint is implicit in CSD DELETE 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 deleted, or the group containing the resource definition to be deleted.
LISTACTION(cvda)
Specifies the effect that group delete has on lists that contain the group. CVDA value is:
REMOVE
The group is removed from all lists that contain it.
RESID(data-value)
Specifies the 8-character name of the resource definition to be deleted. Resource names such as TRANSACTION that are only four 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 deleted. CVDA values are the resource type names.

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:
1
The resource type specified for RESTYPE is not valid.
2
The GROUP option contains one or more characters that are not valid.
4
The RESID option contains one or more characters that are not valid.
10
The value of LISTACTION is 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 value:
1
The specified group is locked to another user.
2
The group is IBM®-protected.
NOTAUTH
RESP2 value:
100
The user associated with the issuing task is not authorized to use this command.
NOTFND
RESP2 values:
1
The specified individual resource definition cannot be found.
2
The specified group cannot be found.