创建 CICS® Java 应用程序作为符合 OSGi 规范的 Eclipse 插件项目。OSGi 服务平台提供了一种机制,可使用组件模型开发应用程序,并将这些应用程序作为 OSGi 束部署到框架中。
插件项目是 OSGi 束,包含 CICS Java 应用程序所需的所有文件和工件,包括用于访问 CICS 资源以及与使用其他语言编写的程序进行交互的 JCICS 类库。在将完整的应用程序导出到主机系统之前,会先将其添加到 CICS 束项目。
关于此任务
本任务会创建新的插件项目。您可以保留设置的缺省值,除非另有声明。在创建项目时,必须编辑清单和添加 JCICS
API 依赖性。
过程
- 在 Eclipse 菜单栏上,单击文件 > 新建 > 项目以打开“新建项目”向导。
- 从提供的列表中选择插件项目,然后单击下一步以打开“新建插件项目”向导。
- 在项目名称字段中,输入项目的名称,在“目标平台”部分中,选择 OSGi 框架,然后从菜单中选择标准。单击下一步。 这样会显示“内容”窗格。
- 在版本字段中,从版本号末尾除去“.qualifier”。当前不支持限定符。
- 在执行环境字段中,选择与 CICS 运行时目标平台中的执行环境匹配的 Java 级别。
- 取消选中生成激活程序复选框,然后单击完成。 这样会在 Package Explorer 视图中创建新的插件项目。
- 必需: 需求:您现在必须编辑插件清单文件和添加 JCICS API 依赖性。
如果未执行这些步骤,那么能够导出和安装束,但束将无法运行。
- 在 Package Explorer 视图中,右键单击项目名称,然后单击 PDE 工具 > 打开清单。 这样会在清单编辑器中打开清单文件。
- 选择依赖性选项卡,然后在“导入的程序包”部分中单击添加。 这样会打开“程序包选择”对话框。
- 选择程序包 com.ibm.cics.server,然后单击确定。 该程序包会显示在“导入的程序包”列表中。
- 可选: 可选:如果您的应用程序需要,可重复上一步来安装以下程序包:
表 1. 程序包 |
描述 |
com.ibm.record |
原有程序的 Java API,这些程序使用 VisualAge 随附的 Java 记录框架中的 IByteBuffer。先前位于 dfjcics.jar 文件中。 |
com.ibm.cics.samples |
用于重定向 System.out 和 System.err 的样本。替换 dfjoutput.jar 文件。 |
- 按 Ctrl +S 以保存清单文件。
结果
这样会创建包含 JCICS API 依赖性的新插件项目。
下一步做什么
现在可以创建 CICS Java 应用程序。
如果不熟悉如何为 CICS 开发 Java 应用程序,那么可以使用随 CICS Explorer™ SDK 提供的 JCICS 样本以帮助您开始。
注: 在开发了应用程序之后,必须将 CICS-MainClass 声明添加到清单文件,然后声明应用程序中所用的类。
请参阅相关链接以了解更多信息。
要了解有关插件开发的更多信息,请参阅 Eclipse 帮助文档中的“平台插件开发者指南”部分。
完成 Java 应用程序之后,必须在 CICS 束中将其部署到 zFS。CICS 束可以包含一个或多个插件,并且这些束是 CICS 中您的应用程序的部署单元。