CSD INSTALL
从 CSD 安装列表、组或组中的单个资源定义。
语法
警告系统命令功能强大,可提供有关系统状态的信息,并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态(在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS),激活命令安全检查。
条件: CSDERR ,不完整, INVREQ , NOTAUTH 和 NOTFND
NOHANDLE、RESP 和 RESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.
描述
CSD INSTALL 命令执行以下操作:
- 从 CSD 中的组安装单个资源。
- 从 CSD 安装整个组。
- 从 CSD 安装列表。
CONNECTION , SESSIONS 或 TERMINAL 池不支持单个资源 INSTALL。 INSTALL GROUP 或 INSTALL LIST 命令允许使用一个命令安装 CONNECTION 或 TERMINAL 池。
同步点在 CSD INSTALL 处理中是隐式的,但在处理命令的早期检测到异常情况时除外。 如果该命令成功,那么将落实对该任务中的可恢复资源所作的未落实更改,如果未成功,那么将回滚。
如果正在使用资源定义覆盖支持,那么在安装这些资源时,会将资源覆盖应用于相关资源。 请参阅 工作方式: 资源定义覆盖。 这些资源覆盖不会更改 CSD。
选项
- 组 (data-value)
- 指定要安装的组或包含要安装的单个资源定义的组的 8 字符名称。
- LIST (data-value)
- 指定要安装的列表的 8 字符名称。
- RESID (data-value)
- 指定要安装的单个资源定义的 8 字符名称。 长度仅为 4 个字符的资源名称 (如 TRANSACTION) 必须用四个空格填充,并在 8 个字符的字段中传递。
- RESTYPE (cvda)
- 指定要安装的资源的类型。 CVDA 值是资源类型名称。
条件
- CSDERR
- RESP2 值:
- 1
- 无法读取CSD。
- 4
- CSD 正由另一个 CICS® 系统使用,并且未配置为共享。
- 5
- 没有足够的 VSAM 字符串 (CSDSTRNO 系统初始化参数值) 可用于运行 EXEC CICS CSD 命令。
- INCOMPLETE
- RESP2 值:
- 1
- 安装完整组或列表仅部分成功。
- INVREQ
- RESP2 值:
- 1
- 为 RESTYPE 指定的资源类型无效。
- 2
- GROUP选项包含一个或多个无效字符。
- 3
- LIST 选项包含一个或多个无效字符。
- 4
- RESID 选项包含一个或多个无效字符。
- 200
- 该命令在使用 EXECUTIONSET 值 DPLSUBSET 定义的程序中运行,或者在没有 SYNCONRETURN 选项的分布式程序链接从远程系统调用的程序中运行。
- n
- 由于系统的当前状态,将指定的资源添加到正在运行的系统时发生错误。
- NOTAUTH
- RESP2 值:
- 100
- 与发出任务关联的用户无权使用此命令。
- NOTFND
- RESP2 值:
- 1
- 找不到指定的资源定义。
- 2
- 找不到指定的组。
- 3
- 找不到指定的列表。
