IBM^® J2EE 连接器工具功能部件版本 6.0.1.2 － 自述文件

用于 IBM Rational^® Application Developer 6.0.1 或 6.0.1.1 和 IBM Rational Software Architect 6.0.1 或 6.0.1.1

要查看此文件的最新版本，请参阅在以下网址提供的自述文件 www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/601/html/J2C6012/nl/zh_CN/readme_6012.html

目录

1.0 关于此发行版
   1.1 产品修订历史
2.0 安装信息
   2.1 硬件需求
   2.2 软件需求
   2.2.1 WebSphere^® Application Server
   2.2.2 资源适配器
3.0 已知局限性、问题和变通方法
4.0 客户支持
5.0 声明与商标

1.0 关于此发行版

此发行版包含对 Rational Application Developer 和 Rational Software Architect 中提供的 IMS^™ 资源适配器的修订并对这些适配器应用维护。在应用更新之后：

• IMS Connector for Java^™ V9.1.0.2.1 将更新为 IMS Connector for Java V9.1.0.2.2。
• IMS Connector for Java V9.1.0.1.2 将更新为 IMS Connector for Java V9.1.0.1.3。

1.1 产品修订历史

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

• 对两个 IMS 资源适配器的修改：

  • 增强了重新路由支持：
    • 允许将落实方式 0（SYNC_SEND_RECEIVE）交互所产生的程序到程序切换的辅助输出消息放在与重新路由目标相关联的 TPIPE 队列上。
    • 允许将落实方式 0 交互的辅助输出消息和多个输出消息一道放在与重新路由目标相关联的 TPIPE 队列上。
    • 允许将“OTMA 至 IMS Connect”的未发送消息放在与重新路由目标相关联的 TPIPE 队列上。
  • 增强了“套接字超时”支持：
    • 确保发生“套接字超时”时套接字总是断开连接的。
    • 增强了对 interactionSpec 属性中列出的“套接字超时”的跟踪，以供分析之用。
  • 确保 IMS Connector for Java 在内部除去了对 reRouteName 属性指定的值的前导和结尾空格，以便当 reRouteName 字段的有效值前后包含一个或多个空格或 reRouteName 字段包含一个或多个空格但没有有效值时，不再抛出错误消息 ICO0009E 异常。
  • 消除了在下列情况下发生的 NullPointerException：在对专用持久套接字（指定了 clientID 值）成功运行交互之后对可共享持久套接字（不指定 clientID 值）运行交互。
  • 将 InteractionSpec 属性 reRouteName、ltermName 和 mapName 的缺省值更新为空字符串而不是 8 个空格。
  • 消除了在下列情况下出现的类 com.ibm.ejs.j2c.ThreadIdentitySecurityHelper 的 ClassNotFoundException：在分布式平台上运行时，用户尝试使用“本地选项”连接。如果用户为 IMSManagedConnectionFactory IMSConnectName 属性随意提供一个值，就可能会发生这种情况。 
  • 消除了在下列情况下发生的 ICO0085E 异常：在运行交互（指定 clientID 值）之后对可共享持久套接字（不指定 clientID 值）运行交互。
• 在启用 SOSI 的情况下，未在 typeDescriptor 模型中设置 DBCSOnly 标志。
• “编译时”语言环境名称应设置为机器语言环境。
• 元素具有的信息不足以使某些象征常量区分开来。

2.0 安装信息

有关安装“J2EE 连接器工具”功能部件的信息，请参阅 www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/60/install_instruction/J2C6012/nl/install_zh_CN_.html

2.1 硬件需求

有关安装“J2EE 连接器工具”功能部件的硬件要求，请参阅安装指示信息。

2.2 软件需求

在安装此功能部件之前，必须安装下列产品之一：

• Rational Application Developer 6.0.1
• Rational Application Developer 6.0.1.1
• Rational Software Architect 6.0.1
• Rational Software Architect 6.0.1.1

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

有关“J2EE 连接器工具”功能部件支持的软件和规范的更多详细信息，请参阅安装指示信息。

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

2.2.1 WebSphere Application Server

WebSphere V5.0 和 WebSphere V5.1 支持 J2C 1.0。下表列示了使用 J2EE 连接器工具所必需的 WebSphere Application Server 服务级别。Rational Application Developer 或 Rational Software Architect 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.3（J2C 1.0）
• IMS 9.1.0.2, 9.1.0.2.2（J2C 1.5）－ 仅用于出站

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

在许多情况下，如果要更新 IMS 资源适配器，则可能要求 IMS Connect 和 IMS 有共同的 APAR。有关共同 APAR 的信息，请参阅以下 Web 站点：www.ibm.com/ims。

4.0 客户支持

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

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

5.0 声明与商标

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

本 IBM 产品中包括的 XDoclet 文档经许可才能使用，并且包含在以下著作权归属声明中：Copyright © 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 © 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 在美国和／或其他国家或地区的商标。

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