WebSphere Business Integration Server Express 和 Express Plus for Linux V4.4 发行说明

(c) Copyright International Business Machines Corporation 2005. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

目录

关于本发行版 已知问题和变通方法
修订和更新历史 文档
安装需求 IBM 软件支持机构
局限性

关于本发行版

本发行版在下列操作系统上增加了对 InterChange Server Express 的支持:

本发行版增加了下列新的功能:

WebSphere Business Integration Server Express 和 WebSphere Business Integration Server Express Plus 包含了下列新适配器:

现在,WebSphere Business Integration Server Express Plus 的适配器功能包包含了 Adapter for eMatrix。

修订和更新历史

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

组件 跟踪号 描述
服务器 WebSphere InterChange Server 修订包 422.3、422.4 和 422.5 已合并到该版本中。
安装程序(适配器功能包) 44001 在 Windows 2000 机器上执行了 Adapter for Metasolv 的远程或本地功能包的安装之后,在启动该适配器时,它由于以下错误而终止:输入行太长。这是 Windows 2000 上的命令行长度问题所导致的。在远程安装该功能包时,Adapter for Oracle Applications 也会出现同样的问题。
安装程序 46851 在文件传输时,来自资源束的未解析文本可能出现在窗口中。特别是,可能显示以下内容:
$L(com.ibm.wbi.install.common.i18n.WBIProductResources, businessIntegrationServerExpressPlusProduct.
displayName)
正确的文本是 WebSphere Business Integration Server Express Plus V4.3.1。
系统监视器 42481 系统监视器支持在相同的语言环境中运行 Web 应用程序服务器和客户机。如果服务器和客户机处于不同的语言环境中,文本将以两种语言显示。如果不可能使服务器运行在与客户机相同的语言环境中,则将 JVM 上的语言环境设置为与客户机相同的语言环境:
系统监视器 42705 在将 Web Service 导出至活动编辑器时,“导出向导“对话框中的复选框树不会正常工作。如果您选中叶节点,则其父节点可能未被选中。即使未选中父节点,导出功能也不会受影响。
系统监视器 43360 如果从“创建和配置视图”页面创建一个超过 20 个监视器的视图,那么在选择该视图时可能会遇到异常。
基于 Web 的“失败事件管理器” 43509 对于 WebSphere Application Server,角色名称必须是小写。
DB2 企业版 35380 当 Windows 重新启动时,DB2 企业版不会重新启动数据库管理器。由于数据库管理器未在运行,如果在安装 WebSphere Business Integration Server Express 或 Express Plus 期间 Windows 重新启动,则可能会出现两个问题:
  • 存储库创建可能失败。当发生该问题时,安装程序日志包含以下消息行:未发出启动数据库管理器命令。
  • 启动 InterChange Server Express 可能失败。因为没有数据库管理器在运行,所以 InterChange Server Express 无法连接至 SMB_DB。当发生该问题时,InterchangeSystem 日志文件消息包含以下行:未发出启动数据库管理器命令。

变通方法:该变通方法用于解决这两个问题:

  1. 打开 DB2 控制中心。
  2. 展开所有编目的系统文件夹,接着展开您主机的文件夹,然后展开实例文件夹。
  3. 实例文件夹里,右键单击 DB2 图标,然后单击启动
    会显示以下 DB2 消息:DB2START 处理成功。

在执行这些步骤之后,您就可以创建存储库并成功启动 InterChange Server Express。

DB2 企业版和 DB2 易捷版卸载程序 35380 如果先前已经安装 DB2 企业版(或 DB2 易捷版)和 WebSphere Business Integration Server Express(或 Express Plus)但又卸载过,则在重新安装 WebSphere Business Integration Server Express 或 Express Plus 期间,存储库的创建会失败。发生该问题是因为卸载 DB2 企业版和 DB2 易捷版时没有从 aliases_directory 目录中除去数据库的别名。

因此,在卸载 DB2 之后,名为 SMB_DB 的 InterChange Server Express 存储库别名保留下来,该别名是在最初安装 WebSphere Business Integration Server Express 或 Express Plus 时创建的。尽管该别名的存在不影响 DB2 企业版或 DB2 易捷版的重新安装,但是重新安装 WebSphere Business Integration Server Express 或 Express Plus 时,由于系统找到旧的 SMB_DB 别名,存储库的创建会失败。

变通方法:在卸载和重新安装 DB2 企业版或 DB2 易捷版之前,手工删除 SMB_DB 数据库。删除实际的数据库会除去它的别名。

