IBM WebSphere Message Broker V8.0.0.0 工具和运行时组件。
自述文件:IBM WebSphere Message Broker
产品/组件发行版:8.0
发布日期:2011 年 12 月 9 日
上次修改日期:2011 年 12 月 9 日
请始终使用本自述文件的最新版本,最新版本可在以下网站上找到(仅提供英文版本):
http://www.ibm.com/support/docview.wss?uid=swg27006917
翻译的自述文件可在以下位置找到:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/
有关在安装本产品之前必须完成的任务的信息,请参阅 WebSphere Message Broker V8.0 信息中心,网址为:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
请检查 WebSphere Message Broker 系统需求以确保安装平台支持计划安装的产品修订版。WebSphere Message Broker 系统需求 Web 页面可从以下网址获取:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
在 Windows 上提供给了两个版本的 WebSphere Message Broker V8.0:
WebSphere Message Broker 的 64 位修订版在 Windows 操作系统的所有 64 位版本上不受支持。有关更多信息,请参阅 WebSphere Message Broker 系统需求 Web 页面。
将服务应用到 z/OS
如果您要将服务应用到 z/OS,必须下载二进制文件格式的程序临时性修订 (PTF) 软件包,然后将它们传输到 z/OS:
组织 . . . :PS
记录格式 . . . :FB
记录长度 . . . :1024
块大小 . . . :6144
第一扩展磁道. . . :500
第二磁道 . . . :50
可以使用下列样本作业控制语言 (JCL) 来分配这些数据集:
/* INSERT A VALID JOBCARD HERE
//*
//ALLOCATE EXEC PGM=IEFBR14
//SYSMOD1 DD DSN=YOUR HIGH LEVEL QUALIFIER (HLQ).PTF
NUMBER.TRS,
// DISP=(NEW,CATLG,DELETE),
// UNIT=SYSDA,
// SPACE=(TRK,(500,50),RLSE),
// DSORG=PS,
// DCB=(RECFM=FB,LRECL=1024,BLKSIZE=6144)
//*
put PTF NUMBER.TRS 'YOUR HLQ.PTF
NUMBER.TRS' (replace
进行更改并添加合适的作业卡之后,可以使用下列样本 JCL 来解压缩数据集:
//*****************************************************
//* UNTERSE APAR
//*****************************************************
/UNPACK EXEC PGM=TRSMAIN,PARM='UNPACK'
//STEPLIB DD DISP=SHR,DSN=TERSE.LOADLIB
//SYSPRINT DD SYSOUT=*
//INFILE DD DSN=YOUR HLQ.PTF NUMBER.TRS,
// DISP=SHR
//OUTFILE DD DSN=YOUR HLQ.PTF NUMBER,
// DISP=(NEW,CATLG),
// SPACE=(TRK,(1000,100,))
/*
如果是从 WebSphere Message Broker V6.1 或者 V7.0 迁移,请参阅位于 http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp 的联机信息中心,此信息中心提供了有关如何进行迁移的详细信息。
WebSphere Message Broker V8.0 联机信息中心位于以下网址:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
总是参阅联机信息中心来获取最新信息。联机信息中心包含了比随 Message Broker Toolkit 一起提供的信息中心更新的信息。
WebSphere Message Broker V8.0 GA 信息中心包含关于记录和查看数据的文档。但是,它不包含关于重播数据的信息。
已提供了一个 PDF,其中包含关于记录、查看和重播数据的最新且最详尽的文档。要下载该 PDF,请参阅位于以下网址的技术说明:
www.ibm.com/support/docview.wss?uid=swg21573603
独立信息中心可从以下地址下载:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_linux.tgz(Linux 版本)
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_win.zip(Windows 版本)
请阅读 wmb_help_linux.tgz 和 wmb_help_win.zip 文件中 ibm_help 文件夹中包含的 using_the_infocenter.html 文件。
缺陷:此自述文件可能包含对缺陷编号的引用。这些编号是指 IBM 的内部问题编号;当您与 IBM 服务代表讨论问题时,您可能会发现这些编号非常有用。
技术说明:有关已知问题和可用修订的最新信息,请参阅位于以下网址的 WebSphere Message Broker 支持 Web 站点:
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_Message_Broker
要查找信息,请单击故障诊断。将显示 WebSphere Message Broker 技术说明,可以对它们进行排序和搜索。
有关从 Passport Advantage Web 站点下载 WebSphere Message Broker V8.0 安装映像的信息,请参阅 Download WebSphere Message Broker V8.0 from the Passport Advantage website site 下载文档,其网址为:
http://www.ibm.com/support/docview.wss?uid=swg24030968
版本:有关 WebSphere Message Broker 支持哪些特定版本的操作系统和数据库的最新信息,请查询系统需求页面:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/index.html
定期检查是否有对 WebSphere Message Broker Toolkit 的更新,包括英语以及其他受支持语言版本的文档更新。可在以下网址找到 WebSphere Message Broker 的建议更新:
http://www.ibm.com/support/docview.wss?uid=swg27006041
有关 V8.0 中的新增功能的详细信息,请访问以下网站:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp?topic=/com.ibm.etools.mft.doc/bb23110_.htm
本部分按组件概述了 WebSphere Message Broker 的已知问题及其解决方法。
症状:
如果您运行 WebSphere Message Broker 卸载程序 uninstaller.exe,并且使用的是 Windows 7 或 Windows Server 2008 R2,那么会显示一个对话框,警告卸载程序文件未经签名。
解决方案:
可以安全地忽略此警告。继续卸载过程。
症状:
如果要通过来自 IBM Passport Advantage 的电子映像安装 IBM 产品,并且您在使用 Windows XP Service Pack 2 或更高版本,那么 Windows 安全性设置可能会导致附件管理器阻止安装程序 .zip 文件的内容,从而导致安装失败。
解决方案:
要解决此问题,请完成下列步骤:
有关 Windows 附件管理器的更多信息,请参阅位于以下网址的 Microsoft Support 站点:http://support.microsoft.com/kb/883260
WebSphere Message Broker V8.0 GA 运行时组件的安装映像超过了 700MB 的物理 CD 推荐限值。出于此原因,在物理 DVD 而非物理 CD 上提供 HP-UX 平台的安装映像。WebSphere Message Broker V8.0 GA 运行时组件的安装映像也可从 Passport Advantage Web 站点获取。
有关从 Passport Advantage Web 站点下载 WebSphere Message Broker V8.0 安装映像的信息,请参阅 Download WebSphere Message Broker V8.0 from the Passport Advantage website site 下载文档,其网址为:
http://www.ibm.com/support/docview.wss?uid=swg24030968
Ubuntu 上支持 WebSphere Message Broker,但是仅限于开发系统。生产系统不应用于在 Ubuntu 上运行 WebSphere Message Broker。
有关更多信息,请参阅 WebSphere Message Broker 系统需求页面。WebSphere Message Broker 系统需求 Web 页面可从以下网址获取:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
症状
如果尝试连接的节点具有通往其他节点的多个输出终端,那么无法创建连接。
解决方案
要绕过此问题,请完成以下一个步骤:
要将 WebSphere Message Broker Explorer 连接至队列管理器以接收发布,该队列管理器的 SVRCONN 通道上的 SHARECNV 属性的值必须大于 0。 如果希望使用 WebSphere Message Broker Explorer 中的“Broker 统计信息”视图或“Broker 统计信息图”视图,那么该值是必需的。
症状:
将 WebSphere Message Broker Toolkit 及其资源迁移至 V8.0 后,V8.0 中已除去的项可能会显示在 WebSphere Message Broker Toolkit 中,例如菜单中先前的 Toolkit 选项。可能还会显示无解释的错误。
解决方案:
要解决此问题,请完成下列步骤:
症状:
将资源导入到新工作空间中时,自动构建完成后可能会显示错误消息。
解决方案:
在“代理程序开发”视图中,选择项目并右键单击项目 > 清理以重建项目。清理项目后,与导入有关的错误消息会被除去。
mqsicreatebar
指定新的工作空间可能需要进行项目清理症状:
运行 mqsicreatebar
命令并指定新工作空间时,可能会显示错误消息。
解决方案:
运行 mqsicreatebar
命令以清除项目时,请使用 -cleanBuild
选项。
症状:
使用 WebSphere Message Broker Toolkit V8.0.0.0 GA 中包含的信息中心时,数据格式描述语言 (DFDL) 主题仅以英语(美国)显示。
这些主题的标识为“dfxxxxx_”,其中“xxxxx”是五位数字。
解决方案:
要以英语(美国)以外的语言查看那这些主题,请使用联机信息中心。WebSphere Message Broker V8.0 的联机信息中心包含最新的已翻译文档,位于以下网址:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
症状:
在执行 WebSphere Adapter for SAP Software 企业元数据发现 (EMD) 迭代式发现期间,将显示并可编辑“适配器连接”向导的服务生成和部署配置面板,但您输入的所有适配器系统连接信息不会保存在适配器组件中。
解决方案:
使用 WebSphere Adapter 编辑器更改适配器系统连接信息,以确保后续 EMD 迭代发现保留适配器系统连接信息:
症状:
如果在适配器向导中选定了确认提交复选框,那么 JDE 入站适配器部署将失败。将发出如下错误:
尝试设置适配器组件“AssuredDeliveryMSApp.IBM WebSphere Adapter for JD Edwards EnterpriseOne”上的属性“AssuredOnceDelivery”失败,因为不支持该属性。
解决方案:
当前不支持此功能,且不应该在消息流开发中使用此功能。
症状:
如果使用图形数据映射来建设从数据库检索到的输入数据,那么将依赖于数据库服务器的缺省模式名称配置。Broker 目前不提供工具来覆盖要在针对数据库发出的 SQL 语句中使用的数据库模式名称。 当前,该映射发出的 SQL 语句仅包含数据库和表名称,而不包含模式名称。因此,您的数据库服务器使用缺省数据库模式名称作为 Broker 运行映射时用于连接到该服务器的身份。Broker 使用的连接身份是在 Broker JDBCProvider 可配置服务中配置的。使用的 JDBCProvider 可配置服务由映射中的数据源名称选择。
如果所需的数据库表在此模式中不可用,那么映射执行会因代理程序错误而失败,该错误中包含数据库服务器的特定错误代码。例如:
BIP3947E: QName“{maps}:RDB_Mapping”的映射处理失败,以下为详细信息:
“{特定的数据库模式表访问错误消息和代码}”
解决方案:
确保从图形数据映射中选择的表在由数据库服务器为 JDBCProvider 可配置服务中配置的数据库连接身份设置的模式中可用。这在 z/OS 上尤其受限。
症状:
在使用 Z shell (zsh) 作为 shell 环境的 UNIX 系统中,调用 'source {install path}/mqsiprofile' 会导致 shell 退出。由于 zsh 的缺省行为,mqsiprofile 命令会检查不正确的参数号以确定它作为源还是直接运行。然后 mqsiprofile 脚本会显示一条警告消息并调用出口,但是 zsh 会将此调用解释为退出当前 shell 的指令。
解决方案:
要绕过此问题,请完成以下步骤:
症状:
信息中心主题 an19545_ mqsiapplybaroverride 描述了用于应用程序和库的参数 -k 和 -y。将这两个参数用于命令会导致以下错误:
BIP1033E 参数无效
解决方案:
此命令不支持这些选项,因此不应予以使用。
使用 z/OS 上的用户数据库的客户需要 DB2 APAR PK99362。
不支持全局协调 ('XA') 事务。
在除 HP-UX on Itanium 和 z/OS 以外的所有代理平台上的 DB2 和 Oracle(不包括 Oracle RAC)都支持 JDBC/XA 全局协调 (“XA”) 事务。
不能在同一个代理上同时包含 ODBC XA 和 JDBC/XA。
不支持 Informix 全局协调 ('XA') 事务。
仅 DB2 和 Microsoft SQL Server 在 Windows Server 2008 R2 和 Windows 7 64 位上受支持。请使用 DB2 和 Microsoft SQL Server 系统需求页面来确定要与您的系统配合使用的每个产品的正确版本。
DB2 系统需求 Web 页面可从以下网址获取:
http://www.ibm.com/software/data/db2/linux-unix-windows/sysreqs.html
http://www.ibm.com/legal/copytrade.shtml
本信息是为在美国提供的产品和服务编写的。
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 在美国和/或其他国家或地区的商标:
DB2、developerWorks、IBM、Informix、Passport Advantage、WebSphere 和 z/OS。
Java 和所有基于 Java 的商标和徽标是 Oracle 和/或其子公司在美国和/或其他国家或地区的商标或注册商标。
Microsoft 和 Windows 是 Microsoft Corporation 在美国和/或其他国家或地区的商标。
UNIX 是 The Open Group 在美国和其他国家或地区的注册商标。
Linux 是 Linus Torvalds 在美国和/或其他国家或地区的商标。
其他公司、产品或服务名称可能是其他公司的商标或服务标记。
WebSphere Message Broker 产品页面
http://www.ibm.com/software/integration/wbimessagebroker/
DB2 修订包
如果您有当前支持合同,可以致电 DB2 支持来订购 DB2 修订包。或者,您也可以从 Web 下载 DB2 修订包,但是,有些修订包文件可能很大,因此购买 CD 版本可避免长时间的下载。
DB2 支持的联系详细信息和 DB2 修订包下载可以从以下网址获取:
http://www.ibm.com/software/data/db2/udb/support.html
WebSphere MQ 修订包
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_MQ
WebSphere Message Broker 修订包
http://www.ibm.com/support/docview.wss?uid=swg27006041
WebSphere Message Broker 要求
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
WebSphere Message Broker 自述文件
http://www.ibm.com/support/docview.wss?uid=swg27006917
WebSphere Message Broker V8.0 单机信息中心
对于 Linux:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_linux.tgz
对于 Windows:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_win.zip
WebSphere Message Broker V8.0 联机信息中心
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/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