IBM J2EE 连接器工具功能部件 V6.0.1 － 发行说明

适用于 IBM Rational Application Developer V6.0.0.1 或 V6.0.1

要查看此文件的最新版本，请参阅在以下网址提供的发行说明：www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/601/J2C/html/nl/readme_zh_CN_601.html

目录

1.0 关于此发行版
   1.1 此发行版中的新增内容
   1.2 产品修订历史
2.0 安装信息
   2.1 硬件需求
   2.2 软件需求
   2.2.1 WebSphere^® Application Server
   2.2.2 资源适配器
3.0 已知局限性、问题和变通方法
   3.1 局限性
   3.1.1 部署时发生异常
   3.1.2 安装在同一运行时服务器上的多个资源适配器
   3.2 问题和变通方法
   3.2.1 不能通过 J2C 向导来更改 ConnectionSpec
   3.2.2 无法导入包含 DBCS 的 COBOL 文件
   3.2.3 在“新建 J2C JavaBean”向导中对某些 IMSInteractionSpec 属性输入值存在困难
4.0 客户支持
5.0 声明与商标

1.0 关于此发行版

“J2EE 连接器（J2C）体系结构”工具允许您创建集成和扩充了现有“企业信息系统”（EIS）上的操作和数据的 J2EE 应用程序。

J2C 工具由下列主要组件组成：

1.1 此发行版中的新增内容

本发行版包含下列更新和功能：

• “创建命令 bean”向导允许您将特定操作的执行包括在 EIS 内。
• J2C 迁移向导允许您将在 WebSphere Application Developer Integration Edition 中创建的 WSDL 文件迁移到当前的 Rational Application Developer 项目中。
• J2C 命令行迁移工具允许您使用命令行将在 WebSphere Application Developer Integration Edition 中创建的 WSDL 文件迁移到 Rational Application Developer 中。
• IMS Connector for Java V9.1.0.2 已升级为 9.1.0.2.1
• IMS Connector for Java V9.1.0.1.1 已升级为 9.1.0.1.2
• CICS ECI V6.0.0 已升级为 6.0.1
• 已使用新的 IMS 9.1.0.1.2 RAR 更新了下列样本：
  • IMS 电话簿
  • 多段输出
  • 输入和输出数组
• 已使用新的 CICS ECI 6.0.1 RAR 更新了“相同的输入和输出”样本。
• 已将一个称为“J2C 命令 Bean”的新样本添加至“样本库”。

1.2 产品修订历史

在此发行版的“Rational Application Developer J2EE 连接器工具功能部件”中提供了下列修订：

• （PK05710）生成的 J2C Java bean 不能正确处理异常。
• （PK05919）在资源引用名称中不能使用“/”字符。
• （PK04996）当选择“短名称”样式代码生成时产生空指针异常。
• （PK07730）IMSRequest 类型在运行时为零而不是缺省值 1。生成的代码现在将把 IMSRequestType 设置为缺省值 1。
• 支持 SYNC_SEND 交互中带有三个参数（IMSInteractionSpec、Input Record 和 Output Record）的执行方法。
• 当在专用持久套接字连接上将 reRoute 属性设置为 TRUE 时抛出包含消息 ICO0007E 的异常。
• 确保 IMS Connector for Java 在内部确认 IMS 中产生的 DFS 消息，以便 DFS 消息之后的后续交互将不会接收到包含 ICO0026E 消息的 java.lang.IllegalArgumentException。 
• 在发生包含 ICO0085E 消息的异常之后，重新设置 IMS Connector for Java 所使用的内部 clientID 的值。当应用程序为可共享的持久套接字连接上的交互提供用户指定的 clientID 时，将抛出包含 ICO0085E 消息的异常。在进行此更新之前，clientID 值将持久保存，直到应用程序重新启动为止。  
• 确保在检测到输入消息的 LL 字段中存在无效值之后，套接字连接仍然保持打开状态。
• 更正跟踪时产生的空指针异常。
• 当为 IMSConnectName 属性指定了值但是 IMS Connector for Java 未在 390 平台上运行时，抛出包含 ICO0056E 消息的异常。如果为 IMSConnectName 属性指定了值，且 IMS Connector for Java 在 OS/390^® 或 z/OS^® 环境中运行，则 IMS Connector for Java 将尝试创建“本地选项”连接。如果 IMS Connector for Java 未在 OS/390 或 z/OS 环境中运行，则应用程序服务器将记录 ICO0056E 异常，但是将继续进行交互，并且 IMS Connector for Java 将尝试使用缺省主机名和端口值来创建 TCP/IP 连接。
• 尝试在当前事务中加入不合格的连接之后抛出异常。
• 将包含 ICO0078E 消息的异常更新为更准确的信息。
• 专用持久套接字连接上的交互不再忽略 IMS Connector for Java 属性 reRoute。对于此更新，将抛出异常消息。
• （PK05920）在 J2C Java Bean 向导的 J2C Web 页面、Web Service 或 EJB 中的部署信息页中不存在“配置资源适配器部署”选项。

