WebSphere Business Integration Adapters バージョン 2.3.1 リリース情報 (AIX 用)

この文書は、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 のセクションを探してください。

このリリースでの新機能

このセクションでは、このリリースで追加された機能および改善された機能について説明します。

WebSphere Business Integration Adapters Framework

WebSphere Business Integration Adapters の API

詳しくは、「コネクター開発ガイド (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 度のみ呼び出され、後続の呼び出しによってデータ・ハンドラーの作成を続行します。

WebSphere Business Integration Adapters インストーラー

CR
番号
問題
11983、12221、13382、17788、20169 「コンポーネント選択」パネルのバージョン 4.2.1.0 での複数の問題は修正されました。 以下のような問題です。
  • 選択するたびにパネルが最新表示される。
  • コンポーネントを縮小したときにパネル内で読めないテキストがある。
  • 親コンポーネントを選択してもすべてのサブコンポーネントが選択されるわけではない。
  • サブコンポーネントを 1 つ選択してもすべてのサブコンポーネントが選択されていた。
20679 InterChange Server が統合ブローカーである場合、WebSphere Business Integration Adapters バージョン 2.3.1 からのアダプターは、 必ず ICS のインストール先ディレクトリーにインストールしてください。

ハードウェア要件およびソフトウェア要件

ハードウェア要件およびソフトウェア要件は、製品資料に記載されています。これらの資料へのリンクについては、『インストール、マイグレーション、アップグレード、および構成に関する情報』を参照してください。

インストール、マイグレーション、アップグレード、および構成に関する情報

ソフトウェアを CD からインストールする場合も、パスポート・アドバンテージからダウンロードしてローカル・ディレクトリーからインストールする場合も、以下の中から該当する資料を参照してください。

これらの資料には、マイグレーション、アップグレード、および構成に関する情報も記載されています。

WebSphere Business Integration Adapters の API

WebSphere Business Integration Adapters の API のバージョン 1.5.0 以降でアダプターを稼働させていることを確認してください。

API のバージョンの確認

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 の最新バージョンをダウンロードするには、次のようにします。

  1. http://www.ibm.com にアクセスします。
  2. 「Support & 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 開発キットおよび 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"
Object Discovery Agent (ODA) を InterChange Server バージョン 4.0.1 および 4.1.x、ADK バージョン 2.0.x および  2.1.x に対して実行する

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 の制限のため、アダプターは 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 セッションに維持してください。

WebSphere Business Integration Adapters インストーラー

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 にあります。

製品資料を入手するには、Web サイトにアクセスし、ご使用のリリースの最新の資料一式をダウンロードしてください。InfoCenter ページに記載されている説明に従って、インストールを完了してください。

Copyright IBM Corp. 1997, 2003