Solaris 用 WebSphere Business Integration Adapters バージョン 2.3.1 リリース情報

この文書は、Solaris 用 WebSphere Business Integration Adapters バージョン 2.3.1 のリリース情報です。この文書は以下のセクションから構成されます。
このリリースでの新機能 WebSphere Business Integration Adapters API
製品修正履歴 既知の問題と予備手段
ハードウェア要件およびソフトウェア要件 資料に関する更新情報
インストール、マイグレーション、アップグレード、および構成に関する情報

注: このリリース情報の公表後に発行されるテクニカル・サポート・フラッシュで、この製品についての重要な情報が提供される場合があります。WebSphere Business Integration サポート Web サイト http://www.ibm.com/websphere/integration/wbiserver/support をご覧ください。関心のあるコンポーネントの領域を選択し、フラッシュのセクションを探してください。

このリリースでの新機能

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

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
「コンポーネント選択 (Component Selection)」パネルのバージョン 4.2.1.0 での複数の問題は修正されました。 以下のような問題です。
  • 選択するたびにパネルが最新表示される。
  • コンポーネントを縮小したときにパネル内で読めないテキストがある。
  • 親コンポーネントを選択してもすべてのサブコンポーネントが選択されるわけではない。
  • サブコンポーネントを 1 つ選択してもすべてのサブコンポーネントが選択されていた。
21679 サイレント・インストール・ツールを使用してアダプターをインストールした場合、アダプターが正常に始動しません。

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

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

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

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

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

WebSphere Business Integration Adapters API

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

WBIA API のバージョンの確認

WBIA API のバージョンを確認するには、マニフェスト・ファイル (ProductDir/lib/WBIA.jar) を見つけて適切な Java JAR エディターで開きます。以下の行を探してください。

Implementation-Title: "CWConnectorAPI"
Implementation-Version: 1.5.0

Implementation Version は、現在の WBIA API のバージョンを示します。 バージョンが 1.5.0 以降でない場合、最新の WBIA API をダウンロードする必要があります。

WBIA API のダウンロード

WBIA 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

アダプターは、100 MB を超える XML メッセージ・テキストを処理のため MQ キューに書き込むことができません。この問題は MQ の制限によるものです。この問題は JMS がトランスポートであり、ブローカーが WMQI または WAS である場合に発生します。アダプターのランタイムは、ビジネス・オブジェクトをメッセージ・サイズが大きすぎて WMQIまたは WAS ブローカーで処理できない XML メッセージに変換します。

予備手段: 1 つのビジネス・オブジェクトにつき 25000 を超える子オブジェクトを作成しないようにします。 または、MQ キューに書き込まれる XML メッセージのサイズを小さくします。

24108 Connector Development Kit (CDK) バージョン 2.2 でビルドしたコネクターを 2.3.1 CDK ビルドと一緒に稼動させると、ランタイム・エラーが戻されます。 予備手段: 解決策として、2.2 CDK パッチを適用してコネクターを再コンパイルします。

WebSphere Business Integration Adapters インストーラー

CR
番号
問題
20679 InterChange Server が統合ブローカーである場合、WebSphere Business Integration Adapters バージョン 2.3.1 からのアダプターは、 必ず ICS のインストール先ディレクトリーにインストールしてください。
24023 インストールまたはアンインストールの後に、以下の警告がコンソールに表示される場合があります。
警告:
名前: scrollbar
クラス: XmScrollbar
スクロール・バー・ページの増分が 1 未満です。

この警告によってインストールまたはアンインストールが失敗することはありません。

24067 「言語選択 (Language Selection) 」パネルで、ドロップダウン言語リストが一部しかブラジル・ポルトガル語に翻訳されていません。 この問題は、インストーラーが使用する Java 仮想マシン (JVM) のバージョンによって発生します。 

予備手段: IBM ではこの予備手段を推奨しませんが、以下のコマンドを実行して、インストーラーがマシンにインストール済みの JRE を使用するように強制する方法があります。

java -cp setup.jar run -swing

24147

サポートされるすべての 2 バイト言語 (日本語、韓国語、中国語 (簡体字)、中国語 (繁体字)) でテキストの破損が発生します。  

予備手段: 以下のコマンドを実行して、インストーラーをスイング・モードで実行します。

./setupsolarisSparc.bin -swing

サード・パーティーのインストーラー

CR
番号
問題
16868 Java コマンド ./setupsolarisSparc.bin -Dtemp.dir=/home/user1/tmp を使用してインストーラーを実行した場合、tmp ディレクトリーがクリーンアップされません。これによって tmp フォルダーのサイズが大きくなります。

予備手段: 不要なファイルを tmp ディレクトリーから手動で削除してください。

23778 選択した言語ロケールによっては、「言語選択 (Language Selection)」パネルのタイトル・テキストが切り捨てられてしまうことがあります。「言語選択 (Language Selection)」ダイアログは、サイズ変更はできません。

資料に関する更新情報

製品資料は、CD などで電子的に製品を配布する場合であっても 製品パッケージには含まれていません。 この製品の資料は、以下の InfoCenter にあります。

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

Copyright IBM Corp. 1997, 2003