向 CICS 束项目添加资源

向 CICS® 束项目添加资源定义后,您在 CICS 区域中部署并安装该束时,CICS 会为您动态创建资源。

开始之前

您必须先创建 CICS 束项目,然后才能向其添加资源。有关更多信息,请参阅创建 CICS 束项目

关于此任务

由于 CICS 资源在 CICS 束中定义并且在束部署期间动态创建,因此这些资源的某些特性会更改。以此方式创建的 CICS 资源的生命周期无法独立于 BUNDLE 资源进行管理。它们必须通过 CICS 束进行管理。由于束和资源生命周期的相互依赖性,应用程序架构设计师必须仔细考虑应将应用程序的哪组资源的生命周期绑定到 CICS 束的生命周期。要了解有关在 CICS 束中定义资源的潜在影响的更多信息,请参阅束资源的特性

您可以在应用程序束中引用一个或多个 CICS 束。通过用这种方法包装应用程序,您可以将应用程序及其束作为一个实体部署到 CICS,以便能够更方便地在 CICS 中更新和管理应用程序。如果 CICS 束只包含有资格实现多版本控制的资源,那么可以由一个或多个应用程序将其安装到 CICS 区域中。

使用平台上部署的作为专用资源受到支持的 CICS 资源的应用程序以及使用为该应用程序设计的其他资源的应用程序和使用带有导入资源的应用程序都具备实现多版本控制的资格。以下资源作为多版本控制应用程序的一部分受到支持:
  • 属于应用程序的在 CICS 束中定义的 PROGRAM 资源
  • 属于应用程序的在 CICS 束中定义的 LIBRARY 资源
  • 策略
  • 应用程序入口点的语句
  • 针对应用程序定义为依赖性或导入的任何资源

包含其他资源类型的 CICS 束不能包含在平台中同一 CICS 区域内安装的其他应用程序中,并且如果已为应用程序安装则不能将其添加到平台。如果您的应用程序需要的资源不受多版本控制的支持,且在安装到平台中目标区域类型内的 CICS 束中已经使用,请创建新的 CICS 束项目。通过在清单文件中指定导入,针对新的 CICS 束将该资源声明为一种依赖关系。然后,将新的 CICS 束项目包含在应用程序项目中。要了解将资源声明为依赖关系的指示信息,请参阅定义束依赖性

在 CICS 束中定义 TRANSACTION 资源并将 CICS 束部署为应用程序的一部分或将 CICS 束添加到平台时,不支持自动安装事务的初始程序。对于作为应用程序一部分部署的 CICS 束中定义的 TRANSACTION 资源,必须针对属于相同应用程序的事务初始程序定义并部署 PROGRAM 资源。对于随平台一起部署的 CICS 束中定义的 TRANSACTION 资源,必须通过以下某种方式针对事务初始程序定义并部署 PROGRAM 资源:
  • 在随平台一起部署的 CICS 束中。
  • 作为平台上部署的应用程序的一部分。
  • 在属于平台的 CICS 区域中,使用独立 CICS 束、CICS CSD 或 CICSPlex® SM 数据存储库。

要在 CICS 束项目中定义资源,请遵循以下步骤:

