创建 CICS 平台项目

CICS® 平台项目可定义平台束,这是描述平台的一种管理束类型。平台束指定平台的区域类型。

开始之前

首先在 zFS 中设置平台的平台主目录,然后创建 CICS 平台项目。最佳实践是使用缺省平台主目录 /var/cicsts/CICSplex/platform1,其中,CICSplex 是将安装平台的 CICSplex 的名称,platform1 是平台的名称。如果需要使用其他目录作为平台主目录,您可以在创建 CICS 平台项目后使用平台编辑器更改为备用目录名。有关在 zFS 中创建平台主目录的指示信息,请参阅CICS TS 5.1 信息中心内的“在 zFS 中创建平台主目录”

如果想要在平台级别部署 CICS 束,您可以在创建 CICS 平台项目时创建这些束以准备进行添加。 例如,您可以部署这样一个 CICS 束, 它包含在平台的所有 CICS 区域中都需要的资源,或应用于在平台上部署的多个应用程序的策略。如果尚未针对平台设置任何应用程序、资源或策略,那么您可以在创建 CICS 束后或者在部署后随时将其添加到平台。有关创建 CICS 束的指示信息,请参阅处理束

关于此任务

平台包含一个或多个区域类型。区域类型用于根据其类型分类和包含 CICS 区域。例如,处理 DB2® 连接的所有 CICS 区域可能属于相同的组。您可以在相同平台的区域类型之间或者与其他平台上的区域类型共享 CICS 区域。

您可以创建要在平台中使用的新区域类型。您还可以选择采用现有 CICS 系统组 (CSYSGRP) 作为平台中的区域类型。单个平台可以包含创建的区域类型与采用的区域类型。

已创建的区域类型可指定其包含的 CICS 区域的属性。您可以在区域类型级别指定属性以克隆区域类型中所有 CICS 区域的某些区域属性值。只有其定义针对这些属性指定了相同值或未指定任何值的 CICS 区域能够成为区域类型的一部分。您可以在区域类型级别指定以下区域属性值:
适合成为路由区域(WLMSTATUS 属性)
启动 CICS 区域时,该 CICS 区域是否作为路由区域参与到关联的工作负载中。
适合成为目标区域(DYNROUTE 属性)
在 CICS 启动时,该 CICS 区域是否作为目标区域处于活动状态,并从作为目标的工作负载中接受工作。
启用 BAS 安装(AUTOINST 属性)
通过资源描述与 CICS 区域关联的资源是否应在 MAS 连接到 CMAS 时自动安装。
BAS 安装失败操作(AINSFAIL 属性)
BAS 安装失败时应采取的操作。
如果平台的体系结构要求区域类型中的所有 CICS 区域在这些区域中都具有特定功能或限制,那么请在区域类型级别指定适当值。如果创建的区域类型对属性没有特殊需求,那么不为该属性指定任何值,以便 CICS 区域中允许任何设置。在区域类型级别指定区域属性值时,该属性值将被锁定,并且之后将无法在属于此区域类型的 CICS 区域中进行更改。
如果想要将现有 CICSPlex® SM 拓扑重新实施为平台,那么您可以采用现有 CICS 系统组 (CSYSGRP) 作为已采用的区域类型。作为平台的一部分采用的每个 CSYSGRP 都必须满足以下需求:
  • 该组尚未被已经安装的平台采用。如果该组已与平台关联,那么不能将其用作区域类型。
  • 该组未包含任何子组。
  • 该组将不需要修改(例如,在 WLM 或 RTA 中包含的组)。平台需要对用作区域类型的组进行锁定。
  • 组中的所有 CICS 区域都指定了 CICSPlex SM 系统参数 MASPLTWAIT(YES)。业务应用程序服务也需要 MASPLTWAIT(YES)。需要该参数,以在 CICS 区域初始化时自动安装应用程序或平台的资源。
如果您在不满足这些需求的 CSYSGRP 中具有 CICS 区域,并且希望将 CICS 区域用作平台的一部分,请将其系统定义 (CSYSDEF) 添加到专门为该平台创建的新 CSYSGRP 中。