适配器和数据处理程序 跟踪号 描述
所有适配器 43586 对于通过 JMS 交付传输运行并使用本地连接器配置(通过 -c 命令行选项指定)的连接器,它的 AgentTraceLevel 属性只能在该连接器的生存期内通过系统管理器动态更新一次。对此属性的后续动态更新尝试将失败。
Adapter for e-Mail 25099 对于该适配器,UseDefault 属性不受支持。在将 XML 业务对象发送至连接器时会导致问题,并且连接器不会生成正确的 XML(它不会生成“<?xml version”标记)。
Adapter for e-Mail 29753 发送邮件时,SMTP 服务器需要认证。
Adapter for e-Mail 30751 连接器的 SMTP 端口需要修改。
Adapter for e-Mail 36801 已添加了对 RFC 822 标准因特网(电子邮件)地址的支持。
Adapter for iSeries 58761 未传递业务对象中带有更改的请求作为另一端的响应。
Adapter for iSeries 59167 在某些 CALLRPG 请求中一个程序被调用了两次。
Adapter for iSeries 60331 适配器模板中特定于适配器的 UseDefaults 属性应采用布尔值,并且应从具有值“true/false”的列表中进行选择。
Adapter for JDBC 28594 应在 ODA 中添加 DeltaUpdate 动词支持。
Adapter for JDBC 29080 适配器调用不遵从超时值。
Adapter for JDBC 29375 应支持 DB2(R) 的序列。
Adapter for JDBC 29822 连接器生成不受支持的 ObjectEventID 格式。
Adapter for JDBC 31569 即便是在结果集为“true”或为空的情况下,适配器也应返回输出参数。
Adapter for JDBC 32392 当数据库发生故障时,在“事件监视器”中不刷新轮询连接。
Adapter for JDBC 32473 ODA 应公开昵称。
Adapter for JDBC 34612 应减少连接器中的落实数。
Adapter for JDBC 35078 如果启用 SPBeforePoll 调用,则该适配器在轮询失败时不会关闭。
Adapter for JDBC 35258 已添加了打印堆栈跟踪的能力,该跟踪用于适配器的主要事件中捕捉到的异常。
Adapter for JDBC 60212

如果某一父对象的键属性在特定于应用程序的信息中具有 UID=AUTO,且其子对象的某一属性将该父对象引用为外键,那么在 create 操作期间不使用来自该父对象的新标识列值填充该子对象的外键。

Adapters for JDBC 和 Oracle Applications 28588 仅当启用跟踪时才构建可跟踪的 SQL 消息。
Adapters for JDBC 和 Oracle Applications 28591 增强了跟踪机制。
Adapters for JDBC 和 Oracle Applications 28868 应支持存储过程的 DeltaUpdate 动词。
Adapters for JDBC 和 Oracle Applications 30436 当事件或归档时间为空白时,发生空指针异常。
Adapters for JDBC 和 Oracle Applications 30774 该适配器需要提高性能。
Adapters for JDBC 和 Oracle Applications

31759

现在未预订的事件会生成要发送电子邮件通知的适当严重性级别的消息。在停止预订协作时会发生该情况。
Adapters for JDBC 和 Oracle Applications 32390 依赖性子目录中的 SQL 脚本存在问题。
Adapters for JDBC 和 Oracle Applications 32484 连接器必须更改它处理日期字段的方法。
Adapters for JDBC 和 Oracle Applications 32508/14585 如果对象关键字使用“名称-值”对,则 JDBC 连接器使用缺省值进行轮询。
Adapters for JDBC 和 Oracle Applications 35078 如果 SPBeforePoll 调用失败,则适配器应返回 APPRESPONSE TIMEOUT。
Adapters for JDBC 和 Oracle Applications 35455

对于“Delete”动词,如果父业务对象是包装器业务对象,则不删除该包装器业务对象的多基数子业务对象。

Adapters for JDBC 和 Oracle Applications 35954

在通过业务对象层次结构使用“复制”属性传播值时,未对 N 基数的子业务对象传播此类值。

Adapters for JDBC 和 Oracle Applications 36188 连接器属性 RetryCountAndInterval 对于子业务对象数据不起作用。
Adapters for JDBC 和 Oracle Applications 43390 检索存储过程参数的大 CLOB 对象时需要支持。
Adapters for JDBC 和 Oracle Applications 58660 如果存储过程的输出参数是 RS(ResultSet),则该适配器会返回一个错误消息。
Adapters for JDBC 和 Oracle Applications 59112 ping 查询失败之后,该适配器无法打开新的数据库连接。
Adapters for JDBC 和 Oracle Applications 59609 该适配器无法执行与 AfterRetrieveByContentSP 关联的存储过程。
Adapters for JDBC 和 Oracle Applications 59817 未返回当结果集在容器的 retrieveSP 中为 null 或空时创建的哑元业务对象。
Adapter for JMS 35855 在事件通知期间,WebSphereMQ 无法将其他 JMS 提供程序所生成的 MessageID 复制到 WebSphere MQ 消息的 CorrelationID 字段。
Adapter for JMS 60609 添加了对使用 BIDI 的支持。
Adapters for JMS 和 WebSphere MQ 33728 在配置元对象中未配置唯一转换属性时,该适配器不能正确地将事件映射至业务对象。
Adapters for JMS 和 WebSphere MQ 36128 当未配置 InputQueue 连接器属性时,该适配器不会进行初始化。
Adapters for JMS 和 WebSphere MQ 36438 从该适配器的发行版 2.5.x 开始,动态和静态元对象中的转换属性名是区分大小写的。
Adapters for JMS 和 WebSphere MQ 37094 如果为该适配器配置多个输入队列,则在处理当前消息时,转换属性检索机制会发生故障。
Adapter for JText  27291 在通过“日志查看器”查看消息时,JText 日志消息中的换行符会导致问题。
Adapter for JText  35432 在使用 SortFilesOnTimestamp 属性并存在大量输入文件时,JText 会花费较长时间来处理它们。
Adapter for JText  37132 为带有 FTPKeepConnectionOpen 属性(设置为“true”)的服务调用远程指定输出目录时,会发生异常。
Adapter for JText 43454 在使用设置为空白的 JText 配置元对象 MO_JTextConnector_Default 的 EventExt 属性来轮询该适配器时,轮询会失败并且该适配器会终止。
Adapter for JText 44014 该适配器不会通过 Windows 控制面板作为服务来启动。
Adapter for JText 46046 在事件处理期间或服务调用期间发送大业务对象(大约 5 MB)时,会导致 OutOfMemory 错误。
Adapter for JText 46499 在分区数据集(PDS)系统中,JText 不会归档与文件掩码匹配的多个文件。
Adapter for JText 46569 当为 MVS 连续数据集(SDS)指定 FTPArchiveDir 和 FTPRenameExt 属性时,该连接器无法归档文件。
Adapter for JText 46570 在事件处理期间,在 MVS 系统上再次轮询同名的输入文件时,不能成功归档该文件。
Adapter for mySAP 33314 处理请求期间,在响应对象中废弃 ObjectEventId。该问题已得到修正。在“扩展模块”中,保留 ObjectEventId 的值以用于处理请求。
Adapter for mySAP 34205

