练习 1.1:选择资源适配器
此教程引导您完成一些详细的步骤来生成一个 J2C 应用程序以处理可变长度和多段 IMS 事务输出消息。
在开始此教程之前,必须先获得需要的资源:
- 与 IMS 有关的信息:在此教程中,您的应用程序与 IMS 中的 IMS 应用程序交互。需要获取一些信息,例如,IMS Connect 的主机名和端口号以及将运行事务的 IMS 数据存储器的名称。与 IMS 系统管理员联系以获取此信息。具体来说,如果想要运行 IMS\MultiSegmentOutput IMS 程序,则需要在 IMS 中执行一些设置工作。在下面提供了此信息。
- COBOL 文件 MSOut.cbl 的一个副本:可在产品安装目录:\rad\eclipse\plugins\com.ibm.j2c.cheatsheet.content_6.0.0\samples\IMS\MultiSegmentOutput 中找到此文件。如果想将它存储到本地,可从以下链接复制其代码:MSOut.cbl
- 一个干净的工作空间。
注意:在此教程中使用的 IMS 事务不是其中一个 IMS 安装验证程序。此教程使用了 DFSDDLT0(它是一个根据控制语句信息发出对 IMS 的调用的 IMS 应用程序)。在下面提供了用于此教程的 DFSDDLT0 控制语句。但是,要运行此教程,您必须为 DFSDDLT0 配置您的环境并提供必需的 JCL。此教程将 SKS2 用作此 DFSDDLT0 应用程序的事务代码。
DFSDDLT0 控制语句
S11 1 1 1 1 TP 1
L GU
E OK
E Z0017 DATA SKS2 M2 SI1M3 SI1
WTO SEGMENT SI1 RECEIVED
L GN
E QD
WTO END OF INPUT SEGMENTS
L ISRT IW06OUT
L Z0012 DATA *******M1SO1
E OK
WTO SEGMENT SO1 INSERTTED
L ISRT
L Z0027 DATA ********M1SO2*********M2SO2
E OK
WTO SEGMENT SO2 INSERTTED
L ISRT
L Z0048 DATA **********M1SO3***********M2SO3************M3SO3
E OK
WTO SEGMENT SO3 INSERTTED
WTO CURRENT PROGRAM STLDDLT2 TERMINATED
L GU
此教程使用了 COBOL 数据结构来描述 IMS 事务输入和输出消息。注意 IMS 返回的输出消息由固定长度的三段构成:
- OUTPUT-SEG1(16 字节)
- OUTPUT-SEG2(31 字节)
- OUTPUT-SEG3(52 字节)
此特定 IMS 应用程序返回的输出消息固定大小为 99 字节,并通过 COBOL 01 结构 OUTPUT-MSG 表示。
开发此多段应用程序的一个方法是使用 COBOL 定义 OUTPUT-MSG 来定义此事务的输出。第二个方法是为此事务的输出创建一个输出消息。此教程提供的代码使用了第二个方法,因为这个方法也可用于构建处理可变长度输出消息的应用程序。将继续使用每个消息段的 COBOL 定义,以简化对每个段的数据访问。
选择资源适配器
切换至 J2EE 透视图
如果 J2EE 图标
没有出现在工作空间的右上方选项卡中,则需要切换到 J2EE 透视图。
- 从菜单栏中选择窗口 > 打开透视图 > 其它。“选择透视图”窗口打开。
- 选择 J2EE。
- 单击确定。J2EE 透视图打开。
连接到 IMS 服务器
- 在 J2EE 透视图中,选择文件 > 新建 > 其它。
- 在“新建”页面中,选择 J2C > J2C Java Bean。单击下一步。
注意:如果在向导列表中没有看到
J2C 选项,则需要启用 J2C 功能。
- 从菜单栏中,单击窗口 > 首选项。
- 在“首选项”窗口的左边,展开“工作台”。
- 单击功能。将显示“功能”窗格。当首次使用需要已启用某个功能的功能部件时,如果您希望接收到提示,则选择在启用功能时提示。
- 展开企业 Java。
- 选择企业 Java。现在已启用必需的 J2C 功能。或者,可以选择“企业 Java 功能”文件夹以启用该文件夹包含的所有功能。要将已启用功能列表设置回安装产品时的状态,单击复原缺省值。
- 要保存更改,单击应用,然后单击确定。启用企业 Java 功能将自动启用开发和调试 J2C 应用程序所需的任何其它功能。
在“选择资源适配器”页面中,选择 J2C 1.0 或 J2C 1.5 IMS 资源适配器。在此教程中,选择 IMS Connector for Java(IBM:9.1.0.1.2)。单击下一步。
在“连接属性”页面中,清除受管连接复选框并选择非受管连接。(在此教程中,将使用非受管连接来直接访问 IMS,这样您不需要提供 JNDI 名称。)接受缺省的连接类名 com.ibm.connector2.ims.ico.IMSManagedConnectionFactory。在空白字段中,提供所有必需的连接信息。用星号(*)指示的必需字段有:
对于 TCP/IP 连接:
- 主机名:(必需)IMS Connect 的 IP 地址或主机名。
- 端口号:(必需)目标 IMS Connect 使用的端口号。
对于本地选项连接:
- IMS Connect 名称:(必需)目标 IMS Connect 的名称。
对于以上两者:
- 数据存储器名称:(必需)目标 IMS 数据存储器的名称。
可从您的 IMS 系统管理员处获取连接信息。当提供了必需的连接信息后,单击下一步。
现在,您可以开始进行练习 1.2:设置 Web 项目以及 Java 接口和实现了。