WebSphere Business Integration Adapter Framework バージョン 2.4.0 (AIX 用)

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

注: これらのリリース情報の発行後に、この製品に関する重要な情報が Technical Support Flashes に掲載される場合があります。この情報は WebSphere Business Integration のサポート Web サイト、http://www.ibm.com/websphere/integration/wbiserver/support にあります。情報を参照したいコンポーネント・エリアを選択して、Flashes のセクションを検索してください。

本リリースの新機能

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

製品修正履歴

リリース 2.3.1 から 2.4.0 までの間に、ユーザーから報告された事例に基づいて以下の変更要求 (CR) が修正されています。

WebSphere Business Integration Adapters ランタイム

トラッキング
番号
説明
23373 Connector Development Kit (CDK) バージョン 2.1 でビルドしたコネクターを 2.3.1 CDK ビルドと一緒に稼働させると、ランタイム・エラーが戻されていました。
23374 Connector Development Kit (CDK) バージョン 2.0 でビルドしたコネクターを 2.3.1 CDK ビルドと一緒に稼働させると、ランタイム・エラーが戻されていました。
23694 新規のメソッド setEventStatus が CWConnectorEventStore クラスに追加されました。 これは、既存の setEventStoreStatus メソッドの呼び出しに代わるものです。 setEventStoreStatus は使用しないでください。

新規のシグニチャーが CWConnectorEventStore クラスの getBO メソッドに追加されました。これは状況パラメーターを取るもので、このパラメーターに getBO メソッドでの doVerbFor 呼び出しの状況が格納されて戻されます。CWConnectorAgent では、pollForEvents メソッドがさらにモジュール化されました。イベント・ストアを取得するメソッド getEventStore が新たに追加されています。getBO メソッドの呼び出しはアダプターでオーバーライドできます。1.6.0 で修正しました。

24108 Connector Development Kit (CDK) バージョン 2.2 でビルドしたコネクターを 2.3.1 CDK ビルドと一緒に稼働させると、ランタイム・エラーが戻されていました。
24230 CWConnectorBusObj クラスの getdoubleValue(int i) または getdoubleValue(String str) を使用して属性の double 値を取得する場合、その値が実際に 100,23 などの double 値であれば、これらのメソッドの呼び出しは成功します。属性の値が 100,00、つまり 100 であれば、エラー「java.lang.ClassCastException: java.lang.Long」が戻されます。1.4.3 で修正しました。
24699 以前は API のデータ・ハンドラー・メソッドでクラス名やビジネス・オブジェクト・プレフィックス (BOPrefix) を受け渡せませんでした。現在では、API の CWConnectorUtil クラスにメソッドが新たに追加され、Reader、Stream、および ByteArrays を処理できるようになっています。1.6.0 で修正しました。
25364 Adapter Framework で IBM ORB が使用されるようになりました。この変更に対応できるように、CWConnEnv.bat、CWODAEnv.bat、CWODAEnv.sh、および CWConnEnv.sh が変更されました。一方、新規のディレクトリー構造 %INSTALL_DIR%\jre\ext が導入されたので、これらのスクリプトではこの変更に対応するための変更も行われています。1.6.0 で修正しました。
27592 CWConnEnv.sh スクリプトの JAVA_PROPERTY_FLAGS に、OSADDR と OAHOST が含まれていませんでした。このため、コネクターは、InterChange Server とは異なるサブネットで稼働している場合、InterChange Server に接続できませんでした。これらはすでに JAVA_PROPERTY_FLAGS に追加されています。1.6.0 で修正しました。
27718 Adapter for JDBC では、API の printStackTrace が呼び出されたときに、パフォーマンスの低下が発生していました。現在、このアダプターでは、トレース・レベルが 5 に設定されている場合に限り、例外がキャッチされたときに printStackTrace メソッドが呼び出されます。1.5.1 で修正しました。
29263 CWConnectorBusObj のメソッドに関しては、各種エラー・メッセージがログに記録されていました。また、この結果、電子メール・メッセージがユーザーに送信されていました。該当のエラー・メッセージは、現在では一部が除去されています。1.6.0 で修正しました。
30086 CWConnectorBusObj クラスの getintValue メソッドと setintValue メソッドがローカライズされていませんでした。1.6.0 で修正しました。

WebSphere Business Integration Adapters インストーラー

トラッキング
番号
説明
15011、17268 サード・パーティーのインストール製品を使用すると、十分なスペースが使用可能でない場合にインストールが停止されませんでした。この問題は修正されました。
11600 Java 仮想マシン (JVM) の初期化時にインストーラーの初回の始動が遅くなりました。
24023 インストールまたはアンインストール後、コンソールに次の警告が表示されました。
警告:
名前: scrollbar
クラス: XmScrollbar
スクロール・バー・ページの増分が 1 未満です。

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


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

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

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

ソフトウェアを CD からインストールするか、またはパスポート・アドバンテージからダウンロードしてローカル・ディレクトリーからインストールするかにかかわらず、以下の該当するガイドを参照してください。

これらのガイドには、汎用マイグレーション、アップグレード、および構成情報も含まれています。

マイグレーションに関する注意事項

