這些版本注意事項涵蓋 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 (短訊) 區段。
本節列示此版本的新增及加強功能。
如需詳細資料,請參閱 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 的程式碼。此外,僅呼叫方法一次, 因此後續的呼叫會繼續建立資料處理常式。 |
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 1.5.0 版或更新版本來執行配接器。
若要檢查 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 之後,您應該會看到下列檔案:
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
若要讓配接器使用各種版本的 ADK 或 InterChange Server,請遵循下列適當的程序:
在 CWConnEnv.sh 中,將 CWVERSION 變數設為 4.X。
set CWVERSION="4.X"
在 CWConnEnv.sh 中,將 CWVERSION 變數設為 4.1.X。
set CWVERSION="4.1.X"
在 bin/CWODAEnv.sh 中,將 CWVERSION 變數設為 4.1.X。
set CWVERSION="4.1.X"
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 個階段作業 |
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 中找到本產品的文件:
http://www.ibm.com/websphere/integration/wicserver/infocenter
http://www.ibm.com/websphere/integration/wbiadapters/infocenter
若要取得產品文件,請造訪該網站並下載適合您目前所用版本的最新文件集。請遵循 InfoCenter 網頁上提供的指示來完成安裝。