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

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

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

本リリースの新機能

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

製品修正履歴

リリース 2.3.1 から 2.4 までの間に、ユーザーから報告された事例に基づいて以下の変更要求 (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 Adapter ツール

トラッキング
番号
説明
19283 WebSphere Business Integration Adapters のツールを、名前にスペースを含むディレクトリーにインストールしないでください (例えば C:\Program Files など)。名前にスペースを含むディレクトリーにツールをインストールすると、System Manager で動作しなくなってしまいます。この問題は修正されました。
22302 デザイナー・ツールのいずれかを起動すると「クラスが見つかりません (class not found)」というエラーが戻される場合、System Manager を起動してからそのツールを再度起動する必要があります。そのツールが最初に起動された後は、System Manager を稼動させておく必要はありません。この問題は修正されました。

WebSphere Business Integration Adapters インストーラー

トラッキング
番号
説明
23604 System Manager 始動スクリプトに余分な円記号 (\) が含まれていました。そのため、System Manager ではツールのプラグイン・ファイルの一部をロードできませんでした。
24013 中国語 (簡体字) ロケールを使用している場合、「宛先パネル (Destination Panel)」入力フィールドで中国語の文字を入力することができませんでした。 

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

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

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

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

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

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

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

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

%CWJAVA% -mx128m -Djava.ext.dirs="%MQ_LIB%";%JRE_EXT_DIRS% -Djava.library.path="%CROSSWORLDS%"\bin;%CONNDIR%;"%MQ_LIB%";%JRE_EXT_DIRS% %ORB_PROPERTY% -Duser.home="%CROSSWORLDS%" -cp %JCLASSES%;%CONNDIR%\CW%CONNAME%.jar; AppEndWrapper -l%CONNPACKAGENAME% -n%CONNAME%Connector -s%SERVER% %3 %4 %5

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

%CWJAVA% -Duser.home="%CROSSWORLDS%" -Djava.library.path=%JLIBRARIES% -Djava.ext.dirs="%JRE_EXT_DIRS%" -mx128m %ORB_DEP% -classpath %JCLASSES% 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 を超える子オブジェクトの作成を避けます。

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 ディレクトリーにある start_adapter.bat ファイルを編集します。「set JVMArgs」が含まれる行を探し出して、-ms オプションを追加してください。例えば、「JVMArgs="-mx128m -ms64m %JVMArgs%"」のように指定します。

 WebSphere Business Integration Adapter ツール

トラッキング
番号
ツール 説明
29024 Business Object Designer ODA Business Object Designer ODA ウィザードを使用して、MetaSolv Applications 用、JD Edwards OneWorld 用、CORBA 用、COM 用、Enterprise JavaBeans 用、または Ariba Buyer 用のアダプターの ODA のメッセージ・ファイルを構成すると、問題が発生することがあります。

予備手段: メッセージ・ファイルのデフォルトの場所の名前の先頭に、プレフィックス「BIA_」を挿入します。

31620 Connector Configurator WebSphere Message Brokers を使用している場合、ビジネス・オブジェクトのメッセージ・セット ID が一意になっていなければ、検証時に次のメッセージが表示されます (メッセージ内の「xxx」には ID が挿入されます)。
サポートされているビジネス・オブジェクト: ビジネス・オブジェクト・メッセージ ID 'xxx' が重複しています。

予備手段: WebSphere Business Integration Broker 5.0 を使用している場合は、このメッセージを無視してかまいません。WebSphere MQ Integrator Broker 2.1 を使用している場合は、問題の ID を更新して一意にしてください。

31824 Connector Configurator Connector Configurator を WebSphere Message Brokers と共に使用している場合、「サポートされているビジネス・オブジェクト」パネルで「メッセージ・セット ID」がヌルになっていると、ビジネス・オブジェクトを構成ファイルに保管できません。

予備手段: 「メッセージ・セット ID」にはヌル以外の値を指定してください。実際のメッセージ・セット ID は、配置の際に System Manager でオーバーライドできます。

WebSphere Business Integration Adapters インストーラー

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

資料

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

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

Copyright IBM Corp. 1997, 2003