过程

  1. 从 CICS Explorer® 菜单栏中,单击文件 > 新建向导 > 其他以打开“新建项目”向导。
  2. 展开 CICS 资源文件夹,单击 CICS 平台项目,并单击下一步
  3. 项目名称字段中,输入 CICS 平台项目的名称,并指定平台自身的名称和描述。 项目位置指定在本地工作空间中保存 CICS 平台项目的位置。 单击下一步
  4. 单击添加以将区域类型添加至平台。在名称字段中,输入区域类型的名称。新区域类型可以是已创建的区域类型,也可以是已采用区域类型。要采用现有 CICS 系统组 (CSYSGRP) 作为已采用区域类型,您必须具有 CICS SM 连接。
    • 对于已创建的区域类型,单击创建具有唯一标识的定义。在标识字段中,输入将针对区域类型创建的 CICS 系统组 (CSYSGRP) 的名称。
    • 对于已采用的区域类型,单击使用现有系统组。从所在的 CICSplex 选择现有 CICS 系统组 (CSYSGRP)。
    单击确定以将区域类型添加至平台。
  5. 重复该步骤以添加平台所需的更多已创建或已采用区域类型。 添加区域类型后,您可以编辑其属性,即区域类型的名称和(仅适用于已创建的区域类型)CSYSGRP 标识。您还可以除去错误添加的任何区域类型。 在完成指定平台的区域类型后,单击下一步
  6. 可选: 指定想要部署到平台的任何 CICS 束。 可从本地工作空间发现 CICS 束的列表。选择相应的 CICS 束并单击下一步,然后指定将部署每个 CICS 束的区域类型。 如果尚未准备好部署到平台的任何 CICS 束,请跳过此阶段。
  7. 单击完成以创建项目。如果正在将 CICS 束部署到平台,那么必须先指定部署作用域,然后单击完成 在 CICS 云透视图的 Project Explorer 视图中创建并显示了 CICS 平台项目。
  8. 使用 CICS Explorer 中的平台编辑器编辑 CICS 平台项目,以检查并完成平台束的规范。 在创建平台项目后,平台编辑器将自动打开。要稍后打开平台编辑器,请双击平台束的任何 .xml 文件,manifest.xml 文件除外。 有关使用平台编辑器的指南,请参阅平台编辑器
  9. 在平台编辑器的概述选项卡上验证或编辑平台的名称和描述。 如果需要使用其他目录来代替缺省平台主目录,请单击浏览以查找您设置的主目录并选择其作为平台主目录。
  10. 在平台编辑器概述选项卡的区域类型区域中验证平台的区域类型,并根据需要使用添加除去按钮添加或除去已创建或已采用的区域类型。 要添加已采用的区域类型,您必须具有 CICS SM 连接。 在安装并激活平台后,您可以在区域类型中添加和除去个别 CICS 区域。但是,您无法修改已安装平台中的区域类型,因此请先最终确定区域类型,然后再安装平台。
  11. 在平台编辑器概述选项卡的 CICS 束区域中验证要部署到平台的 CICS 束,并根据需要使用添加除去按钮添加或除去束。 要编辑任何 CICS 束,请双击束名称以在束清单编辑器中将其打开。 在开发应用程序和策略时,您可以在安装平台后在平台级别部署其他 CICS 束。
  12. 在平台编辑器的区域类型选项卡中,选择平台中每个已创建的区域类型以查看区域类型属性。在区域类型属性区域中,指定必须在区域类型的所有 CICS 区域中应用的任何必需设置。 仅可接受所需设置的 CICS 区域可属于此区域类型。如果创建的区域类型对属性没有特殊需求,那么不为该属性指定任何值,以便 CICS 区域中允许任何设置。
  13. 在平台编辑器的区域类型选项卡上选择平台中的每个已创建的区域类型,然后单击添加区域按钮以针对将属于区域类型的 CICS 区域添加一个或多个 CICS 区域定义。 针对在第一次创建 CICS 平台项目时在向导中添加的已创建的区域类型,将提供缺省 CICS 区域定义,您必须将其替换为区域类型中 CICS 区域的实际定义。您可以选择缺省 CICS 区域定义并在区域属性区域中将缺省属性替换为自己的属性。或者您可以在已创建的区域类型中创建新的 CICS 区域定义,然后删除缺省 CICS 区域定义。
    1. 区域属性区域中,为新 CICS 区域的 CICS 系统定义 (CSYSDEF) 指定名称(最多 8 个字符)。 CSYSDEF 名称在 CICSplex 中必须唯一。
    2. CICS Explorer 会为新的 CICS 区域提供与您指定的名称匹配的 APPLID,这是最佳实践。此 APPLID 是用于在相互通信网络中识别该 CICS 区域的名称,即,其网络名。如果需要,更改 APPLID 以满足自己的网络需求。
    3. 为新的 CICS 区域指定 SYSID。 SYSID(也称为 SYSIDNT)是 CICS 区域被其他 CICS 区域所识别的 1-4 字符的名称。
    4. 在将包含新的 CICS 区域的平台中,指定一个或多个已创建的区域类型。 如果在区域类型间共享 CICS 区域,那么针对这些区域类型所指定的任何必需设置必须匹配且不能冲突。
    5. 可选: 如果 CICS 区域要使用 IPIC 系统链接 (SYSLINK) 连接到其他 CICS 区域,请针对该 CICS 区域指定字符主机名或 IPv4/IPv6 地址、网络标识和出站请求端口号。 网络标识是 z/OS® Communications Server NETID。
    您无法使用平台编辑器在采用的区域类型中添加、除去或共享 CICS 区域。您只能处理已创建的区域类型中的 CICS 区域定义。
  14. 在平台编辑器的部署选项卡上验证或编辑每个 CICS 束将部署到平台的区域类型。
  15. 保存 CICS 平台项目。
    注: 创建 CICS 平台项目后,必须确保适当地管理在工作空间中创建的项目文件夹。 无法在 zFS 中通过导出的数据重构 CICS 平台项目,并且工作站故障可能会导致数据丢失。确保将项目检入源代码管理系统。使用与 Eclipse 集成的源代码管理系统时,可以在 CICS Explorer 中工作时检入和检出项目。

结果

CICS 平台项目具有包含以下 XML 文件的 META-INF 文件夹:
  • bundles.xml 描述部署到平台的 CICS 束。
  • deployment.xml 描述用来将 CICS 束部署到平台的规则。
  • manifest.xml 是平台束的清单文件,将其标识为 CICS 管理束。
  • platform.xml 描述平台,包括其名称、描述、区域类型和平台主目录。
  • regions.xml 描述项目中已创建的 CICS 区域。
  • regionTypes.xml 包含每个区域类型的元数据,包括其名称、描述、区域类型和系统组标识。
  • regionTypeLinks.xml 描述所创建的区域到区域类型的链接。

下一步做什么

将项目导出至 zFS,设置 CICS 区域以匹配在平台的区域类型中创建的每个 CICS 区域定义,然后在 CICSplex 中安装平台以使其可用。请参阅部署 CICS 平台项目