WebSphere Business Integration Adapter Framework V2.6.0 for HP-UX 发行说明

这些发行说明包含 IBM^(R) WebSphere^(R) Business Integration Adapters V2.6.0 for HP-UX 的发行信息。它们包含下列各节：

本发行版中的新增内容安装和配置信息

产品修订历史局限性

向后兼容性已知问题和变通方法

产品兼容性文档更新

硬件和软件需求

注意：关于本产品的重要信息可以在发布这些发行说明之后发布的技术支持 Flash 中获得。可以在 WebSphere Business Integration Support Web 站点 http://www.ibm.com/websphere/integration/wbiserver/support 找到它们。请选择您感兴趣的组件区并搜索 Flash 部分。

本发行版中的新增内容

本节列示了此发行版中的新功能和进行的改进。

能够支持 DB2^(R) Information Integrator。
能够支持 IBM Common Event Infrastructure（CEI）。
能够支持双向（BIDI）语言。
适配器运行时已经从 InterChange Server 中分离出来。
现在，底层 Java^(TM) 运行时的版本为 1.4.2。
已经不推荐使用“连接器代理程序并行性”（CAP）。
在协作和映射中使用 BIDI API 来对代理程序中的数据强制使用统一的 BIDI 格式。

产品修订历史

在发行版 2.4.0 和 2.6.0 之间，根据客户报告的情况修正了下列 CR。

WebSphere Business Integration Adapters API

跟踪号码	描述
35632	DisableNumberFormatGrouping 将用来确定当调用 CWConnectorBusObj.setintValue(..)/setfloatValue()/setdoubleValue() 时是否使用分组。如果未设置此属性，则缺省值将为 false。如果不使用分组，则 1,234,567 将显示为 1234567。新属性 DisableLocaleFormating 将用来确定是否对数字执行任何格式化。此属性的缺省值为 false。
33705	添加了两种新属性 MaxDoublePrecision 和 MaxFloatPrecision，用来设置与语言环境无关的双精度和浮点精度。现在，如果设置了这些属性值，setdoubleValue 和 setfloatValue 方法就会使用这些属性值，而不使用缺省语言环境精度。在补丁 1.6.1 中已进行修正。
30617	引入了新属性 RetrieveVerb。为了保持向后兼容性，缺省情况下，查询描述将设置为 RetrieveByContent。适配器可以设置 RetrieveVerb 来覆盖此缺省值。如果设置了该属性，则将把它用作 getBO 中的检索查询描述。
33784	为 fetchEvents 添加了新的方法特征符。方法特征符是：public Vector fetchEvents(int pollQuantity) 抛出 ConnectionFailureException 和 FetchEventsFailedException。为了保持向后兼容性，此方法还具有缺省实现：包含对原始方法的调用，并且在 CWConnectorEventStore 中将返回 eventsToProcess 向量。捕获了 StatusChangeFailedException，并且转换为 ConnectionFailureException。在 pollForEvents 中，将调用新方法。如果存在 ConnectionFailureException，则会返回 APPRESPONSETIMEOUT。对于 FetchEventsFailedException，pollForEvents 将返回“失败”（FAIL）状态。

WebSphere Business Integration Adapters 运行时

