WebSphere Business Integration Adapters for AIX 2.3.1 版的版本注意事項

這些版本注意事項涵蓋 WebSphere Business Integration Adapters for AIX 2.3.1 版的版本資訊。包含下列各節：
本版新增的功能 WebSphere Business Integration Adapters API
產品修正歷史 已知的問題及暫行解決方法
軟硬體需求 文件更新
安裝、移轉、升級及配置資訊

附註：在公佈這些版本注意事項之後，發行的 Technical Support Flashes (技術支援短訊) 中可能提供關於本產品的重要資訊。如需這些資訊支援，請造訪 WebSphere Business Integration 支援網站，網址為： http://www.ibm.com/websphere/integration/wbiserver/support。選取感興趣的元件區域並搜尋 flash (短訊) 區段。

本版新增的功能

本節列示此版本的新增及加強功能。

WebSphere Business Integration Adapters 組織架構

WebSphere Business Integration Adapters API

如需詳細資料，請參閱 Connector Development Guide for Java。

產品修正歷史

在這個版本中，已根據客戶報告案例修正了下列 CR。

WebSphere Business Integration Adapters API

CR
號碼		 說明
12271 支援自訂商業物件處理常式。已加入具有方法 doVerbForCustom 的新介面 CWCustomBOHandlerInterface。 使用自訂商業物件處理常式的配接器必須實作這個介面。此外， 商業物件動詞特定應用程式專用的資訊必須變更，以便 CBOH=custom_BO_Handler_class_name (確定使用完整路徑名稱， 亦即，以 "com" 作為路徑開頭)。
17975 當捕捉到異常狀況時，WebSphere Business Integration Adapters API 方法現在會記載異常狀況訊息，並且列印堆疊追蹤。
19664

已加入新內容 EventStoreFactory。如果它設成連接器的事件儲存區 Factory 實例， 比方說，com.crossworlds.connectors.JDBC.JDBCEventStoreFactoryInstance， 它將用來取得事件儲存區；如果它未設成該實例， API 將嘗試根據套件資訊，來建置事件儲存區 Factory 實例類別名稱。 此外，TRUESTRING 及 FALSESTRING 已加入到 CWConnectorAttrType， 且寫在程式中的 "true" 字串已換成這個字串。
19665 如果指定整數以外的任何資料給 pollQuantity，pollForEvents 將傳回 FAIL。
19673 有一個採用定界字元及內容名稱的新方法 getAppText 已加入至 CWConnectorBusObj。根據內容名稱及定界字元， 將傳回特定應用程式專用的資訊中的內容值。
22702 有一個新方法 setDEEId 已加在 CWConnectorBusObj 類別中。 它會將 ObjectEventId 屬性設成事件 ID：

public void setDEEId(String eventid)

傳回 AttributeNotFoundException、AttributeValueException。
22877 有一個新方法 getEventStore 已加入至 CWConnectorAgent 類別。 這個方法會從連接器取得事件儲存區，然後傳回 CWConnectorEventStore 物件：

public CWConnectorEventStore getEventStore()

預設 pollForEvents 方法已做了變更，以便能夠呼叫這個方法。 此外，這個方法有一個預設實作。首先它會查看 EventStoreFactory 內容。 EventStoreFactory 內容必須設成 CWConnectorEventStoreFactory 介面實作。 若是如此，則這個類別的實例即會建置，並取得已從連接器取得的事件儲存區。 如果未設定內容，方法將嘗試從連接器套件建置實作名稱。

連接器具有置換這個方法並提供自己方法的選項。如果連接器想要使用預設建構子以外的建構子，這個選項很有用。
23369 從 pollForEvents 內呼叫 doVerbFor 時， 來自 doVerbFor 方法呼叫的 APPRESPONSETIMEOUT 不會終止連接器。若要啟用， 狀態必須最多傳送至 pollforEvents，且 pollForEvents 必須傳回 APPRESPONSETIMEOUT。
23406 EXISTS 及 RETRIEVEBYCONTENT 動詞常數已加入至 CWConnectorConstants 類別。
23612 對於屬性或商業物件層次的特定應用程式專用的資訊， 沒有值的標籤 (如 ior_file_name=;poa_name=server) 將失敗， 並顯示「發生異常狀況，找不到如此的元素」。這已經修好了。
23620 並不會以原子性 (或同步處理) 步驟， 來配置 meta 物件及建立資料處理常式。當多個執行緒進入 WebSphere Business Integration Adapters API 時，這將導致與資料處理常式基礎類別有關的問題。 現在會同步處理用來呼叫 setConfigMO 的程式碼。此外，僅呼叫方法一次， 因此後續的呼叫會繼續建立資料處理常式。

WebSphere Business Integration Adapters 安裝程式

CR
號碼		 問題
11983, 12221, 13382, 17788, 20169 4.2.1.0 版的「元件選擇」畫面中的多個問題已經修好了。 它們包括：
  • 每次選擇後，就會重新整理畫面
  • 當收合元件時，無法讀取畫面中的文字
  • 選取母項元件不會選取所有子元件。
  • 選取一個子元件就會選取所有子元件
20679 如果 InterChange Server 是您的整合分配管理系統， 請確定您是在安裝 ICS 的目錄中安裝 WebSphere Business Integration Adapters 2.3.1 版的配接器。

軟硬體需求

軟硬體需求已併入在產品文件中。如需那些手冊的鏈結， 請參閱安裝、移轉、升級及配置資訊。

安裝、移轉、升級及配置資訊

無論您是從 CD 安裝軟體，或者從 Passport Advantage 下載後再從本端目錄進行安裝，皆請參閱適當的手冊：

這些手冊也會併入移轉、升級及配置資訊。