在处理请求期间,当 SAP 服务器突然关闭时,请求事件不再会丢失。

Adapter for mySAP 34614

保留 ObjectEventId 的值以用于处理请求。

Adapter for mySAP 35192

在将用于 ALE 请求处理的多个状态文件填入 Request 目录时,性能会降低。

Adapter for mySAP 35387

必须校正在将段发送至 SAP 时在段中用于填充字段的空格字符的设置。

Adapter for mySAP 35673

在使用来自 SAP R/3 4.7 系统的 IDOC 文件时,业务对象中生成的特定于应用程序的信息不正确。

Adapter for mySAP 36006

该适配器未使用已配置的 AleEventDir 连接器属性值来创建 Request 文件夹。Request 文件夹使用 TID 管理来存放用于 ALE 请求处理的状态消息文件。

Adapter for mySAP 37005

在使用 ABAP BAPI_Handler 时必须正确处理子业务对象。

Adapter for mySAP 37323

当该连接器暂停时所发送的事件不能再到达状态为 3 的归档表。这些事件保留在状态为 Q、已准备好进行轮询的事件表中。该更改要求从下列文件导入传输:4_Delivery.zip 和 4_Utilities.zip。

Adapter for mySAP 37455

在处理带有空文本段的 IDOC 时,该适配器不再会出现故障,不会出现 MQ 错误。

Adapter for mySAP 42920

RFC 节点的“根据描述搜索”BAPI/RFC 未正确生成其相应的业务对象。

Adapter for mySAP 44080

当该适配器暂停时,某些事件会消失。通过该修正,会列出事件队列中的所有事件。

Adapter for mySAP 44697

现在支持 MS932 日语字符。必须使用配置属性 PartnerCharset 来指定 PartnerCharset 编码。

Adapter for mySAP 45003

暂停该连接器时,事件被发送至错误队列。通过该修正,在连接器恢复时,事件保留在要重新处理的事件队列中。

Adapter for mySAP 58492

重新启动/重试功能未正确地重新启动该连接器。

Adapter for mySAP 58858

在控制记录数据(SAP ALE)错误的情况下,该适配器不再抛出 NullPointerException。

Adapter for mySAP 58954

如果业务对象不受支持,则该适配器不应终止。而是应该记录错误并使该适配器保持活动。

Adapter for mySAP 59037

在业务对象中不存在 Dummy_key 属性时,该适配器发生故障。通过该修正,适配器会成功处理事件而无需 dummy_key 映射。

Adapter for mySAP 59080 在从 WebSphere Message Broker 接收到无效响应消息时,RfcServer 不再终止。
Adapter for mySAP 60038

通过该修正,可在 SAP 4.7 系统上使用事件链接机制。该更改要求将传输导入至 47_EventTriggering.zip 文件。

Adapter for mySAP 60078

在发送带有 CR LF 字符的业务对象之后,该适配器不再挂起。

Adapter for mySAP 60220

ODA 无法创建在导入和导出字段中包含相同结构的业务对象。通过该修正,可唯一地重命名这些结构并可成功创建对象。

Adapter for Web Services 28828 在实例化包含所需属性的协议配置元对象时,该连接器发生故障。
Adapter for Web Services 30117 在 Adapter for Web Services 平稳终止时,如果启动轮询循环或手工终止该适配器,则它会在不释放资源的情况下立即退出。
Adapter for Web Services 30302 特定于应用程序的信息属性 ws_prop_name 未用于传播用户定义的协议属性。
Adapter for Web Services 30580 在 Web 服务描述语言(WSDL)ODA 遇到循环模式引用时,它会断开连接。
Adapter for Web Services 30816 HTTP 处理程序从响应读取的内容长度不应超出有效内容的长度。
Adapter for Web Services 36663 SOAP 数据处理程序不填充与某个仅有属性而没有子元素的元素相对应的业务对象。
Adapter for Web Services 37217 SOAP 数据处理程序不填充带有某些元素的业务对象,这些元素只有属性而没有子元素。
Adapter for Web Services 47158

该适配器将新行追加至内容的开始处,该内容是从对子数据处理程序的调用返回的。SOAP 数据处理程序元对象现在支持具有可能值 true 或 false 的新属性 UseNewLine。值 true 在结果的开始处添加一行新行,该结果是从对子数据处理程序的调用获取的。值 false 会将内容附加至元素 opening 标记。对于向后兼容性,缺省值是 true。例如:

- UseNewLine is set to true
<ParentElement>
content obtained from a child datahandler</ParentElement>
- UseNewLine is set to false
<ParentElement>content obtained from a child datahandler</ParentElement>
Adapter for Web Services 59943

