IBM WebSphere Business Integration Server Express V4.3.1 for Windows 发行说明

这些发行说明包括了 IBM(R) WebSphere(R) Business Integration Server Express 和 IBM WebSphere Business Integration Server Express Plus V4.3.1 for Windows(R) 的信息。它们包含以下各节：

本发行版中的新增内容 安装、迁移、升级和配置信息
产品修订历史记录 已知问题和变通方法
硬件和软件需求 文档

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

本发行版中的新增内容

除了 Windows 2000 上的现有支持之外，此发行版在下列操作系统上添加了对 InterChange Server Express 的支持：

对于此发行版，MetaSolv 适配器现在支持产品服务请求（PSR）和本地服务请求（LSR）模块。

产品修订历史记录

在发行版 4.3.0 与 4.3.1 之间，以下问题已根据客户报告的情况得到修订。

组件 跟踪
号 		描述
JDBC 适配器和 Oracle Applications 适配器 31759

当协作当机时，如果已设置电子邮件协作，则错误消息应通过电子邮件发出。当前，电子邮件未发出。要使电子邮件设置好，则错误消息应使用严重性级别进行记录。当严重性为 FATAL 时，已用严重性级别对日志消息进行更改。取消预订的对象现在已记录为 FATAL 错误类型。已在修订包 2.4.4 中修订。
JDBC 适配器和 Oracle Applications 适配器 35455

对于“删除”查询描述，如果父业务对象是包装器业务对象，则多个基数子业务对象未删除。当处理“删除”查询描述时，包装器业务对象的多个基数子业务对象现在已删除。已在修订包 2.4.4 中修订。
JDBC 适配器和 Oracle Applications 适配器

35954

 当使用 Copy 属性在业务对象层次结构中向下传播值时，未对基数 n 个子业务对象传播值。Copy 属性值现在已对基数 n 个子业务对象传播。已在修订包 2.4.4 中修订。
MetaSolv Applications 适配器 36472 已在修订包 2.7.1 中增加了对产品服务请求（PSR）和本地服务请求（LSR）模块的网关服务器的支持。
Portal Infranet 适配器 在请求处理期间，当连接器正在从业务对象构造 input-Flist 时，它未在与具有值 CxBlank 的属性对应的 Flist 中创建字段。现在，InputFlist 包含这些属性（在输入业务对象的值也为 CxBlank）。已在适配器的修订包 4.2.2 中修订。
Siebel eBusiness Applications 适配器 32653 该适配器不会关闭，即使出现 ConnectErrors 连接器属性中指定的错误时也是如此。已在适配器的修订包 4.4.3 中修订。
Telcordia 适配器 当特定于连接器的属性 InputQueue 未配置时，Telcordia 适配器在初始化期间失败。已在适配器的修订包 2.5.2 中修订。
Telcordia 适配器 36438 Telcordia 适配器强制要求元对象特定于应用程序的信息（ASI）和属性名区分大小写。已在适配器的修订包 2.5.2 中修订。
WebSphere Commerce 适配器 36128 当特定于连接器的属性 InputQueue 未配置时，WebSphere Commerce 适配器在初始化期间失败。已在适配器的修订包 2.5.2 中修订。
WebSphere Commerce 适配器 36438 WebSphere Commerce 适配器强制要求元对象特定于应用程序的信息（ASI）和属性名区分大小写。已在适配器的修订包 2.5.2 中修订。
JDBC 适配器和 Oracle Applications 适配器 43246 OracleAppsODA 的启动脚本在 DRIVEPATH 中包括 xworacle.jar 文件，它没有按预期在 Oracle 数据库中列出所有的表。如果要在数据库中列出所有的表，可以使用 Oracle 提供的本机 JDBC 驱动程序 － classes12.zip。根据适配器用户指南中的指示信息在启动脚本中相应地设置驱动程序路径。
JDBC 适配器和 Oracle Applications 适配器

31301

 当检索存储过程返回的结果集时，适配器会标记以下错误：未找到属性 RS。在适配器检查属性名为 RS 后，会检索输出属性名。现在，在检查前可检索属性名，因此相应地处理 OP=RS。已在适配器的修订包 2.4.3 中修订。
JDBC 适配器和 Oracle Applications 适配器 31759 尽管已设置电子邮件通知，但当协作失败时未发送电子邮件消息。已在适配器的修订包 2.4.3 中修订。
JDBC 适配器和 Oracle Applications 适配器 32620 当更新整数键值具有前导零的子业务对象时，出现故障。当比较已检索业务对象和要更新的业务对象时，会比较所有键属性的字符串值，因此前导零会导致比较失败。