过程

  1. 在 Project Explorer 视图中,右键单击 CICS 束项目,然后单击新建
  2. 从菜单中选择要添加的资源,例如,程序、库、事务或 URI 映射定义。
    提示: CICS 束支持资源的混合大小写名称,其中,在 CICS 中支持这些项。但是,您的文件系统可能不允许同名而大小写不同的文件驻留在同一 CICS 束项目中。 如果您需要使用不同大小写的重复资源名称,请在单独的 CICS 束项目中定义这些资源。
  3. 完成向导中的必填字段。
    1. 对于 CICS 资源的子集,如果资源是应用程序的入口点,那么您可以添加应用程序操作。
    2. 对于 JVM 服务器,您可以选择使用提供的某个模板、OSGi、Axis2 或 Liberty 来创建 JVM 概要文件,或使用 CICS 束中的现有 JVM 概要文件,或者从工作空间中的其他位置或从本地文件系统将现有 JVM 概要文件导入到 CICS 束中。 完成向导之后,遵循编辑 CICS 束项目中定义的资源中的指示信息,编辑 JVM 概要文件以满足您的系统需求。
    3. 对于管道,您可以选择使用 CICS 提供的某个样本管道配置文件创建一个管道配置文件,或者从本地文件系统或本地工作空间导入现有配置文件。完成向导之后,遵循编辑 CICS 束项目中定义的资源中的指示信息,编辑管道配置文件以添加要在此配置文件中包含的消息处理程序、头处理程序和应用程序处理程序。
    4. 对于 Web Service,可从本地文件系统或本地工作空间导入 Web Service 绑定文件,以创建 WEBSERVICE 定义。您可以选择导入要打包到束中的 WSDL 文档或 WSDL 归档文件,而对于服务供应商,您可以选择用于在束中包含 PROGRAM 定义的复选框。 请注意,Web Service 是使用无需 SOAP 消息的完整验证的缺省设置创建的,但是您可以在安装资源后在资源编辑器中或 CICS 中更改此设置。
    5. 创建 WEBSERVICE 定义后,可以右键单击该定义并启动向导以生成用于 Web Service 的 URIMAP 定义,并创建别名事务:
      • 将基于 Web Service 绑定文件预填充 URIMAP 的路径,但是您可以根据需要输入其他路径。
      • 将基于 Web Service 绑定文件预填充 URIMAP 的主机名和端口号。如果无法检索到主机名,那么 CICS Explorer 将显示一条警告消息,并且您必须在主机字段中输入值。如果无法检索到端口号,那么 CICS Explorer 会根据 URI 模式提供缺省值 80 或 443。
      • 缺省别名事务为 CPIH,但您可以更改此事务,并且您可以选择用于生成事务定义的复选框。 请注意,即使选中该复选框,也不会为 CPIH 或 CPIQ 生成事务定义。以 C 开头的其他事务名称是为 CICS 保留的。
      • 要使 URIMAP 资源成为应用程序入口点,您可以打开 CICS 束清单编辑器,并切换到入口点选项卡,然后通过指定唯一操作名称、URIMAP 资源类型和 URIMAP 资源名称来添加一个入口点。
    6. 对于 URIMAP 资源,您可以通过新建 URI 映射定义对话框创建 URIMAP 配置文件。指定主机、路径,并选择用途。
      • 对于使用 HFS 文件提供静态响应的 URIMAP 定义,该文件必须与 URIMAP 资源一起打包在 CICS 束中。指定相对于 CICS 束的根目录的相对文件路径。对于相对文件路径,请勿在路径开头使用斜杠。可以使用绝对路径,但强烈建议不要这样做。
      • 选择用途:
        • 要为 CICS 创建 URIMAP 定义作为 HTTP 服务器,请选择服务器。这种类型的 URIMAP 定义用于将入局 HTTP 请求的 URI 从 Web 客户机映射到 CICS 资源。可以提供由应用程序生成的响应或静态响应。
        • 要为 CICS 创建 URIMAP 定义作为 HTTP 客户机,请选择客户机。当 CICS 请求服务器上的 HTTP 资源时会使用这种类型的 URIMAP 定义,这样您可以避免在应用程序中标识 URI。
        • 要为 Web Service 创建 URIMAP 定义,请选择管道。该类型的 URIMAP 定义用于入站 Web Service 请求;即,客户机借以调用 CICS 中的 Web Service 的请求。入局请求的 URI 与 WEBSERVICE 和 PIPELINE 资源相关联,这些资源指定了要在消息上执行的处理。
        • 要为 Atom 订阅源创建 URIMAP 定义,请选择 Atom。该类型的 URIMAP 定义用于入局请求,该请求要求获取 CICS 以 ATOM 订阅源形式提供的数据。URIMAP 定义将请求 URI 映射到定义 Atom 文档的 ATOMSERVICE 资源定义。
        • 要为在 JVM 服务器中运行的 Web 应用程序创建 URIMAP,请选择 JVM 服务器。此类型的 URIMAP 用于将入局应用程序请求映射到 CICS 事务。如果没有任何 URIMAP 匹配入局请求的 URI,那么 CICS 会使用 CJSA 事务。
        • 要配置 URIMAP 以提供静态响应,请选择文件,然后选择 HFS 文件模板名称。用途属性设置为 USAGE(SERVER)。
      • 要使 URIMAP 资源成为应用程序入口点,请选择创建应用程序入口点复选框,并输入唯一的操作名称。或者,您可以打开 CICS 束清单编辑器,并切换到入口点选项卡,然后通过指定唯一操作名称、URIMAP 资源类型和 URIMAP 资源名称来添加一个入口点。
  4. 单击完成
  5. 如果要在创建资源后立即查看并编辑其属性,可以选中打开编辑器复选框,以便在完成向导时打开资源编辑器。 如果您要在以后执行此操作,可以从 Project Explorer 视图中打开资源编辑器。

结果

将在 CICS 束项目中创建资源定义,并将更新束清单。

下一步做什么

要在资源编辑器中编辑资源,请遵循编辑 CICS 束项目中定义的资源中的指示信息。

完成资源定义后,可以将 CICS 束项目部署到 zFS,或者封装束以使用应用程序或平台束进行部署。请参阅部署 CICS 束,以获取更多信息。