WebSphere Business Integration Adapters for HP-UX バージョン 2.3.1 リリース情報

この文書は、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 のセクションを探してください。

このリリースでの新機能

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

WebSphere Business Integration Adapters Framework

WebSphere Business Integration Adapters API

詳しくは、「コネクター開発ガイド (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 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

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 パッチを使用してコネクターを再コンパイルします。

WebSphere Business Integration Adapters インストーラー

CR
番号
問題
PFS マウント・ソフトウェアを使用して CD をマウントすると、CD テキストがすべて大文字またはすべて小文字で表示される場合があります。この状況が発生した場合、インストーラーが実行されないことがあります。テキストは、大文字小文字の両方を使用して表示される必要があります。テキストに大文字小文字が正しく混在していることを確認するには、コマンド行から以下のステップを実行してください。
  1. 次のデーモンを開始します。
    # nohup /usr/sbin/pfs_mountd &
    # nohup /usr/sbin/pfsd 4 &
  2. 次の行を /etc/pfs_fstab に追加します。
    /dev/dsk/c2t1d0 /cdrom pfs-iso9660 xlat=no_version
  3. CD-ROM をマウントします。
    # pfs_mount /cdrom
  4. CD-ROM をアンマウントします。
    # pfs_umount /cdrom
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 にあります。

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

Copyright IBM Corp. 1997, 2003