要解决此问题，现在首先将字符串值转换为相应的值，然后进行比较。已在适配器的修订包 2.4.3 中修订。
JDBC 适配器和 Oracle Applications 适配器 33565 当在父业务对象上设置外键时，如果缺少其中一个单基数子业务对象，则它前面的所有单基数子业务对象的外键会被 CxIgnore 覆盖。已修订此问题，因此外键被相应地填充。已在修订包 2.4.3 中修订。
JDBC 适配器和 Oracle Applications 适配器 34612 在轮询期间，多个至数据库的提交更新了事件中各个事件的状态，并尽可能快地将表进行归档。由于一些用户根据状态过滤事件中的各个事件，因此这是必需的；然而，这可能导致出现性能问题。

现在多个提交是可配置的。已引入新的特定于连接器的属性 SelectiveCommitForPoll。如果它的值为“true”，则在处理某一事件后只有一个提交。如果它的值为“false”，则其行为与以前相同，即至数据库的提交是在每个事件处理阶段完成的。该属性的缺省值为“false”。已在适配器的修订包 2.4.3 中修订。

WebService 适配器

36663

 SOAP 数据处理程序未填充与具有属性的元素对应的业务对象，但没有子对象。已在 Web Service V3.2.2 中修订。

硬件和软件需求

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

安装、迁移、升级和配置信息

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

注意：如果您将技术适配器和应用程序适配器安装在同一机器上，则通过 Server Express Plus 先安装技术适配器，然后通过“适配器功能包”安装程序安装每一个应用程序适配器。

已知问题和变通方法

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

组件名 跟踪号 描述
活动编辑器 42343 在活动编辑器中，可以从库窗口里的一系列全局变量中选择以用于定制活动。全局变量可以和 Java 变量一样简单（例如 String 类型）或者和业务对象变量一样复杂（例如 BusObj 类型）。当全局变量用在一个活动中的时候，它的赋值仅仅出现在活动的末尾，所以应避免使用在一个活动中具有相同根变量的不同变量。

但是，可以在不同的操作中执行两个子活动。如果必须使用具有相同根的变量，尝试重用单一的根变量来代替。
适配器 43586 通过 JMS 交付传输运行和使用本地连接器配置（通过 -c 命令行选项指定）的连接器的 AgentTraceLevel 属性仅可在该连接器的生存期内通过系统管理器动态更新一次。对此属性的后续动态更新尝试将失败。类似下列的消息将显示在日志中：
[类型：警告] [消息标识：14211] [消息：不允许动态更新 AgentTraceLevel。
在配置文件中，已为连接器代理程序设置值且将使用
以前设置的值。]
通过 JMS 交付传输运行和使用本地连接器配置的连接器的 AgentTraceLevel 属性不应通过系统管理器动态更新。如果该属性需要修改，则必须更新连接器配置文件并且重新启动连接器代理。否则，将会遇到刚才描述的错误，连接器控制器设置与连接器代理设置之间也可能发生不匹配。
JDBC 适配器 43503 当使用 ODA 从运行于 Linux 上的 DB2 数据库服务器生成业务对象时，业务对象设计器将会挂起。发生此问题是因为 DB2 JDBC Applet Server 没有启动。

要解决此问题，登录到 DB2 服务器，并运行下列命令：db2jstrt LISTENPORT。
JDBC 适配器和 Oracle Applications 适配器 43246 OracleAppsODA 的启动脚本在 DRIVEPATH 中包括 xworacle.jar 文件，它没有按预期在 Oracle 数据库中列出所有的表。如果要在数据库中列出所有的表，可以使用 Oracle 提供的本机 JDBC 驱动程序 － classes12.zip 文件来解决此问题。
JMS 适配器和 WebSphere MQ 适配器 37094 在处理来自其中一个多配置的输入队列中的一条不确定消息（来自 InProgressQueue）时，该适配器会根据特定于连接器的属性中的第一个输入队列来检索转换属性。
JMS 适配器 36128 当没有配置 InputQueue 属性时，适配器初始化失败。
JMS 适配器和 WebSphere MQ 适配器 33728 在事件处理过程中，当多个转换属性与某个输入消息的 InputFormat 和／或 InputQueue 匹配时，适配器试图不正确地使用静态元对象中最后一个匹配的业务对象属性作为输入消息的映射。在这种情况下，适配器应将消息内容传递给数据处理程序以允许数据处理程序来决定业务对象名称。