SOAP/JMS 协议处理程序不会使某一在已配置的 ResponsetWaitTimeout 值内没有响应的请求失败。

Adapter for Web Services 60193

如果不指定 HTTP 头内容长度,则 SOAP/HTTP(S) 处理程序会忽略同步响应有效内容。

Adapter for WebSphere Commerce 不适用 添加了对 WebSphere Commerce Business Edition V5.6 的支持。
Adapter for WebSphere Commerce JR20054/CR36128 修正了该适配器中的一个问题,在未配置特定于连接器属性 InputQueue 的情况下,该问题导致适配器在初始化期间发生故障。
Adapter for WebSphere Commerce JR20054/CR36438 修正了该适配器中的一个问题,该问题是对元对象的特定于应用程序的信息和属性名强制区分大小写。
Adapter for WebSphere Commerce JR20054/CR33728 修正了该适配器中的一个问题,该问题是在静态元对象属性中配置了非唯一 InputFormat/InputQueue 值的情况下,允许错误地对转换属性进行高速缓存。
Adapter for WebSphere Commerce JR20054/CR37094 修正了该适配器中的一个问题,该问题是在对该适配器配置了多个输入队列的情况下,当处理不确定的事件时,该适配器将转换属性不正确地映射至事件消息。
Adapter for WebSphere MQ 34969 在同步事件处理期间,该适配器不将数据处理程序错误发送至报告消息。
Adapter for WebSphere Commerce 44680 在使用 RestartRetry 配置时,该适配器不能重新启动。
Adapter for WebSphere Commerce 59006 添加了对定制安全出口的支持。
Adapter for XML 6526
  • 在尝试从业务对象转换为 HTTP 消息之前,如果需要的话,异步协议处理程序会检查和截断 MIME 类型。
  • 异步协议处理程序包含其他超时/重试功能。
  • 异步协议处理程序包含用于执行 base64 编码的选项。
Adapter for XML 32205 在将请求发送至连接器(它正在使用同步 HTTP 协议处理程序)时,如果目标站点正忙,则该适配器会无限期等待,这会导致协作线程也会无限期等待。当等待的线程数增加到协作的并发事件属性中的数目时,不会再处理任何事件。必须重新引导 InterChange Server。
Adapter for XML 59588 当业务对象包含日语字符时,如果在 Web 服务器上接收该业务对象,则这些字符会被破坏。
XML 数据处理程序 31537 该数据处理程序不能向后兼容某些业务对象定义。
XML 数据处理程序 32710 不填充业务对象中的 xml:lang 属性。
XML 数据处理程序 35141 在丢失文档类型声明或处理指令的情况下,在将 XML 转换为业务对象时,该数据处理程序返回一个错误。
XML 数据处理程序 35148 该数据处理程序不支持 UTF-16 格式的文档。
XML 数据处理程序 42671 该数据处理程序错误地转换了 XML 文档,这些文档包含一组作为元素数据的方括号([ ])。
XML 数据处理程序 44470 XML ODA 不处理某些模式,这些模式将其他模式导入至不同名称空间并具有复杂类型或同名元素。在发生该错误时,ODA 在业务对象生成期间显示下列内容:“调用 core.setAgentProperties 出错: 未找到类型为 QuoteSubLine 的模式。”

安装需求

无论您是从 CD 安装该软件还是从 Passport Advantage 下载并从本地目录安装它,请参阅《WebSphere Business Integration Server Express 安装指南 Linux 版》一书。

局限性

在下列日期之后,WebSphere Business Integration Server Express Plus V4.4 可提供 WebSphere Business Integration Connect Express 产品:

如果在上述日期之前接收到 WebSphere Business Integration Server Express Plus V4.4 介质,您可以:

已知问题和变通方法

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

组件 跟踪号 描述
服务器 45170/45175 组合标识关系(用于使父业务对象和子业务对象相关的标识关系)功能部件在该 WebSphere Business Integration Server V4.4 中不起作用。
服务器 45460 如果多次(在较长时期内可能达几千次)关闭并重新启动 WebSphere InterChange Server Express 和/或适配器而未重新启动命名服务器,则该命名服务器不会释放内存。

变通方法:如果发生该问题,则关闭 WebSphere InterChange Server Express 和适配器,关闭命名服务器,然后重新启动该服务器和适配器。

安装程序 43593 因为标题文本的长度太长,它在消息对话框中可能会被截断;然而,预期的消息内容还是显示了。
安装程序 45860 如果将 WebSphere Business Integration Server Express 从修订包 4.3.1.1 升级至版本 4.4,则 4.3.1.1 的卸载程序会保留在该机器上的 install_location\_uninst 目录中。

变通方法:不要运行包含在install_location\_uninst 目录中的卸载程序来升级至版本 4.4,因为它会影响安装。您可手工除去该目录。但是,在原位保留该目录不会影响该产品的功能。

ADK 66604 如果在适配器和 WebSphere InterChange Server Express 运行时关闭并重新启动了服务器,则该适配器会基于为它指定的 RestartRetryCount 和 RestartRetryInterval 属性来尝试连接至该服务器。但是,如果重试次数用完而服务器在该时间段中没有重新启动,则该适配器不会重新启动并会发生异常。仅当传输方式是 JMS 时才会发生该情况。如果在发生该异常之后重新启动服务器,则适配器仍不能连接至服务器。必须手工停止并重新启动该适配器才能连接至服务器。
启动板 37017 从 CD 运行启动板时,启动板的闪屏悬挂在最初的窗口上。有些标注了 DVD Multi Player & Compact Disk Rewritable High Speed(该驱动器必须拥有两者)的 CD 驱动器可能导致 Express Plus CD 在安装时挂起,并且闪屏会长时间悬挂着。

