IBM® WebSphere® Message Broker V6.1

更改历史记录：

© Copyright IBM Corporation 2008. All rights reserved.
.

欢迎使用 IBM WebSphere Message Broker。本文是工具和运行时组件 V6.1.0.3 的自述文件。

本自述文件描述了已知问题并包含了对产品文档可用级别的更新。

目录

面向所有用户的基本信息

请始终使用本自述文件的最新版本，最新版本可在以下网站上找到（仅提供英语版本）：
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917

翻译的自述文件可在以下位置找到：
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/

要完成安装，请参阅《WebSphere Message Broker 安装指南》。通过此指南您可以了解安装本产品之前必须完成的 任务。

如果您要将 V6.1.0.3 服务应用到 Message Broker Toolkit，请参阅《安装指南》以了解有关此过程的指示信息，确保您能正确完成过程。

可以访问以下网址的 IBM 出版物中心提供的在线安装指南：

http://publib.boulder.ibm.com/epubs/pdf/c3468662.pdf

迁移时需要了解的基本信息

如果要从此产品的 V5.0 或 V6.0 迁移，请参阅在线信息中心（http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp），其中提供了有关如何迁移的详细信息。

对通过 IBM 支持机构报告的特定迁移问题进行描述的文档会在 WebSphere Message Broker Support Web 站点上定期更新：http://www.ibm.com/software/integration/wbimessagebroker/support/。单击故障诊断 > 查看所有故障诊断文档，然后搜索标题为“Problems and solutions when migrating to WebSphere Message Broker 6.0 and 6.1”的文档。

文档

WebSphere Message Broker 独立信息中心可以从“快速入门 CD”获取，也可以在线访问：http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp

还可从以下地址下载：
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_linux.tgz（Linux® 版本）
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_win.zip （Windows® 版本）

请阅读 wmb_help_linux.tgz 和 wmb_help_win.zip 文件中 ibm_help 文件夹包含的 quickstart_welcome.html 文件。

以下网址收集了各种信息主题，格式为可移植文档格式（.pdf）：
http://www.ibm.com/software/integration/wbimessagebroker/library/

支持

缺陷：整个自述文件文档中，各缺陷号都有对应参考。这些编号是指 IBM 的内部问题编号；当您与 IBM 服务代表讨论问题时，您可能会发现这些编号非常有用。

技术说明：有关已知问题和可用修订的最新信息，请转至 WebSphere Message Broker Support Web 站点：
http://www.ibm.com/software/integration/wbimessagebroker/support/

要查找信息：

所有相关的技术说明将显示，可以对它们进行排序和进一步搜索。

有关从 Passport Advantage® Web 站点下载 WebSphere Message Broker V6.1 安装映像的信息，请参阅 Passport Advantage downloads for WebSphere Message Broker V6.1 下载文档，您可以从以下网址获取此文档：
http://www.ibm.com/support/docview.wss?rs=849&uid=swg24017456

版本：有关 WebSphere Message Broker 支持的特定版本操作系统和数据库的最新状态，请查询系统页面：
http://www.ibm.com/software/integration/wbimessagebroker/requirements/index.html

功能部件更新

请定期检查 Toolkit 的功能部件更新，包括英语以及其他所支持语言的文档更新。可在以下网址找到 WebSphere Message Broker 的建议更新：http://www.ibm.com/support/docview.wss?uid=swg27006041
返回页首

限制和局限性

本部分按组件概述了 WebSphere Message Broker 的限制和局限性。

返回页首

安装

创建安装路径时，请确保路径长度不超过系统允许的最大字符长度。（例如，Windows 允许最大长度为 256 个字符）。

Windows Vista 或 Windows Server 2008 上 WebSphere Message Broker V6.1.0.2 或更低版本的安装版本无法正常工作，此外，在执行安装操作时，会在文件系统和注册表中创建异常元素，可能需要手动执行除去操作，才能将这些元素除去。

