実行グループへのフロー・デバッガーの接続

メッセージ・フローをデバッグする前に、フロー・デバッガーをフローがデプロイされている実行グループに接続して、デバッグ・セッションを開始する必要があります。

始める前に:

単一のワークベンチから、同じまたは異なるホスト・コンピューターで実行する複数の実行グループにフロー・デバッガーを接続して、それらのフロー (したがって複数のメッセージ) を同時にデバッグすることができます。

変更の始まりある実行グループをデバッグできるのは一度に 1 人のユーザーだけです。 したがって、1 人がある実行グループにデバッガーを接続すると、デバッグ・セッションを終了するまで、他のユーザーは同じ実行グループにデバッガーを接続できなくなります。変更の終わり

フロー・デバッガーは、以前のバージョンのランタイム・ブローカーをデバッグできます。前述の「デバッグ」ウィザードの「エンジンの選択」パネルで対応するオプションをチェックして、デバッグするブローカーのバージョンを選択します。

それぞれのブローカー・オペレーティング・システムにどのバージョンの Rational Agent Controller (RAC) をインストールする必要があるかについての詳細は、Rational Agent Controller のインストールを参照してください。

64 ビットの実行グループにデプロイ済みのフローをデバッグすることはできません。フロー・デバッガーでサポートされているのは 32 ビットの実行グループのみです。

デバッガーを実行グループに接続するには、以下のようにします。

  1. 「ブローカー管理」パースペクティブに切り替えます。 「ドメイン」ペインに表示されているメッセージ・フローの名前を記録します。
  2. 「ブローカー管理ナビゲーター」ペインで名前をダブルクリックして、デバッグするメッセージ・フローをメッセージ・フロー・エディターで開きます。
  3. 入力ノードから通じる接続に、ブレークポイントを追加します。これにより、デバッグを始める前に、メッセージ・フローが完了まで実行されるということがなくなります。

    ブレークポイントは使用可能なブレークポイント として表示されます。ブレークポイントの追加について詳しくは、フロー・デバッガー内でのブレークポイントでの作業を参照してください。

  4. 「デバッグ」パースペクティブに切り替えます。
  5. ツールバーの「デバッグ」アイコンデバッグの起動の下矢印をクリックし、「デバッグ」をクリックして、「デバッグ (構成の作成、管理、および実行)」ウィザードを起動します。
    デバッグ起動構成を作成することになります。事前に作成済みの場合は、「デバッグ」アイコンデバッグの起動自体を直接クリックして、再起動できます。 以下のいずれかの条件が真である場合、このアクションによってエラーが生成されます。
    • デバッグ起動構成をまだ作成していない場合
    • 以前に接続したブローカーおよび実行グループが実行中でなくなった場合
    • ブローカーおよび実行グループが再始動されたために、新しいプロセス ID がある場合 (以下を参照)
  6. 構成のリストで、「メッセージ・ブローカー・デバッグ」を選択し、「新規」をクリックします。「接続」で始まる、タブ付きパネルのセットが表示されます。

    「接続」パネルのフィールドが完成するまで、「デバッグ」はクリックできません。それから他のパネルのフィールドを完成させることもできますし、「デバッグ」をクリックしてそのまま進むこともできます。

    ウィザード内のパネルは以下のとおりです。
    • 「接続」: このパネルを使用して、Rational Agent Controller を介した実行グループに対する接続を確立します。 「デバッグ」をクリックしてデバッグ・セッションを開始する前に、このパネルのすべてのフィールドを完成させる必要があります。
      Agent Controller ポート番号
      使用するポート番号を入力します。
      フロー・プロジェクト
      フロー・プロジェクトを選択します。
      HostName
      実行グループが稼働しているホスト・コンピューターを選択します。 ホストがリストされていない場合、「ホスト名」フィールドにホスト・コンピューターのホスト名または IP アドレスを入力します (「ホスト名」フィールドを使用できない場合は、まず「リセット」をクリックしてから、変更を加えます)。
      実行グループ
      デバッグするブローカーおよび実行グループを選択します。 「ブラウズ」ボタンをクリックした際に開くリスト・ボックスでの各実行グループのリストの形式は、プロセス ID の後に、ブローカーの名前と実行グループの名前がコロンで区切られて続きます。例えば、以下のようになります (ここでは「エンジン名」としています)。
      プロセス ID  エンジン名
      ---------    ---------------
      5984         WMBV6BR:default
      実行グループがリスト・ボックスに表示されない場合、「リフレッシュ」をクリックしてリスト・ボックスを更新して、現在ホスト・コンピューターにデプロイされており使用可能なすべての実行グループの名前が表示されるようにします。 実行グループが依然としてリスト・ボックスに表示されない場合は、ホスト・コンピューターで RAC の再始動を試行してください。

      ターゲット・ホストで実行中の実行グループに接続するオプションが提示されます。 実行グループのリストには、デプロイされたフローを持たない実行グループが含まれます。

      プロセス番号は、「タスク マネージャ」の「プロセス」ページにリストされている Windows® PID です。PID は、デプロイ時に「イベント・ログ」で報告されます。パブリッシュ/サブスクライブ・トポロジーのデプロイを参照してください。

      「デバッグ」をクリックして次のステップに進むか、その他のパネルを完成させます。

      JavaCompute ノードまたは Java™ コードを含むユーザー定義ノードをデバッグするには、デバッグ・ポート番号を使用してブローカー JVM を構成します。この値を設定するには、以下のコマンドを (すべてを 1 行で) 発行してください。

      mqsichangeproperties <broker-name> -e <execution-group-name>
       -o ComIbmJVMManager -n jvmDebugPort -v <port-number>
      このコマンドが完了したら、ブローカーを再始動してください。
  7. 「デバッグ」をクリックします。 「デバッグ」ビューに、選択したホスト・コンピューターおよび実行グループの名前が表示されます。
  8. 次のメッセージがフローに入れられて、入力ノードの後に追加したブレークポイントに到達すると、フローは一時停止し、ブレークポイント・アイコンが強調表示され 使用可能な一時停止されているブレークポイント、デバッグを開始できるようになります。
  9. 「デバッグ」ビューで、デバッグするメッセージ・フローをダブルクリックします。メッセージ・フロー・エディターで メッセージ・フロー がオープンします。 これで、ブレークポイントの追加、フローのステップオーバーの開始などを行うことができます。

次に行う事柄:

以下のいずれかのタスクを続行します。

関連概念
フロー・デバッガーの概要
関連タスク
Rational Agent Controller のインストール
デプロイ
メッセージ・フローのデバッグ
デバッグ: セッションの終了
関連資料
フロー・デバッガーのショートカット
フロー・デバッガーのアイコンおよびシンボル
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
最終更新 : 2009-02-20 12:43:47

ag11186_