IBM^(R) WebSphere^(R) Business Integration Message Brokers Toolkit V5.1

更改历史：
GA：2004 年 7 月 23 日
更新：2004 年 8 月 20 日
更新：2004 年 10 月 20 日
更新：2004 年 12 月 17 日
修订包 5：2005 年 2 月 9 日

(C) Copyright IBM Corporation 2004, 2005. All rights reserved.

欢迎使用 IBM WebSphere Business Integration Message Brokers Toolkit V5.1。

此自述文件仅适用于在 Microsoft^(R) Windows^(R) 上安装 Message Brokers Toolkit V5.1，并且 Message Brokers Toolkit V5.1 与 WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker V5.0 协同使用。它描述了已知问题，并且包含文档更新，这些文档更新未能及时包含在在线信息中心中。您还必须阅读 IBM WebSphere Business Integration Message Brokers V5.0 的自述文件，以获取关于产品的进一步信息。

警告！
只有当您安装了 WebSphere Application Development Integration Edition V5.1 时，才安装 Message Brokers Toolkit V5.1。如果存在先前级别的 WebSphere Studio Application Developer Integration Edition，则不要安装 V5.1；对于先前级别的 WebSphere Studio Application Developer Integration Edition，您必须使用 Message Brokers Toolkit V5.0，它与 WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker V5.0 一起提供。Message Brokers Toolkit V5.1 具有与 Message Brokers Toolkit V5.0 完全相同的功能。

在团队环境中安装 Message Brokers Toolkit V5.1
WebSphere Studio Application Developer Integration Edition V5.1 不是每次安装 Message Brokers Toolkit V5.1 的必备软件。但是，如果至少一次 Message Broker Toolkit 安装集成了 WebSphere Studio Application Developer Integration Edition V5.1，则所有 Message Broker Toolkit 安装必须是 V5.1 以确保数据共享和完整性。

如果您没有在任何系统上使用 WebSphere Studio Application Developer Integration Edition V5.1，或者您正在使用 WebSphere Studio Application Developer Integration Edition V5.0，则您必须安装 Message Brokers Toolkit V5.0。

CVS compatibility
The Message Brokers Toolkit Version 5.1 is based on Eclipse 2.1.2, and uses CVS client plugin version 2.1.1. For this version, your CVS server must be at version 1.11.6 or earlier (Linux and UNIX only, CVSNT is not supported).

针对所有用户的必要信息

自述文件的翻译版本和 install.html 文件可以从以下网址获取： ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling

信息中心的翻译版本不包含在此软件包内。信息中心中的所有本地语言片段都为空，而且所有信息都用英语显示。如果您希望用除 US 英语之外的受支持语言显示信息中心，则您必须在安装了修订包之后下载相应的 Eclipse 功能。在修订包可用时或在它可用之后，翻译才可用。要获取关于如何下载这些更新的指示信息，请参阅功能更新。

迁移时必不可少的信息

如果您正在迁移，请参阅 install.html 文件，以获取关于安装前您必须执行的操作的详细信息。

如果您想在已经安装了 Message Brokers Toolkit V5.0 的系统上安装 Message Brokers Toolkit V5.1，则您必须首先卸载 V5.0 Toolkit；这两个版本不能共存。

信息中心提供关于迁移的进一步信息；要在安装之前查看此信息，下载信息中心的独立版本（请参阅文档以获取指示信息）。

您必须了解这些迁移和部署注意事项：

• 当您在 V5.1 toolkit 中创建或修改消息流、消息集和消息映射时，您不再能访问 V5.0 toolkit 中的资源。确保共享团队环境中项目的所有用户都了解这一限制并在必要时作好备份副本。
• 在您可以成功部署包含所有用户定义的节点插件的消息流程之前，您必须从供应商处获取这些插件的迁移版本。

您可以在不同系统上的版本之间共享资源：