2.0 安装信息

有关安装 Rational Application Developer J2C 功能部件的信息，请参阅 www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/601/install_instruction/ifeature_j2c/nl/install_zh_CN_601.html

2.1 硬件需求

有关安装 Rational Application Developer J2C 功能部件的硬件需求，请参阅安装指示信息。

2.2 软件需求

如果使用 Rational Application Developer 中的 J2C 工具来开发应用程序，然后在 WebSphere Application Server V5 上运行它，则应确保您具有适用于 WebSphere Application Server V5 的必需维护。有关详细信息，请参阅 2.2.1 WebSphere Application Server 这一节。

有关 Rational Application Developer J2C 功能部件支持的软件和规范的更多详细信息，请参阅安装指示信息。

有关 Rational Application Developer 中的特定工具支持的软件和规范的详细信息，请参阅联机帮助。

在安装此功能部件之前，必须安装了 IBM^® Rational Application Developer V6.0.0.1。

2.2.1 WebSphere Application Server

WebSphere V5.0 和 WebSphere V5.1 支持 J2C 1.0。下表列示了使用 J2EE 连接器工具所必需的 WebSphere Application Server 服务级别。Rational Application Developer V6.0 提供的后备级别测试环境需要下表中“需要的 WAS 分布式服务级别”这一列中所列示的服务。WebSphere Application Server 支持站点（www.ibm.com/software/webservers/appserv/was/support）中提供了 WebSphere Application Server 累积修订（例如，WAS 5.0.2.8）。在以下网址提供了版本 5.0 和 5.1 的 Integration Edition 运行时修订：www.ibm.com/support/docview.wss?rs=180&context=SSEQTP&dc=D410&dc=D420&uid=swg24004796&loc=en_US&cs=utf-8&lang=en。WebSphere Application Server for z/OS 支持站点（www.ibm.com/software/webservers/appserv/zos_os390/support/）提供了 WebSphere Application Server for z/OS PTF。

WebSphere V6 支持 J2C 1.5 应用程序。

2.2.2 资源适配器

J2C 工具中支持下列资源适配器：

• CICS ECI 5.1（J2C 1.0）
• CICS ECI 6.0.0 和 6.0.1（J2C 1.5）－ 仅用于出站
• IMS 9.1.0.1.1 和 9.1.0.1.2（J2C 1.0）
• IMS 9.1.0.2 和 9.1.0.2.1（J2C 1.5）－ 仅用于出站

3.0 已知局限性、问题和变通方法

此发行说明包括特定于发行版的信息（例如，问题和局限性），在产品文档最终定稿之后才会提供这些信息。

3.1 局限性

3.1.1 部署时发生异常

在创建 Web 页面、EJB 或 Web Service 期间，您可能会发现 WebSphere Application Server V6 服务器控制台中存在异常。这并不会影响服务器或 J2C bean 的正常运行。WebSphere Application Server V6.0.1（www.ibm.com/software/webservers/appserv/was/support/）中已经修正了此问题。

[2/21/05 18:55:49:781 EST] 00000017 SystemErr R java.lang.reflect.InvocationTargetException at sun.reflect.NativeMethodAccessorImpl.invoke0 (Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:85) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:58) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java(Compiled Code)) at java.lang.reflect.Method.invoke(Method.java(Compiled Code)) at com.ibm.ws.ffdc.DiagnosticModule.getDataForDirective(DiagnosticModule.java:316) at com.ibm.ws.ffdc.DiagnosticModule.getDataForDirectives(DiagnosticModule.java:287) at com.ibm.ws.ffdc.DiagnosticModule.dumpComponentData(DiagnosticModule.java:143) at com.ibm.ws.ffdc.DiagnosticEngine.processIncident(DiagnosticEngine.java:159) at com.ibm.ws.ffdc.FFDCFilter.filterEngine(FFDCFilter.java:434) at com.ibm.ws.ffdc.FFDCFilter.processException(FFDCFilter.java:195) at com.ibm.ws.management.AdminServiceImpl.outputWarningAndFFDC(AdminServiceImpl.java:1660) at com.ibm.ws.management.AdminServiceImpl.checkForOpDeprecation(AdminServiceImpl.java:1737) at com.ibm.ws.management.AdminServiceImpl.preInvoke(AdminServiceImpl.java:1670) at com.ibm.ws.management.AdminServiceImpl.access$400(AdminServiceImpl.java:100) at com.ibm.ws.management.AdminServiceImpl$1.run(AdminServiceImpl.java:899) at com.ibm.ws.security.util.AccessController.doPrivileged(AccessController.java(Compiled Code)) at com.ibm.ws.management.AdminServiceImpl.invoke(AdminServiceImpl.java:817) at com.ibm.ws.management.connector.AdminServiceDelegator.invoke(AdminServiceDelegator.java:139) at sun.reflect.GeneratedMethodAccessor23.invoke(Unknown Source) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java(Compiled Code)) at java.lang.reflect.Method.invoke(Method.java(Compiled Code)) at com.ibm.ws.management.connector.soap.SOAPConnector.invoke(SOAPConnector.java:325) at com.ibm.ws.management.connector.soap.SOAPConnector.service(SOAPConnector.java:193) at com.ibm.ws.management.connector.soap.SOAPConnection.handleRequest(SOAPConnection.java:55) at com.ibm.ws.http.HttpConnection.readAndHandleRequest(HttpConnection.java:641) at com.ibm.ws.http.HttpConnection.run(HttpConnection.java:469) at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java(Compiled Code)) Caused by: java.lang.NullPointerException at com.ibm.ws.management.dm.JmxDM.processAdminService(JmxDM.java:50) at com.ibm.ws.management.dm.JmxDM.ffdcDumpDefaultJmx(JmxDM.java:34) ... 28 more