如果选择静默安装运行时组件，且要生成模板或记录响应文件，那么《安装指南》第 79 页上的第 7 章“选择安装界面”中的示例都不正确。要记录响应文件，请输入：

installer -options-record responsefile.

要生成模板，请输入：

installer -options-template responsefile.

第 80 页上的表 13 中的相应命令也都不正确；在 -options 和 -record（或 -template）之间不能有空格。

使用 Windows 解压缩向导来解压缩从 Passport Advantage Xtreme Leverage Web 站点下载的 WebSphere Message Broker V6.1 压缩文件时，如果指定很长的目录路径来解压缩文件，那么可能会导致显示密码消息。

如果将文件解压缩到路径很长的目录，那么可能会因为路径太长而导致 Windows 解压缩向导无法处理，此时，不会向您发送错误消息，而是打开一个窗口，显示一条提示您输入密码的消息。例如，“需要密码 文件“DB2CS_NewCLRProcWizard...”受到密码的保护。请在下面的框中输入密码”。此消息是错误的，可能会对许多文件重复出现。

返回页首

平台

在部署消息流并启动代理之后，可能会看到以下症状：

BIP2060W: 代理检测到执行组 <insert_1> 和进程标识 <insert_2> 已关闭。

BIP2227E: 执行异常结束处理期间遇到错误：<insert_1> － 正在终止。

此外，mqsistart 命令可能无法启动代理，并且系统日志可能包含以下错误消息：

BIP8893E: 验证失败。无法使用用户标识 <insert_2> 来访问文件“/var/mqsi/components/AIX53_BK/bipcvp_javaversion.tmp”。

如果 AIX V5.3 文件集 bos.rte.libc 的级别低于 5.3.0.52，那么会发生这些问题。

返回页首

迁移

在同一台计算机上将组件从 V5.0 或 V6.0 迁移到 V6.1 时，请先打开新的 shell，然后运行 mqsiprofile 以设置命令环境。

z/OS 的迁移需要 IC54505。IC54505 包含在修订包 2 内。

在 V5.0 和 V6.0 中，将消息集的“消息域”属性设置为“MRM”之外的值或“IDOC”，可在消息集中同时包含非 MRM 和 MRM 模型，并可在将消息集添加到 bar 文件时生成 .dictionary 文件，无论“消息域”的设置如何。

在 V6.1 中，字典只有在“消息域”设置为“MRM”或“IDOC”时才可以生成。

返回页首

WebSphere Message Broker Toolkit

尝试启动 Toolkit 时，显示“JVM terminated Exit Code = 1”错误或者 javaw.exe 进程占用 CPU 100% 的资源并且停止。

问题可能是由于 eclipse.ini 文件中的 -Xshareclasses:singleJVM, keep 开关引起。此开关创建高速缓存（提供共享所有已装入类的方法）并对共享类数据的 JVM 没有作任何限制。如果高速缓存损坏，那么就不允许新的 JVM 连接到该高速缓存。现有 JVM 可以继续运行，但无法更新高速缓存。

如果需要更新原先使用 IBM Installation Manager 安装的软件包，那么您必须还使用 IBM Installation Manager 进行更新。虽然您可以使用 Eclipse 更新管理器安装非 IBM 插件，但是请勿使用 Eclipse 更新管理器更新原先使用 IBM Installation Manager 安装的 Eclipse 功能部件和插件。当您使用 Eclipse 更新管理器添加插件时，请确保将其安装到软件包组目录，而非共享资源目录（它是保留目录，由 IBM Installation Manager 管理）。

当多个产品已作为软件包组一部分安装时，启动面板（程序启动时显示的面板，有时也称为启动屏幕）随着软件包组中首个安装的产品的不同而有所不同。例如，如果您先安装 Rational® Application Developer（RAD），再安装 WebSphere Message Broker，然后安装 WebSphere Integration Developer（WID），那么当这三个程序当中任何一个程序启动时，RAD 的启动面板都会显示。

以特定方式格式化 WSDL 或 XSD 文件可能会导致项目（在导入后生成）发生问题。

