CICS 束的清单内容

每个 CICS® 束都包含用于描述束内容的束清单。束清单描述了束，供应时要在 CICS 区域中设计或修改的资源以及成功启用 CICS 束所需的依赖关系。

CICS 束的清单称为 cics.xml ，位于 META-INF 子目录中。捆绑软件清单以 XML 编写，并且符合模式。有关更多信息，请参阅供应商接口。捆绑软件清单以 UTF-8 编码，包含有关捆绑软件本身以及捆绑部件 (捆绑软件提供的定义，导出，导入，应用程序入口点和策略作用域) 的信息。

捆绑软件信息

清单包含可选的 <meta-directives> 元素，其中包含有关捆绑软件的信息; 例如，它可以包含创建捆绑软件时的时间戳记。

清单还包含有关 CICS 束的版本信息的详细信息。

定义

<define> 元素定义将由 CICS 束管理的 CICS 资源。每个资源定义包括:

工件的名称。
定义为 URI 的资源类型。
捆绑软件中文件的相对路径位置。该文件包含资源的元数据。

某些定义会导致 CICS 动态地创建一个或多个资源; 例如， http://www.ibm.com/xmlns/prod/cics/bundle/EVENTBINDING 资源类型会创建 EVENTBINDING 资源以及一个或多个 CAPTURESPEC 资源。其他定义 (例如 http://www.ibm.com/xmlns/prod/cics/bundle/POLICY 资源类型) 仅由 CICS 在运行时处理中使用，并且没有等效的 CICS 资源定义。

CICS 为希望管理非CICS 资源以及 CICS提供的资源的用户提供注册和回调接口。有关更多信息，请参阅回调接口中使用的容器和可在捆绑软件中部署的工件。

导出

<export> 元素提供有关捆绑软件可以提供的资源或服务的其他信息。 CICS 在其束处理中不使用 export 语句。可以使用 SPI ， CMCI 和工具 (例如 CICS Explorer®) 在供应的 CICS 束中查看已指定的导出。

导入

<import> 元素定义与捆绑软件所需的其他资源的依赖关系。每个依赖关系都具有名称和类型，但没有路径属性。依赖关系还具有一个属性，用于描述在 CICS 区域中不存在其中一个必需导入时， CICS 如何处理 BUNDLE 资源安装。 BUNDLE 资源可以保持禁用状态，通过警告消息启用，或者在无警告的情况下启用。缺省行为是需要所有导入; 可以安装但不启用 BUNDLE 资源。

在打包为平台上部署的应用程序的一部分的 CICS 束中，可以将公共或专用资源定义为依赖关系，包括由应用程序自动安装的专用程序。 CICS 首先检查在包含该<import>元素的 CICS 软件包所在的应用程序中，是否存在类型和名称与该元素匹配的私有资源。如果安装了多个版本的应用程序，那么当前应用程序上下文会确定导入的专用资源的版本。如果找不到该资源作为应用程序的专用资源，那么 CICS 会在 CICS 区域中检查与指定类型和名称匹配的公共资源，并导入该资源。您不能从其他应用程序导入专用资源。

用户可以扩展<import>列表，以包含其自定义的用户资源类型。有关更多信息，请参阅可在捆绑软件中部署的工件

应用程序入口点

如果 CICS 束是 CICS 应用程序的一部分，那么可以在束清单中定义一个或多个应用程序入口点。应用程序入口点标识作为应用程序访问点的资源。应用程序入口点用于控制用户对部署在平台上的不同应用程序版本的访问。它们还可用于创建应用程序上下文，以监视应用程序的资源使用情况和识别正在运行的应用程序。

<modify> 元素中的 <entrypoint> 元素定义应用程序入口点。包清单可以包含0个或多个用于应用程序入口点的<modify>元素。 <entrypoint> 元素指定 CICS 资源的名称，资源类型和应用程序操作。可以为不受该 CICS 束管理的资源指定应用程序入口点。

策略作用域

策略作用域用于将策略限制为特定应用程序操作。使用应用程序作用域部署策略时，该策略将应用于其应用程序上下文中具有匹配的平台，应用程序和应用程序版本信息的所有用户任务。策略作用域用于进一步将策略限制为仅与操作匹配的用户任务。

<modify> 元素中的 <policyscope> 元素定义策略的策略作用域。捆绑软件清单可以包含策略作用域的 0 到多个 <modify> 元素。 <policyscope> 元素指定应用程序操作的名称以及要应用于该操作的用户任务的策略的名称。操作的名称必须由单独的 <entrypoint> 元素定义，并且策略必须由同一捆绑软件中的 <define> 元素或与定义策略作用域的捆绑软件一起部署的单独捆绑软件中的元素定义。

清单示例

以下示例显示了 CICS 束的清单，该清单包含同时作为应用程序入口点的程序定义以及该应用程序入口点的用户任务的策略和策略作用域。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<manifest xmlns="http://www.ibm.com/xmlns/prod/cics/bundle" bundleVersion="1"
    bundleRelease="0" build="IntB-201705232112">
    id="CustomerRecordsStore"
    bundleMajorVer="1"
    bundleMinorVer="200"
    bundleMicroVer="4"                     1 
    <meta_directives>
        <timestamp>2018-01-25T14:59:32.092Z</timestamp>
    </meta_directives>                     2 
    <import
        name="ADDC"
        type=http://www.ibm.com/xmlns/prod/cics/bundle/TRANSACTION
        optional="false" warn="false"/>    3 
    <define
        name="ADDCUST"
        type=http://www.ibm.com/xmlns/prod/cics/bundle/PROGRAM
        path="ADDCUST.program"/>          4 
    <define
        name="CUSTLIB"
        type=http://www.ibm.com/xmlns/prod/cics/bundle/LIBRARY
        path="CUSTLIB.library"/>          5 
    <define
        name="NewCustomer"
        type=http://www.ibm.com/xmlns/prod/cics/bundle/POLICY
        path="NewCustomer.policy"/>       6 
    <modify>
        <entrypoint
            name="ADDCUST"
            type=http://www.ibm.com/xmlns/prod/cics/bundle/PROGRAM
            operation="add_customer"/>    7 
    </modify>
    <modify>
        <policyscope
            name="NewCustomer"
            type=http://www.ibm.com/xmlns/prod/cics/bundle/POLICY
            operation="add_customer"/>     8 
    </modify>
</manifest>

包含有关捆绑软件项目的信息，包括捆绑软件标识和捆绑软件版本。
元伪指令元素包含创建捆绑软件的日期和时间。
束将导入必须在供应系统中存在并启用的事务资源，以启用此 CICS 束。此 CICS 束不会声明或管理事务资源。
捆绑软件定义 PROGRAM 资源，包括资源的名称以及用于定义资源属性的 XML 文件的路径。
捆绑软件定义 LIBRARY 资源以动态装入定义的 PROGRAM ，包括资源的名称以及定义资源属性的 XML 文件的路径。
捆绑软件定义 POLICY 资源，包括策略的名称以及定义策略属性的 XML 文件的路径。
捆绑软件声明 PROGRAM 资源作为特定操作的应用程序入口点。
捆绑软件声明 POLICY 仅应用于与指定操作匹配的任务。