WebSphere Business Integration Adapters API

請確定您是搭配 WebSphere Business Integration Adapters API 1.5.0 版或更新版本來執行配接器。

驗證 API 的版本

若要檢查 API 版本，請尋找 manifest 檔 (ProductDir/lib/WBIA.jar) 並以適合的 Java JAR 編輯器開啟它。尋找下列行：

Implementation-Title: "CWConnectorAPI"
Implementation-Version: 1.5.0
Implementation version indicates the current version of WBIA API.

如果版本不是 1.5.0 或以上，您必須下載最新的 WBIA API。

下載 API

若要下載最新版的 API，請：

  1. 前往 http://www.ibm.com。
  2. 按一下 Support and downloads (支援與下載) 標籤。
  3. 在 Downloads (下載) 標題下，按一下 All downloads & drivers (所有的下載及驅動程式)。
  4. 在 Enter search terms (輸入搜尋詞彙) 欄位中，鍵入 "wbia api" 並按一下 Submit (送出)。

在下載並安裝 API 之後，您應該會看到下列檔案：

lib/WBIA.jar
lib/WBIA/3.0.0/WBIA.jar
lib/WBIA/4.0.0/WBIA.jar
lib/WBIA/4.1.1/WBIA.jar
bin/CWConnEnv.sh
bin/CWODAEnv.sh
connectors/messages/CwConnectorAgentMessages.txt

讓配接器能夠使用舊版的 Adapter Development Kit 和 InterChange Server

若要讓配接器使用各種版本的 ADK 或 InterChange Server，請遵循下列適當的程序：

InterChange Server 4.0.1 版、4.1.0 版、ADK 2.0.x 版

在 CWConnEnv.sh 中，將 CWVERSION 變數設為 4.X。

set CWVERSION="4.X"
InterChange Server 4.1.x 版（4.1.0 除外）、ADK 2.1.x 版

在 CWConnEnv.sh 中，將 CWVERSION 變數設為 4.1.X。

set CWVERSION="4.1.X"
對 InterChange Server 4.0.1 和 4.1.x 版以及 ADK 2.0.x 和 2.1.x 版執行「物件探查代理程式」(ODA)

在 bin/CWODAEnv.sh 中，將 CWVERSION 變數設為 4.1.X。

set CWVERSION="4.1.X"

已知的問題及暫行解決方法

WebSphere Business Integration Adapters 執行時期

CR
號碼		 問題
23373 執行利用 Connector Development Kit (CDK) 2.1 版 (含有 2.3.1 CDK 建置) 建置的連接器時，將傳回執行時期錯誤。

暫行解決方法：利用 2.1 CDK 修補程式來重新編譯連接器。

23374 執行利用 Connector Development Kit (CDK) 2.0 版 (含有 2.3.1 CDK 建置) 建置的連接器時，將傳回執行時期錯誤。

暫行解決方法：利用 2.0 CDK 修補程式來重新編譯連接器。

23482

由於 WebSphere MQ 限制，所以配接器無法將 100 MB 以上的 XML 訊息文字寫入 MQ 佇列以進行處理。當 JMS 是傳輸， 且 WMQI 或 WAS 是整合分配管理系統時，就會發生這個問題。 配接器執行時期會將商業物件轉換為可以變得非常大的 XML 訊息。

暫行解決方法：避免在每一個商業物件中建立 25000 個以上的子項物件。
24108 執行利用 Connector Development Kit (CDK) 2.2 版 (含有 2.3.1 CDK 建置) 建置的連接器時，將傳回執行時期錯誤。

暫行解決方法：利用 2.2 CDK 修補程式來重新編譯連接器。

23699

在重負載的 AIX 5.3 平台環境中 (transport = JMS; broker = WMQI 或 WAS；大量子項商業物件； 商業物件大小大於 1 MB；並行耗用階段作業大於 1 的情況下執行配接器)，連續 10 到 12 小時執行連接器代理程式後可能出現 OutOfMemory 錯誤。

暫行解決方法：將並行階段作業維持在 1 個階段作業

WebSphere Business Integration Adapters 安裝程式

CR
號碼		 問題
11600 起始設定 Java Virtual Machine (JVM) 期間，「安裝程式」的起始啟動可能緩慢。 

暫行解決方法：僅啟動「安裝程式」一次，請勿嘗試多次啟動它。
17529、
21358、
21858、
21901		 如果您從舊版的 WebSphere Business Integration Adapters 升級至 WebSphere Business Integration Adapters 2.3.1 版，當解除安裝 WebSphere Business Integration Adapters 2.3.1 時，某些資料夾和檔案可能會被保留下來。

解決方案：解除安裝完成後，手動移除不要的檔案或目錄。
24023 在安裝或解除安裝之後，您可能在主控台中看到下列警告：
警告：
名稱：scrollbar
類別：XmScrollbar
捲軸頁面增量小於 1

安裝或解除安裝是否順利完成，不會受到這個警告的影響。

協力廠商安裝程式

CR
號碼		 問題
15011、17268 協力廠商安裝產品在空間不足時不會停止安裝。

解決方案：啟動安裝之前，請先確定安裝目錄中有足夠的磁碟空間。
23778 「語言選擇」畫面上的標題文字可能會被截斷，取決於您選擇的語言環境而定。 「語言選擇」對話框無法改變大小。

文件更新

不論是光碟或電子產品分送之產品套件中，並不包括產品文件。您可以在下列 InfoCenter 中找到本產品的文件：

若要取得產品文件，請造訪該網站並下載適合您目前所用版本的最新文件集。請遵循 InfoCenter 網頁上提供的指示來完成安裝。

Copyright IBM Corp. 1997, 2003