3.2.2 ルーチン内のステップ実行とルーチンの1ステップ実行

省略時の設定では，PC が CALL 文を指しているときに STEP コマンドを入力すると，デバッガは呼び出されたルーチンを 1 ステップとして実行します。ルーチンは実行されますが，ルーチン内で実行が停止することはなく，CALL 文の次の行の先頭で実行が停止します。命令単位で実行している場合は，呼び出されたルーチンの復帰命令の直後の命令で実行が停止します。

PC が CALL 文を指しているときに呼び出されたルーチン内の命令をステップ実行するには，STEP/INTO コマンドを入力します。次の例は，TEST モジュールのルーチン COUNT から呼び出されたルーチン PRODUCT 内の命令をステップ実行する方法を示しています。

DBG> STEP
stepped to TEST\COUNT\%LINE 18 
    18:       AREA := PRODUCT(LENGTH, WIDTH); 
DBG> STEP/INTO
stepped to routine TEST\PRODUCT 
     6:    function PRODUCT(X,Y : INTEGER) return INTEGER is 
DBG>

呼び出されたルーチン内の任意の位置から，呼び出し元のルーチンに復帰するには，STEP/RETURN コマンドを使用します。このコマンドによって，デバッガは実行中のルーチンの復帰命令をステップ実行します。後続の STEP コマンドによって，ルーチン呼び出しの直後の文に制御が戻ります。次に例を示します。

DBG> STEP/RETURN
stepped on return from TEST\PRODUCT\%LINE 11 to TEST\PRODUCT\%LINE 15+4 
    15:    end PRODUCT; 
DBG> STEP
stepped to TEST\COUNT\%LINE 19 
    19:       LENGTH := LENGTH + 1; 
DBG>

いくつかのルーチン内の命令をステップ実行するには，SET STEP INTO コマンドを入力して STEP コマンドの省略時の動作を STEP/OVER から STEP/INTO に変更します。

DBG> SET STEP INTO

このコマンドの入力後，PC が CALL 文を指しているときに STEP コマンドを入力すると，呼び出されたルーチン内で実行が中断するようになります。あとで，ルーチン呼び出しを 1 ステップとして実行したい場合には， SET STEP OVER コマンドを入力します。

SET STEP INTO が有効なときには，SET STEP コマンドに次のようなパラメータを指定することによって，デバッガがその中の命令をステップ実行する呼び出されるルーチンの種類を指定できます。

• [NO]SHARE---呼び出された共用可能イメージ・ルーチン内の命令をステップ実行するかどうかを制御する。

• [NO]SYSTEM---呼び出されたシステム・ルーチン内の命令をステップ実行するかどうかを制御する。

これらのパラメータを使用すれば，アプリケーションで定義されたルーチンの場合はその内部命令をステップ実行し，システム・ルーチンの場合は自動的に 1 ステップとして実行する，というような指定が可能になります。たとえば，次のコマンドは，呼び出されたルーチンがユーザ空間内に存在する場合だけ，その中の命令をステップ実行するようデバッガに指示します。システム空間内および共用可能イメージ内のルーチンは， 1 ステップとして実行されます。

DBG> SET STEP INTO,NOSYSTEM,NOSHARE

3.3 ブレークポイントによる実行の中断とトレースポイントによるトレース

この節では，SET BREAK コマンドと SET TRACE コマンドを使用して，プログラムの実行をそれぞれ中断およびトレースする方法について説明します。この 2 つのコマンドは類似点が多いため，いっしょに説明します。

SET BREAKコマンドの概要

SET BREAK コマンドを使用すれば，プログラムの実行を中断するプログラム記憶位置またはイベント ( ブレークポイント ) を指定できます。ブレークポイントの設定後，ユーザは，GO コマンドを使用してプログラムの実行を開始または再開できます。プログラムは，指定された記憶位置に到達するか，または指定された条件が満たされるまで，実行を続けます。ブレークポイントが検出されると，デバッガは実行を中断し，ブレークポイントを示して，DBG> プロンプトを表示します。ユーザは，ここでたとえば，SHOW CALLS コマンドで現在の位置を決定する，ルーチン内の命令をステップ実行する，変数を検査または変更する，といったデバッガ・コマンドを入力できます。

