WebSphere Business Integration Adapters for HP-UX 2.3.1 版的版本注意事項

這些版本注意事項涵蓋 WebSphere Business Integration Adapters for HP-UX 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 對於屬性或商業物件層次中的 ASI, 沒有值的標籤 (如 ior_file_name=;poa_name=server) 將失敗, 並顯示 "發生異常狀況,找不到如此的元素"。這已經修好了。
23620 並不會以原子性 (或同步處理) 步驟, 來配置 meta 物件及建立資料處理常式。當多個執行緒進入 WebSphere Business Integration Adapters API 時,這將導致與資料處理常式基礎類別有關的問題。 現在會同步處理用來呼叫 setConfigMO 的程式碼。此外,僅呼叫方法一次, 因此後續的呼叫會繼續建立資料處理常式。

軟硬體需求

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

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

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

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

限制

HP-UX 不支援巴西葡萄牙文。因此,HP-UX 上的「安裝程式」不會列出「巴西葡萄牙文」語言環境選項。

WebSphere Business Integration Adapters API

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

驗證 WBIA API 的版本

若要檢查 WBIA 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。

下載 WBIA API

若要下載最新版的 WBIA 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 修補程式來重新編譯連接器。

WebSphere Business Integration Adapters 安裝程式

CR
號碼
問題
當使用 PFS 裝載軟體來裝載 CD 時,CD 文字可能會全大寫字元或全小寫字元出現。 如果發生這種情況,「安裝程式」可能無法執行。 文字應該是大小寫的混合。若要確定適當的文字大小寫, 請從指令行遵循下列步驟:
  1. 啟動下列常駐程式:
    # nohup /usr/sbin/pfs_mountd &
    # nohup /usr/sbin/pfsd 4 &
  2. 在 /etc/pfs_fstab 加入下列一行:
    /dev/dsk/c2t1d0 /cdrom pfs-iso9660 xlat=no_version
  3. 裝載 CD-ROM:
    # pfs_mount /cdrom
  4. 若要卸載 CD-ROM:
    # pfs_umount /cdrom
20679 如果 InterChange Server 是您的整合分配管理系統, 請確定您是在安裝 ICS 的目錄中安裝 WebSphere Business Integration Adapters 2.3.1 版的配接器。
23364 沒有建立原生的 HP-UX 解除安裝程式執行檔 (uninstaller.bin)。然而, 「安裝程式」會在 ProductDir/_uninst_WBIA2.3.1 目錄中產生 uninstall.jar 檔, 其中 ProductDir 是安裝 WebSphere Business Integration Adapters 產品的目錄。

暫行解決方法:執行下列 Java 指令來啟動解除安裝程式: 

java -cp ProductDir/_uninst_WBIA2.3.1/uninstall.jar run
23813

如果您使用 ja_JP.eucJP 或 ja_JP.SJIS 作為語言環境,來安裝 WebSphere Business Integration Adapters 產品, 並且使用日文字元來命名安裝目錄,產品授權檔將無法安裝。

暫行解決方法:使用 UTF-8 編碼的日文語言環境 (如 ja_JP.utf8) 來安裝產品。

24023 在安裝或解除安裝之後,您可能在主控台中看到下列警告:
警告:
名稱:scrollbar
類別:XmScrollbar
捲軸頁面增量小於 1

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

24147

亂碼文字會發生在所有支援的雙位元組語言:   日文、韓文、簡體中文,以及繁體中文。   

暫行解決方法:執行下列指令,在 Swing 模式中執行「安裝程式」:

./setupHP.bin -swing

如需與 HP-UX 平台上的雙位元組語言有關的問題的詳細資訊, 請參閱 HP UNIX SDK 1.3.1 版本注意事項。 

 

協力廠商安裝程式 

CR
號碼
問題
23778 「語言選擇」畫面上的標題文字可能會被截斷,取決於您選擇的語言環境而定。 「語言選擇」對話框無法改變大小。

文件更新

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

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

Copyright IBM Corp. 1997, 2003