跟踪号码	描述
46029	添加了 RAS 帮助，以始终跟踪所使用的适配器版本。
46185	当 CxListBuffer 的 endsWith() 方法无法找到指定的搜索值时，它未正确地返回值 false。已经修正了 CxListBuffer 中的 IndexOutOfBoundsException。
30977	当 MQSeries 产生 2019 错误时，适配器表现反常。
29963	可以启动多个同名的适配器。添加了检查方法，以确保一个适配器不能在同一平台上多次启动。如果检测到另一个同名的适配器，则会显示一条消息。
33337、33338 和 33339	应该添加大对象支持。
32412	无法启动 C++ 适配器，原因是软件包中缺少 CWConnector.dll。
34350	使用 JDBCConnector 时，如果选择查询遇到多个记录，则 RetrieveByContent 查询描述不会检索业务对象。
46118	RetrieveByContent 查询描述在 JDBC 适配器中处理失败。
34472	当处理大型事件时，MQ 适配器返回 OutOfMemory 错误。已经添加了代码来检查轮询线程中的 OutOfMemory 异常。如果发现了该异常，则将记录一条消息，该适配器也将退出。
34726	当与 WebSphere Business Integration Message Broker 配合运行的适配器接收到无效消息时，这些无效消息丢失。这种类型的消息不会被传递至故障队列。
36131	当接收到意外类型的 JMS 消息时，Adapter Framework 的响应将是 ClassCastException 错误。已经添加了跟踪，以指示发生了错误。
36763 和 58347	重新启动 Persistent Naming Server 之后，适配器无法连接至 InterChange Server。
36147	对代理程序跟踪级别的动态更新不起作用。
32199	Adapter Framework 始终将连接器名称添加到 ObjectEventId 前面。为 InterChange Server 代理程序添加了新的连接器属性 EnableOidForFlowMonitoring。此属性为布尔值，缺省值为 false。如果将此属性设置为 true，则 ADK 将把传入 ObjectEventId 标记为流监视的外键。
29420 和 30721	更改适配器脚本可以提高适配器的性能。JVM 自变量包含 -mx 选项（最大堆大小）。通过添加 -ms 选项（最小堆大小）并将它的值设置为最大堆大小的一半可以提高性能。编辑位于 \bin 目录中的 start_adapter.bat 文件。找到包含“set JVMArgs”的那一行，并添加 -ms 选项。例如：set JVMArgs="-mx128m -ms64m %JVMArgs%"
29249	将业务对象属性设置为零会导致解析器错误：org.xml.sax.SAXParseException：在元素中找到了无效 XML 字符（Unicode：0x0）。

向后兼容性

在同一物理机器上还安装有较早版本的情况下，建议不要使用 WebSphere Business Integration Adapters V2.6.0。如果需要不同于 WebSphere Business Integration Adapters V2.6.0 的其它版本，应该使用另外的机器。

产品兼容性

受支持的 InterChange Server 版本包括 4.2.2 到 4.3。
受支持的适配器包括随 WebSphere Business Integration Adapters V2.3.1 到 V2.6.0 一起发布的任何适配器。

硬件和软件需求

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

安装和配置信息

无论您是从 CD 中安装软件，还是从 Passport Advantage 下载软件然后从本地目录中安装它，请参阅 Installing WebSphere Business Integration Adapters, V.2.6。

迁移说明

要允许前发行版的 Adapter Framework 中的任何适配器在此发行版中能够正常工作，必须同时更改连接器和 ODA 的启动脚本。有关必须进行的特定更改，请参阅 Adapter Migration Guide。

CORBA 适配器安装说明

如果安装 CORBA 适配器，务必阅读适配器发行说明以了解有关必备软件的更多信息。

局限性

此发行版具有下列局限性：

业务对象实例内容的 BIDI 支持是在连接器级别提供的。于是，每个连接器只能使用一种 BIDI 格式；因此，在特定连接器上受支持的所有业务对象应该使用相同 BIDI 格式的数据。

没有提供用于强制采用统一 BIDI 格式的机制。由于并不是所有组件（例如，“访问接口”和各种连接器）都支持 BIDI，因此，如果将它们与支持 BIDI 的组件一起使用，则可以保证没有采用统一 BIDI 格式的数据驻留在 InterChange Server 上。因此，这可能会导致 InterChange Server 上的 BIDI 数据的表示不一致以及基于这些数据的处理不正确。用户应负责强制采用 BIDI 格式。为了帮助您对从不支持 BIDI 的组件中接收到的数据强制采用 BIDI 格式，为您提供了一个 BIDI API。