要解决此问题,如果可能,将 CD 驱动器配置成在安装时除去高速能力。如果不可能,从电子化软件交付(ESD)映像运行安装。也可以尝试将所有的 CD 内容复制到硬盘驱动器上。
系统监视器 43759 如果在双字节字符语言中使用 Netscape 4.7x,字符可能在 Netscape 中不能显示。要将 Netscape 配置成启用双字节字符集字符显示,请遵循这些步骤进行操作:
  1. 从 Netscape 的视图菜单选择字符集 > Unicode(UTF-8)
  2. 视图菜单选择字符集 > 设置缺省字符集
  3. 编辑菜单选择首选项
  4. 首选项窗口中选择外观 > 字体
  5. 编码字段中选择 Unicode
  6. 可变宽度字体字段中选择 Lucida Sans Unicode
  7. 选择使用我的缺省字体,覆盖文档指定的字体
  8. 单击确定
基于 Web 的部署 45346 将 WebSphere Application Server 5.1.1 用作 Web 部署的应用程序服务器时,Web 部署工具不能使用 HTTPS 连接至 WebSphere Business Integration Server Express。该问题是由 WebSphere Application Server V5.1.1 的缺省系统属性 java.protocol.handler.pkgs 所导致的,它被设置为 com.ibm.net.ssl.internal.www.protocol。 对于 HTTPS,必须将该属性设置为 com.ibm.net.ssl.www.protocol 才能正常工作。要重新设置该属性,请遵循下列步骤进行操作:
  1. 转至开始 > 程序并找到 WebSphere Application Server 5.1.1 快捷方式。
  2. 单击启动 Application Server
  3. 打开“管理控制台”(本地)
  4. 登录该控制台(将 ibm 用作用户标识)
  5. 在左面板中单击服务器
  6. 单击 Application Servers
  7. 单击 ICSMonitor
  8. 单击进程定义
  9. 单击 Java 虚拟机
  10. 滚动以查找“通用 JVM 实参”,并将下列内容添加至现有实参的末尾:

    -Djava.protocol.handler.pkgs=com.ibm.net.ssl.www.protocol
国际化 70964 InterChange Server Express 可生成一组作为诊断辅助的消息,以用于解决方案开发。这些消息未被翻译,只能用英语显示。在该产品的正常操作期间可能会显示这些消息中的某些消息。

适配器 跟踪号 描述
Adapter for eMatrix 66617 该适配器文档错误地指定了“ArchiveProcessed”属性;但是,配置模板正确地指定了“ArchivedProcessed”。
Adapter for iSeries 45275 ODA for iSeries 中的三个属性(TracefileName、Messagefilename 和 Tracelevel)从随 Adapter Framework V2.6 交付的 XML 文件中获取其缺省值,它们在业务对象设计器工具中不可视。
Adapter for iSeries 45475 iSeries ODA 需要以下变通方法来选择 IFS 文件。

变通方法:在 iSeriesFilePath 属性中提供完整的 iSeries IFS 文件路径,例如 /QSYS.LIB/PNPLIB.LIB/SRCPF.FILE/。设置该路径之后,ODA 会在该文件夹下列出文件。选择适当的文件以生成业务对象。有关更多信息,请参阅以下地址上的技术说明: http://www-1.ibm.com/support/docview.wss?rs=695&context=SSMKUK&dc=DB520&q1=iseries&uid=swg21188205&loc=en_US&cs=utf-8&lang=en

Adapter for JDBC 不适用 WebSphere Business Integration Adapters 和 InterChange Server Express 不支持双向字符作为业务对象的一部分和业务对象属性名。

变通方法:在基于数据库表(其列名包含双向字符)生成业务对象模板之后,请重命名包含非拉丁字符的所有业务对象名和属性名,以使它们只包含拉丁字符。

Adapter for JDBC 不适用 在 JDBC ODA 中,用于 DB2 OS/390 IBM 通用 JDBC 驱动程序的希伯莱语的表名和列名会限制应如何将非拉丁字符指定为 SQL 查询的一部分。特别是,如果表名和列名未括在括号中,则它不会正确处理将双向字符用作表名和列名一部分的 SQL 查询。

变通方法:由于在特定于应用程序的信息(ASI)中,JDBC ODA 生成的业务对象模板不会将表名和列名括在括号内,因此,如果您正在通过 IBM 通用 JDBC 驱动程序使用那些模板与 OS/390 DB2 通信,则按如下方式修改业务对象模板中的表名和列名:

  • 使用 TN="<table name>" 来替换该业务对象级别的 ASI 中的所有 TN=<table name>。
  • 使用 CN="<column name>" 来替换该业务对象属性级别的 ASI 中的所有 CN=<column name>。
Adapter for JDBC 不适用 由于 DB2 OS/400 IBM 通用 JDBC 驱动程序的局限性,在生成的业务对象模板中没有包含那些包括了双向字符的表列名称。因此,在业务对象模板生成期间,仅考虑包含拉丁名的列。如果表没有带拉丁名的列,则不生成业务对象模板。
Adapter for JDBC 43503 在使用 ODA 从 Linux 上运行的 DB2 数据库服务器生成业务对象时,业务对象设计器会挂起。发生此问题是因为 DB2 JDBC Applet Server 没有启动。