要解决此问题，为静态元对象中的每一个 BusinessObjectType_verb 属性配置唯一的 InputFormat 和 InputQueue 键。
JMS 适配器和 WebSphere MQ 适配器 34323 JMS 和 WebSphere MQ 适配器的样本旨在在 WebSphere InterChange Server Express 环境中提供适配器的配置和使用。在技术说明中提供使用这些样本的指示信息，它描述了如何在 WebSphere Business Integration Server Express 环境中使用这些样本来发送和接收业务对象。

JMS 适配器的技术说明可在以下位置找到：
http://www-1.ibm.com/support/docview.wss?rs=0&q1=JMS+adapter&uid=swg21174512&loc=en_US&cs=utf-8&cc=us&lang=en
WebSphere MQ 适配器的技术说明可以在以下位置找到：
http://www-1.ibm.com/support/docview.wss?rs=0&q1=WebSphereMQ+adapter&uid=swg21174510&loc=en_US&cs=utf-8&cc=us&lang=en
JMS 适配器和 WebSphere MQ 适配器 36438 配置元对象的特定于应用程序信息中转换属性名称和动态元对象的名称是区分大小写的。
JText 适配器 46499 如果与 MVS PDS 中的事件掩码匹配的文件多于一个，并且指定了 FTPRenameExt，则连接器仅归档一个文件且不能对第二个文件重命名和归档。要解决此问题，同时将 FTPArchiveDir 和 FTPRenameExt 指定为空白，以便在 MVS 事件文件不被重命名的情况下被删除。
JText 适配器 44014 通过 Windows 控制面板，该适配器将不会作为服务启动。

要解决此问题，在启动 JText 或 MetaSolv 作为服务之前，必须编辑该服务启动脚本。
  1. 转至 <installDirectory>\connectors\JText\start_JText_service.bat 文件，然后在文件结束处删除“pause” 语句。
  2. 保存文件，然后通过 Windows 控制面板启动服务。
JText 适配器 43454 当 JText 配置元对象 MO_JTextConnector_Default 的 EventExt 属性设置为空白时轮询 JText 适配器，轮询会失败并且适配器终止。
JText 适配器 35571 需要一个规定，即在二进制处理方式中指定“EOF”作为 EndBODelimiter 的值。
要解决此问题，对于 EndBODelimiter 正是 EOF 本身的所有文件，使用十六进制编辑器来包括几个字节（例如 FF02）作为定界符，并指定这些字节为 EndBODelimiter。
JText 适配器 34834 JText 需要安全的 FTP 支持。目前对 JText 系统管理员可见的密码字段，使用安全 FTP 则任何人都看不见。
MetaSolv 适配器 44014 通过 Windows 控制面板，该适配器将不会作为服务启动。

要解决此问题，在启动 JText 或 MetaSolv 作为服务之前，必须编辑该服务启动脚本。
  1. 转至 <installDirectory>\connectors\MetaSolv\start_MetaSolv_service.bat ，然后在文件结束处删除“pause”语句。
  2. 保存文件，然后通过 Windows 控制面板启动服务。
WebSphere Commerce 适配器 42516 在商业服务器上使用带有修订包 4 的 WebSphere Commerce Business Edition V5.5（或更高版本）时，无法使用 WebSphere Commerce 适配器正确创建仓库用户。因为权限不正确，仓库用户无法登录到仓库。需要 Websphere Commerce 电子修订来修订此问题。电子修订是带有修订包 4 的 WebSphere Commerce 5.5 上的 JR20090。
WebSphere MQ 适配器 34969 在同步事件处理期间，没有为数据处理程序错误发送报告消息。
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 精简版的卸载进程没有将数据库的别名从目录 C:\DB2\aliases_directory 中除去。

因此，在 WebSphere Business Integration Server Express 或 Express Plus 的最初安装中创建的、InterChange Server Express 资源库的名为 SMB_DB 的别名，在 DB2 卸载后保留下来。尽管此别名的存在没有影响到 DB2 企业版或 DB2 精简版的重新安装，但是当 WebSphere Business Integration Server Express 或 Express Plus 重新安装时，由于系统找到旧的 SMB_DB 别名，资源库创建会失败。

要解决此问题，在卸载和重新安装 DB2 企业版或 DB2 精简版前手工删除 SMB_DB 数据库。删除实际的数据库会除去它的别名。
文档 Data Handler Guide 指南为二进制主机数据处理程序不正确地参阅和提供了文档。二进制主机数据处理程序没有包含在产品中。
文档 MetaSolv 适配器的指南应说明 Metasolv 适配器现在支持产品服务请求（PSR）和本地服务请求（LSR）模块。
文档 对所有的指南，“本发行版中的新增内容”一节应为：
除了 Windows 2000 上的现有支持之外，此发行版在下列操作系统上添加了对 InterChange Server Express 的支持：
  • IBM OS/400 V5R2，V5R3
  • Red Hat Enterprise AS Linux 3.0，更新 1
  • 带有 SP3 的 SuSE Linux Enterprise Server 8.1
  • Microsoft Windows 2003