对于使用格式与 Windows BIDI 格式不同的数据的两个应用程序，如果它们通过 InterChange Server 代理程序来进行通信，则它们之间的通信会由于下列原因而遭到破坏：
- BIDI 转换的已知局限性。此转换是不可传递的。
- 所选的 InterChange Server 代理程序的缺省统一 BIDI 格式为 Windows BIDI 格式（逻辑上从左到右）
将进行以下通信时的方案作为一个示例：
两个应用程序之间通过 InterChange Server 代理程序来进行通信。每个应用程序都提供可视 BIDI 格式的数据。
在此方案中，从一个应用程序发送至另一个应用程序的可视数据将进行 BIDI 转换，即，从可视转换为逻辑并从逻辑转换为可视 BIDI 格式。发生这种转换的原因是，InterChange Server 代理程序上的统一内部 BIDI 格式被定义为逻辑。因此，由于 BIDI 引擎缺乏传递性，所以，第二个应用程序接收到的数据可能与第一个应用程序发送的数据不相同。
对于 WebSphere Business Integration Message Broker，有一种变通方法。您可以选择定义代理程序的内部格式。

例如，考虑在刚才描述的方案中使用 WebSphere Business Integration Message Broker，而不是使用 InterChange Server 代理程序。可以在代理程序的内部 BIDI 格式成为可视之前设置它，由于根本不会对数据执行转换，因此避免了发生刚才描述的问题。

目前，只有 XML 和定界数据处理程序才受支持。仅当“请求－响应”数据处理程序使用 XML 或定界数据处理程序来处理请求和响应时，才支持“请求－响应”数据处理程序。EDI、“固定宽度”和“名称－值”数据处理程序都不受支持。

已知问题和变通方法

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

WebSphere Business Integration Adapters 运行时

跟踪号码	问题
23482	由于 WebSphere MQ 的局限性，适配器不能将超过 100 MB 的 XML 消息文本写入 MQ 队列以进行处理。当 JMS 是传送包且 WebSphere MQ Integrator 或 WebSphere Application Server 为集成代理程序时，就会产生此问题。适配器运行时将业务对象转换成 XML 消息，因此 XML 消息会变得非常大。要解决此问题，每个业务对象应避免创建的子对象超过 25000 个。
不适用	对于将元数据／配置数据存储在元业务对象中（作为缺省值的一部分）或存储在常规业务对象中（作为运行时实例内容的一部分）的适配器来说，它可能无法完全支持按从右向左的方向处理 BIDI 数据。仅当此元数据／配置数据在处理特定于应用程序的信息（ASI）时指导连接器，并且包括数据处理程序类路径、数据编码和队列名等的规范时，才可能会发生不正确的处理。要解决此问题，必须为每个元业务对象添加特定的定义。尤其是，必须为每个元业务对象的业务对象级别 ASI 添加 BIDI.METABUSINESSOBJECT=YES 规范。

WebSphere Business Integration Adapters 安装程序

跟踪号码	描述
44407	当与 IBM WebSphere Business Integration Adapter Framework 安装程序配合使用的 IBM 32 位 SDK 在繁体中文、简体中文和韩国语语言环境中运行时，该安装程序欢迎屏面上的文本指出“软件开发包”（SDK）版本为 2.6.0。版本 2.6.0 实际上是指 IBM WebSphere Business Integration Adapter Framework 而不是 IBM SDK。当该安装程序在其它语言环境中运行时，则不存在此问题。
29755	如果您选择的安装位置的目录名中包含简体中文、繁体中文、韩国语或日语字符，则安装会失败。要解决此问题，应安装至一个不包含这些字符的路径。

WebSphere Business Integration Adapters 工具

跟踪
号码

描述

不适用

在将外部位置（例如，“记事本”）的 BIDI 字符复制并粘贴到带有 GUI 的基于 C++ 的 WebSphere Business Integration 工具中时，如果选择了非 BIDI 键盘布局（例如，英语键盘），这些 BIDI 字符将显示为问号。为了避免此问题，在从外部源复制到基于 C++ 的 WebSphere Business Integration 工具 GUI 组件时，应该使用 BIDI 键盘布局。

文档更新

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

集成代理程序是 WebSphere InterChange Server
http://www.ibm.com/websphere/integration/wicserver/infocenter
http://www.ibm.com/websphere/integration/wbicollaborations/infocenter（对于协作）
集成代理程序是 WebSphere Message Broker（WebSphere MQ Integrator、WebSphere MQ Integrator Broker 和 WebSphere Business Integration Message Broker）或 WebSphere Application Server
http://www.ibm.com/websphere/integration/wbiadapters/infocenter

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