在 Windows，开始->程序文件中的“启动帮助”和“停止帮助”菜单项缺失。

如果您导入 WSDL 或 XSD 定义，对于某些文件编码（如 EBCDIC-CP-US），可能会遇到文件有效性错误。要成功导入这些定义，请在 XML 文件中将编码属性更新为系统编码（如 UTF-8）。

返回页首

Web Service

WebSphere Message Broker V6.1 不支持 Windows .NET Server Web Services Security X509。所有其他与 Windows .NET 有关的 WebSphere Message Broker Web Services 功能都完全支持，特别是 Web Services Security 的 USERNAME 令牌。

不支持使用大小超过 16KB 的消息传输优化机制（MTOM）附件。

返回页首

节点

Collector 节点可能导致异常终止，已在 IC54505 解决。IC54505 包含在修订包 2 内。

如果使用 XMLNSC 解析器来确定 TCP/IP 输入和接收节点中的消息末尾，那么只有在位流上出现下一个 XML 文档，或 XMLNSC 解析器看到位流末尾时，XMLNSC 解析器才会找到消息末尾。如果以上两种情况都未出现，那么将显示超时异常。

要解决此问题，请将“记录检测”属性设为 Delimited，并向位流添加一个空字符。

Solaris x86-64 上的 TCP/IP 节点不处理数据，因此可能会拒绝连接。如果遇到这些问题，请将 rlim_fd_max 和 rlim_fd_cur 设为 8193 或更小的值。

z/OS 上的 JMS 节点不支持协调事务，直到 IC54505。IC54505 包含在修订包 2 内。

WebSphere Message Broker V6.1 修订包 1 EndpointLookup 和 RegistryLookup 节点可用于访问 WebSphere Service Registry and Repository (WSRR) V6.0.2 或 V6.1 中驻留的服务元数据。但是，目前不支持 WSRR V6.1 中引入的新功能，如在 WSDL 中引用 MQ 端点和访问建模的对象和元素。

支持 WebSphere Service Registry and Repository（WSRR）V6.1。不支持先前版本的 WSRR。

返回页首

WebSphere Adapter 节点

要从 SAP R/3 支持的 MQ 链接迁移到 Message Broker V6.1，您需要 IC54505。IC54505 包含在修订包 2 内。

返回页首

数据库

JDBC 数据库连接不支持 JDBC/XA 全局协调（“XA”）事务。

不支持全局协调（“XA”）事务。

不支持存储过程。

不支持在数据库中操作 Unicode 数据。

如果在 HP-UX on PA-RISC 上安装了 WebSphere Message Broker 6.1.0.2（或更低版本），那么必须使用 DataDirect Connect for ODBC Drivers（DD）V5.0 或 DataDirect Connect64 for ODBC Drivers（DD）V5.0 来设置数据库的 ODBC 连接。信息中心主题提到了 DD V5.3，该版本不受此平台支持。

在开始针对代理数据库或用户数据库配置 ODBC 连接之前，请阅读技术说明“Configuring database ODBC connections for WebSphere Message Broker V6.1 on HP-UX (PA-RISC platform)”，网址为：http://www.ibm.com/support/docview.wss?rs=0&context;=SSMKUK&uid=swg21305099。本文档提供了详细信息，说明如何使用 DD V5.0 驱动程序来定义连接及配置事务的全局协调。本次更改不影响其他平台。

不支持全局协调（“XA”）事务。

针对 z/OS 系统上的 DB2 数据库执行 DB2 V9 存储过程（具有类型为“REAL”的参数）时，调用该存储过程会失败并发出 DB2 错误“CLI0111E 数值超出范围。SQLSTATE=22003”。

如果先前创建了一个使用 Sybase 数据库作为代理数据库的代理，并且您想要升级到 Message Broker V6.1.0.2，那么在您启动代理时，代理和代理数据库可能会遇到问题。

