IBM WebSphere Business Integration Server Express V4.3.1 for OS/400 发行说明

这些发行说明覆盖了 IBM(R) WebSphere(R) Business Integration Server Express V4.3.1 for OS/400(R) 的发行信息。它们包含以下各节:
概述 已知问题和变通方法
硬件和软件需求 文档
安装和配置信息

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

概述

IBM WebSphere Business Integration Server Express 和 IBM WebSphere Business Integration Server Express Plus 包含下列组件:

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

硬件和软件需求

硬件和软件需求包括在产品文档中。请参阅安装和配置信息获得那些指南的链接。

安装和配置信息

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

注意:如果您将技术适配器和应用程序适配器安装在同一机器上,则通过 Server Express Plus 先安装技术适配器,然后通过 Adapter Capacity Pack 安装程序安装每一个应用程序适配器。

已知问题和变通方法

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

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

但是,可以在不同的操作中执行两个子活动。如果必须使用具有相同根的变量,尝试重用单一的根变量来代替。

适配器 43586 通过 JMS 交付传输运行和使用本地连接器配置(通过 -c 命令行选项指定)的连接器的 AgentTraceLevel 属性仅可在该连接器的生存期内通过系统管理器动态更新一次。对此属性的后续动态更新尝试将失败。类似下列的消息将显示在日志中:

[类型:警告] [消息标识:14211] [消息:不允许动态更新 AgentTraceLevel。在配置文件中,连接器代理的值已经设置并且将使用先前设置的值。]

通过 JMS 交付传输运行和使用本地连接器配置的连接器的 AgentTraceLevel 属性不应通过系统管理器动态更新。如果该属性需要修改,则必须更新连接器配置文件并且重新启动连接器代理。否则,将会遇到刚才描述的错误,连接器控制器设置与连接器代理设置之间也可能发生不匹配。
JText 适配器 46499 如果与 MVS PDS 中的事件掩码匹配的文件多于一个,并且指定了 FTPRenameExt,则连接器仅归档一个文件且不能对第二个文件重命名和归档。要解决此问题,同时将 FTPArchiveDir 和 FTPRenameExt 指定为空白,以便在 MVS 事件文件不被重命名的情况下被删除。
JText 适配器 43454 当 JText 配置元对象 MO_JTextConnector_Default 的 EventExt 属性设置为空白时轮询 JText 适配器,轮询会失败并且适配器终止。
JText 适配器 35571 需要一个规定以便在二进制处理方式中指定“EOF”作为 EndBODelimiter 的值。
要解决此问题,对于 EndBODelimiter 正是 EOF 本身的所有文件,使用十六进制编辑器来包括几个字节(例如 FF02)作为定界符,并指定这些字节为 EndBODelimiter。
JText 适配器 34834 JText 需要安全的 FTP 支持。目前对 JText 系统管理员可见的密码字段,使用安全 FTP 则任何人都看不见。
JDBC 适配器 43503 当使用 ODA 从运行于 Linux 上的 DB2 数据库服务器生成业务对象时,业务对象设计器将会挂起。发生此问题是因为 DB2 JDBC Applet Server 没有启动。

要解决此问题,登录到 DB2 服务器,并运行下列命令:db2jstrt LISTENPORT。

JDBC 适配器和 Oracle 应用程序适配器 43246 OracleAppsODA 的启动脚本在 DRIVEPATH 中包括 xworacle.jar 文件,它没有按预期在 Oracle 数据库中列出所有的表。如果要在数据库中列出所有的表,可以使用 Oracle 提供的本机 JDBC 驱动程序 - classes12.zip 文件来解决此问题。根据适配器用户指南中的指示信息在启动脚本中相应地设置驱动程序路径。
JMS 适配器和 WebSphere MQ 适配器 37094 在处理来自其中一个多配置的输入队列中的一条不确定消息(来自 InProgressQueue)时,该适配器会根据特定于连接器的属性中的第一个输入队列来检索转换属性。
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 适配器 33728 在事件处理过程中,当多个转换属性与某个输入消息的 InputFormat 和\或 InputQueue 匹配时,适配器试图不正确地使用静态元对象中的最后一个匹配的业务对象属性作为输入消息的映射。在这种情况下,适配器应将消息内容传递给数据处理程序以允许数据处理程序来决定业务对象名称。

要解决此问题,为静态元对象中的每一个 BusinessObjectType_verb 属性配置唯一的 InputFormat 和 InputQueue 键。

