BUNDLE 资源定义

BUNDLE 资源定义 CICS 束，这是应用程序的部署单元。束是 CICS 资源，工件，引用和清单的集合，您可以将这些资源，工件，引用和清单部署到 CICS 区域中，以表示整个应用程序或应用程序的组件。

清单是一个文件，用于描述捆绑软件的内容，包括要在 CICS 区域中创建的资源以及支持工件的位置，应用程序成功运行所需的先决条件以及应用程序可以向其他应用程序提供的任何服务。

束可部署到 z/OS UNIX 并构成工件的目录结构。 BUNDLE 资源定义捆绑软件在 z/OS UNIX 中的部署位置及其状态。当您启用 BUNDLE 资源时， CICS 会读取清单并动态创建清单中为您定义的应用程序资源。定义为应用程序先决条件的其他资源必须存在于 CICS 区域中，才能成功启用 BUNDLE 资源。

使用 CICS 束时，已安装资源的生命周期遵循束的生命周期; 如果使 CICS 束可用或不可用，启用或禁用或废弃，那么将对 CICS 束动态创建的所有资源应用相同的操作。有关在 CICS 束中打包资源的含义的信息，请参阅 CICS 束中资源的特征。

注: 使用 CICS Explorer创建和部署束后，应确保正确管理束源代码。无法从导出的数据中重建束zFS,工作站的故障将导致数据丢失。您可以使用 CICS Explorer 的 "导出" 功能来导出束并将其检入到源代码管理系统。

有关安装 BUNDLE 资源定义的信息，请参阅定义 CICS 束。有关使用 BAS 的信息，请参阅使用 BAS BUNDLE 资源定义。

语法

属性

BASESCOPE(值)

指定用于定义捆绑软件作用域的 1-255 字符串。如果可能，请使用统一资源标识 (URI)。如果要将相似的束分组在一起，或者要将 CICS 束与在平台中运行的特定应用程序相关联，请使用 BASESCOPE 属性。应用程序的 URI 具有以下格式:

cicsapplication://Platform/ApplicationID/MajorVersion/MinorVersion/MicroVersion

Platform 是运行应用程序的平台的名称， ApplicationID 是应用程序捆绑软件的标识，后跟应用程序的主版本，次版本和微版本。

缺省值为空，因此所有 BUNDLE 资源都安装在同一作用域中。有关更多信息，请参阅捆绑软件范围。

可接受的字符：

A-Z a-z 0-9 $ @ #./ - _ % &?!:| " = ¬,; < >

有效字符在代码页 IBM® -037 显示时列出。如果使用不同的 EBCDIC 代码页，请注意变体角色中记录的变体字符。

BUNDLE(名称)

指定 BUNDLE 的 1-8 字符名称。

可接受的字符：

A-Z a-z 0-9 $ @ #./ - _ % &?!:| " = ¬,; < >

当代码页为 IBM-037时，有效字符将按其呈现方式列出。如果使用不同的 EBCDIC 代码页，请注意变体角色中记录的变体字符。

最好不要使用以 DFH 开头的名称，因为这些字符保留供 CICS使用。

当您升级或提供新功能或修订时， CICS 可以将其删除或废弃，并将其替换为 CICS 资源。

BUNDLEDIR( zfsdirectory )

为 z/OS UNIX 上的 bundle 指定 1 - 255 个字符的完全合格的根目录名称。第一个字符必须是 / 和结束字符 /。

指定的值必须是 UNIX 文件的有效名称：

它不得包含嵌入的空格字符。
它不得包含 / 字符的连续实例。
它区分大小写。

可接受的字符：

A-Z a-z 0-9。 /_ # @-

当代码页为 IBM-037时，有效字符将按其呈现方式列出。如果使用不同的 EBCDIC 代码页，请注意变体角色中记录的变体字符。

DESCRIPTION (文本)

在此字段中，可以提供要定义的资源的描述。描述文本的长度最多可以为 58 个字符。没有限制适用于您可以使用的字符。不过，如果使用括号，请确保每个开头括号 ( 都有一个匹配的结尾括号 )。如果使用 CREATE 命令，那么对于文本代码中的每个单撇号，请使用两个撇号。

STATUS（已启用 |DISABLED )

指定 BUNDLE 资源在安装时的初始状态。

已启用: BUNDLE 可供使用。 CICS 会检查区域中是否存在捆绑软件的所有先决条件，并尝试安装和启用捆绑软件中定义的所有必需资源。
DISABLED: BUNDLE 不可用。 CICS 不检查先决条件，也不安装但不启用束中定义的资源。