要解决此问题，请在执行迁移之后，启动代理之前运行以下命令。

  1. 在命令提示符下，输入以下命令：

    2. isql -Umqsiuid -Pmqsipw

    如果授权了代理用于访问数据库的另一个用户标识和密码，请使用您的值替代该命令中的 mqsiuid 和 mqsipw。

  2. 使用以下命令连接到代理数据库：

    3. use WBRKBKDB

    如果创建了具有不同名称的代理数据库，请使用您的代理数据库名称替代该命令中的 WBRKBKDB。

  3. 使用以下命令应用更改：

    4. go

  4. 使用以下命令更新 BROKERAA 表：

    5. alter table BROKERAA

    modify MsgId NOT NULL

    modify ReplyToQ NOT NULL

  5. 使用以下命令应用更改：

    6. go

  6. 使用以下命令更新 BROKERAAEG 表：

    7. alter table BROKERAAEG

    modify MsgId NOT NULL

    modify CntlMsgId NOT NULL

  7. 使用以下命令应用更改：

    8. go

  8. 使用以下命令更新 BSUBSCRIPTIONS 表：

    9. alter table BSUBSCRIPTIONS

    modify Expiration NOT NULL

    modify Creation NOT NULL

  9. 使用以下命令应用更改：

    10. go

  10. 使用以下命令更新 BMQPSTOPOLOGY 表：

    11. alter table BMQPSTOPOLOGY

    modify Migrated NOT NULL

  11. 使用以下命令应用更改：

    12. go

  12. 使用以下命令更新 BACLENTRIES 表：

    13. alter table BACLENTRIES

    modify QopLevel NOT NULL

  13. 使用以下命令应用更改：

    14. go

  14. 使用以下命令更新 BMULTICASTTOPICS 表：

    15. alter table BMULTICASTTOPICS

    modify GroupAddress NOT NULL

  15. 使用以下命令应用更改：

    16. go

  16. 使用以下命令更新 BAGGREGATE 表：

    17. alter table BAGGREGATE

    modify ReplyGroupId NOT NULL

  17. 使用以下命令应用更改：

    18. go

返回页首

样本

样本不受支持，直到 IC54505。IC54505 包含在修订包 2 内。

样本不受支持，直到 IC54505。IC54505 包含在修订包 2 内。

返回页首

声明和商标

本信息是为在美国提供的产品和服务编写的。

IBM 可能在其他国家或地区不提供本信息中讨论的产品、服务或功能特性。有关您当前所在区域的产品和服务的信息，请向您当地的 IBM 代表咨询。任何对 IBM 产品、程序或服务的引用并非意在明示或暗示只能使用 IBM 的产品、程序或服务。只要不侵犯 IBM 的知识产权，任何同等功能的产品、程序或服务，都可以代替 IBM 产品、程序或服务。但是，评估和验证任何非 IBM 产品、程序或服务，将由用户自行负责。

IBM 公司可能已拥有或正在申请与本信息内容有关的各项专利。提供本信息并未授予用户使用这些专利的任何许可。您可以用书面方式将许可查询寄往：

有关双字节字符集（DBCS）信息的许可查询，请与您所在国家或地区的 IBM 知识产权部门联系，或用书面方式将查询寄往：

以下条款不适用于英国或此类条款与当地法律不一致的任何其他国家或地区：

International Business Machines Corporation“按现状”提供本出版物，不附有任何种类的（无论是明示的还是暗含的）保证，包括但不限于暗含的有关非侵权、适销和适用于某种特定用途的保证。某些国家或地区在某些交易中不允许免除明示或暗含的保证。因此本条款可能不适用于您。

本信息中可能包含技术方面不够准确的地方或印刷错误。此处的信息将定期更改；这些更改将编入本资料的新版本中。IBM 可以随时对本信息中描述的产品和/或程序进行改进和/或更改，而不另行通知。

本信息中对非 IBM Web 站点的任何引用都只是为了方便起见才提供的，不以任何方式充当对那些 Web 站点的保证。那些 Web 站点中的资料不是 IBM 产品资料的一部分，使用那些 Web 站点带来的风险将由您自行承担。