• 您可以部署在 V5.0 中开发的任何项目，而不必对它们进行更改。
• 您可以将此版本中创建的代理归档文件导入到 V5.0 工作空间，并成功地部署它们。

文档

支持

功能更新

1. 从该 toolkit，选择帮助 > 软件更新 > 新更新。然后，Eclipse 会搜索可用的更新。
2. Eclipse 显示哪些更新是可用的。选择您要安装的更新。
3. 当选择了要安装的更新时，您会接收到一条警告消息，该消息指出尚未对这些功能进行数字签名。您可以忽略该警告消息。
4. 安装功能后，Eclipse 会提示您重新启动工作台。
5. 当您重新启动了工作台后，新功能就安装好了并可以使用。

目录

限制和限定

• WebSphere Studio Application Developer Integration Edition
• 共存
• 安装
• 安装后

声明和商标

有用的 Web 页面

限制和限定

本部分按组件来概述 WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker 的限制和限定。

WebSphere Studio Application Developer Integration Edition

要用此产品扩展 WebSphere Studio Application Developer Integration Edition 工作台，您必须将 WebSphere Studio Application Developer Integration Edition 升级到相应的支持级别。可以扩展的 WebSphere Studio Application Developer Integration Edition 工作台的版本是带有“临时修订 002 － 一般修订 2.0.0”的 WebSphere Studio Application Developer Integration Edition V5.1 GA。不支持 WebSphere Studio Application Developer Integration Edition 5.1 的先前版本。

在安装了 WebSphere Business Integration Message Broker 或 WebSphere Business Integration Event Broker 后，您还必须应用修订“WebSphere Business Integration Message Broker V5.1.5 临时修订 001 － 必备的修订 1.0.0.1”。

要获取详细的指示信息，请参阅 install.html 文件。

共存

• 您可以部署在 V5.0 中开发的任何项目，而不必对它们进行更改。
• 您可以将此版本中创建的代理归档文件导入到 V5.0 工作空间，并成功地部署它们。

安装

1. 缺陷 34320
   在安装期间，如果您选择“不”接受许可证协议，则出现带有“是”和“否”按钮的弹出窗口。不管您选择哪一个按钮，都会返回到“许可证协议”页面。单击“是”会导致安装被取消且启动板被关闭。

   同样，在安装期间如果您单击“许可证协议”页面上的“上一步”，则会出现几条 Java^TM 虚拟机（JVM）错误消息，并且启动板会挂起。

   解决方案：如果您希望成功安装产品，就接受许可证协议。

2. 缺陷 37122
   Installshield 中的错误导致未正确解释静默安装中使用的响应文件。要避免此问题，完成以下操作：
   • 创建响应文件，如下所示。
   • 将 installLocation 设置为所选安装目录。
   • 将要安装的组件设置为 true，如注释行中所述。

   下面的示例将工具安装到位置 C:\Program Files\IBM\WBIMB。

   ---start of response file---------
   
   -P installLocation="C:\Program Files\IBM\WBIMB"
   -W setupTypes.selectedSetupTypeId=custom
   
   ###############################################################################
   #
   # User Input Field - suiteFeatures
   #
   #
   
   #Do not change this - it sets the installer to ignore the standard custom setup route
   -W featureSelectionIB.active=false
   
   #Set a value to true to install that component
   # If any of the Broker, UNS or Config Manager parameters are set to true, 
   # the core value must also be set to true.  
   # Otherwise set this should be set to false to avoid installing most of the product.
   
   -W enableCore.value=true
   -W setCustomSuiteBrokerFeatureTrue.propertyValue=false
   -W setCustomSuiteUNSFeatureTrue.propertyValue=false
   -W setCustomSuiteConfigMgrFeatureTrue.propertyValue=false
   
   #Set to true if the Message Broker extension features are required.
   #The broker and core features must also be set to true to install this
   
   -W setCustomMessageTrue.value=false
   
   #Set to true if the tooling is required
   -W setCustomToolingTrue.value=true
   
   ------ end of response file----------
   

