この文書は、WebSphere Business Integration Adapters for HP-UX バージョン 2.3.1 のリリース情報です。この文書は以下のセクションから構成されます。
このリリースでの新機能 | 制限事項 |
製品修正履歴 | WebSphere Business Integration Adapters API |
ハードウェア要件およびソフトウェア要件 | 既知の問題と予備手段 |
インストール、マイグレーション、アップグレード、および構成に関する情報 | 資料に関する更新情報 |
注: このリリース情報の公表後に発行されるテクニカル・サポート・フラッシュで、この製品についての重要な情報が提供される場合があります。WebSphere Business Integration サポート Web サイト http://www.ibm.com/websphere/integration/wbiserver/support をご覧ください。対象となるコンポーネントの領域を選択し、Flashes のセクションを探してください。
このセクションでは、このリリースで追加された機能および改善された機能について説明します。
詳しくは、「コネクター開発ガイド (Java 用)」を参照してください。
このリリースでは、ユーザーから報告された事例に基づいて、以下の変更要求 (CR) が修正されています。
WebSphere Business Integration Adapters API
CR 番号 |
問題 |
12271 | カスタム・ビジネス・オブジェクト・ハンドラーのサポート。新しいインターフェースとして、メソッド doVerbForCustom を持つ CWCustomBOHandlerInterface が追加されました。カスタム・ビジネス・オブジェクト・ハンドラーを使用するアダプターは、このインターフェースをインプリメントする必要があります。また、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 | 属性レベルまたはビジネス・オブジェクト・レベルの ASI の場合、ior_file_name=;poa_name=server などのように値を持たないタグは、「このエレメントでは例外が見つかりませんでした。(No such element found Exception)」というメッセージが出されて失敗します。この問題は修正されました。 |
23620 | 構成メタオブジェクトの設定およびデータ・ハンドラーの作成は、1 つのアトミック (同期化) ステップで実行されません。 このため、複数のスレッドを WebSphere Business Integration Adapters API に入力すると、データ・ハンドラーの基底クラスに問題が発生していました。setConfigMO を呼び出すコードが同期化されるようになりました。さらに、このメソッドは 1 度のみ呼び出され、以降の呼び出しによって引き続きデータ・ハンドラーが作成されます。 |
ハードウェア要件およびソフトウェア要件は、製品資料に記載されています。これらの資料へのリンクについては、『インストール、マイグレーション、アップグレード、および構成に関する情報』を参照してください。
ソフトウェアを CD からインストールする場合も、パスポート・アドバンテージからダウンロードしてローカル・ディレクトリーからインストールする場合も、以下の中から該当する資料を参照してください。
これらの資料には、インストール、マイグレーション、アップグレード、および構成に関する情報も含まれています。
HP-UX はブラジル・ポルトガル語をサポートしません。そのため、HP-UX ではインストーラーはブラジル・ポルトガル語のロケール・オプションをリストしません。
WebSphere Business Integration Adapters (WBIA) API のバージョン 1.5.0 以降でアダプターを稼働させていることを確認してください。
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 の最新バージョンをダウンロードするには、次のようにします。
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
アダプターが ADK または InterChange Server のさまざまなバージョンと連動できるようにするには、該当する以下の手順に従います。
CWConnEnv.sh 内で CWVERSION 変数を 4.X に設定します。 set CWVERSION="4.X"
CWConnEnv.sh 内で CWVERSION 変数を 4.1.X に設定します。
set CWVERSION="4.1.X"
bin/CWODAEnv.sh 内で CWVERSION 変数を 4.1.X に設定します。
set CWVERSION="4.1.X"
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 の制限のため、アダプターで 100 MB を超える XML メッセージ・テキストを MQ キューに書き込み、処理することができません。この問題は、JMS がトランスポートであり、WMQI または WAS のいずれかが統合ブローカーである場合に発生します。 アダプター・ランタイムでは、ビジネス・オブジェクトが XML メッセージに変換されますが、XML メッセージが非常に大容量になる場合もあります。 予備手段: ビジネス・オブジェクト 1 つあたり、25000 を超える子オブジェクトの作成を避けます。 |
24108 | Connector Development Kit (CDK) バージョン 2.2 でビルドしたコネクターを 2.3.1 CDK ビルドと一緒に稼動させると、ランタイム・エラーが戻されます。
予備手段: 2.2 CDK パッチを使用してコネクターを再コンパイルします。 |
CR 番号 |
問題 |
PFS マウント・ソフトウェアを使用して CD をマウントすると、CD テキストがすべて大文字またはすべて小文字で表示される場合があります。この状況が発生した場合、インストーラーが実行されないことがあります。テキストは、大文字小文字の両方を使用して表示される必要があります。テキストに大文字小文字が正しく混在していることを確認するには、コマンド行から以下のステップを実行してください。
|
|
20679 | InterChange Server を統合ブローカーとして使用している場合は、WebSphere Business Integration Adapters バージョン 2.3.1 からのアダプターは、必ず ICS がインストールされているディレクトリーにインストールしてください。 |
23364 | ネイティブの HP-UX アンインストーラー実行可能ファイル (uninstaller.bin) は作成されていません。ただし、
インストーラーによって、ProductDir/_uninst_WBIA2.3.1 ディレクトリーに uninstall.jar ファイルが作成されます。この場合の ProductDir は、WebSphere Business Integration Adapters 製品をインストールしたディレクトリーです。
予備手段: 次の Java コマンドを実行して、アンインストーラーを起動します。 java -cp ProductDir/_uninst_WBIA2.3.1/uninstall.jar run |
23813 |
ja_JP.eucJP または ja_JP.SJIS のいずれかをロケールとして使用して WebSphere Business Integration Adapters 製品をインストールし、かつ、日本語の文字をインストール・ディレクトリーの名前に使用した場合に、製品ライセンス・ファイルをインストールできません。 予備手段: ja_JP.utf8 などの UTF-8 エンコードされた日本語ロケールを使用して、製品をインストールします。 |
24023 | インストールまたはアンインストール後、コンソールに次の警告が表示される場合があります。 警告: 名前: scrollbar クラス: XmScrollbar スクロール・バー・ページの増分が 1 未満です。 この警告によってインストールまたはアンインストールが失敗することはありません。 |
24147 |
テキストの破損が、日本語、韓国語、中国語 (簡体字)、および中国語 (繁体字) といったサポートされるすべての 2 バイト言語で発生します。 予備手段: 次のコマンドを実行することにより、インストーラーをスイング・モードで実行します。 ./setupHP.bin -swing HP-UX プラットフォームにおける 2 バイト 言語の問題について詳しくは、「HP UNIX SDK 1.3.1 Release Note」を参照してください。 |
CR 番号 |
問題 |
23778 | 選択した言語ロケールによっては、「言語の選択 (Language Selection)」パネルのタイトル・テキストが切り捨てられる場合があります。「言語の選択 (Language Selection) ダイアログは、サイズ変更できません。 |
製品の資料は、CD などで電子的に製品を配布する場合であっても 製品パッケージには含まれていません。 この製品の資料は、以下の InfoCenter にあります。
http://www.ibm.com/websphere/integration/wicserver/infocenter
http://www.ibm.com/websphere/integration/wbiadapters/infocenter
製品資料を入手するには、Web サイトにアクセスし、ご使用のリリースの最新の資料一式をダウンロードしてください。InfoCenter ページに記載されている説明に従って、インストールを完了してください。