变通方法:登录 DB2 服务器并运行以下命令:db2jstrt LISTENPORT。

Adapters for JDBC 和 Oracle Applications 41966 在使用 Oracle 瘦驱动程序时,由于该驱动程序不支持对 StoredProcedures 进行同义词分析,所以 JDBC ODA 不能从存储过程的昵称生成业务对象。

变通方法:通过 ODA 使用实际的存储过程名称来生成业务对象,或者手工构造业务对象。

Adapters for JDBC 和 Oracle Applications 41967 在显示 ODA 配置属性或提示输入特定于业务对象定义的属性时,Adapter Framework 不能处理超出 20,000 个的属性值。确保下拉列表中返回的值不超过 10,000 个,否则 ODA 会挂起。
Adapters for JDBC 和 Oracle Applications 43246 Oracle Applications ODA 的启动脚本在 DRIVERPATH 中包括 xworacle.jar 文件,它没有按预期在 Oracle 数据库中列出所有表。

变通方法:要在数据库中列出所有表,请使用 Oracle 所提供的本机 JDBC 驱动程序 classes12.zip 文件。

Adapters for JDBC 和 Oracle Applications 43888 在分析 SQL Server 数据库时,JDBC ODA 显示带有“;1”后缀的存储过程节点名。这是 SQL Server 数据库的问题,尚未修正。

变通方法:在生成的业务对象中,在为存储过程属性所生成的特定于应用程序的信息中手工除去“;1”。

Adapters for JMS 和 WebSphere MQ 45751 消息键 21021 在 WebSphere MQ 消息文件中丢失。这是通用错误消息:“无法完成处理。请参阅以前的错误消息以获取详细信息”。
Adapter for JText 不适用

本发行版在该适配器中包含下列局限性:

  • JText 有两种处理方式:文本(正常方式)和二进制。二进制方式要求插入适当的数据处理程序。
  • JText 不能重命名使用 MVS 命名约定的数据集。
  • 由于 MVS 的局限性,MVS 中的归档逻辑与 UNIX(R) 和 Windows(R) 环境中的归档逻辑不同。
  • 仅当 FTP 服务器支持修改日期和时间(mdtm)命令时,JText 才可根据时间戳记从 FTP 站点轮询远程文件。启用此功能会降低性能,特别是在事件目录中存在大量事件文件的情况下。
  • 在将 JText 适配器中的 LargeObject 元对象属性设置为 true 时,该适配器会遵循另一种的归档方法。在该方法中,如果事件文件有多个业务对象,则只能在处理了该事件文件的所有业务对象之后才可执行归档。并且,不归档原始文件,以防对该事件文件的所有业务对象进行的业务对象处理会导致故障或导致未预订的状态。仅当对该事件文件进行的业务对象处理导致出现混合状态(例如,有成功的状态,也有失败的状态)时,才归档该原始文件。
  • 由于下列限制,在本发行版中不存在对 FTPFileEventMask 属性的双向支持:
    • 只有 VM 操作系统才允许定义包含双向字符的文件名。
    • JText 连接器中的 FTP 支持不允许与 VM FTP 进行通信。
Adapter for JText 33378 如果进行大量请求调用,那么在进行 n 个调用时,JText 仅写出 n-1 个文件。
Adapter for JText 34834 JText 需要安全的 FTP 支持。对于 JText 系统管理员可看到的密码字段,如果使用安全 FTP,则任何人都看不到。
Adapter for JText 35571 需要提供一个规定,以在二进制处理方式中将 EOF 指定为 EndBODelimiter 的值。

变通方法:对于 EndBODelimiter 不超过 EOF 本身的所有文件,使用十六进制编辑器来包含几个字节(例如 FF02)作为定界符,并将这些字节指定为 EndBODelimiter。

Adapter for JText 58964 对于文件路径中有非拉丁字符的 FTP 服务器,JText 使用下列编码约定:
  • 如果语言环境是希伯莱语,则使用 ISO-8859-8
  • 如果语言环境是阿拉伯语,则使用 ISO-8859-6
  • 如果是除上述两种语言之外的其它所有语言,则使用 ISO-8859-1
Adapter for Lotus Domino 31633 在 UNIX 环境中,安装程序生成 connector_manager_adapter 脚本。该脚本引用 Adapter Framework V2.4.0 所引入的 adapterEnv.sh。如果您正在运行更早版本的 Adapter Framework,则 adapterEnv 不可用。要将本版本的适配器与较早版本的 Framework 一起运行,则在 connector_manager_adapter 脚本中将引用从 adapterEnv.sh 更改为 CWSharedEnv.sh。
Adapter for mySAP 70689 在处理大的 IDOC 时,Adapter for mySAP 抛出 OutOfmemory 异常。

变通方法:请参阅技术说明 Memory utilization for the IBM WebSphere Business Integration Adapter for mySAP.com v6.0.0 (ALE module)

Adapter for Oracle Applications 41977 在使用 DataDirect SQL 驱动程序时,Oracle Applications ODA 不会为返回结果集的存储过程生成适当的特定于应用程序的信息。当存储过程返回结果集时,该驱动程序不支持返回类型的分析。例如,存储过程返回 @RETURNVALUE, ODA 不能使用它来生成属性。

