CSD INSTALL

从 CSD 安装列表、组或组中的单个资源定义。

语法

警告系统命令功能强大,可提供有关系统状态的信息,并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。

通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态(在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS),激活命令安全检查。

列表的 CSD INSTALL 语法

读取语法图跳过可视语法图CSDINSTALLLIST( data-value)

资源定义或组的 CSD INSTALL 语法

读取语法图跳过可视语法图CSDINSTALLRESTYPE( CVDA)ATOMSERVICEBUNDLEDB2CONNDB2ENTRYDB2TRANDOCTEMPLATEDUMPCODEENQMODELFILEIPCONNJOURNALMODELJVMSERVERLIBRARYLSRPOOLMAPSETMQCONNPARTITIONSETPARTNERPIPELINEPROCESSTYPEPROFILEPROGRAMTCPIPSERVICETDQUEUETERMINALTRANCLASSTRANSACTIONTSMODELTYPETERMURIMAPWEBSERVICERESID( data-value)GROUP( data-value)

条件: CSDERR ,不完整, INVREQ , NOTAUTH 和 NOTFND

NOHANDLERESPRESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.

描述

CSD INSTALL 命令执行以下操作:
  • 从 CSD 中的组安装单个资源。
  • 从 CSD 安装整个组。
  • 从 CSD 安装列表。
如果安装了整个组或列表,那么某些个别资源可能无法安装。 在这种情况下,将产生不完全条件,并将相关的警告和错误消息写入 CSDE 瞬时数据队列。

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
由于系统的当前状态,将指定的资源添加到正在运行的系统时发生错误。
有关 RESP2 值的信息,请参阅 CREATE 和 CSD 命令的 RESP2 值
NOTAUTH
RESP2 值:
100
与发出任务关联的用户无权使用此命令。
NOTFND
RESP2 值:
1
找不到指定的资源定义。
2
找不到指定的组。
3
找不到指定的列表。