LIBRARY 属性

描述 LIBRARY 资源的语法和属性。

DATA SET NAMES

CRITICAL({NO|YES})

指示此 LIBRARY 对于 CICS®的运行是否至关重要。这将确定在启动期间无法安装 LIBRARY 时的行为，例如，由于下列其中一个原因，找不到 LIBRARY 定义中的数据集或无法分配该数据集时:

如果 LIBRARY 为 CRITICAL
- 如果正在 CICS 启动期间创建 LIBRARY (通过 grouplist 安装， BAS 安装， PLTPI 程序或从目录复原) ，那么将发出 GO 或 CANCEL 消息，以便操作员可以决定是覆盖重要程度并允许 CICS 启动，还是导致启动失败。如果应答要继续启动，那么不会将 LIBRARY 重新编目为 NONCRITICAL ，但如果您决定将来不将 LIBRARY 视为 CRITICAL ，那么可以将 CRITICAL 状态更改为 NONCRITICAL。
- 如果在 CICS 启动期间未创建 LIBRARY ，那么 LIBRARY 的重要程度不会影响安装的行为。

如果 LIBRARY 非 CRITICAL
- 如果正在 CICS 启动期间创建 LIBRARY (通过 grouplist 安装， BAS 安装， PLTPI 程序或从目录复原) ，那么将安装但禁用 LIBRARY ，并发出警告消息，然后继续 CICS 启动。稍后可以尝试解决问题并启用 LIBRARY。
- 如果在 CICS 启动期间未安装 LIBRARY ，那么 LIBRARY 的重要程度不会影响安装的行为。

DFHRPL (静态 LIBRARY) 预定义为 CRITICAL ，不能更改。任何问题都会导致 CICS 启动失败并发出错误消息。

对于在作为应用程序束或应用程序绑定束的一部分打包和安装的 CICS 束中定义的专用 LIBRARY 资源，将忽略 CRITICAL 属性。

DSNAME01-16(名称)

最多 16 个包含程序工件的数据集的名称，这些数据集将构成 LIBRARY 并置。安装 LIBRARY 时，数据集将按命名顺序并置在一起，例如， DSNAME02之前的 DSNAME01 。并非所有数据集属性都需要按顺序完成，例如， DSNAME01 可能为空。但是，至少其中一个数据集属性必须具有值。请参阅定义数据集命名约定以获取更多信息。

GROUP(groupname)

每个资源定义都必须具有 GROUP 名称。资源定义成为组的成员，并在安装组时安装在 CICS 系统中。

可接受的字符： `A-Z 0-9 $ @ #` 输入的任何小写字符都将转换为大写。

GROUP 名称的长度最多可以为 8 个字符。小写字符被视为大写字符。

LIBRARY(名称)

LIBRARY 资源的名称。

