CSD ALTER
Change the attributes of an existing resource definition in the CSD.
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.
- 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.
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.
- 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.