CSD ALTER
更改 CSD 中现有资源定义的属性。
语法
警告系统命令功能强大，可提供有关系统状态的信息，并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
条件: CSDERR ， INVREQ ， ENGERR ， LOCKED ， NOTAUTH 和 NOTFND
NOHANDLE、RESP 和 RESP2是常用选项，可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项.
描述
CSD ALTER 命令更改 CSD 中现有资源定义的部分或全部属性。
同步点在 CSD ALTER 处理中是隐式的，但在处理命令的早期检测到异常情况时除外。 如果该命令成功，那么将落实对该任务中的可恢复资源所作的未落实更改，如果未成功，那么将回滚。
选项
- ATTRIBUTES (data-value)
- 指定要更改的属性。 将属性列表编码为单个字符串。
- ATTRLEN (data-value)
- 以全字二进制值的形式指定 ATTRIBUTES 选项中提供的字符串的长度 (以字节为单位)。
- 组 (data-value)
- 指定包含资源定义的组的 8 字符名称。
- RESID (data-value)
- 指定要变更的资源的 8 字符名称。 只有四个字符的资源名称 (如 TRANSACTION) 必须用四个空格填充并在 8 字符字段中传递。
- RESTYPE (cvda)
- 指定要变更的资源的类型。 CVDA 值是资源类型名称。
- 同胞方式 (cvda)
- 指定在此命令的 ATTRIBUTES 字符串中是否允许过时的属性。 指定下列其中一个 CVDA 值:
- 公司
- 此命令的 ATTRIBUTES 字符串中允许使用过时的资源属性。
- NOCOMPAT
- 此命令的 ATTRIBUTES 字符串中不允许使用过时的资源属性。
条件
- CSDERR
- RESP2 值：
- 1
- 无法读取CSD。
- 2
- CSD为只读。
- 3
- CSD已满。
- 4
- CSD 正由另一个 CICS® 系统使用，并且未配置为共享
- 5
- 没有足够的 VSAM 字符串 (CSDSTRNO 系统初始化参数值) 可用于运行 EXEC CICS CSD 命令。
- INVREQ
- RESP2 值：
- 1
- RESTYPE 未指定有效的资源类型
- 2
- GROUP选项包含一个或多个无效字符。
- 11
- 同胞方式的值无效。
- 200
- 该命令在使用 EXECUTIONSET 值 DPLSUBSET 定义的程序中运行，或在没有 SYNCONRETURN 选项的分布式程序链接从远程系统调用的程序中运行。
- n
- ATTRIBUTES 或 RESID 的值无效。
- LENGERR
- RESP2 值:
- 1
- ATTRLEN 中指定的长度为负数。
- LOCKED
- RESP2 值:
- 1
- 该组已锁定给其他用户，无法更新。
- 2
- 该组受 IBM®保护。
- NOTAUTH
- RESP2 值:
- 100
- 未授权与发出任务关联的用户使用此命令。
- NOTFND
- RESP2 值:
- 1
- 指定的资源定义不在指定的组中。
- 2
- 指定的组不存在。