JMS 适配器 36128 当没有配置 InputQueue 属性时,适配器初始化失败。
JMS 适配器 36438 配置元对象的特定于应用程序信息中的转换属性名称和动态元对象的名称是区分大小写的。
WebSphere Commerce 适配器 42516 在商业服务器上使用带有修订包 4 的 WebSphere Commerce Business Edition V5.5(或更早版本)时,无法使用 WebSphere Commerce 适配器正确创建仓库用户。因为不正确的权限,仓库用户无法登录到仓库。需要 WebSphere Commerce 电子修订来修正此问题。电子修订是带有修订包 4 的 WebSphere Commerce 5.5 上的 JR20090。
WebSphere MQ 适配器 34969 在同步事件处理期间,没有为数据处理程序错误发送报告消息。
Adapter Capacity Pack 58762 如果将应用程序适配器从 Adapter Capacity Pack 安装到 OS/400 系统上,并且该系统已经安装了 Server Express Plus InterChange Server 或者 Web Tools(或两者),但是没有安装任何技术适配器,则您的应用程序适配器可能不能启动。
要解决此问题,运行启动板并安装一个技术适配器(例如,电子邮件、JText 或 JDBC)。在安装完成后,就能够启动应用程序适配器了。
Adapter Capacity Pack 58799 如果将应用程序适配器从 Adapter Capacity Pack 安装到 OS/400 系统上,并且该系统没有安装 Server Express Plus,该应用程序适配器可能不能启动。(适配器日志会指示一个 ClassNotFoundException。)
要解决此问题,请执行下列其中一种操作:
在命令行输入下列命令将 WBIA.jar 文件复制到产品库:
CPY OBJ('/QIBM/ProdData/WBIServer43/AdapterCapacityPack/lib/WBIA.jar') TODIR('/QIBM/ProdData/WBIServer43/product/lib') OWNER(*KEEP)。
注意:确保已拷贝文件的文件所有者和权限与原始的 .jar 文件相匹配。
运行启动板并且安装一个技术适配器(例如,电子邮件、JText 或 JDBC)。在安装完成后,就能够启动应用程序适配器了。
安装程序(Adapter Capacity Pack) 44001 当在 Windows 2000 上为 Metasolv 和 JD Edwards OneWorld 适配器执行一个远程的或本地的 Capacity Pack 安装并且试图启动该适配器时,它会终止并出现错误:输入行太长。这是因为 Windows 2000 上的命令行长度问题。当执行一个远程的 CP 安装时,WebSphere Business Integration 的 Siebel 和 Oracle 应用程序适配器具有相同的问题。此问题的一个变通方法是计划在此发行版后有一个技术说明可用。
适配器和 OS/400 用户概要文件安全性 由于安全的原因,有必要更改用于适配器代理进程在 OS/400 之下运行的用户概要文件。例如,如果适配器是 JDBC 或者 JText,访问您的数据库(对于 JDBC)或者访问目录和文件(对于 JText)的权限可能是您不想将 QWBISVR43 用户概要文件权限授予它们的那些。如果是这样,将必须执行下列操作以启用适配器来成功运行于一个除 QWBISVR43 之外的用户概要文件之下:
  1. 要更改适配器代理的作业描述,使用 CHGJOBD CL 命令将 USER 参数设置成您要的用户概要文件。
  2. 使用 GRTOBJAUT CL 命令将对象权限授予第 1 步中指定的作业描述以及第 1 步中的用户概要文件,将 USER 参数设成该用户概要文件以及将 AUT 参数设成下面的值:*READ 和 *EXECUTE。
  3. 使用 GRTOBJAUT CL 命令将对象权限授予第 1 步中的用户概要文件的 QWBISVR43 库,将 USER 参数设成该用户概要文件以及将 AUT 参数设成下面的值:*READ 和 *EXECUTE。
  4. 通过将 USER 参数设成该用户概要文件以及将 AUT 参数设成下面的值:*READ 和 *EXECUTE,使用 GRTOBJAUT CL 命令为第 1 步中指定的用户概要文件对象将权限授予 QWBISVR43 库中的 QWBISVR43 子系统描述。
  5. 使用 GRTOBJAUT CL 命令为第 1 步中指定的用户概要文件将对象权限授予 QWBISVR43 库中的 QWBISVR43 类,将 USER 参数设成该用户概要文件以及将 AUT 参数设成下面的值:*READ 和 *EXECUTE。
  6. 使用 CHGAUT CL 命令为第 1 步中的用户概要文件将对象权限授予在集成文件系统中包括连接器的目录。将 USER 参数设成该用户概要文件以及将 DTAAUT 参数设成 *RWX。
