IBM^(R) WebSphere^(R) Business Integration Message Brokers Toolkit 5.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 5.1 版。

本 Readme 檔的資訊僅適用於在 Microsoft^(R) Windows^(R) 上安裝 Message Brokers Toolkit 5.1 版， 並與 WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker 5.0 版搭配使用。 其中說明了已知的問題，並包含線上資訊中心的更新文件。您還必須閱讀 IBM WebSphere Business Integration Message Brokers 5.0 版 Readme 檔， 以進一步瞭解本產品相關資訊。

警告！
除非您已安裝 WebSphere Application Development Integration Edition 5.1 版，才需要安裝 Message Brokers Toolkit 5.1 版。 如果您有較舊層次的 WebSphere Studio Application Developer Integration Edition，請勿安裝 5.1 版； 這樣的情況下，您必須使用由 WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker 5.0 版所提供的 Message Brokers Toolkit 5.0 版。 Message Brokers Toolkit 5.1 版與 Message Brokers Toolkit 5.0 版的功能相同。

在群組環境中安裝 Message Brokers Toolkit 5.1 版
WebSphere Studio Application Developer Integration Edition 5.1 版並非 安裝 Message Brokers Toolkit 5.1 版的必備項目。但若其中一項 Message Broker Toolkit 安裝作業整合了 WebSphere Studio Application Developer Integration Edition 5.1 版，則所有安裝的 Message Broker Toolkit 版本都必須是 5.1 版，以確保資料的分享及完整性。

如果您並未在任何系統上使用 WebSphere Studio Application Developer Integration Edition 5.1 版， 或您使用的是 WebSphere Studio Application Developer Integration Edition 5.0 版， 請務必安裝 Message Brokers Toolkit 5.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).

使用者重要須知

您可以在以下網址中找到 Readme 檔以及 install.html 檔的翻譯版本： ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling

此套件不包含資訊中心的翻譯版本。資訊中心中的其他語言部分會保持空白，且所有的資訊都以英文顯示。 如果您要用美國英文以外的支援語言顯示資訊中心，請在安裝修正套件後，下載適當的 Eclipse 功能。 您可在修正套件發佈當時或稍後取得翻譯的版本。如需下載更新的指示，請參閱功能更新。

移轉重要須知

如果您要執行移轉作業，請先參閱 install.html 檔，以瞭解詳細的安裝前必須進行的動作。

如果您想在安裝了 Message Brokers Toolkit 5.0 版的系統上安裝 Message Brokers Toolkit 5.1 版， 您必須先解除安裝 5.0 版，因為這兩個版本無法同時存在。

資訊中心中提供了進一步的移轉相關資訊；請在安裝前，先下載獨立資訊中心（請參閱文件以取得指示）。

請您注意以下幾個有關移轉和部署的事項：

• 在 5.1 版工具箱中建立或修改訊息流程、訊息集以及訊息對映後， 您無法再存取 5.0 版工具箱中的資源。 請確定在團隊環境中共用專案的所有使用者都注意到此限制，且在需要時製作備份。
• 您必須要從供應商取得所有使用者定義的節點外掛程式的移轉版本， 才能成功地部署包含這些節點外掛程式的訊息流程。

在不同系統中，您可以共用不同版本的資源：

• 您可以部署任何在 5.0 版中所開發的專案，不需作任何變更。
• 您可以將此版本所建立的分配管理程式保存檔匯入 5.0 版工作區，並成功部署。

文件

支援

功能更新

1. 從工具箱中，選取說明 > 軟體更新 > 新的更新項目。之後，Eclipse 會搜尋可用的更新項目。
2. 這時 Eclipse 會顯示可用的更新項目。選取您要安裝的更新項目。
3. 當您選取要安裝的更新項目時，您會收到一則功能尚未以數位簽章的警告。您可以忽略這個警告。
4. 安裝好功能之後，Eclipse 會提示您重新啟動工作台。
5. 在您重新啟動工作台後，新的功能已安裝，且可以開始使用。

目錄

限制

• WebSphere Studio Application Developer Integration Edition
• 共存性
• 安裝
• 安裝之後

注意事項和商標

有用的網頁

限制

