CSD ALTER

Change the attributes of an existing resource definition in the CSD.

CSD ALTER

Read syntax diagramSkip visual syntax diagramCSDALTERRESTYPE( cvda)ATOMSERVICEBUNDLECONNECTIONCORBASERVERDB2CONNDB2ENTRYDB2TRANDJARDOCTEMPLATEENQMODELFILEIPCONNJOURNALMODELJVMSERVERLIBRARYLSRPOOLMAPSETMQCONNPARTITIONSETPARTNERPIPELINEPROCESSTYPEPROFILEPROGRAMREQUESTMODELSESSIONSTCPIPSERVICETDQUEUETERMINALTRANCLASSTRANSACTIONTSMODELTYPETERMURIMAPWEBSERVICERESID( data-value)GROUP( data-value)ATTRIBUTES( data-value)ATTRLEN(data-value)NOCOMPATCOMPATMODE( cvda)COMPAT

Conditions: CSDERR, INVREQ, LENGERR, LOCKED, NOTAUTH, NOTFND

Description

The CSD ALTER command changes some or all of the attributes of an existing resource definition in the CSD.

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

ATTRIBUTES(data-value)
Specifies the attributes to be changed. Code the list of attributes as a single character string.
See The ATTRIBUTES option for general rules for specifying attributes
See RDO resources for details about specific attributes.
ATTRLEN(data-value)
Specifies the length in bytes of the character string supplied in the ATTRIBUTES option, as a fullword binary value.
GROUP(data-value)
Specifies the 8-character name of the group containing the resource definition.
RESID(data-value)
Specifies the 8-character name of the resource to be altered. Resource names such as TRANSACTION that are only four characters must be padded with four blanks and passed in an 8-character field.
RESTYPE(cvda)
Specifies the type of resource to be altered. CVDA values are the resource type names.
COMPATMODE(cvda)
Specifies whether obsolete attributes are allowed in the ATTRIBUTES string for this command. Specify one of the following CVDA values:
COMPAT
Obsolete resource attributes are allowed in the ATTRIBUTES string for this command.
NOCOMPAT
Obsolete resource attributes are not allowed in the ATTRIBUTES string for this command.
The default is NOCOMPAT.

Conditions

CSDERR
RESP2 values:
1
The CSD cannot be read.
2
The CSD is read only.
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.
INVREQ
RESP2 values:
1
RESTYPE did not specify a valid resource type
2
The GROUP option contains one or more characters that are not valid.
11
The value of COMPATMODE 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.
n
The value of ATTRIBUTES or RESID is not valid.
See RESP2 values for EXEC CICS CREATE and EXEC CICS CSD commands for information on RESP2 values.
LENGERR
RESP2 value:
1
The length specified in ATTRLEN is negative.
LOCKED
RESP2 value:
1
The group is locked to another user and cannot be updated.
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 value:
1
The specified resource definition is not in the named group.
2
The named group does not exist.