练习 1.1:选择资源适配器
此教程将引导您完成一些详细的步骤,以便生成一个 J2C 应用程序,该 J2C 应用程序使用外部调用接口(ECI)来连接 CICS 事务。此服务是从 CICS COBOL 函数 getCustomerInfo 构建的。该函数接受客户号。根据客户的类别(优质客户、一般客户和不良客户)不同,程序返回的有关此客户的输出信息也不同。
在开始此教程之前,必须先获得需要的资源:
- 与 CICS ECI 服务器的连接:在此教程中,您的应用程序与服务器上的 CICS 程序交互。具体来说,就是您需要在机器上设置一个 CICS 事务网关来访问服务器。您还需要在想要运行此 CICS 的 CICS 服务器上进行一些设置工作。在这里没有包括这些步骤。
- COBOL 文件 taderc25.cbl 的一个副本:可在产品安装目录:\rad\eclipse\plugins\com.ibm.j2c.cheatsheet.content_6.0.0\Samples\CICS\taderc25 中找到此文件。如果想将它存储到本地,可从以下链接复制其代码:taderc25.cbl
- 一个干净的工作空间。
选择资源适配器
切换至 J2EE 透视图
如果 J2EE 图标
没有出现在工作空间的右上方选项卡中,则需要切换到 J2EE 透视图。
- 从菜单栏中选择窗口 > 打开透视图 > 其它。“选择透视图”窗口打开。
- 选择 J2EE。
- 单击确定。J2EE 透视图打开。
连接到 CICS ECI 服务器
- 在 J2EE 透视图中,选择文件 > 新建 > 其它。
- 在“新建”页面中,选择 J2C > J2C Java Bean。单击下一步。
注意:如果在向导列表中没有看到
J2C 选项,则需要启用 J2C 功能。
- 从菜单栏中,单击窗口 > 首选项。
- 在“首选项”窗口的左边,展开“工作台”。
- 单击功能。将显示“功能”窗格。当首次使用需要已启用某个功能的功能部件时,如果您希望接收到提示,则选择在启用功能时提示。
- 展开企业 Java。
- 选择企业 Java。现在已启用必需的 J2C 功能。或者,可以选择“企业 Java 功能”文件夹以启用该文件夹包含的所有功能。要将已启用功能列表设置回安装产品时的状态,单击复原缺省值。
- 要保存更改,单击应用,然后单击确定。启用企业 Java 功能将自动启用开发和调试 J2C 应用程序所需的任何其它功能。
在“资源适配器”页面中,在查看依据下面,选择 JCA 版本。展开 1.5,然后选择 ECIResourceAdapter (IBM:6.0.0)。单击下一步。
在“连接属性”页面中,选择非受管连接复选框。(在此教程中,将使用非受管连接来直接访问 CICS 服务器,这样您不需要提供 JNDI 名称。)接受缺省的连接类名 com.ibm.connector2.cics.ECIManagedConnectionFactory。在空白字段中,提供连接信息。用星号(*)指示的必需字段有:
- 服务器名称:(不是必需的)CICS 事务网关服务器的名称。
- 连接 URL*:(必需)CICS ECI 服务器的服务器地址。
- 端口号:(不是必需的)用来与 CICS 事务网关通信的端口号。缺省端口是 2006。
- 用户名:(不是必需的)连接的用户名。
- 密码:(不是必需的)连接的密码。
可从您的 CICS 服务器系统管理员获取连接信息。当提供了必需的连接信息后,单击下一步。
现在,您可以开始进行练习 1.2:设置 Web 项目以及 Java 接口和实现了。