安装后

1. 如果您已经安装了 Message Brokers Toolkit V5.1 并替换了 V5.0：
   1. 缺陷 34555
      您必须重新构建在您的工作空间中定义的所有项目。
   2. 缺陷 34930
      如果 INSTALL_PATH\eclipse\workspace\.metadata 存在，则您可能发现当打开 Message Brokers Toolkit 时，虽然更新管理器会正常启动，但对您的插件的任何更新都会失败。因此，Message Brokers Toolkit 不会用正确的插件级别打开，并且可能会发生 toolkit 故障。
      
      例如，当您在代理应用程序开发透视图中时，您可能发现文件 > 新建菜单生成的列表缺少消息定义文件菜单项。这表示您的安装未包含 Message Brokers Toolkit 的插件的正确级别或版本。
      
      您可以通过在 Message Brokers Toolkit for WebSphere Studio 窗口中单击帮助 > 关于 Message Brokers Toolkit for WebSphere Studio － Message Broker 来检查您正在使用的插件级别是否正确。在标题“Message Brokers Toolkit for WebSphere Studio”下面显示了版本号。 安装了 V5.1 后，如果使用的是插件的正确版本，则显示的版本为 5.1.0。如果显示的版本低于此级别：
      1. 删除 .metadata 目录。
      2. 重新打开 Message Brokers Toolkit。
      3. 通过对每个项目执行以下操作将现有的项目重新导入到工作空间：
         1. 单击文件 > 导入。
         2. 当“导入”向导出现时，选择导入现有的项目到工作空间中并单击下一步。
         3. 单击浏览并在工作空间中定义项目的位置。
         4. 单击完成。
2. 缺陷 32898
   如果没有为本地主机访问正确配置 LAN 设置（也许因为您的自动配置脚本中的设置），则可能发生以下情况之一：
   • 您的帮助浏览器打开时出现空白页面。
   • 您的帮助浏览器显示 HTTP 错误而不是显示帮助页面。
   • 当装入信息中心时，有长时间的延迟。
   
   解决方案：通过执行以下操作，您的系统管理员可以配置您的 LAN 设置以便可以从本地帮助服务器成功访问帮助文档：
   1. 在“控制面板”中，打开“Internet 选项”，选择“连接”选项卡，并选择 LAN 设置。
   2. 如果您的主机配置为对 IP 指定使用 DHCP，则确保清除了自动检测设置复选框。
   3. 如果您使用代理服务器，则确保选择了对于本地地址不使用代理服务器。
   4. 在代理的“高级”设置中，如果“127.0.0.1;localhost”没有列出，则将该地址添加到异常。
   5. 如果您正在使用代理设置的自动配置脚本，并且您不确定该脚本是否正确，则清除使用自动配置脚本复选框。
   
   如果上述步骤没有修正您的问题，则尝试更改 org.eclipse.tomcat\preferences.ini 中的端口和主机属性。设置 host=localhost 或 host=127.0.0.1 应该会起作用。如果您正在运行防火墙，则可能还需要设置端口=80（或其它防火墙支持的值）。
3. 缺陷 T32243
   mxsd 文件扩展名没有正确地与消息定义编辑器相关联。要确保 mxsd 文件作为缺省操作在消息定义编辑器中打开，选择窗口 > 首选项 > 工作台 > 文件关联。向下滚动文件类型的列表，并选择 *.mxsd。然后，在“关联的编辑器”列表中选择消息定义编辑器。单击缺省，然后单击确定。