SET BREAK コマンドの構文は次のとおりです。

SET BREAK[/qualifier[...]] [address-expression[, ...]] 
[WHEN (conditional-expression)] 
[DO (command[; ...])] 

次の例は，SET BREAK コマンドの典型的な使用例と，ブレークポイントでのデバッガの省略時の動作の概略を示しています。

この例では，SET BREAK コマンドは，ルーチン COUNT ( ルーチン・コードの先頭 ) にブレークポイントを設定します。そして，GO コマンドで実行を開始します。ルーチン COUNT に到達すると，実行は一時停止されます。デバッガは，ルーチン COUNT でブレークポイントに到達したことをユーザに知らせ ("break at ...")，実行を停止したソース行 (54) を表示し，コマンド入力を要求するプロンプトを表示します。

DBG> SET BREAK COUNT
DBG> GO
   .
   .
   .
break at routine PROG2\COUNT 
     54:  procedure COUNT(X,Y:INTEGER);
DBG>

SET TRACEコマンドの概要

SET TRACE コマンドを使用すれば，プログラムの実行をトレースするプログラム記憶位置またはイベント ( トレースポイント ) を選択できます。ただし，トレースポイントでプログラムが一時停止することはありません。トレースポイントの設定後，ユーザは GO コマンドで実行を開始し，予期しない動作を調べながらその記憶位置をモニタできます。ルーチンにトレースポイントを設定すると，そのルーチンの呼び出し回数をモニタすることもできます。

トレースポイントでのデバッガの省略時の動作は，ブレークポイントの場合と同じです。ただし，トレースポイントではプログラムの実行は停止しません。したがって，トレースポイントに到達し，デバッガがそれを知らせるときに， DBG> プロンプトは表示されません。

SET TRACE コマンドの構文は，コマンド名以外は SET BREAK コマンドの構文と同じです。

SET TRACE[/qualifier[...]] [address-expression[, ...]] 
[WHEN (conditional-expression)] 
[DO (command[; ...])] 

SET TRACE コマンドと SET BREAK コマンドは，同じ修飾子を持っています。 SET TRACE コマンド使用時には，SET BREAK コマンドの場合と全く同じように，アドレス式，修飾子，およびオプションの WHEN 句や DO 句を指定します。

SET BREAK(SET TRACE) コマンドで /TEMPORARY 修飾子を使用しないかぎり，ブレークポイントおよびトレースポイントは，ユーザが次に示す動作を行うまで有効です。

• ブレークポイント，トレースポイントを無効にする，または取り消す ( 第 3.3.7 項 )。

• RERUN/NOSAVE コマンドを使用して，プログラムを再実行する ( 第 1.3.3 項 )。

• 新しいプログラムを実行するか ( 第 1.3.4 項 )，またはデバッグ・セッションを終了する( 第 1.8 節 )。

現在設定されているすべてのブレークポイントおよびトレースポイントを示すには，SHOW BREAK (SHOW TRACE)コマンドを使用します。

ブレークポイントまたはトレースポイントを無効にする，有効にする，または取り消すには，次のコマンドを使用します ( 第 3.3.7 項 参照)。

DEACTIVATE BREAK, DEACTIVATE TRACE
ACTIVATE BREAK, ACTIVATE TRACE
CANCEL BREAK, CANCEL TRACE

次の各項では，SET TRACE コマンドと SET BREAK コマンドを使用してプログラム記憶位置およびイベントを指定する方法について説明します。

3.3.1 個々のプログラム記憶位置へのブレークポイントまたはトレースポイントの設定

特定のプログラム記憶位置にブレークポイントまたはトレースポイントを設定するには，SET BREAK または SET TRACE コマンドをアドレス式といっしょに指定します。

基本的には，アドレス式はメモリ・アドレスまたはレジスタを指定します。デバッガはプログラムに対応するシンボルを理解します。したがって，ユーザが通常，SET BREAK または SET TRACE コマンドといっしょに使用するアドレス式は，メモリ・アドレスではなく，ルーチン名，ラベル，またはソース行番号です。デバッガは，これらのシンボルをアドレスに変換します。