3.1.2 安装在同一运行时服务器上的多个资源适配器

不能将同一 EIS 资源适配器的多个独立版本安装在 WebSphere Application Server 中，当它们用于同一 EIS 类型时更是如此。例如，如果您同时安装了 CICS ECI 5.1 和 CICS ECI 6.0，就可能会发送冲突。 这是因为所有独立的资源适配器将共享同一个类载入器。

3.2 问题和变通方法

3.2.1 不能通过 J2C 向导来更改 ConnectionSpec

J2C 向导未提供任何用户界面支持以便于用户更改 ConnectionSpec。您必须在生成的实现 Java 代码中直接更改它。在编辑器中打开生成的实现 Java 文件，浏览至您需要修改的方法，然后更改、添加或除去该方法的 doclet。

3.2.2 无法导入包含 DBCS 的 COBOL 文件

如果导入包含 NL 字符的 COBOL 文件，则必须从窗口 > 首选项 > 导入器 > COBOL > 更多 COBOL 选项中更改“编译时语言环境名称”。对于缺省值 en_US 将产生错误。

3.2.3 在“新建 J2C JavaBean”向导中对某些 IMSInteractionSpec 属性输入值存在困难

在“新建 J2C JavaBean”向导中，如果选择 com.ibm.connector2.ims.ico.IMSInteractionSpec，则在高级输入字段 Reroute 名称、LTERM 名称和映射名中输入值时存在困难。由于这些字段是用空白填充的，因此应在输入值之前删除这些空白。否则，将显示出错的提示，且您不能继续执行。

4.0 客户支持

Rational Application Developer 的产品主页为 www.ibm.com/software/awdtools/developer/application/。有关 FAQ、已知问题与修订的列表以及其它支持信息，请访问位于以下网址的支持页面：www.ibm.com/software/awdtools/developer/application/support/

5.0 声明与商标

© Copyright IBM Corporation 2000, 2005. All Rights Reserved.

本 IBM 产品中包括的 XDoclet 文档经许可才能使用，并且包含在以下著作权归属声明中：Copyright (c) 2000-2005, XDoclet Team。All rights reserved.

部分内容基于 Design Patterns: Elements of Reusable Object-Oriented Software, by Erich Gamma, Richard Helm, Ralph Johnson and John Vlissides, Copyright (c) 1995 by Addison-Wesley Publishing Company, Inc. All rights reserved.

本信息是为在美国提供的产品和服务编写的。IBM 可能在其他国家或地区不提供本文档中讨论的产品、服务或功能特性。有关您当前所在区域的产品和服务的信息，请向您当地的 IBM 代表咨询。任何对 IBM 产品、程序或服务的引用并非意在明示或暗示只能使用 IBM 的产品、程序或服务。只要不侵犯 IBM 的知识产权，任何同等功能的产品、程序或服务，都可以代替 IBM 产品、程序或服务。但是，评估和验证任何非 IBM 产品、程序或服务，则由用户自行负责。

IBM 公司可能已拥有或正在申请与本文档内容有关的各项专利。提供本文档并未授予用户使用这些专利的任何许可。您可以用书面方式将许可查询寄往：

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

有关双字节（DBCS）信息的许可查询，请与您所在国家或地区的 IBM 知识产权部门联系，或用书面方式将查询寄往：

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

