この文書は、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) が修正されています。
トラッキング 番号 |
説明 |
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 で修正しました。 |
トラッキング 番号 |
説明 |
19283 | WebSphere Business Integration Adapters のツールを、名前にスペースを含むディレクトリーにインストールしないでください (例えば C:\Program Files など)。名前にスペースを含むディレクトリーにツールをインストールすると、System Manager で動作しなくなってしまいます。この問題は修正されました。 |
22302 | デザイナー・ツールのいずれかを起動すると「クラスが見つかりません (class not found)」というエラーが戻される場合、System Manager を起動してからそのツールを再度起動する必要があります。そのツールが最初に起動された後は、System Manager を稼動させておく必要はありません。この問題は修正されました。 |
トラッキング 番号 |
説明 |
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 をインストールする際には、必ずこのアダプターのリリース情報を一読して、前提ソフトウェアに関する追加情報を確認してください。
このリリースでは、以下の問題が検出されています。
トラッキング 番号 |
問題 |
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%"」のように指定します。 |
トラッキング 番号 |
ツール | 説明 |
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 でオーバーライドできます。 |
トラッキング 番号 |
説明 |
23778 | 選択した言語ロケールによっては、「言語の選択 (Language Selection)」パネルのタイトル・テキストが切り捨てられる場合があります。「言語の選択 (Language Selection)」ダイアログは、サイズ変更できません。 |
CD の場合も電子的配布による場合も、製品資料は製品パッケージの一部として組み込まれていません。この製品の資料は以下の InfoCenter にあります。
http://www.ibm.com/websphere/integration/wicserver/infocenter
http://www.ibm.com/websphere/integration/wbicollaborations/infocenter (コラボレーションの場合)
http://www.ibm.com/websphere/integration/wbiadapters/infocenter
製品資料を入手するには、Web サイトにアクセスし、ご使用のリリースの最新の資料一式をダウンロードしてください。InfoCenter ページに記載されている説明に従って、インストールを完了してください。