IBM® WebSphere® Message Broker 6.1 版

修訂歷程：

© Copyright IBM Corporation 2008. All rights reserved.
.

歡迎使用 IBM WebSphere Message Broker。這是工具及執行時期元件 6.1.0.3 版的 Readme 檔。

本 ReadMe 說明已知問題，並包含產品文件可用版次的更新。

內容

適用於所有使用者的重大資訊

請務必使用本 Readme 檔的最新版本，其可在下列網址上找到 (僅提供英文版)：
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917

翻譯的 Readme 檔可在下列位置找到：
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/

若要執行完整安裝作業，請參閱 WebSphere Message Broker 安裝手冊。內含您安裝產品前必須完成的作業相關資訊。

如果您是將 6.1.0.3 版服務套用至 Message Broker Toolkit，請參閱「安裝手冊」取得此處理程序的相關指示，以確保您正確地完成處理程序。

請從以下的 IBM Publications Center 存取線上「安裝手冊」：

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

移轉時的重大資訊

如果您是從本產品的 5.0 版或 6.0 版移轉，請參閱線上資訊中心 (http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp)，其中提供如何移轉的相關詳細資訊。

經由「IBM 支援中心」報告，並說明特定移轉問題的文件，會在 WebSphere Message Broker Support 網站上定期更新：http://www.ibm.com/software/integration/wbimessagebroker/support/。按一下 Troubleshoot > View all Troubleshooting documents，然後搜尋標題為 "Problems and solutions when migrating to WebSphere Message Broker 6.0 and 6.1" 的文件。

文件

可從「快速入門 CD」取得 WebSphere Message Broker 獨立式資訊中心，也可從下列網址線上存取： 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® 版)

讀取 quickstart_welcome.html 檔 (放在 wmb_help_linux.tgz 和 wmb_help_win.zip 檔的 ibm_help 資料夾中)。

下列網址收集了各種資訊主題，其格式為「可攜式文件格式 (.pdf)」：
http://www.ibm.com/software/integration/wbimessagebroker/library/

支援

問題報告：本 ReadMe 文件的各個部分皆含有問題報告編號的參照。這些編號相當於內部 IBM 問題編號；當您和 IBM 客戶服務代表討論問題時，這些編號或許很有用。

Technote：如需已知問題和可用修正程式的最新相關資訊，請造訪 WebSphere Message Broker Support 網站：
http://www.ibm.com/software/integration/wbimessagebroker/support/

若要尋找資訊：

畫面上會顯示所有相關的 TechNote，並可對其排序與進一步搜尋。

若想瞭解如何從 Passport Advantage® 網站下載 WebSphere Message Broker 6.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 6.1.0.2 版或更低版本之後，後者無法正常工作，且執行安裝作業時會在檔案系統及登錄中建立異常元素，可能需要手動執行移除作業，才能將這些元素移除掉。

如果您選擇無聲自動安裝方式來安裝執行時期元件，而且產生範本或記錄回應檔，則「安裝手冊」中的範例 (第 7 章「選擇安裝介面」，第 79 頁) 是不正確的。若要記錄回應檔，請輸入：

installer -options-record responsefile.

若要產生範本，請輸入：

installer -options-template responsefile.

第 80 頁的表格 13 也不正確；不可在 -options 和 -record 或 -template 間包含空格。

使用 Windows 解壓縮精靈來解壓縮從 Passport Advantage Xtreme Leverage 網站下載的 WebSphere Message Broker 6.1 版壓縮檔時，若指定長目錄路徑以解壓縮檔案，則可能導致顯示密碼訊息。

如果將檔案解壓縮至路徑很長的目錄，則可能會因為路徑太長而導致 Windows 解壓縮精靈無法處理，此時，系統不會發出錯誤訊息，而是開啟一個視窗，顯示一則訊息提示您輸入密碼。例如，「需要密碼 檔案 'DB2CS_NewCLRProcWizard...' 受到密碼的保護。請在下面的方框中輸入密碼」。此訊息是錯誤的，且可能會針對許多檔案顯示。

頂端

平台

在部署訊息流程並啟動分配管理系統之後，可能會看到下列症狀：

BIP2060W: 分配管理系統偵測到「執行群組」<insert_1> 及程序 ID <insert_2> 已關閉。

BIP2227E: 執行異常終止處理時發生錯誤：<insert_1> - 終止中。

此外，mqsistart 指令無法啟動分配管理系統，且 syslog 可能包含下列錯誤訊息：

BIP8893E: 驗證失敗。無法透過使用者 ID <insert_2> 來存取檔案 '/var/mqsi/components/AIX53_BK/bipcvp_javaversion.tmp'。

如果 AIX 5.3 版檔案集 bos.rte.libc 的版次低於 5.3.0.52，則會發生這些問題。