本条款不适用英国或任何这样的条款与当地法律不一致的国家或地区：INTERNATIONAL BUSINESS MACHINES CORPORATION“按现状”提供本出版物，不附有任何种类的（无论是明示的还是暗含的）保证，包括但不限于暗含的有关非侵权、适销和适用于某种特定用途的保证。某些国家或地区在某些交易中不允许免除明示或暗含的保证。因此本条款可能不适用于您。

本信息中可能包含技术方面不够准确的地方或印刷错误。此处的信息将定期更改；这些更改将编入本资料的新版本中。IBM 可以随时对本资料中描述的产品和／或程序进行改进和／或更改，而不另行通知。

本信息中对非 IBM Web 站点的任何引用都只是为了方便起见才提供的，不以任何方式充当对那些 Web 站点的保证。那些 Web 站点中的资料不是 IBM 产品资料的一部分，使用那些 Web 站点带来的风险将由您自行承担。

IBM 可以按它认为适当的任何方式使用或分发您所提供的任何信息而无须对您承担任何责任。

本程序的被许可方如果要了解有关程序的信息以达到如下目的：（i）允许在独立创建的程序和其他程序（包括本程序）之间进行信息交换，以及（ii）允许对已经交换的信息进行相互使用，请与下列地址联系：

Intellectual Property Dept. for Rational Software
IBM Corporation
3600 Steeles Avenue East
Markham, Ontario
Canada L3R 9Z7

只要遵守适当的条件和条款，包括某些情形下的一定数量的付费，都可获得这方面的信息。

本资料中描述的许可程序及其所有可用的许可资料均由 IBM 依据 IBM 客户协议、IBM 国际软件许可协议或任何同等协议中的条款提供。

此处包含的任何性能数据都是在受控环境中测得的。因此，在其他操作环境中获得的数据可能会有明显的不同。有些测量可能是在开发级的系统上进行的，因此不保证与一般可用系统上进行的测量结果相同。此外，有些测量是通过推算而估计的，实际结果可能会有差异。本文档的用户应当验证其特定环境的适用数据。

涉及非 IBM 产品的信息可从这些产品的供应商、其出版说明或其他可公开获得的资料中获取。IBM 没有对这些产品进行测试，也无法确认其性能的精确性、兼容性或任何其他关于非 IBM 产品的声明。有关非 IBM 产品性能的问题应当向这些产品的供应商提出。

所有关于 IBM 未来方向或意向的声明都可随时更改或收回，而不另行通知，它们仅仅表示了目标和意愿而已。

本信息包含在日常业务操作中使用的数据和报告的示例。为了尽可能完整地说明这些示例，示例中可能会包括个人、公司、品牌和产品的名称。所有这些名称都是虚构的，与实际商业企业所用的名称和地址的任何雷同纯属巧合。

版权许可：

本信息包括源语言形式的样本应用程序，这些样本说明不同操作平台上的编程方法。如果是为按照在编写样本程序的操作平台上的应用程序编程接口（API）进行应用程序的开发、使用、经销或分发为目的，您可以任何形式对这些样本程序进行复制、修改、分发，而无须向 IBM 付费。这些示例并未在所有条件下作全面测试。因此，IBM 不能担保或暗示这些程序的可靠性、可维护性或功能。

凡这些样本程序的每份拷贝或其任何部分或任何衍生产品，都必须包括如下版权声明：

©（贵公司的名称）（年）。此部分代码是根据 IBM 公司的样本程序衍生出来的。© Copyright IBM Corp. 2000, 2005. All rights reserved.

如果您正在查看此信息的软拷贝，图片和彩色图例可能无法显示。

编程接口信息

编程接口信息旨在帮助您创建使用此程序的应用软件。

通用编程接口允许您编写获取此程序的工具服务的应用软件。

然而，本信息还可能包含诊断、修改和调整信息。诊断、修改和调整信息用来帮助您调试应用软件。

警告：不要将此诊断、修改和调整信息用作编程接口，因为它是会更改的。

商标和服务标记

下列各项是 International Business Machines Corporation 在美国和／或其他国家或地区的商标：

• CICS
• IBM
• IMS
• OS/390
• Rational
• WebSphere
• z/OS

Java 和所有基于 Java 的商标是 Sun Microsystems,Inc. 在美国和／或其他国家或地区的商标。

Windows 和 Windows NT^® 是 Microsoft^® Corporation 在美国和／或其他国家或地区的商标。

Intel^® 和 Pentium^® 是 Intel Corporation 或其子公司在美国和／或其他国家或地区的商标或注册商标。

UNIX^® 是 The Open Group 在美国和其他国家或地区的注册商标。

Linux^® 是 Linus Torvalds 在美国和／或其他国家或地区的商标。

其他公司、产品或服务名称可能是其他公司的商标或服务标记。