この文書は、WebSphere Business Integration Adapters バージョン 2.3.1 のリリース情報 (AIX 用) です。リリース情報には、以下のセクションが含まれています。
このリリースでの新機能 | WebSphere Business Integration Adapters の API |
製品修正履歴 | 既知の問題と予備手段 |
ハードウェア要件およびソフトウェア要件 | 資料に関する更新情報 |
インストール、マイグレーション、アップグレード、および構成に関する情報 |
注: このリリース情報の公表後に発行されるテクニカル・サポート・フラッシュで、この製品についての重要な情報が提供される場合があります。WebSphere Business Integration サポート Web サイト http://www.ibm.com/websphere/integration/wbiserver/support をご覧ください。対象となるコンポーネントの領域を選択し、Flashes のセクションを探してください。
このセクションでは、このリリースで追加された機能および改善された機能について説明します。
詳しくは、「コネクター開発ガイド (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 が追加されました。このプロパティーが、例えばコネクターのイベント・ストア・ファクトリー・インスタンスである com.crossworlds.connectors.JDBC.JDBCEventStoreFactoryInstance に設定されている場合は、イベント・ストアの取得に使用されます。そのインスタンスに設定されていない場合、API はパッケージ情報に基づいてイベント・ストア・ファクトリー・インスタンスのクラス名の作成を試みます。また、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 | doVerbFor メソッドの呼び出しから APPRESPONSETIMEOUT が戻されても、doVerbFor が pollForEvents 内部から呼び出された場合、コネクターは終了しません。コネクターを終了させるには、状況を pollforEvents まで伝搬させ、また pollForEvents から APPRESPONSETIMEOUT を戻すようにする必要があります。 |
23406 | EXISTS および RETRIEVEBYCONTENT 動詞定数が、CWConnectorConstants クラスに追加されました。 |
23612 | 属性レベルまたはビジネス・オブジェクト・レベルでのアプリケーション固有情報では、ior_file_name=;poa_name=server などのように値を持たないタグは、「No such element found Exception」というメッセージが出されて失敗します。これは修正されました。 |
23620 | 構成メタオブジェクトの設定とデータ・ハンドラーの作成は、1 つのアトミック (同期化) ステップでは実行されません。そのため、複数のスレッドが WebSphere Business Integration Adapters API に入力されると、データ・ハンドラーの基底クラスに問題が生じていました。setConfigMO を呼び出すコードは同期化されるようになりました。また、このメソッドは 1 度のみ呼び出され、後続の呼び出しによってデータ・ハンドラーの作成を続行します。 |
CR 番号 |
問題 |
11983、12221、13382、17788、20169 | 「コンポーネント選択」パネルのバージョン 4.2.1.0 での複数の問題は修正されました。
以下のような問題です。
|
20679 | InterChange Server が統合ブローカーである場合、WebSphere Business Integration Adapters バージョン 2.3.1 からのアダプターは、 必ず ICS のインストール先ディレクトリーにインストールしてください。 |
ハードウェア要件およびソフトウェア要件は、製品資料に記載されています。これらの資料へのリンクについては、『インストール、マイグレーション、アップグレード、および構成に関する情報』を参照してください。
ソフトウェアを CD からインストールする場合も、パスポート・アドバンテージからダウンロードしてローカル・ディレクトリーからインストールする場合も、以下の中から該当する資料を参照してください。
これらの資料には、マイグレーション、アップグレード、および構成に関する情報も記載されています。
WebSphere Business Integration Adapters の API のバージョン 1.5.0 以降でアダプターを稼働させていることを確認してください。
API のバージョンを確認するには、マニフェスト・ファイル (ProductDir/lib/WBIA.jar) を見つけて適切な Java JAR エディターで開きます。以下の行を探してください。
Implementation-Title: "CWConnectorAPI"
Implementation-Version: 1.5.0
Implementation Version は、現在の 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 の制限のため、アダプターは 100MB 以上の XML メッセージを処理のために MQ キューへ書き込むことができません。この問題は、JMS がトランスポートであり、WMQI または WAS のいずれかが統合ブローカーである場合に発生します。 アダプターのランタイムはビジネス・オブジェクトを XML メッセージに変換しますが、その XML メッセージは非常にサイズが大きくなる場合があります。 予備手段: ビジネス・オブジェクト 1 つにつき、25000 以上の子オブジェクトを作成しないようにしてください。 |
24108 | Connector Development Kit (CDK) バージョン 2.2 でビルドしたコネクターを 2.3.1 CDK ビルドと一緒に稼動させると、ランタイム・エラーが戻されます。
予備手段: 2.2 CDK パッチを用いてコネクターを再コンパイルしてください。 |
23699 |
負荷の多い AIX 5.3 プラットフォーム環境 (アダプターの実行時に トランスポートが JMS、ブローカーが WMQI または WAS で、多数の子ビジネス・オブジェクトがあり、ビジネス・オブジェクトのサイズが 1 MB より大きく、並行消費セッションが 1 より大きい場合) では、コネクター・エージェントを 10 時間から 12 時間連続で実行した後に OutOfMemory エラーが戻される場合があります。 予備手段: 並行セッションを 1 セッションに維持してください。 |
CR 番号 |
問題 |
11600 | Java 仮想マシン (JVM) の初期化時にインストーラーの初回の始動が遅い場合があります。
予備手段: インストーラーを 1 回のみ始動します。複数回始動しないようにしてください。 |
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 | 選択した言語ロケールによっては、「言語選択」パネルのタイトル・テキストが切り捨てられてしまうことがあります。「言語選択」ダイアログは、サイズ変更はできません。 |
製品資料は、CD などで電子的に製品を配布する場合であっても 製品パッケージには含まれていません。 この製品の資料は、以下の InfoCenter にあります。
http://www.ibm.com/websphere/integration/wicserver/infocenter
http://www.ibm.com/websphere/integration/wbiadapters/infocenter
製品資料を入手するには、Web サイトにアクセスし、ご使用のリリースの最新の資料一式をダウンロードしてください。InfoCenter ページに記載されている説明に従って、インストールを完了してください。