IBM 可以按它认为适当的任何方式使用或分发您所提供的任何信息而无须对您承担任何责任。

本程序的被许可方如果要了解有关程序的信息以达到如下目的：（i）允许在独立创建的程序和其他程序（包括本程序）之间进行信息交换，以及（ii）允许对已经交换的信息进行相互使用，请与下列地址联系：

只要遵守适当的条件和条款，包括某些情形下的一定数量的付费，都可获得这方面的信息。

本信息中描述的许可程序及其所有可用的许可资料均由 IBM 依据 IBM 客户协议、IBM 国际软件许可协议或任何同等协议中的条款提供。

涉及非 IBM 产品的信息可从这些产品的供应商、其出版说明或其他可公开获得的资料中获取。IBM 没有对这些产品进行测试，也无法确认其性能的精确性、兼容性或任何其他关于非 IBM 产品的声明。有关非 IBM 产品性能的问题应当向这些产品的供应商提出。

本信息包含在日常业务操作中使用的数据和报告的示例。为了尽量完整地说明这些示例，示例中可能会包括个人、公司、品牌和产品的名称。所有这些名字都是虚构的，若现实生活中实际业务企业使用的名字和地址与此相似，纯属巧合。

版权许可：

本信息包括源语言形式的样本应用程序，这些样本应用程序说明不同操作平台上的编程方法。如果是为按照在编写样本程序的操作平台上的应用程序编程接口（API）进行应用程序的开发、使用、经销或分发为目的，您可以任何形式对这些样本程序进行复制、修改、分发，而无须向 IBM 付费。这些示例并未在所有条件下作全面测试。因此，IBM 不能担保或暗示这些程序的可靠性、可维护性或功能。用户如果是为了按照 IBM 应用程序编程接口开发、使用、经销或分发应用程序，则 可以任何形式复制、修改和分发这些样本程序，而无须向 IBM 付费。

以下术语是 International Business Machines Corporation 在美国和/或其他国家或地区的商标：

AIX、DB2、developerWorks、IBM、Passport Advantage、Rational、WebSphere 和 z/OS。

Java 和所有基于 Java 的商标是 Sun Microsystems, Inc. 在美国和/或其他国家或地区的商标。

Microsoft 和 Windows 是 Microsoft Corporation 在美国和/或其他国家或地区的商标。

UNIX 是 The Open Group 在美国和其他国家或地区的注册商标。

Linux 是 Linus Torvalds 在美国和/或其他国家或地区的商标。

其他公司、产品或服务名称可能是其他公司的商标或服务标记。

返回页首

有用的 Web 站点

DB2 修订包
您可以从 CD 中获取 DB2 修订包，也可以从 Web 下载。但是请注意，修订包可能很大，因此从 CD 获取修订包可避免长时间的下载。
如果有当前支持合同，可以致电 DB2 支持机构来定购 CD 上的 DB2 修订包。
以下地址提供了联系详细信息：
http://www.ibm.com/software/data/db2/udb/support.html
另外还可以从该 Web 站点进行下载。

WebSphere MQ 修订包
http://www.ibm.com/software/integration/wmq/support/

WebSphere Message Broker 修订包
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006367

WebSphere Message Broker 要求
http://www.ibm.com/software/integration/wbimessagebroker/requirements/

WebSphere Message Broker 自述文件
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917

WebSphere Message Broker 独立信息中心
对于 Linux：
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_linux.tgz
对于 Windows：
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_win.zip

WebSphere Message Broker V6.1 联机信息中心
http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp

IBM Java™ 技术开发中心下载
http://www.ibm.com/developerworks/java/jdk/

Web 服务描述语言（WSDL）规范
http://www.w3.org/TR/wsdl

WebSphere Message Broker developerWorks® 园地
http://www.ibm.com/developerworks/websphere/zones/businessintegration/wmb.html