4. 缺陷 36638
   “消息集编辑器首选项”主题（ad15810_）仅描述 V5.0 toolkit 中可用的选项。V5.0 的选项不可用于 V5.1。在 V5.1 toolkit 中，选项是：
   • 消息集编辑器设置、“大纲”视图设置。显示这些选项，但这些选项不起作用：
     • 按名称空间分组，然后按集合分组
     • 按集合分组，然后按名称空间分组
   • 消息定义编辑器设置：
     • 显示基本复杂类型
       如果您定义了一个或多个基于其他复杂类型的复杂类型，并且您希望在消息定义编辑器概述和“大纲”视图中显示这些基本复杂类型的内容，选择此选项（缺省情况下，此选项是选中的）。
       如果您不希望显示这些内容，则清除复选框。
5. 缺陷 36655
   如果您通过调用带有 -silent 选项的 uninstaller.exe 来卸载 toolkit，则卸载程序将立即返回控件并作为后台任务运行。如果您希望卸载程序直到完成时才返回，则您必须使用此命令调用 Java 内的卸载程序：
   java -cp <install_dir>\_uninst\studio\uninstall.jar run -silent
   其中 <install_dir> 是您安装该产品的目录。
   如果您未配置 jvm（V1.3.1 或更高版本），则可以使用目录 <install_dir>\_sjvm\bin\ 中的已安装产品内的 jvm。如果您这样操作的话，您可能在卸载完成时不得不手工删除此目录。
6. 缺陷 37671
   导入 COBOL 副本：当您导入 COBOL 副本以填充消息集定义文件时，检查副本是否包含至少一个 01 级别的结构。如果没有 01 级别的结构，则未导入对象（元素、组、类型）。
7. Database Views definitions are not supported in the ESQL editor. References to database views in the ESQL code (instead of to schemas or tables) are flagged as warnings (unresolved reference) in the ESQL editor. These warnings do not prevent you from deploying the corresponding ESQL.
   These unresolved reference warnings might also appear when you have migrated a Version 2.1 message flow, because the 5.0 ESQL editor validates database references.
   References to database tables and schemas only are supported.
8. ESQL compilation restriction: if you create a subflow, and choose to distribute this as a plug-in project, calls to ESQL global routines within the subflow might not be generated correctly when you add a message flow that contains the subflow to a BAR file. When you deploy the BAR file, it will fail.
   Workaround: Implement one of the following options:
   • Include all routines at module-level within the subflow.
   • Add the subflows to your workspace, and update the project that contains the calling message flow to reference the subflow project (or projects).

声明

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

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

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

• IBM Director of Licensing
• IBM Corporation
• North Castle Drive
• Armonk, NY 10504-1785
• U.S.A.

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

• IBM World Trade Asia Corporation
• Licensing
• 2-31 Roppongi 3-chome, Minato-ku
• Tokyo 106, Japan

本条款不适用英国或任何这样的条款与当地法律不一致的国家或地区：

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

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

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

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

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

• IBM United Kingdom Laboratories,
• Mail Point 151,
• Hursley Park,
• Winchester,
• Hampshire,
• England
• SO21 2JN

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

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

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

本信息包括在日常业务操作中使用的数据和报告示例。为了尽可能完整地阐述它们，这些示例包括个人姓名、公司名称、品牌名称和产品名称。 所有这些名称都是虚构的，对于现实中使用类似于此名称和地址的企业都纯属巧合。

版权许可：

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

商标

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

IBM WebSphere。

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

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

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

有用的 Web 页面

WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker 修订包
http://www.ibm.com/software/integration/mqfamily/support/summary/wbib.html

WebSphere Business Integration Message Broker 需求
http://www.ibm.com/software/integration/wbimessagebroker/requirements/

WebSphere Business Integration Event Broker 需求
http://www.ibm.com/software/integration/wbieventbroker/requirements/

WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker Install.html
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/

WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker 自述文件
http://www.ibm.com/software/integration/mqfamily/support/readme/

WebSphere Business Integration Message Broker 独立信息中心
http://www.ibm.com/software/integration/wbimessagebroker/library/

WebSphere Business Integration Event Broker 独立信息中心
http://www.ibm.com/software/integration/wbieventbroker/library/