文档 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
Windows 上的 DB2(R) 企业版 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。

Windows 上的 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 数据库。删除实际的数据库会除去它的别名。

安装程序(所有) 46851 在文件传输时,来自资源束的未解析文本可能出现在窗口中。特别地,可能显示以下内容:$L(com.ibm.wbi.install.common.i18n.WBIProductResources, businessIntegrationServerExpressPlusProduct.displayName)。

应该显示的是:WebSphere Business Integration Server Express Plus V4.3.1。
安装程序(所有) 43593 因为它的长度,标题文本在消息对话框中可能会被截断;然而,预期的消息内容还是显示了。
启动板 在安装 DB2 精简版或 WebSphere MQ 组件之前,必须禁用任何已安装的反病毒软件的实时文件系统保护功能。

如果安装了 Norton AntiVirus 软件,通过停止 Norton AntiVirus Client Windows 服务可以禁用它的实时文件系统保护功能。对于其它的反病毒软件,参阅产品文档以获得如何禁用实时文件系统保护功能的指示信息。可以在安装 DB2 精简版或 WebSphere MQ 组件之后启用反病毒软件。

启动板 58560 当安装样本组件时,Toolset Express 组件是自动安装的,即使清除了管理工具和开发工具复选框。发生该问题是因为启动板 GUI 没有正确刷新以重置复选框。
启动板 35851 当通过电子映像安装时,如果将该映像下载至包含有空格的位置,则 DB2 精简版或带有 CSD 6 的 WebSphere MQ V5.3.0.2 的安装可能失败。

要解决此问题,将电子映像解压缩到不包含空格的位置。

启动板 37017 从 CD 运行启动板时,启动板的闪屏在初始窗口挂起。有些标注了 DVD Multi Player & Compact Disk Rewritable High Speed(该驱动器必须拥有两者)的 CD 驱动器可能导致 Express Plus CD 在安装时挂起,并且闪屏会不确定地挂起。

要解决此问题,如果可能,将 CD 驱动器配置成在安装时除去高速能力。如果不可能,从电子化软件交付(ESD)映像运行安装。也可以尝试将所有的 CD 内容复制到硬盘驱动器上。
OS/400 V5R2 必需的 PTF 下列 PTF 必需装入到您的 OS/400 V5R2 系统上:
PTF 号 产品 描述
SI13693 5722SS1 使用 ResultSet.getObject() 修正 JDBC NullPointerException
SI07110 5722SS1 IBM Tivoli License Manager,系统代理程序支持
SI10105 5722SS1 IBM Tivoli License Manager,系统代理程序支持
SI10771 5722SS1 IBM Tivoli License Manager,系统代理程序支持
SI10904 5722SS1 IBM Tivoli License Manager,系统代理程序支持
OS/400 V5R3 必需的 PTF 下列 PTF 必需装入到您的 OS/400 V5R3 系统上:
PTF 号 产品 描述
SI13094 5722SS1 修正在 JVM 启动时的 -Xbootclasspath 的 Java 语法分析
SI14668 5722SS1 使用 ResultSet.getObject() 修正 JDBC NullPointerException
SI12116 5722SS1 IBM Tivoli License Manager,系统代理程序支持
系统监视器 43759 如果在双字节字符语言中使用 Netscape 4.7x,字符可能在 Netscape 中不能显示。要将 Netscape 配置成启用双字节字符集字符显示,遵循这些步骤:
  1. 从 Netscape 中的查看菜单,选择字符集 > Unicode(UTF-8)
  2. 查看菜单,选择字符集 > 设置缺省字符集
  3. 打开编辑菜单并且选择首选项
  4. 首选项窗口,选择外观 > 字体
  5. 编码字段,选择 Unicode
  6. 可变宽度字体字段,选择 Lucida Sans Unicode
  7. 选择使用我的缺省字体,覆盖文档指定的字体
  8. 单击确定
系统监视器 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 codecountry code
  4. 重新启动 InterChange Server 监视器服务器,并将客户机浏览器设置成在前一步骤中使用的同一语言。
服务器(样本) 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 文件。
工具 - 活动编辑器 36145 在活动编辑器中,Java(TM) 代码编辑器里的颜色标记不能处理字符串中的引号;然而,这个不会影响到编译。

文档

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