WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

ユーザー定義ノードのテスト

必要なリソースを作成してインストールしたら、ユーザー定義ノードをテストできます。

始める前に

以下のタスクを実行します。

このトピックの対象は、Java と C で作成したユーザー定義ノードに限られます。

サブフローから作成したユーザー定義ノードについては、サブフローのユーザー定義ノード・プロジェクトのテストを参照してください。

以下の手順でユーザー定義ノードをテストします。

  1. これらのプロジェクトとリソースをテストするには、以下の手順で 2 番目の WebSphere Message Broker Toolkitを起動する必要があります。
    1. ユーザー定義ノード・プロジェクトを右クリックします。 メニューが開きます。
    2. 「新しいワークベンチで実行」をクリックします。
      • プロジェクトにエラーが含まれている場合は、エラー・メッセージが表示されます (操作を続行するオプションとキャンセルするオプションがあります)。
      • プロジェクトがエラー・フリーであれば、「ワークスペース・ランチャー」ウィンドウが開きます。
        1. 新しいワークスペースを使用するか、既存のワークスペースを使用するかを選択できます。 既存のワークスペースを選択する場合は、「参照」をクリックします。 2 番目のワークスペースが開きます。
        2. 最初のワークベンチで、すべてのエラー・フリーのユーザー定義ノード・プロジェクトのユーザー定義ノードを使用してテストを実行できます。
  2. WebSphere Message Broker Toolkit の 2 番目のインスタンスでメッセージ・フロー・エディターを開きます。 ノード・パレットに新しいノードが表示されます。
  3. ノードを含むメッセージ・フローを作成します。 メッセージ・フロー・ノードの追加を参照してください。
  4. メッセージ・フローをブローカーにデプロイします。 リソースのデプロイを参照してください。
  5. フローを通過するようにテスト・メッセージを送信し、予想通りの結果になることを確認します (例えば、メッセージがターゲット・キューに入れられる)。 テスト・メッセージをメッセージ・フローに送信するアプリケーションを作成する必要があるかもしれません。
  6. 用意されている診断ツールを使用して、ノードが動作しているかどうかを確認し、動作していない場合はその原因を判別します。
    1. いくつかの一般的な問題とその解決方法の説明を確認します。 ユーザー定義拡張機能の問題の解決を参照してください。
    2. 管理ログ を確認します。 「管理ログ」ビューを参照してください。
    3. ノードから管理ログにエントリーを書き込みます。 ユーザー定義拡張機能からのエラー・ログの使用を参照してください。
    4. デバッグ・レベルでユーザー・トレースを開始します。 トレースの使用を参照してください。

      ユーザー・トレースから生成された以下のデバッグ・メッセージは、ユーザー定義ノードおよびパーサーの実行を理解するのに役立ちます。

      • BIP2233BIP2234: ユーザー定義拡張機能の実装関数を開始する前と後にトレースされるメッセージのペア。 これらのメッセージは、入力パラメーターと戻り値を報告します。

        これらのメッセージでは、「インプリメンテーション関数」は C インプリメンテーション関数または Java インプリメンテーション・メソッドのいずれかとして解釈できます。

      • BIP3904: ユーザー定義ノードの Java evaluate() メソッドを開始する前にトレースされるメッセージ。
      • BIP3905: ユーザー定義ノードの C cniEvaluate() 実装関数 (CNI_VFT の iFpEvaluate メンバー) を開始する前にトレースされるメッセージ。
      • BIP4142: ユーザー定義ノードのユーティリティー関数を開始したときにトレースされるデバッグ・メッセージ (ユーティリティー関数は、構文エレメントの状態を変更します)。 cniSetElement* (* はその語幹を持つすべてのノード) で始まるすべてのユーティリティー関数が含まれます。
      • BIP4144BIP4145: 特定の実装関数でトレースされるメッセージのペア (ユーザー定義拡張機能がそれらの実装関数を開始すると、ブローカーのオブジェクトの内部状態が変更されることがあります)。 可能なブローカー・オブジェクトとして、構文エレメント、ノード、およびパーサーがあります。

        これらのメッセージでは、「インプリメンテーション関数」は C インプリメンテーション関数または Java インプリメンテーション・メソッドのいずれかとして解釈できます。

      • BIP4146: ユーザー定義パーサーのユーティリティー関数を開始したときにトレースされるデバッグ・メッセージ (ユーティリティー関数は、構文エレメントの状態を変更します)。 cpiSetElement (* はその語幹を持つすべてのノード) で始まるすべてのユーティリティー関数が含まれます。
      • BIP4147: ユーザー定義拡張機能がユーザー定義拡張機能のユーティリティー API 関数に無効な入力オブジェクトを渡したときにトレースされるエラー・メッセージ。
      • BIP4148: ユーザー定義拡張機能がブローカーのオブジェクトに損傷を与えたときにトレースされるエラー・メッセージ。
      • BIP4149: ユーザー定義拡張機能がユーザー定義拡張機能のユーティリティー API 関数に無効な入力データ・ポインターを渡したときにトレースされるエラー・メッセージ。
      • BIP4150: ユーザー定義拡張機能がユーザー定義拡張機能のユーティリティー API 関数に無効な入力データを渡したときにトレースされるエラー・メッセージ。
      • BIP4151: cniGetAttribute2 または cniGetAttributeName2 で戻りコードが予期しない値に設定されたときにトレースされるデバッグ・メッセージ。 予想される値は、CCI_SUCCESS、CCI_ATTRIBUTE_UNKNOWN、 および CCI_BUFFER_TOO_SMALL です。 それ以外の値はすべて、予期しない値です。
      • BIP4152: 以下の状況でトレースされるデバッグ・メッセージ。
        1. cniGetAttribute2 または cniGetAttributeName2 で 戻りコードが CCI_BUFFER_TOO_SMALL に設定されている場合。
        2. cniGetAttribute2 または cniGetAttributeName2 を、 サイズ・バッファーを訂正して再度呼び出す際に、戻りコードが CCI_BUFFER_TOO_SMALL に設定されている場合。
    5. メッセージ・フローに Trace ノードを追加し、生成される出力をチェックします。
    6. フロー・デバッガーを使用して、ノードを含むフローをデバッグします。 メッセージ・フローのテストとデバッグを参照してください。

ノードの動作が完全で正確であれば、メッセージ・フロー・エディターの通常のノード・パレットにその新しいノードを追加します。 ユーザー定義ノード・プロジェクトのパッケージ化および配布を参照してください。 このタスクが完了するまでは、ローカル・システムのテスト WebSphere Message Broker Toolkit セッションでのみ、その新しいノードを使用できます。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:48:01


タスク・トピックタスク・トピック | バージョン 8.0.0.5 | as04505_