以前のリリースの Adapter Framework で使用していたユーザー作成のアダプターを、今回のリリースの Adapter Framework と共に正常に機能させるには、コネクターと ODA の両方の始動スクリプトを変更する必要があります。CWJAVA と JRE_EXT_DIRS の 2 つの新しい環境変数が、それぞれ Java コマンドの位置の指定と Java ランタイム環境の指定のために導入されたからです。

コネクター用の新しい JVM コマンド行は次のとおりです (変更された箇所は太字で強調表示しています)。

exec ${CWJAVA} ${JVM_FLAGS} -Djava.library.path=${LD_LIBRARY_PATH} -Djava.ext.dirs=${JRE_EXT_DIRS} -classpath ${CLASSPATH} AppEndWrapper ${CONNECTOR_TYPE}${CONNECTOR_AGENT} -n${CONNAME}Connector -s${SERVER} ${CON_START_OPTIONS} $3 $4 $5 $6 $7 $8 $9

ODA 用の新しい JVM コマンド行は次のとおりです (変更された箇所は太字で強調表示しています)。

${CWJAVA} ${JVM_FLAGS} ${ORB_DEP} -Djava.ext.dirs=${JRE_EXT_DIRS} -classpath ${CWCLASSES} com.crossworlds.ODKInfrastructure.${CONNECTION} -l${AGENTNAME} -c${AGENTCLASS}

Adapter for CORBA のインストールに関する注意事項

Adapter for CORBA をインストールする際には、必ずこのアダプターのリリース情報を一読して、前提ソフトウェアに関する追加情報を確認してください。

既知の問題と予備手段

このリリースでは、以下の問題が検出されています。

WebSphere Business Integration Adapters ランタイム

トラッキング
番号
問題
23482

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

予備手段: ビジネス・オブジェクト 1 つあたり、25000 を超える子オブジェクトの作成を避けます。

23699

負荷の多い AIX 5.3 プラットフォーム環境 (アダプターの実行時にトランスポートが JMS、ブローカーが WMQI または WAS で、多数の子ビジネス・オブジェクトがあり、ビジネス・オブジェクトのサイズが 1 MB より大きく、並行消費セッションが 1 より大きい場合) では、コネクター・エージェントを 10 時間から 12 時間連続で実行した後に OutOfMemory エラーが戻される場合があります。

予備手段: 並行セッションを 1 セッションに維持してください。

29249 ビジネス・オブジェクト属性がゼロに設定されていると、パーサー・エラーが発生する場合があります。戻されるエラーは、「org.xml.sax.SAXParseException: 無効な XML 文字 (Unicode: 0x0) がエレメントで見つかりました (org.xml.sax.SAXParseException: An invalid XML character (Unicode: 0x0) was found in the element)」です。

予備手段: 16 進 00 をビジネス・オブジェクト属性の値として割り当てないでください。ビジネス・オブジェクトのフィールドを初期化するときは、空ストリングまたはブランクにします。

29420、30721 アダプターのスクリプトを変更することで、アダプターのパフォーマンスを改善できる場合があります。JVM の引き数には、-mx オプション (最大ヒープ・サイズ) も含まれています。ここに -ms オプション (最小ヒープ・サイズ) を追加して、その値を最大ヒープ・サイズの半分に設定すると、パフォーマンスが改善されます。そのためには /bin ディレクトリーにある adapterEnv.sh ファイルを編集します。「JVM_ARGS=」が含まれる行を探し出して、-ms オプションを追加してください。例えば、「JVM_ARGS="-Xmx512m -Xms256m"」のように指定します。
31023 すでに WebSphere Business Integration Adapters リリース 2.3 がインストールされている場合、WebSphere Business Integration Adapter Framework 2.4 をインストールすると、アダプターまたは ODA を実行したときに Java コア・ダンプ・エラーが発生することがあります。

予備手段: 必要なアダプターを一時的な場所に保管してから、WebSphere Business Integration Adapters リリース 2.3 をアンインストールします。その後で Adapter Framework 2.4 をインストールし、必要なアダプターをコピーします。

WebSphere Business Integration Adapters インストーラー

トラッキング
番号
問題
23778 選択した言語ロケールによっては、「言語の選択 (Language Selection)」パネルのタイトル・テキストが切り捨てられる場合があります。「言語の選択 (Language Selection)」ダイアログは、サイズ変更できません。
29755

ディレクトリー名に 2 バイト文字が含まれている場所をインストール先として選択すると、インストールが失敗します。

予備手段: 2 バイト文字が含まれていないパスにインストールします。

31633 インストーラー・プログラムは connector_manager_adapter スクリプトを生成します。このスクリプトは、Adapter Framework バージョン 2.4.0 で導入された adapterEnv.sh を参照します。以前のバージョンの Adapter Framework が実行されている場合には、adapterEnv を使用できません。今回リリースされたバージョンのアダプターを 2.4.0 よりも前のバージョンの Adapter Framework と共に稼働させる場合は、connector_manager_adapter スクリプトに含まれる参照ファイル名 adapterEnv.sh を、CWSharedEnv.sh に変更する必要があります。

資料の更新

CD の場合も電子的配布による場合も、製品資料は製品パッケージの一部として組み込まれていません。この製品の資料は以下の InfoCenter にあります。

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

Copyright IBM Corp. 1997, 2003