IBM WebSphere Business Integration JDBC 适配器版本 2.6.0 发行说明

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

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

本发行版中的新增内容

以下是此发行版中的新功能和进行的改进:

新的操作系统支持

现在,JDBC 适配器在 64 位 AIX(R) 上运行(32 位 JVM 在 64 位 AIX 上)。

新的语言支持

已经对适配器和 ODA 添加了对双向(BIDI)语言的支持。

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

产品修订历史

在发行版 2.5.0 和 2.6.0 之间,根据客户报告的情况修正了下列问题。

跟踪
号码
描述
35258 添加了打印在 JDBC 适配器的主要事件中捕获到的异常的堆栈跟踪。
31759 在修订包 2.4.4 中修正了与 LogAtInterchangeEnd 电子邮件通知有关的问题。
35455 未删除包装程序业务对象中的容器。在修订包 2.4.4 中修正了此问题。
35954 未将复制属性传播至子代容器业务对象。在修订包 2.4.4 中修正了此问题。
35078 轮询失败时适配器未关闭,并启用了 SPBeforePoll 调用。
43390 需要支持将大型 CLOB 对象作为存储过程的参数来检索。
36188 连接器属性 RetryCountAndInterval 对子代业务对象数据不起作用。
58660 如果存储过程的输出参数为 RS(结果集),则适配器将返回错误消息。
59112 在 ping 查询失败之后,适配器无法建立新的数据库连接。

硬件和软件需求

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

安装、迁移、升级和配置

无论您是从 CD 中安装软件,还是从 Passport Advantage 下载软件然后从本地目录中安装它,请参阅相应的指南:

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

有关特定于此产品的硬件和软件需求以及安装、迁移、升级和配置信息,请参阅 Adapter for JDBC 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 上运行,它处理 InterChange Server V4.2.2 和 V4.3.0。

已知问题和变通方法

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

跟踪
号码
描述
41966 使用 Oracle 瘦驱动程序时,JDBC ODA 不能从存储过程的昵称生成业务对象,这是因为该驱动程序不支持分析存储过程的同义词。要解决此问题,通过使用 ODA 并使用实际的存储过程名称来生成业务对象,要么手工构造业务对象。
43888 当分析 SQL Server 数据库时,JDBC ODA 显示存储过程节点名具有“1”这个后缀。这是 SQL Server 数据库存在的一个问题,目前还没有修正。要解决此问题,可以手工除去在为生成的业务对象中的存储过程属性生成的 ASI 中的“1”。
41967 当显示 ODA 配置属性或者要求用户提供特定于业务对象定义的属性时,Framework 不能处理超过 20,000 个的属性值。确保下拉列表中返回的值不超过 10,000 个,否则 ODA 将被挂起。
不适用 WebSphere Business Integration Adapters 和 InterChange Server 不支持将 BIDI 字符作为业务对象名和业务对象属性名的一部分。因此,在根据其列名包含 BIDI 字符的数据库表生成业务对象模板之后,必须对包含非拉丁字符的所有业务对象名和属性名进行重命名,以使它们只包含拉丁字符。
不适用 在 JDBC ODA 中,DB2 OS/390 IBM 通用 JDBC 驱动程序的希伯莱语表名和列名对于应该如何将非拉丁字符指定为 SQL 查询的一部分具有一些限制。特别是,它不会正确处理表名和列名中包含 BIDI 字符的 SQL 查询(如果未用圆括号将表名和列名括起来的话)。因此,由于 JDBC ODA 生成的业务对象模板在特定于应用程序的信息(ASI)中未用圆括号将表名和列名括起来,所以,如果您正在使用这些模板来通过 IBM 通用 JDBC 驱动程序与 OS/390 DB2 通信,则必须按如下所示修改业务对象模板中的表名和列名:
应该将业务对象级别 ASI 中出现的所有 TN=<table name> 替换为 TN="<table name>"
应该将业务对象属性级别 ASI 中出现的所有 CN=<column name> 替换为 CN="<column name>"
不适用 由于 DB2 OS/400 IBM 通用 JDBC 驱动程序的局限性,从生成的业务对象模板中排除了表列名(包括 BIDI 字符)。因此,在生成业务对象模板期间,只考虑包含拉丁名称的列。如果表中没有拉丁语列,则不会生成任何业务对象模板。
如果您正在使用 DataDirect JDBC 驱动程序,则您将看到下列问题:
41973 DataDirect SQL 驱动程序不支持分析 TimeStamp 类型列。对于链接至数据库中 TimeStamp 类型列的属性,在业务对象定义中手工更正属性类型。
41977 当使用 DataDirect SQL 驱动程序时,OracleApps ODA 不为返回结果集的存储过程生成适当的特定于应用程序的信息。当存储过程返回结果集时,驱动程序不支持分析返回类型。例如,存储过程返回 @RETURNVALUE,而 ODA 不能使用它来生成属性。要解决此问题,在业务对象定义中手工添加属性。
当业务对象是从表的昵称生成的时候,DataDirect Oracle 驱动程序不提供有关键的信息,并且它不支持分析昵称。要解决此问题,生成业务对象之后必须修改它。

文档更新

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

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

Copyright IBM Corp. 1997, 2004