接続起動構成の使用

コンパイル型言語アプリケーションに接続されるデバッグ起動構成を作成するには、 このトピック内のステップを実行します。
このタスクについて
  1. デバッガーのメインメニューから、「ファイル」>「新規起動」>「プロセスへの接続」を 選択します。
  2. 「名前」フィールドに、 作成する構成の名前を入力します。
  3. 「メイン」タブを選択して、 それを前景に移します。
  4. デバッグしたいプログラムのプロセス ID が分かっている場合、 それを「プロセス ID」フィールドに入力します。あるいは、 「ブラウズ」ボタンを選択して「プロセス の選択」ダイアログ・ボックスを起動し、そこから、デバッグしたいプログラムとそのシステム・プロセス ID を 選択することができます。デバッグしたいプログラムがプロセス・リスト中に見つからない場合、 リストをスクロールするか、「リフレッシュ」を クリックして、最近開始されたプログラムでリストを更新します。接続先のプログラムを 選択したら、「OK」をクリックします。
    注:
    • 接続先のプロセスの名前がユニークである場合、 プロセス ID の代わりに名前を指定することができます。
    • リモートでデバッグしているときには、「ブラウズ」アクション を使用することはできません。このアクションでは、ユーザー・インターフェース・クライアントを実行している マシンのブラウズのみがサポートされています。
  5. 「詳細設定」タブを選択します。ここでは、以下の設定を 行うことができます。
    • 「プロセスが fork するときは常時、親に従う」: これは、 デバッグされるプロセスが fork() を呼び出したときのデバッガーの動作を制御します。 このチェック・ボックスが選択されていない場合、デバッガーは、停止し、どちらのプロセスをデバッグするのか 質問を出します。このチェック・ボックスが選択されている場合、デバッガーは、停止せず、親プロセスの デバッグを続行します。
    • 「システム・スレッドの表示」: 一部のバージョンの pthread ライブラリーには、 スレッド化を実行するシステム・スレッドがあります。デフォルトでは、 デバッガーはこのスレッドを表示しません。このチェック・ボックスが選択されている場合、このスレッドが 表示されます。大部分のユーザーは、これを表示する必要はありません。

      このチェック・ボックスが 選択されている場合、エンジンは pthread ライブラリーの存在を 無視し、カーネル・スレッドのみを表示します。

    • 「表示されるタブ幅」: ユーザー・インターフェースのソース・ファイル・ビューでタブを展開するときに 使用される、タブの間隔を指定します。 デフォルトは 8 です。
    • 「ディープ・ステップ・デバッグを使用可能にする」: デフォルトでは、 ステップ・デバッグ機能は、当面のサブルーチンだけをチェックしてデバッグ情報を確認します。この チェック・ボックスが選択されている場合、エンジンは、デバッグ情報のあるロケーションが見つかるまで ステップインします。これは、 デバッグ情報のない大量のコードがあると遅くなる可能性があります。
    • 「バックグラウンドでのデバッグ情報読み取りを使用不可にする」: デバッガーは、 デバッグ対象プログラムから、必要なときだけデバッグ情報を読み取り、 それを解釈します。このチェック・ボックスが選択されていない場合、デバッガーは、 デバッグ情報の読み取りを、それ以外の活動は停止中である間も続けます。通常、これは、 デバッグのパフォーマンスを向上させますが、デバッグされるプログラムが非常に大きい場合は、 デバッガーは遅くなります。
    • 「エンジン・サービス・トレースを使用可能にする」: この設定は、 診断目的にのみ使用されます。IBM サービス技術員の指示があった場合にのみ 選択してください。
  6. ソース・ルックアップ・パスを設定するには、「ソース」タブを 選択して、以下のタスクを実行します。
    • ソース・ロケーションを追加するには、「追加」をクリックします。 これによって「ソースの追加」ダイアログ・ボックスが起動し、そこで追加するソース・ロケーションのタイプを選択することができます。 「ソースの追加」ダイアログ・ボックスの 選択リストから、「ワークスペース」を選択すると、 ワークスペース内のすべてのプロジェクトがソース検索パスに追加され、 「デバッグ・エンジン」を選択すると、デバッグ・エンジンが ソース検索パスに追加されます。他の選択を行った場合は、ダイアログ・ボックスが開き、 使用したいソース検索パスを入力または参照できます。
    • 既存のエントリーを除去するには、ソース・ロケーションを選択して、 「除去」をクリックします。
    • 既存のエントリーの順序を設定するには、ソース・ロケーションを選択して、 「上へ」または「下へ」を クリックして、そのロケーションの位置を変更します。
      注: 場合によっては、ロケーションの位置を変更しても、 次にプログラムが起動されるまで変更が有効にならないことがあります。

    ソース検索パス内のソース・ファイル名のすべてのインスタンスを検索する場合は、 「パス上の重複ソース・ファイルを検索する」チェック・ボックスを選択します。このチェック・ボックスが 選択されている場合、デバッガーがファイル名の複数のインスタンスを見つけると、 正しいソース・ファイルを選択するように指示するダイアログ・ボックスが表示されます。

  7. 「環境」タブを選択して、それを 前景に移します。「環境」ページでは、 デバッグ・セッション用の環境変数を設定できます。このページで行った 設定は、その設定を実行したユーザーのデバッグ・セッションにのみ影響します。
    注: このタブで行った変更は、デバッグ・エンジンに対してのみ有効であり、デバッグされるプロセスには 影響しません。デバッグされるプロセスは既に実行中であり、その環境をこのタブで変更することはできません。

    さまざまな要素について環境変数を設定する必要があります。 例えば、デバッグ・セッションに必要な、アプリケーションの実行可能ファイルのロケーションを 指定する必要があります。このページで環境変数を設定するには、 以下のタスクを実行します。

    • デフォルトでは、デバッグ・セッション用に設定される環境変数は、 次のとおりです。
      • 環境変数が設定されたバッチ・ファイルまたはコマンド行から ワークベンチを起動した場合、それらの環境変数が、デバッグ・セッション用に使用 されるデフォルト環境変数になります。
    • デバッグ・セッション用の環境変数を追加するには、「新規」ボタン をクリックし、「新規環境変数」ダイアログ・ボックスに適当な値を 入力します。その環境変数がデフォルトの環境変数に 追加されます。
    • デバッグ・セッション用の環境変数を除去するには、その環境変数を 「設定する環境変数」リストから選択し、 「除去」ボタンを選択します。
    • 「選択」をクリックするとダイアログ・ボックスが開き、 環境に現在ある変数を追加することができます。
  8. 起動構成に必須の全情報が指定されると、 「デバッグ」ボタンおよび 「適用」ボタンが使用可能になります。 「適用」をクリックすると、起動構成が保管されます。 この時点で、デバッグ・セッションを起動せずにダイアログ・ボックスを閉じることも、 「デバッグ」をクリックして、 その新しい起動構成を使用してデバッグ・セッションを起動することも選択できます。 「デバッグ」をクリックすると、 起動構成に対して行った変更が保管され、デバッグ・セッションが起動されます。
    注: 実行プロセスに接続するための起動構成を保管する際、入力したプロセス ID が保管されますが、 その起動構成を次に使用するときには、それが有効ではないことがよくあります。 構成を編集して、もう一度プロセス ID を選択してください。
    ヒント: 起動構成設定をまだ保存していない場合で、除去または変更する必要がある起動構成設定に入力している場合は、「戻す」をクリックすると、実行したすべての変更が除去されます。
  9. 起動構成に必須の情報が指定されていない場合、または指定した情報にエラーがある場合には、 ダイアログ・ボックスの上部に何が欠落しているかを示すメッセージが表示されます。
  10. デバッグ・セッションを起動するのにダイアログ・ボックスを使用しなかった場合は (例えば、 それを使用して起動構成を作成し保管した場合)、作業が終了したら「クローズ」を クリックしてダイアログ・ボックスを終了してください。
タスクの結果

起動構成を削除するには、デバッガーのメインメニューから、「ファイル」>「起動」>「起動の削除」を 選択します。これによって、ダイアログ・ボックスが開き、 除去する起動を選択できます。

既に作成済みの起動構成を使用して デバッグ・セッションを起動するには、「ファイル」>「起動」> <launch> を 選択します。ここで、<launch> は、起動構成を作成したときに指定した起動構成名 です。この起動構成に対する保管された設定が入った起動構成ダイアログ・ボックスが 開きます。この起動構成を再使用する前に、それらの設定を編集することができます。

重要: 誤ったプロセス ID を入力した場合や、 システム・プロセスへ接続しようとした場合、予期しない結果が起こる可能性があります。
関連概念
どのようなときに接続を行うのか

フィードバック