本節依元件概述 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 5.1GA 版。 不支援舊版的 WebSphere Studio Application Developer Integration Edition 5.1。

在安裝了 WebSphere Business Integration Message Broker 或 WebSphere Business Integration Event Broker 之後，您還必須套用修正程式「WebSphere Business Integration Message Broker 5.1.5 版臨時修正程式 001 - 必備修正程式 1.0.0.1」。

若要取得詳細指示，請參閱 install.html 檔。

共存性

• 您可以部署任何在 5.0 版中所開發的專案，不需作任何變更。
• 您可以將此版本所建立的分配管理程式保存檔匯入 5.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 5.1 版，並取代了 5.0 版：
   1. 問題報告 34555
      您必須重新建置在您工作區中所定義的所有專案。
   2. 問題報告 34930
      如果 INSTALL_PATH\eclipse\workspace\.metadata 存在，您可能會發現，在開啟 Message Brokers Toolkit 時， 「更新管理程式」會正確啟動，但是對外掛程式的任何更新都會失敗。因此，Message Brokers Toolkit 無法開啟正確的外掛程式層次，可能導致工具箱失敗。
      
      例如，當您在「分配管理系統應用程式開發視景」中，您可能會發現檔案 > 新建功能表所產生的清單遺漏了訊息定義檔功能表項目。 這表示您的安裝架構中不含 Message Brokers Toolkit 外掛程式的正確層次或版本。
      
      您可以按一下 Message Brokers Toolkit for WebSphere Studio 視窗中的說明 > 關於 Message Brokers Toolkit for WebSphere Studio - Message Broker，來檢查所使用的外掛程式層次是否正確。 在 "Message Brokers Toolkit for WebSphere Studio" 標題之下，會顯示版本號碼。 如果在安裝 5.1 版後使用了正確版本的外掛程式，則顯示的版本會是 5.1.0。如果顯示的版本為舊的，請執行以下步驟：
      1. 刪除 .metadata 目錄。
      2. 重新開啟 Message Brokers Toolkit。
      3. 針對每個專案執行下列動作，以將現有專案重新匯入工作區中：
         1. 按一下檔案 > 匯入。
         2. 當「匯入」精靈出現時，請選取現有專案至工作區，然後按一下下一步。
         3. 按一下瀏覽並定義工作區中的專案位置。
         4. 按一下完成。
2. 問題報告 32898
   如果本端主機存取作業的 LAN 設定配置不正確，可能會因為自動組態 Script 中的設定而發生下列狀況之一：
   • 您的說明瀏覽器開啟空白的頁面。
   • 您的說明瀏覽器顯示 HTTP 錯誤，而不是說明頁面。
   • 在載入資訊中心時有長時間的延遲。
   
   解決方案：系統管理者可以執行下列動作來配置 LAN 設定，以便從本端說明伺服器順利存取說明文件：
   1. 在控制台中，開啟「網際網路選項」，選取「連線」標籤，選擇 LAN 設定。
   2. 如果您的主機配置成使用 DHCP 來指派 IP，請確定已清除自動偵測設定勾選框。
   3. 如果您使用 Proxy 伺服器，請確定已選取本端網址略過 Proxy 伺服器。
   4. 在 Proxy 的進階設定中，如果 '127.0.0.1;localhost' 沒有列在「例外」中，請將它加進去。
   5. 如果您使用 Proxy 設定的自動組態 Script，且不確定這個 Script 是否正確，請清除使用自動組態 Script 勾選框。
   
   如果上述步驟無法修正您的問題，請嘗試變更 org.eclipse.tomcat\preferences.ini 中的 port 和 host 內容。 設定 host=localhost 或 host=127.0.0.1 應該會有效。 如果您在執行防火牆，您也可能需要設定 port=80（或其他防火牆方便使用的值）。
3. 問題報告 T32243
   "mxsd" 副檔名並未正確關聯到訊息定義編輯器 (Message Definition Editor)。為確保 mxsd 檔能在訊息定義編輯器中 以預設動作開啟，請選取 Windows > 喜好設定 > 工作台 > 檔案關聯。向下捲動檔案類型清單， 並選取 *.mxsd。再選取關聯編輯器清單中的訊息定義編輯器。按一下預設，再按確定。
