使用 DFHCSDUP 定义资源

CSD 更新批量实用程序 DFHCSDUP 是一个离线实用程序，可用于定义 CICS® 资源。请参阅如何定义 CICS 资源，以获取 DFHCSDUP 简介以及与替代资源定义方法的比较。在 CICS 处于运行状态或处于不活动状态时，可以使用 DFHCSDUP 对 CICS 系统定义文件 (CSD) 进行读写操作。

限制: DFHCSDUP 以非 RLS 方式打开 CSD ，即使您请求对 JCL 进行 RLS 访问也是如此。这意味着，如果以 RLS 方式从 CICS 访问 CSD ，那么在运行 DFHCSDUP 时无法打开该 CSD。之所以限制，是因为DFHCSDUP不具备在RLS模式下打开可恢复文件所需的功能。但是，如果 CSD 不可恢复，那么此限制也适用。

使用 DFHCSDUP 命令可执行的操作

资源管理实用程序 DFHCSDUP 命令列出了可用的命令。您可以使用 DFHCSDUP 来执行以下任务:

将组添加到 CSD 文件中指定列表的末尾 (ADD 命令)
更改现有资源定义的属性。在 CSD 上 (ALTER 命令)
将组列表从一个 CSD 文件附加到另一个 CSD 文件或同一 CSD 文件中的组列表 (APPEND 命令)
将一个组中的所有资源定义复制到同一组或另一个 CSD 文件中的另一个组 (COPY 命令)
将单个资源定义从一个组复制到另一个组 (COPY 命令)
在 CSD 上定义单个资源或一组资源 (DEFINE 命令)
从 CSD 中删除单个资源定义，组中的所有资源定义或列表中的所有组名 (DELETE 命令)
从 CSD 抽取数据并将其传递给用户程序以进行处理 (EXTRACT 命令)
初始化新的 CSD 文件，并向其添加 CICS提供的资源定义 (INITIALIZE 命令)
列示所选资源定义，组和列表 (LIST 命令)
处理 APAR-即，将特定 APAR 的维护应用于 CSD (PROCESS 命令)
从 CSD 文件的列表中除去单个组 (REMOVE 命令)
扫描所有 IBM®提供的组和用户定义的组以获取资源 (SCAN 命令)
必要时维护 CSD 文件 (SERVICE 命令)
在 CICS 的新发行版的主 CSD 文件中升级 CICS提供的资源定义 (UPGRADE 命令)
使用一组用户定义的缺省值定义资源 (USERDEFINE 命令)
通过除去组和列表上的内部锁定来验证 CSD 文件 (VERIFY 命令)

如何调用 DFHCSDUP

您可以通过两种方式调用 DFHCSDUP:

作为批处理程序
您可以编辑并使用此样本作业以将 DFHCSDUP 作为批处理程序调用。
从以批处理方式或在 TSO 环境中运行的用户程序
有关详细信息，请参阅从用户程序调用 DFHCSDUP。

您还可以编写自己的修改或扩展 DFHCSDUP 的程序。请参阅系统定义实用程序 (DFHCSDUP) 的用户程序。

处理错误

DFHCSDUP 对错误 (返回码为 8 或更高) 的反应取决于该错误的性质以及调用 DFHCSDUP 的方式。

作为批处理程序: 如果在 CSD 连接期间发生错误，那么不会完成后续命令。如果该错误在其他位置发生，那么不会执行除 LIST 命令以外的后续命令。如果 DFHCSDUP 作为批处理程序运行，那么 put-message-exit 例程不适用。
从用户程序: DFHCSDUP 出口可用于控制错误处理。请参阅系统定义实用程序 (DFHCSDUP) 的用户程序。如果为 DFHCSDUP 提供 put-message-exit 例程，那么只要发出消息，就会调用该例程。如果在 DFHCSDUP 从 get-command 出口接收命令时检测到错误，那么将尽可能处理所有后续命令。

DFHCSDUP 的安全性

DFHCSDUP 需要对 CSD 进行批处理访问。确保仅允许授权用户更新 CSD。将 CSD 数据集配置文件的访问列表限制为 CICS 区域用户 ID 和其他授权用户。更多信息，请参阅 z/OS Security Server RACF Security Administrator's Guide 中的保护数据集。