IBM WebSphere Business Integration WebSphere MQ 适配器版本 2.7.0 发行说明

这些发行说明包含 IBM(R) WebSphere(R) Business Integration WebSphere MQ 适配器版本 2.7.0 的发行信息。 这些发行说明包含下列各节:
本发行版中的新增内容 WebSphere Business Integration Adapters API 和运行时
产品修订历史 已知问题和变通方法
硬件和软件需求 文档更新
安装、迁移、升级和配置

注意:关于本产品的重要信息可以在发布这些发行说明之后发布的技术支持 Flash 中获得。可以在 WebSphere Business Integration Support Web 站点 http://www.ibm.com/websphere/integration/wbiserver/support 找到它们。单击您感兴趣的产品;如果提供了 Flash,则它们位于自助 > 解决问题 > Flash(提醒)

本发行版中的新增内容

此发行版包括对各种元数据属性的双向(BIDI)支持。

有关适配器和新功能的详细信息,请参阅 Adapter for WebSphere MQ User Guide

产品修订历史

在发行版 2.6.0 和 2.7.0 之间,根据客户报告的情况修正了下列问题。
跟踪
号码
描述
36128 当未配置 InputQueue 连接器属性时,适配器不进行初始化。在修订包 2.5.2 中更正了这种情况。
36438 从适配器的发行版 2.5.x 开始,静态和动态元对象中的转换属性名区分大小写。
33728  当配置元对象中未配置唯一的转换属性时,适配器错误地将事件映射至业务对象。
37094 当为适配器配置了多个输入队列时,转换属性检索机制在处理进行中的消息时失败。
34969 在同步事件处理期间,适配器不将数据处理程序错误发送至报告消息。

硬件和软件需求

产品文档中包括了硬件和软件需求。有关与这些指南的链接,请参阅安装、迁移、升级和配置信息

安装、迁移、升级和配置

无论您是从 CD 中安装软件,还是从 Passport Advantage 下载软件然后从本地目录中安装它,请根据您使用的集成代理程序而参阅相应的指南:

这些指南还包括一般迁移、升级和配置信息。

有关特定于此适配器的硬件和软件需求以及配置信息,请参阅 Adapter for WebSphere MQ User Guide

升级说明

WebSphere Business Integration Adapters API 和运行时

确保将此版本的适配器与 WebSphere Business Integration Adapters 运行时版本 1.8.0 或更高版本配合使用。

WebSphere Business Integration Adapters API .jar 文件和相关联的脚本(对于 Windows(R) 为 CWConnEnv.bat 和 CWODAEnv.bat;对于 UNIX 平台为 CWConnEnv.sh 和 CWODAEnv.sh)是由 WebSphere Business Integration Adapters API 安装的。在安装适配器之前,确保安装了 WebSphere Business Integration Adapters 运行时。如果版本不是 1.8.0 或更高版本,则必须下载最新的 API。本节提供了有关验证 API 版本、下载最新版本以及启用适配器在各种版本的 InterChange Server 和 Adapter Development Kit(ADK)上运行的指示信息。

验证运行时版本

要检查运行时的版本,应找到清单文件(ProductDir\lib\WBIA.jar)并在适合的 Java JAR 编辑器中打开它。查找下列行:

Implementation-Title: "CWConnectorAPI"
Implementation-Version: 1.8.0

Implementation-version 这一行表示已安装的 API 版本。如果版本不是 1.8.0 或更高版本,则必须下载最新的运行时。

下载运行时

要下载最新版本的运行时:

  1. 访问 http://www.ibm.com
  2. 单击 Support & downloads 选项卡。
  3. Downloads 标题下,单击 Downloads & drivers
  4. Enter search terms 字段中,输入“wbia api”并单击 Submit

在下载并安装运行时之后,您应当看到下列文件:

lib\WBIA.jar
bin\CWConnEnv.bat(Windows)
bin/CWConnEnv.sh(UNIX)
bin\CWODAEnv.bat(Windows)
bin/CWODAEnv.sh(UNIX)
connectors\messages\CwConnectorAgentMessages.txt

启用较早版本的 Adapter Development Kit 和 InterChange Server 的适配器

此适配器仅在当前 Adapter Framework V2.6.0 上运行。

已知问题和变通方法

在本发行版中已经发现了下列问题:

跟踪
号码
描述
58988 当在 Linux(TM) 多处理器系统上进行部署时,适配器被挂起。此问题是由已知的 Linux JDK 1.4.2 问题造成的(在垃圾回收期间,此已知问题将导致挂起)。(为此 JDK 问题设立的 PMR 号码为 27182.001.866。)

要解决此问题,修改适配器启动脚本,以使用“-Xgcthreads1”选项来设置 JVMArgs 变量,如以下示例中所示:
JVMArgs="-Xgcthreads1 %JVMArgs%"
34668 CSD06 或更低级别的 WebSphere MQ V5.3 不支持 JMSCorrelationID 字段中的 BIDI 数据;因此,要充分利用适配器的 BIDI 功能,将需要 CSD07 级别的 WebSphere MQ V5.3。

文档更新

产品文档没有通过 CD 或者电子产品分发的形式包括为产品软件包的一部分。可以在下列信息中心找到此产品的文档:

要获得产品文档,请访问 Web 站点,并下载您正在使用的发行版的最新文档集。遵循“信息中心”页面上提供的指示信息来完成安装。

Copyright IBM Corp. 1997, 2004