创建插件项目

创建 CICS® Java™ 应用程序作为符合 OSGi 规范的 Eclipse 插件项目。OSGi 服务平台提供了一种机制,可使用组件模型开发应用程序,并将这些应用程序作为 OSGi 束部署到框架中。 插件项目是 OSGi 束,包含 CICS Java 应用程序所需的所有文件和工件,包括用于访问 CICS 资源以及与使用其他语言编写的程序进行交互的 JCICS 类库。在将完整的应用程序导出到主机系统之前,会先将其添加到 CICS 束项目。

关于此任务

本任务会创建新的插件项目。您可以保留设置的缺省值,除非另有声明。在创建项目时,必须编辑清单和添加 JCICS API 依赖性。

过程

  1. 在 Eclipse 菜单栏上,单击文件 > 新建 > 项目以打开“新建项目”向导。
  2. 从提供的列表中选择插件项目,然后单击下一步以打开“新建插件项目”向导。
  3. 项目名称字段中,输入项目的名称,在“目标平台”部分中,选择 OSGi 框架,然后从菜单中选择标准
    “新建插件向导”的截屏
    单击下一步
    这样会显示“内容”窗格。
  4. 版本字段中,从版本号末尾除去“.qualifier”。当前不支持限定符。
  5. 执行环境字段中,选择与 CICS 运行时目标平台中的执行环境匹配的 Java 级别。
    “执行环境”字段的截屏,已选择菜单并显示可供选择的选项列表。
  6. 取消选中生成激活程序复选框,然后单击完成 这样会在 Package Explorer 视图中创建新的插件项目。
  7. 必需: 需求:您现在必须编辑插件清单文件和添加 JCICS API 依赖性。 如果未执行这些步骤,那么能够导出和安装束,但束将无法运行。
    1. 在 Package Explorer 视图中,右键单击项目名称,然后单击 PDE 工具 > 打开清单 这样会在清单编辑器中打开清单文件。
    2. 选择依赖性选项卡,然后在“导入的程序包”部分中单击添加 这样会打开“程序包选择”对话框。
    3. 选择程序包 com.ibm.cics.server,然后单击确定 该程序包会显示在“导入的程序包”列表中。
    4. 可选: 可选:如果您的应用程序需要,可重复上一步来安装以下程序包:
      表 1.
      程序包 描述
      com.ibm.record 原有程序的 Java API,这些程序使用 VisualAge 随附的 Java 记录框架中的 IByteBuffer。先前位于 dfjcics.jar 文件中。
      com.ibm.cics.samples 用于重定向 System.out 和 System.err 的样本。替换 dfjoutput.jar 文件。
    5. 按 Ctrl +S 以保存清单文件。

结果

这样会创建包含 JCICS API 依赖性的新插件项目。

下一步做什么

现在可以创建 CICS Java 应用程序。 如果不熟悉如何为 CICS 开发 Java 应用程序,那么可以使用随 CICS Explorer® SDK 提供的 JCICS 样本以帮助您开始。

注: 在开发完应用程序之后,必须将 CICS-MainClass 声明添加到清单文件,然后声明应用程序中所用的类。 请参阅相关链接以了解更多信息。

要了解有关插件开发的更多信息,请参阅 Eclipse 帮助文档中的“平台插件开发者指南”部分。

完成 Java 应用程序之后,必须在 CICS 束中将其部署到 zFS。CICS 束可以包含一个或多个插件,并且这些束是 CICS 中您的应用程序的部署单元。