4. 問題報告 36638
   訊息集編輯器喜好設定主題 (ad15810_) 只說明了 5.0 版工具箱中可用的選項。5.1 版中並不包括 5.0 版的選項。 5.1 版工具箱中的選項為：
   • 訊息集編輯器設定、概要檢視畫面設定。畫面上會顯示這些選項，但無法作業：
     • 先以名稱空間為群組，再以集合為群組
     • 先以集合為群組，再以名稱空間為群組
   • 訊息定義編輯器設定：
     • 顯示基本複式類型
       如果您以其他複式類型為準，定義了一或多個複式類型，請選擇此選項以便在訊息定義編輯器概觀和概要檢視畫面中， 顯示這些複式類型的內容（此為預設選項）。
       如果不想顯示其內容，請取消勾選此勾選框。
5. 問題報告 36655
   如果您呼叫 uninstaller.exe 並加上 -silent 選項來解除安裝工具箱， 解除安裝程式會立即交回控制權，並以背景方式執行作業。 如果您希望解除安裝程式在完成作業後交回控制權，便需使用以下指令在 Java 中呼叫解除安裝程式：
   java -cp <install_dir>\_uninst\studio\uninstall.jar run -silent
   其中的 <install_dir> 是您安裝產品的目錄。
   如果您沒有配置 JVM（1.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 可能擁有其專利或專利申請案。 提供本資訊不代表提供這些專利的授權。您可以書面提出授權查詢，來函請寄到：

• 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

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

IBM 公司只依「現況」提供本出版品，不提供任何明示或默示之保證， 其中包括且不限於不違反規定、可商用性或特定目的之適用性的隱含保證。有些地區在特定交易上，不允許排除明示或暗示的保證，因此，這項聲明不一定適合您。

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

這份資訊中所提及的任何非 IBM 網站只供參考，IBM 不為這些網站提供保證。 這些網站所提供的素材不是 IBM 本產品的素材內容，如果要使用這些網站的素材，您必須自行承擔風險。

IBM 得以各種適當的方式使用或散布由您提供的任何資訊，無需對您負責。

如果本程式的獲授權人為了 (i) 在個別建立的程式和其他程式（包括本程式）之間交換資訊， 以及 (ii) 相互使用所交換的資訊，因而需要相關的資訊，請洽詢：

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

這些資訊可依適當條款而取得，在某些情況下必須付費方得使用。

IBM 基於雙方之 IBM 國際程式設計授權合約（或任何同等合約）條款， 提供本資訊所提及的授權程式與其所有適用的授權資料。

本書所提及之非 IBM 產品資訊，取自產品的供應商，或其發佈的聲明或其他 公開管道。IBM 並未測試過這些產品，也無法確認這些非 IBM 產品的執行效能、 相容性或任何對產品的其他主張是否完全無誤。有關非 IBM 產品的性能問題應直接洽詢該產品供應商。

這份資訊含有日常商業運作所用的資料和報告範例。 為了要使它們儘可能完整，範例包括個人、公司、品牌和產品的名稱。 所有這些名稱都是虛構的，如有任何類似實際企業所用的名稱及地址之處，純屬巧合。

著作權：

這份資訊含有原始語言的範例應用程式，用以說明各作業平台中的程式設計技術。 您可以基於研發、使用、銷售或散布符合作業平台（撰寫範例程式的作業平台）之應用程式介面的應用程式等目的，以任何形式複製、修改及散布這些範例程式，而不必向 IBM 付費。 此些範例並未在所有情況下完整測試。因此，IBM 不保證或暗示這些程式的可靠性、有用性或功能。 您可以免費為了開發、使用、銷售或散布應用程式，利用任何形式來複製、修改和散布這些程式範例，不過，這些應用程式必須符合 IBM 的應用程式設計介面。

商標

下列詞彙是 IBM 公司在美國及/或其他國家或地區的商標：

IBM WebSphere。

Java 和所有以 Java 為基礎的商標是 Sun Microsystems, Inc. 在美國及/或其他國家或地區的商標。

Microsoft 和 Windows 是 Microsoft 公司在美國及/或其他國家或地區的商標。

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

有用的網頁

WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker Fix Packs
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 Readme 檔
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/