安装程序（适配器功能包） 35184 如果卸载操作正在静默方式中运行，则您将不能卸载各个适配器。要解决此问题，通过卸载程序 GUI 卸载适配器。
安装程序（适配器功能包） 44001 当在 Windows 2000 上为 Metasolv 和 JD Edwards OneWorld 适配器执行一个远程的或本地的功能包安装并且试图启动该适配器时，它会终止并出现错误：输入行太长。这是因为 Windows 2000 上的命令行长度问题。当执行一个远程的 CP 安装时，WebSphere Business Integration 的 Siebel 和 Oracle Applications 适配器具有相同的问题。此问题的一个变通方法是计划在此发行版后有一个技术说明可用。
安装程序（所有） 46851 在文件传输时，来自资源束的未解析文本可能出现在窗口中。特别可能显示以下内容：
$L(com.ibm.wbi.install.common.i18n.WBIProductResources, businessIntegrationServerExpressPlusProduct.
displayName)
应该显示的是：WebSphere Business Integration Server Express Plus V4.3.1。
安装程序（所有） 43593 由于它的长度原因，标题文本在消息对话框中可能会被截断；然而，还是显示了预期的消息内容。
安装程序 58725 在安装后必须重新引导机器，以便编辑映射和／或协作模板。在安装后，如果通过 Windows 中安装程序快捷方式来启动 InterChange Server，则它是作为 Windows 服务启动的。安装程序设置 Windows 环境变量的 JDK 路径。但是，在重新引导机器之前，Windows 服务不识别对环境变量的更改。因此，InterChange Server 不识别安装程序设置的 JDK 路径，从而未找到编辑协作模板和映射所需的 Java 编译器。

要解决此问题，在安装 WebSphere Business Integration Server Express 后，重新启动 Windows。
启动板 37017 从 CD 运行启动板时，启动板的闪屏在初始窗口挂起。有些标注了 DVD Multi Player & Compact Disk Rewritable High Speed（该驱动器必须拥有两者）的 CD 驱动器可能导致 Express Plus CD 在安装时挂起，并且闪屏会不确定地挂起。

要解决此问题，如果可能，将 CD 驱动器配置成在安装时除去高速能力。如果不可能，从电子化软件交付（ESD）映像运行安装。也可以尝试将所有的 CD 内容复制到硬盘驱动器上。
启动板 在安装 DB2 精简版或 WebSphere MQ 组件之前，必须禁用任何已安装反病毒软件的实时文件系统保护功能。

如果安装了 Norton AntiVirus 软件，通过停止“Norton AntiVirus Client”Windows 服务可以禁用它的实时文件系统保护功能。对于其它的反病毒软件，参阅产品文档以获得如何禁用实时文件系统保护功能的指示信息。可以在已安装产品后启用此软件。
启动板 27110 如果正在 Windows XP 机器上安装且已启动 Windows XP 欢迎屏幕，则在安装 DB2 精简版组件后，不能作为管理员登录。DB2 精简版组件使用管理权限创建用户，导致欢迎屏幕停止显示管理员帐户。

要解决此问题，通过以下操作禁用欢迎屏幕：

  1. 转至开始 > 控制面板 > 用户帐户 > 更改用户登录或注销的方式。
  2. 清除使用欢迎屏幕复选框，然后单击应用选项。

要在已注销的情况下作为 DB2 管理员登录，可以使用以下用户标识和密码进行登录：
用户标识：db2admin
密码：smbP4$$word
启动板 58560 当安装样本组件时，Toolset Express 组件是自动安装的，即使清除了管理工具和开发工具复选框。发生该问题是因为启动板 GUI 没有正确刷新以重置复选框。
启动板 35851 当通过电子映像安装时，如果将该映像下载至包含有空格的位置，则 DB2 精简版或带有 CSD 6 的 WebSphere MQ V5.3.0.2 的安装可能失败。

要解决此问题，将电子映像解压缩到不包含空格的位置。
服务器（样本) 43775 在 \mqseries\RemoteServerSample.mqsc 文件中有一个错误。

