部署 JCICS 示例

您可以使用 CICS Explorer® SDK 中的示例 CICS® 束将 JCICS 示例部署到 CICS 区域。

开始之前

您必须创建 JCICS 示例项目,如 JCICS 示例入门中所述。

关于此任务

CICS 从 zFS 装入和运行 Java 应用程序,因此必须将已编译的应用程序部署到 zFS 中的适当目录。 您可以使用 CICS Explorer 中的 z/OS® 透视图在 zFS 中创建一个适当的目录。CICS 必须对该目录具有读取和执行访问权。

CICS Explorer SDK 支持将 CICS 束项目中的 Java 应用程序部署到 zFS。CICS 束项目将一组 OSGi 束组合在一起,在逻辑上将这些束作为单个单元进行部署和管理。您可以使用示例 CICS 束项目将 JCICS 示例部署到 CICS 区域。

过程

  1. 在 Eclipse IDE 中,打开 Java 透视图。
  2. 使用以下一个选项打开“新建示例”向导:
    • 在 Eclipse 菜单栏中,单击文件 > 新建 > 示例
    • 单击新建向导图标上的向下箭头,然后单击示例
    • 在 Project Explorer 视图中,右键单击,然后单击新建 > 示例
  3. CICS Java 文件夹中,选择 CICS 束 OSGi 示例,然后单击下一步
  4. 项目名称字段中,输入新项目的名称。 缺省情况下,Eclipse 创建的名称为工作空间中示例的文件夹位置,后跟示例名称。例如,CICS 束的缺省项目名称是 com.ibm.cics.server.examples
  5. 单击完成 Eclipse 创建了包含清单和三个资源的 CICS 束项目。 这些资源引用三个 OSGi 束。程序文件也是样本束项目的组成部分,可用于将项目部署到 CICS 并安装束。
  6. 打开 web.osgibundle 文件以检查其内容。 该文件采用 XML 格式,包含 OSGi 束的符号名称和版本。同时还包含样本 JVM 服务器的名称。JVM 服务器是 CICS 中 Java 应用程序的运行时环境。创建您自己的应用程序时,必须提供该文件中目标 JVM 服务器的名称。
  7. 将 CICS 束部署到 zFS:
    1. 右键单击 CICS 束项目,然后选择导出到 z/OS UNIX 文件系统
    2. 选择导出到文件系统中的特定位置,然后单击下一步
    3. 根据需要输入您的 FTP 凭证。 如果先前未设置连接,那么可能需要创建指向目标主机的连接。
    4. 浏览至要部署 CICS 束的目录,然后单击完成
    CICS 束将部署在指定目录中。
  8. 打开 CICS SM 透视图。在 CICSplex Explorer 视图中,选择要运行 JCICS 示例程序的 CICS 区域。
  9. 安装 JVMSERVER 资源 DFH$JVMS(位于样本组 DFH$OSGI 中)。 该资源会在包含 OSGi 框架的 CICS 区域中创建样本 JVM 服务器。该资源名称与在 CICS 束的清单中指定的 JVM 服务器的名称匹配。您可以通过单击操作 > Java > JVM 服务器来检查 JVM 服务器的状态。
  10. 单击定义 > 束定义以打开“束定义”视图。 此视图列出了 CICS 区域的所有束定义。
  11. 在“资源组定义”视图中,选择所提供的 DFH$OSGI 组。 如果该视图未打开,请选择窗口 > 显示视图以在 Eclipse 透视图中将其打开。 “束定义”视图经过滤,可显示 DFH$OSGB 资源定义。
  12. 将资源定义复制到新的组以编辑这些属性:
    1. 右键单击 DFH$OSGB 并选择复制
    2. 右键单击“资源组定义”视图中的任何位置,并选择粘贴
    3. 输入新的组名,然后单击确定
  13. 编辑新组中的 BUNDLE 资源定义,以将束目录更改为匹配已部署 CICS 束的位置。
  14. 右键单击定义以安装 BUNDLE 资源。 可以通过单击操作 > 来检查安装的 BUNDLE 是否处于 ENABLED 状态。同时还可以通过单击操作 > Java > OSGi 束来检查 OSGi 束的列表。
  15. 要在 JVM 服务器中运行示例,请在 CICS 区域中安装 DFH$OSGI 样本组。 该组包含所有样本的资源定义。由于已创建具有相同名称的资源,因此未安装样本 BUNDLE 和 JVMSERVER 资源。 在安装组时,CICS 会创建运行示例所需的资源。

结果

您已将示例 CICS 束成功部署到 zFS,并且已创建运行 JCICS 示例所需的 CICS 资源。

下一步做什么

您可以按照运行 JCICS 示例中所述运行 JCICS 示例。