变通方法:在业务对象定义中手工添加该属性。

Adapter for Oracle Applications (Adapter Framework) 66615 在使用动词级别的特定于应用程序的信息时,Adapter for Oracle 在执行 retrieve 操作或 retrieveall 操作时发生故障并出现下列错误:“java.sql.SQLException: ORA-00933: 不能正常终止 SQL 命令”。该问题由 Adapter Framework 问题所导致,并且仅在将 JMS 用作 DeliveryTransport 时才出现该问题。

变通方法:将 DeliveryTransport 标准属性设置为 IDL。

Adapter for Web Services 不适用 在 XML ODA 中,不支持双向字符作为业务对象的一部分和业务对象属性名。

变通方法:在生成了基于 XML/XSD 文件(其属性/元素名包含双向字符)的业务对象模板之后,请重命名包含非拉丁字符的所有业务对象名和属性名,以使它们只包含拉丁字符。

Adapter for Web Services 23993

当 WSDL ODA 遇到多个彼此导入而不提供模式位置的直接插入模式时,它会记录警告或错误;但是,会正常生成业务对象。

变通方法:将每个模式分成单独的文件并更新 imports/includes 以包含适当的文件位置。使用带有适当文件位置的 import 语句将这些单独的模式文件导入至 WSDL 文档。

Adapter for Web Services 24662

如果将 WebSphere MQ 5.3 CSD03 用作 JMS 提供程序,那么在将消息从输入队列移至当前队列时,该适配器 JMS 侦听器不能读消息体。这是 WebSphere MQ 应用程序的问题。

Adapter for Web Services 59428 当以非编码格式指定目标 URL 时,Web 服务描述语言(WSDL)ODA 不能通过包含非英语字符的 URL 来访问 WSDL 文件。但是,WSDL ODA 可成功处理本地路径包含国际字符的那些文件。

变通方法:使用编码的 URL,或将 WSDL 文件保存至本地存储器并使用本地路径而不是 HTTP URL。

Adapter for Web Services 59584 当以非编码格式指定目标 URL 时,该适配器不能将 HTTP(S) 请求发送至包含非英语字符的 URL。

变通方法:使用编码的 URL。

Adapter for Web Services 59634 该适配器不能对使用非 TLO(顶级业务对象)的同步侦听器请求生成响应。
Adapter for WebSphere Commerce 42516 在商业服务器上使用带有修订包 4 的 WebSphere Commerce Business Edition V5.5(或更早版本)时,无法使用 Adapter for WebSphere Commerce 正确创建仓库用户。由于权限不正确,仓库用户无法登录到仓库。需要 Websphere Commerce 紧急修订程序来修正此问题。紧急修订程序是带有修订包 4 的 WebSphere Commerce 5.5 上的 JR20090。
Adapter for WebSphere MQ 34688 处于 CSD06 或更低级别的 WebSphere MQ V5.3 不支持 JMSCorrelationID 字段中的双向数据;因此,为了充分利用该适配器的双向功能,您必须使用处于 CSD07 级别的 WebSphere MQ V5.3。
Adapter for WebSphere MQ 58988 在 Linux(TM) 多处理器系统上进行部署时,该适配器挂起。该问题是由已知的 Linux JDK 1.4.2 问题引起的,在垃圾回收期间,它导致挂起。(此 JDK 问题的 PMR 号是 27182.001.866。)

变通方法:修改适配器启动脚本以使用选项 "-Xgcthreads1" 来设置 JVMArgs 变量,如下例所示:
JVMArgs="-Xgcthreads1 %JVMArgs%"

文档

CD 或电子产品分发未包括产品文档作为产品软件包的一部分。此产品的文档可从 IBM WebSphere Business Integration Server Express InfoCenter 中找到。

适配器用户指南 不适用

在本发行版中,某些适配器指南(如下所示)尚未修订特定于 WebSphere Business Integration Server Express 和 Express Plus 发行版的产品名、平台支持和功能部件限制等信息。但是,提供了 IBM WebSphere Business Integration Adapters 产品发行版的最新版本指南。上述情况适用于下列指南:

Adapter for eMatrix User Guide
Adapter for Healthcare Data Protocols User Guide
Adapter for HTTP User Guide
Adapter for iSeries User Guide
Adapter for JMS User Guide
Adapter for Lotus Domino User Guide
Adapter for mySAP.com (for SAP R/3 V. 3.x) User Guide
Adapter for Oracle Applications User Guide
Adapter for SWIFT User Guide
Adapter for TCP/IP User Guide
Adapter for Web Services User Guide
Adapter for WebSphere Commerce User Guide
Adapter for WebSphere MQ User Guide

这些指南包含 IBM WebSphere Business Integration Adapters 产品发行版中所交付的适配器功能部件的最新信息。您可能会注意到这些指南中所引用的某些工具名称与 IBM WebSphere Business Integration Server Express 和 Express Plus 产品所交付的工具的名称之间有差别。另外,这些指南中可能出现的下列功能部件引用对于 WebSphere Business Integration Server Express 和 Express Plus 发行版无效:

  • 对集成代理程序而不是 InterChange Server Express 的引用
  • 对作为交付传输机制的 MQ 的引用
  • 对使用 MQ 因特网传递的连接器代理程序实施的引用,该 MQ 因特网传递通过安装在因特网防火墙另一端的 InterChange Server Express 来实施连接器代理程序
  • 对连接器代理程序并行性的引用
  • 对 ITLM 签名的引用