在下列表达式中，突出显示的文本是不正确的：
DEFINE CHANNEL(CH_ICS_TO_AGENT) CHLTYPE(SDR) TRPTYPE(TCP) REPLACE +
XMITQ(TO_AGENT) DESCR('Server to Agent') +
CONNAME('172.16.15.96(1415)')

该表达式应为如下内容（请参阅突出显示文本）：
DEFINE CHANNEL(CH_ICS_TO_AGENT) CHLTYPE(SDR) TRPTYPE(TCP) REPLACE +
XMITQ(XMITQ_TO_AGENT) DESCR('Server to Agent') +
CONNAME('172.16.15.96(1415)')

要解决此问题，在安装后修改 \mqseries\RemoteServerSample.mqsc 文件。
系统监视器 43360 如果从创建和配置视图页创建一个超过 20 个监视器的视图，当您选择视图时可能会遇到异常。将视图中的监视器数量限制为少于 20。
系统监视器 42481 系统监视器支持在相同的语言环境中运行 Web 应用程序服务器和客户机。如果服务器和客户机处于不同的语言环境中，文本将以两种语言显示。如果不可能使服务器和客户机在相同的语言环境中运行，通过执行以下步骤，将 JVM 上的语言环境设置为与客户机相同的语言环境：
  1. 从 WebSphere Application Server 启动 WebSphere Application Server 管理员控制台（对于 Express，必须启用控制台应用程序）。
  2. 通过以下路径转至 Java 虚拟机：
    服务器 > 应用程序服务器 > ICSMonitor > 进程定义 > Java 虚拟机
  3. 将下列自变量到添加通用 JVM 自变量：
    -Duser.language=language code -Duser.region=country code
    用您自己的特定语言和国家或地区代码替换 language code 和 country code。
  4. 重新启动 InterChange Server 监视器服务器，并将客户机浏览器设置成在前一步骤中使用的同一语言。
系统监视器 43759 如果在双字节字符语言中使用 Netscape 4.7x，字符可能在 Netscape 中不能显示。要将 Netscape 配置成启用双字节字符集字符显示，遵循这些步骤：
  1. 从 Netscape 中的查看菜单，选择字符集 > Unicode（UTF-8）。
  2. 从查看菜单，选择字符集 > 设置缺省字符集。
  3. 打开编辑菜单并且选择首选项。
  4. 从首选项窗口，选择外观 > 字体。
  5. 在编码字段，选择 Unicode。
  6. 在可变宽度字体字段，选择 Lucida Sans Unicode。
  7. 选择使用我的缺省字体，覆盖文档指定的字体。
  8. 单击确定。
系统监视器 42705 当正在将 Web service 导出至活动编辑器时，导出向导对话框中的复选框树不能正常工作。如果选择叶节点，则不能选择其父节点。即使未选择父节点，也不会影响导出功能。
基于 Web 的失败事件管理器 43509 WebSphere Application Server 的角色名必须为小写。
WebSphere MQ 5.3.0.2 CSD 6 42837 如果已将 CSD 6 应用至 WebSphere MQ 安装且重新引导机器，则必须从 WebSphere MQ Series 对 WebSphereICS.queue.manager 启动侦听器。

文档

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

下列文档可从那个 Web 站点上找到：

Map Development Guide
Business Object Development Guide
Collaboration Development Guide
Data Handler Guide
Access Development Guide
《WebSphere Business Integration Server Express 安装指南 Windows 版》
《WebSphere Business Integration Server Express 安装指南 Linux 版》
《WebSphere Business Integration Server Express 安装指南 OS/400 版》
Quick Start Guide
System Implementation Guide
System Administration Guide
Adapter for COM User Guide
Adapter for e-Mail User Guide
Adapter for Exchange User Guide
Adapter for iSeries User Guide
Adapter for JD Edwards OneWorld User Guide
Adapter for JDBC User Guide
Adapter for JMS User Guide
Adapter for JText User Guide
Adapter for Lotus Domino User Guide
Adapter for MetaSolv Applications User Guide
Adapter for mySAP.com (SAP R/3 V. 4.x) User Guide
Adapter for Oracle Applications User Guide
Adapter for PeopleSoft User Guide
Adapter for Portal Infranet User Guide
Adapter for Siebel eBusiness Applications User Guide
Adapter for SWIFT User Guide
Adapter for Telcordia User Guide
Adapter for Web Services User Guide
Adapter for WebSphere Commerce User Guide
Adapter for WebSphere MQ User Guide
Adapter for XML User Guide
Collaborations for Customer Relationship Management
Collaborations for Procurement
Collaborations for Financials and Human Resources
Collaborations for Order Management

Copyright IBM Corp. 2004