对于在 CICS 区域， CICSPlex ® SM 数据存储库或独立 CICS 束中定义的 LIBRARY 资源，该资源名称用作数据集的 LIBRARY 并置的 DD 名称。因此， LIBRARY 资源的名称必须符合有效 DD 名称的规则 (1-8 个字符，第一个字符为 A-Z ， $， # 或 @ ，其余字符为 A-Z ， 1-9 ， $， # 或 @)。避免使用与安装所使用的其他 DD 名称冲突的名称。如果所选名称与另一公共 LIBRARY 资源的系统中已在使用的 DD 名称发生冲突，那么创建公共 LIBRARY 资源将失败。

对于打包并安装为应用程序束或应用程序绑定束的一部分的 CICS 束中定义的专用 LIBRARY 资源， LIBRARY 资源的名称不会用作数据集 LIBRARY 并置的 DD 名称。相反，当应用程序安装在平台上时， CICS 会请求数据集的 LIBRARY 并置的唯一 DD 名称。因此，资源名称可以与安装中其他位置使用的 LIBRARY 名称相同，也可以由应用程序的不同版本使用。 CICS 发出消息 DFHLD0518 ，以说明 z/OS® 为 LIBRARY 并置生成的 DD 名称。您还可以在 CICS Explorer®中查看已安装应用程序的数据集名称。

LIBRARY 资源不接受以下保留名称:

DFHRPL 或以 DFH 开头的任何名称
以 EYU 开头的任何名称
CEEDUMP
DUMMY
作业
作业库
STEPCAT
STEPLIB
SYSABEND
SYSIN
SYSMDUMP
SYSOUT
SYSUDUMP

不接受以 DFH 或 EYU 开头的 LIBRARY 资源名称，以确保这些名称在将来可供 CICS使用。应谨慎使用以 CEE 开头的 LIBRARY 资源名称，但应接受这些名称。 SYSIN 和 SYSOUT 和 DUMMY 通常用作 DD 卡，因此不可用作 LIBRARY 资源名称。其余部分是由 MVS™保留的 DD 名称; DFHRPL 保留用于在 CICS 启动 JCL 中用作静态 LIBRARY 的名称。

RANKING(1-99)

等级是一个全字二进制值，其中包含一个十进制数，用于确定此 LIBRARY 在整个 LIBRARY 搜索顺序中的显示位置。较小的数字表示搜索此 LIBRARY 以查找要在具有较高排名号的其他 LIBRARY 资源之前装入的程序。排名类似于 LIBRARY 并置中数据集的并置数，尽管它有一些差异。

等级可以采用值 1-99 ，缺省值为 50。值 10 是为 DFHRPL (静态 LIBRARY) 保留的，不能指定该值。

为 DFHRPL 并置分配了预定义的排名 10 ，不能更改此排名。此值通过为动态定义的 LIBRARY 资源提供小于 10 的排名值，使其能够按整体搜索顺序置于 DFHRPL 并置之前。

注：

您应该将具有将其置于搜索顺序中的 DFHRPL 之前的排名的 LIBRARY 资源视为临时情境。
虽然预定义的 DFHRPL 排名（10）旨在避免使 LIBRARY 资源在搜索顺序中居于 DFHRPL 之前，但它不会限制可置于 DFHRPL 之前的 LIBRARY 资源的总数（条件是这些 LIBRARY 资源之间的相对排名并不重要）。如果指定小于 10 的等级值，那么将发出一条消息，指示此 LIBRARY 在搜索顺序中显示在 DFHRPL 之前。
在发出 NEWCOPY 或 PHASEIN 请求或首次装入程序 (如果尚未装入) 之前，排名更改不会生效。
未定义具有相同排名的 LIBRARY 的搜索顺序，这意味着 LIBRARY 资源的相对搜索顺序不重要。实际上，搜索顺序是 LIBRARY 的安装顺序。
作为安装在平台上的应用程序的一部分在 CICS 束中定义的 LIBRARY 资源是该应用程序版本的专用资源。这些 LIBRARY 并置仅搜索该应用程序版本的任务。
LIBRARY 可以具有相同的排名，但如果两个 LIBRARY 资源的相对搜索位置具有任何意义，那么不应对它们使用相等的排名值。
排名相同的两个 LIBRARY 资源的搜索位置不可靠。搜索顺序与每个资源的安装时间相关，并且可以在 COLD 或 INITIAL 启动后或在更改 LIBRARY 的排名时进行更改。首先安装的资源按搜索顺序显示在另一个 LIBRARY 之前。

STATUS({ENABLED|DISABLED})

指示在创建 LIBRARY 时是启用还是禁用该 LIBRARY。当将 LIBRARY 创建为已启用时， CICS 会尝试分配数据集，然后将其并置，最后打开 LIBRARY 并置。如果其中任何步骤失败，那么将撤销已成功的步骤，并且将以禁用方式安装 LIBRARY。将发出一条消息，指示失败的步骤。

在以禁用方式创建 LIBRARY 时， CICS 不会尝试分配或并置数据集。

对于 CICS 束动态生成的 LIBRARY 资源，将忽略此属性。 LIBRARY 资源的初始状态派生自定义该资源的捆绑软件的初始状态。