另外,在“本发行版中的新增内容”中详细说明了 Linux 平台支持声明,且上面所列指南中的适配器平台部分不是最新的。对于本发行版中列示为支持 Linux 的适配器,受支持的 Linux 版本如下所示:

  • Red Hat Enterprise Linux WS/AS/ES 3.0 Update 2 Intel (IA32)
  • SuSE Linux ES 8.1 SP3 Intel (IA32) 和 SuSE Linux ES 9.0 Intel (IA32)
特定于平台的信息通常与指南中的下列章节相关:
  • 平台支持声明
  • 路径名和文件名参考
  • 创建和使用启动脚本
  • 用于启动和停止连接器的指示信息
  • 用于创建新配置文件的指示信息
  • 用于设置连接器配置器中“安全”属性的指示信息

System Implementation Guide《系统管理指南》中可找到有关 Windows、Linux 或 OS/400 及 i5/OS 上受支持的所有适配器相关的实施和管理任务。要获取更多信息并了解有关适配器功能局限性的问题,请访问 WebSphere Business Integration Server Express support Web 站点

提供了以下适配器的用户指南:
Adapter for eMatrix
Adapter for iSeries
Adapter for JDBC
Adapter for mySAP.com
Adapter for Oracle Applications
Adapter for Web Services
66473 这些指南描述了“业务对象向导”的步骤 2 中所提供的 ODA 初始化属性。在这些指南中列出了下列 ODA 初始化属性,但在缺省情况下,通过“业务对象向导”不能获取这些属性:
  • TraceFileName
  • TraceLevel
  • MessageFile
对于消息文件中具有 BIA_ 或其它此类前缀的 ODA,确保文件 oda.dd.xml 存在于 ODA/adapterNameODA 文件夹中。并且,确保 messagefile 的输入在 oda.dd.xml 文件中设置了相应的前缀,例如:
<messagefile prefix="BIA_">></messagefile>

这就确保了装入合适的消息文件之后,ODA 会正常启动。

IBM 软件支持

可在 WebSphere Business Integration Server Express support Web 站点找到有关该产品的支持信息。

要想每周接收有关修订的电子邮件通知和有关 IBM 产品的其它新闻,请执行下列步骤:

  1. 在 Support 站点中,单击该支持页面右上角的 My support
  2. 如果已注册到 My support,则跳至下一步。如果尚未注册,则单击 My support 登录页面上的 register now,使用您的电子邮件地址作为 IBM 标识。
  3. 登录至 My support。
  4. Edit profile 选项卡中单击 Add Products
  5. Products 下拉列表中选择 Software 或任何其它产品类别。该操作会使第二个下拉列表出现。
  6. 从第二个下拉列表中选择某一产品部分,例如,Application server。会出现第三个下拉列表。
  7. 从第三个下拉列表选择产品子部分,例如,Distributed Application & Web Servers。会显示一个可应用的产品列表。
  8. 选中您要接收更新的产品旁边的复选框,例如,IBM HTTP ServerWebSphere Application Server
  9. 单击 Add products

与 IBM 软件支持机构联系

IBM 软件支持机构对产品缺陷提供帮助。与 IBM 软件支持机构联系之前,贵公司必须具有有效的 IBM 软件维护合同,并且您必须已被授权向 IBM 提交问题。您需要的软件维护合同的类型取决于您具有的产品类型:

如果您不能确定需要哪种类型的软件维护合同,在美国请致电 1-800-IBMSERV(1-800-426-7378), 如果是在其他国家或地区,请访问 Web 上的 IBM Software Support Handbook 联系人页面(techsupport.services.ibm.com/guides/contacts.html),然后单击您所在地理区域的名称以获得您所在的地区可提供支持的人员的电话号码。

按照本主题中的步骤与 IBM 软件支持机构联系:

  1. 确定问题对业务产生的影响。
  2. 描述问题并收集背景信息。
  3. 向 IBM 软件支持机构提交问题。

确定问题对业务的影响

当向 IBM 报告问题时,将要求您提供严重性级别。因此,您需要了解并评估您报告的问题对业务造成的影响。使用以下标准:

严重性级别 1 严重业务影响:无法使用程序,对操作产生严重影响。这种情况要求立即解决。
严重性级别 2 重大业务影响:程序仍然可用,但是受到极大限制。
严重性级别 3 一定程度的业务影响:程序是可用的,但是不太重要(对操作不起关键作用)的功能部件不可用。
严重性级别 4 最低程度业务影响:问题对操作造成的影响很小,或者已经对问题采取了合理的应对措施。

描述问题并收集背景信息

当向 IBM 说明问题时,请尽量详细一些。请包括所有相关的背景信息,以便 IBM 软件支持机构的专家能够更有效地帮助您解决问题。为了节省时间,请明确回答下列问题:

向 IBM 软件支持机构提交问题

可以使用下面两种方法中的任何一种来提交问题:

如果您提交的问题是关于软件缺陷或者是关于缺少文档或文档不准确,则 IBM 软件支持机构将创建一个“授权程序分析报告”(APAR)。该 APAR 详细描述了该问题。只要有可能,IBM 软件支持机构在解决 APAR 并提供修订之前将提供一种变通方法让您来实施。

IBM 每天都在 IBM 产品支持 Web 页面上发布已解决的 APAR,以便遇到相同问题的其他用户也可以使用相同的解决方案。

Copyright IBM Corp. 2004, 2005