頂端

移轉

在相同電腦上將執行時期元件從 5.0 版或 6.0 版移轉至 6.1 版時，請開啟新的 Shell，再執行 mqsiprofile 以設定指令環境。

在 z/OS 中移轉時需要 IC54505。IC54505 包含在 Fix Pack 2 中。

在 5.0 與 6.0 版中，您所擁有的訊息集可以同時包含非 MRM 與 MRM 模型，且訊息集的「訊息網域」內容不是設為 'MRM' 或 'IDOC'，並於新增訊息集至 bar 檔時產生 .dictionary 檔，不管「訊息網域」的設定值為何。

在 6.1 版中，只有當「訊息網域」為 'MRM' 或 'IDOC' 時，才會產生 .dictionary 檔。

頂端

WebSphere Message Broker Toolkit

在您嘗試啟動 Toolkit 時，顯示 "JVM 已終止，結束碼 = 1" 錯誤，或是 javaw.exe 程序 100% 佔用 CPU 並且停止。

此問題可能因 eclipse.ini 檔中的 -Xshareclasses:singleJVM,keep 切換參數所致。此切換參數會建立快取，以便能夠共用所有載入的類別，並對共用類別資料的 JVM 不設限。 如果此快取毀損，則不允許任何新的 JVM 連接此快取。現有的 JVM 可繼續運作，但無法更新快取。