3.3.1.1 シンボリック・アドレスの指定

注意 SET BREAK コマンドまたは SET TRACE コマンドをシンボリック・アドレス式といっしょに使用する場合に，モジュールの設定，有効範囲またはパス名の指定が必要になることがあります。これらの概念については， 第 5 章 で詳しく説明します。以下の例では，特に指定しないかぎり，すべてのモジュールが設定され，参照されるすべてのシンボルが一意に定義されるものと想定します。

次の例は，ルーチン (SWAP) にブレークポイント，ラベル (LOOP1) にトレースポイントを設定する方法を示しています。

DBG> SET BREAK SWAP DBG> SET TRACE LOOP1

次のコマンドは，ルーチン SWAP の復帰命令上にブレークポイントを設定します。ルーチンの復帰命令上にブレークポイントを設定すると，そのルーチンがアクティブな状態の場合でも，ローカル環境を検査することができます ( たとえば，ローカル変数値の取得 )。

DBG> SET BREAK/RETURN SWAP

いくつかの言語，たとえば Fortran では，数値ラベルを使用します。数値ラベル上にブレークポイントまたはトレースポイントを設定するには，数字の前に組み込みシンボルである %LABEL を付ける必要があります。 %LABEL を付けないと，デバッガは，数字をメモリ・アドレスと解釈してしまいます。たとえば，次のコマンドはラベル 20 にトレースポイントを設定します。

DBG> SET TRACE %LABEL 20

行番号の前に，組み込みシンボルである %LINE を付けると，ソース・コード行にブレークポイントまたはトレースポイントを設定することができます。次のコマンドは，14 行目にブレークポイントを設定します。

DBG> SET BREAK %LINE 14

上記のブレークポイントは，14 行目の最初の命令で実行を停止させます。ブレークポイントまたはトレースポイントを設定できるのは，コンパイラ生成命令に対応する行 ( 実行可能なコード行 ) だけです。コメント行または変数を宣言するだけで初期化しない文など命令と対応していない行の番号を指定すると，デバッガは診断メッセージを発行します。次に例を示します。

DBG> SET BREAK %LINE 6 %DEBUG-I-LINEINFO, no line 6, previous line is 5, next line is 8 %DEBUG-E-NOSYMBOL, symbol '%LINE 6' is not in the symbol table DBG>

上記のメッセージは，コンパイラが 6 行目と7行目に対応する命令を生成しなかったことを示します。

いくつかの言語では，1 行に 2 つ以上の文を書くことができます。このような場合，同一行上の文を識別するために文番号を使用できます。文番号は，行番号の後ろにピリオド (.) とその文を示す番号を付けたものです。形式は次のとおりです。

%LINE line-number.statement-number

たとえば，次のコマンドは38行目の2番目の文にトレースポイントを設定します。

DBG> SET TRACE %LINE 38.2

コマンド内で参照されているシンボルを検索するときに，デバッガは 第 5.3.1 項 で説明する規則を使用します。すなわち，現在実行が停止しているモジュール内を最初に検索し，その後，呼び出しスタック内のルーチンに対応する他の有効範囲を検索します。したがって，行番号など，2 つ以上のモジュールで定義されているシンボルを指定するには，パス名を使用する必要があります。たとえば，次のコマンドは，モジュール MOD4 の 27 行目にトレースポイントを設定します。

DBG> SET TRACE MOD4\%LINE 27

デバッガ・コマンド内で行番号を指定するときには，シンボル検索規則に注意する必要があります。実行が停止しているモジュール内で行番号が定義されていない場合，その行に対応する命令が存在しないため，デバッガはシンボル検索規則に従って，行番号が定義されている他のモジュール内を検索します。

アドレス式を指定する場合，シンボリック・アドレスとバイト・オフセットを組み合わせることができます。したがって，行番号とその行の先頭から命令の先頭バイトまでのオフセットを指定することによって，特定の命令にブレークポイントまたはトレースポイントを設定できます。たとえば，次のコマンドは，23 行目の先頭から 5 バイトの位置のアドレスにブレークポイントを設定します。

DBG> SET BREAK %LINE 23+5

---

目次

索引