部署 JCICS 示例

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

1. 打开 com.ibm.cics.sever.examples.web.osgibundle 文件以检查其内容。
   打开 com.ibm.cics.sever.examples.web.osgibundle 文件时，您可以期望找到 XML 文件，一组 Java 类以及一组用于 CICS 的样本 Java Web 应用程序，这些应用程序演示了如何使用 OSGi 技术在 CICS中创建和部署 Web Service。
   com.ibm.cics.sever.examples.web.osgibundle 文件采用 XML 格式，包含 OSGi 捆绑软件的符号名称和版本。 同时还包含样本 JVM 服务器的名称。 JVM 服务器是 CICS中 Java 应用程序的运行时环境。 创建您自己的应用程序时，必须提供该文件中目标 JVM 服务器的名称。
2. 将 CICS 束项目部署到 zFS。
   您需要分别对 com.ibm.cics.server.examples.bundle CICS 束项目和 com.ibm.cics.server.examples.jdbc CICS 束项目执行此步骤。
   1. 右键单击 com.ibm.cics.server.examples.bundle CICS 束项目，然后选择 将束项目导出到 z/OS UNIX 文件系统。
   2. 选择 导出到文件系统中的特定位置 ，然后单击 下一步。
   3. 根据需要输入您的 FTP 凭证。
      如果先前未设置连接，那么必须创建到目标主机的连接。
   4. 浏览到要在其中部署 CICS 束的目录，然后单击 完成。
      CICS 束部署在指定的目录中。

   针对 com.ibm.cics.server.examples.jdbc CICS 束项目重复步骤 2.a 到 2.d 。

3. 打开 CICS SM 透视图。 在 CICSplex Explorer 视图中，选择要运行 JCICS 示例程序的 CICS 区域。
4. 通过单击 定义 > JVM 服务器定义打开 "JVM 服务器定义" 视图。
   此视图列示 CICS 区域的所有 JVMSERVER 定义。
5. 在 "CSD 资源组" 视图中，选择提供的 DFH$OSGI 组。
   如果此视图未打开，请选择 窗口 > 显示视图，然后选择 CSD 资源组 并按 打开 以在 Eclipse 透视图中打开该视图。
   将对 "JVM 服务器定义" 视图进行过滤以显示 DFHJVMS 资源定义。
6. 右键单击 "JVM 服务器定义" 视图中的 DFHJVMS ，然后选择 "安装" 以安装此 JVMSERVER 资源。
   该资源在包含 OSGi 框架的 CICS 区域中创建样本 JVM 服务器。 此资源名称与 CICS 束清单中指定的 JVM 服务器的名称相匹配。 您可以通过单击 操作 > Java > JVM 服务器来检查 JVM 服务器的状态。
7. 通过单击 定义 > 束定义打开 "束定义" 视图。
   将对 "束定义" 视图进行过滤，以显示组 DFH$OSGI 中的 DFH$OSGB 和 JDBC BUNDLE 资源定义。
8. 将两个 BUNDLE 资源定义复制到新组以编辑属性:
   1. 选择 DFH$OSGB 和 JDBC 资源定义，右键单击，然后选择 复制。
   2. 右键单击 "CSD 资源组" 视图中的任意位置，然后选择 粘贴。
   3. 输入新的组名，然后单击 确定。
   4. 在 "CSD 资源组" 视图中，选择新组。
      "束定义" 视图将更改以显示新的 BUNDLE 定义。
   5. 编辑新组中的两个 BUNDLE 资源定义以更改束目录，从而与步骤 2.d中相应 CICS 束项目的部署位置相匹配。
9. 在 "束定义" 视图中，选择 DFH$OSGB 和 JDBC 资源定义，右键单击并选择 安装 以安装 BUNDLE 资源。
   您可以通过单击 操作 > 束来检查这两个 BUNDLE 是否都已安装为 ENABLED 状态。 您还可以通过单击 操作 > Java > OSGi 捆绑软件来检查 OSGi 捆绑软件列表。
10. 更新 JVM 概要文件，如下所示:
    1. 更新 OSGI_BUNDLES 选项以列出 Db2 驱动程序 jar 文件。

       OSGI_BUNDLES=<path_to_Db2_JDBC_install_dir>/jdbc/classes/db2jcc4.jar,
       <path_to_Db2_JDBC_install_dir>/jdbc/classes/db2jcc_license_cisuz.jar,\

       其中， <path_to_Db2_JDBC_install_dir> 是 Db2的数据驱动程序的安装路径。

       例如，如果使用了 Db2 12 的缺省安装路径，请按如下所示指定 OSGI_BUNDLES 选项:

       OSGI_BUNDLES=/usr/lpp/db2v13/jdbc/classes/db2jcc4.jar,
       /usr/lpp/db2v13/jdbc/classes/db2jcc_license_cisuz.jar,\

    2. 添加以下 LIBPATH_SUFFIX 语句:

       LIBPATH_SUFFIX=<path_to_Db2_JDBC_install_dir>/jdbc/lib

       同样，如果使用了 Db2 12 的缺省安装路径，请按如下所示指定 LIBPATH_SUFFIX 语句:

       LIBPATH_SUFFIX=/usr/lpp/db2v13/jdbc/lib

11. 要在 JVM 服务器中运行示例，请在 CICS 区域中安装 DFH$OSGI 样本组。
    该组包含所有样本的资源定义。 未安装两个样本 BUNDLE 资源和同一个 JVMSERVER 资源，因为您已在步骤 9中创建同名资源。
    安装组时， CICS 会创建运行示例所需的资源。
12. 将提供的 C 程序 DFH$LCCA 和 DFH$LCCC (由程序控制示例使用) 编译和链接编辑到 DFHRPL 库中。