如果您需要更新原先使用 IBM Installation Manager 安裝的套件，則也必須使用 IBM Installation Manager 來更新它們。 雖然您可使用 Eclipse Update Manager 來安裝非 IBM 外掛程式，但請不要使用 Eclipse Update Manager 來更新原先使用 IBM Installation Manager 所安裝的 Eclipse 功能及外掛程式。在使用 Eclipse Update Manager 新增外掛程式時，請確保您將它們安裝至套件群組目錄，而非共用資訊目錄 (由 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 服務

WebSphere Message Broker 6.1 版不支援 Windows .NET Server Web Services Security X509。所有其他使用 Windows .NET 的 WebSphere Message Broker Web 服務功能仍完全受支援，特別是 Web Services Security 的 USERNAME 記號。

不支援使用大小超過 16KB 的「訊息傳輸最佳化機制 (MTOM)」附件。

頂端

節點

Collector 節點可能造成的異常終止問題已在 IC54505 中獲得解決。IC54505 包含在 Fix Pack 2 中。

如果是使用 XMLNSC 剖析器來判斷 TCP/IP 輸入及接收節點的訊息結尾，則只有當下一個 XML 文件出現於位元串流中，或 XMLNSC 剖析器看見位元串流結尾時，XMLNSC 剖析器才會找到訊息結尾。如果以上兩種狀況皆未出現，則會顯示逾時異常。

若要克服此問題，請將「記錄偵測」內容設為 Delimited，然後在位元串流中新增一個空值字元。

Solaris x86-64 上的 TCP/IP 節點不處理資料，因此可能會拒絕連線。如果您遇到這些問題，請將 rlim_fd_max 及 rlim_fd_cur 設為 8193 或較小值。

在 IC54505 之前，z/OS 上的 JMS 節點不支援協調交易。IC54505 包含在 Fix Pack 2 中。

WebSphere Message Broker 6.1 版 Fix Pack 1 的 EndpointLookup 及 RegistryLookup 節點，可用於存取位於 WebSphere Service Registry and Repository (WSRR) 6.0.2 版或 6.1 版的服務 meta 資料。但是，WSRR 6.1 版所引入的的新功能 (例如，在 WSDL 中參照「MQ 端點」，以及存取模型化物件與元素等)，目前尚未受到支援。

支援 WebSphere Service Registry and Repository (WSRR) 6.1 版。舊版 WSRR 則不支援。

頂端

WebSphere Adapter 節點

若要從 MQ link for SAP R/3 移轉至 Message Broker 6.1 版，必須具備 IC54505。IC54505 包含在 Fix Pack 2 中。

頂端

資料庫

JDBC 資料庫連線不支援 JDBC/XA 廣域協調 ('XA') 交易。

不支援廣域協調 ('XA') 交易。

不支援儲存程序。

不支援操作資料庫中的 Unicode 資料。

如果已在 HP-UX (PA-RISC) 上安裝 WebSphere Message Broker 6.1.0.2 (或更低版本)，則必須使用 DataDirect Connect (或 DataDirect Connect64) for ODBC Drivers (DD) 5.0 版來設定資料庫的 ODBC 連線。資訊中心主題有提到 DD 5.3 版，其不受此平台支援。

在開始針對分配管理系統資料庫或使用者資料庫配置 ODBC 連線之前，請閱讀 Technote「在 HP-UX (PA-RISC 平台) 上針對 WebSphere Message Broker 6.1 版配置資料庫 ODBC 連線」，網址為：http://www.ibm.com/support/docview.wss?rs=0&context;=SSMKUK&uid=swg21305099。本文件提供詳細資訊，說明如何使用 DD 5.0 版驅動程式來定義連線及配置交易的廣域協調。本次修訂不影響其他平台。

不支援廣域協調 ('XA') 交易。

如果針對 z/OS 系統上的 DB2 資料庫執行 DB2 第 9 版儲存程序 (具有 'REAL' 類型的參數)，則呼叫該儲存程序會失敗並發出 DB2 錯誤 "CLI0111E 數值超出範圍。SQLSTATE=22003"。

如果先前建立了一個使用 Sybase 資料庫當作分配管理系統資料庫的分配管理系統，且您希望升級至 Message Broker 6.1.0.2 版，則在您啟動分配管理系統時，分配管理系統及分配管理系統資料庫可能會發生問題。

若要克服此問題，請在移轉之後、啟動分配管理系統之前執行下列指令。

  1. 在命令提示字元中，輸入下列指令：

    2. isql -Umqsiuid -Pmqsipw

    如果您已授權另一個使用者 ID 及密碼以讓分配管理系統存取資料庫，請使用您的值替代該指令中的 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 包含在 Fix Pack 2 中。

IC54505 之前不支援範例。IC54505 包含在 Fix Pack 2 中。

頂端

聲明和商標

本資訊是針對 IBM 在美國所提供之產品與服務開發出來的。

而在其他國家中，IBM 不見得有提供本資訊中所提的各項產品、服務或功能。要知道在您所在地區是否可得到這些產品及服務，請洽詢當地的 IBM 服務代表。IBM 產品、程式或服務的任何參照絕不表示或暗示只能使用 IBM 的產品、程式或服務。只要未侵犯 IBM 的智慧財產權，任何功能相當的產品、程式或服務都可以取代 IBM 的產品、程式或服務。不過，任何非 IBM 的產品、程式或服務，使用者必須自行承擔作業的評估和驗證責任。

IBM 對於本資訊的內容擁有專利或專利申請案。使用者並不享有本資訊之專利權。您可以透過書面查詢授權，來函請寄到：

若要查詢有關雙位元組字集 (DBCS) 資訊的授權條款，請聯絡您國家或地區的 IBM 智慧財產部門，或用書面方式寄到：

下列段落若與該國之法律條款抵觸，即視為不適用：

IBM 係以「現狀」提供本出版品，而不提供任何明示或默示之保證，包括但不限於非侵害、可售性或符合特定用途之暗示保證。倘若干地區在特定交易中並不許可相關明示或默示保證之棄權聲明，則於該等地區之特定交易，此項聲明不適用。

本資訊中可能會有技術上或排版印刷上的錯誤。因此，IBM 會定期修訂，並將修訂後的內容納入資訊的新版中。IBM 隨時會修改及/或變更本資訊中所說明的產品及/或程式，恕不另行通知。

本資訊中任何對非 IBM 網站之敘述僅供參考，IBM 對這些網站不提供保證。這些網站上的資料並非本 IBM 產品資料的一部分，因此使用該網站造成之損害，由貴客戶自行負責。

IBM 得以在其認可的適度範圍內使用或散佈該資訊，無須擔保任何責任。

獲本程式授權者若希望取得本程式之相關資訊，以便達到下列目的：(i) 在獨立建立的程式與其它程式 (包括本程式) 之間交換資訊；以及 (ii) 相互使用已交換之資訊。則請與位於下列地址之人員聯絡：

上述資料之取得有其特殊要件，在某些情況下必須付費方得使用。

非 IBM 產品的相關資訊，取自該產品供應商、發佈的聲明或其他公共來源。

本文件所提及之非 IBM 產品資訊，取自產品的供應商，或其公佈聲明或其他公開管道。IBM 沒有測試過這些產品，無法確認效能的精確性、相容性或非 IBM 產品的任何其他宣稱內容。關於非 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 在美國和/或其他國家或地區的商標。

其他公司、產品或服務名稱，可能是第三者的商標或服務標誌。

頂端

有用的網站

DB2 Fix Pack
您可以從 CD 或從網站下載來取得 DB2 Fix Pack。然而請注意，該「修正套件」可能很大，因此，使用 CD 版本可避免長時間下載。
如果您擁有現行支援合約，可聯絡 DB2 支援中心，訂購 CD 上的 DB2 Fix Pack。
有關聯絡方面的詳細說明，請造訪：
http://www.ibm.com/software/data/db2/udb/support.html
也可從相同的網站下載。

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 Readme
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 6.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