3.3.7 ブレークポイントまたはトレースポイントの無効化，有効化，および取り消し |
 |
いったん設定されたブレークポイントまたはトレースポイントは，無効にしたり，有効にしたり，また取り消したりすることができます。
ブレークポイントまたはトレースポイントを無効にするには， DEACTIVATE BREAK または DEACTIVATE TRACE コマンドを入力します。これで，デバッガは，プログラムの実行中にそのブレークポイントまたはトレースポイントを無視するようになります。いったん無効にしたブレークポイントまたはトレースポイントはあとで，たとえば呼び出し元のプログラムを再実行したときなど ( 第 1.3.3 項 参照) に再度有効にすることもできます。無効にされたブレークポイントまたはトレースポイントは， SHOW BREAK コマンドを実行したときに表示されるリストでは無効なもとのして表示されます。
ブレークポイントまたはトレースポイントを有効にするには， ACTIVATE BREAK または ACTIVATE TRACE コマンドを使用します。これらのコマンドを使用すれば，プログラムの実行中にブレークポイントまたはトレースポイントが有効になります。
DEACTIVATE BREAK/ALL および ACTIVATE BREAK/ALL コマンド (DEACTIVATE TRACE/ALL および ACTIVATE TRACE/ALL コマンド ) は，すべてのブレークポイントまたはトレースポイントに対して作用し，特に RERUN コマンドを使用してプログラムを再実行するときに有効です。
ブレークポイントまたはトレースポイントを取り消すには， CANCEL BREAK
または CANCEL TRACE コマンドを使用します。取り消されたブレークポイントまたはトレースポイントは， SHOW BREAK または SHOW TRACE コマンドで表示されるリストには載らなくなります。
これらのコマンドを使用する場合には，ブレークポイントまたはトレースポイントの設定時と全く同じようにして，アドレス式と ( 必要であれば ) 修飾子を指定します。次に例を示します。
DBG> DEACTIVATE TRACE/LINE
DBG> CANCEL BREAK SWAP,MOD2\LOOP4,2753
|
SET WATCH コマンドを使用すれば，デバッガがプログラムの実行中にモニタするプログラム変数または任意のメモリ記憶位置を指定できます。このプロセスを，ウォッチポイントの設定といいます。ウォッチされている変数またはメモリ記憶位置の値がプログラム実行中に変更されると，ウォッチポイントが検出されます。デバッガは実行を中断し情報を表示して，コマンド入力用プロンプトを表示します。デバッガは，プログラムの実行中は常にウォッチポイントをモニタします。
この節では，SET WATCHコマンドの使用方法の概略を説明します。非静的変数，すなわち呼び出しスタック上またはレジスタ内に割り当てられる変数へのウォッチポイントの設定についての詳しい説明は， 第 3.4.3 項 を参照してください。
 | 注意
SET WATCH コマンドを変数名または任意のシンボリック・アドレス式といっしょに使用する場合，モジュールの設定あるいは有効範囲かパス名の指定が必要になることがあります。これらの概念については， 第 5 章 で詳しく説明します。以下の例では，すべてのモジュールが設定され，すべての変数名が一意に定義されるものと想定します。
コンパイル時にプログラムの最適化を行うと，プログラム内のある変数がコンパイラによって除去されることがあります。このような変数にウォッチポイントを設定しようとすると，デバッガは警告を発行します (
第 1.2 節 および 第 14.1 節 を参照)。
|
SET WATCH コマンドの構文は次のとおりです。
SET WATCH[/qualifier[...]] address-expression[, ...]
[WHEN (conditional-expression)]
[DO (command[; ...])]
|
ユーザは，任意の有効なアドレス式を指定できますが，通常は変数名を指定します。次に，典型的な SET WATCH コマンドの使用例と，ウォッチポイントでのデバッガの省略時の動作の概略を示します。
DBG> SET WATCH COUNT
DBG> GO
.
.
.
watch of MOD2\COUNT at MOD2\%LINE 24
24: COUNT := COUNT + 1;
old value: 27
new value: 28
break at MOD2\%LINE 25
25: END;
DBG>
|
この例では，SET WATCH コマンドによって，変数 COUNT にウォッチポイントが設定され，GO コマンドで実行が開始されます。プログラムが変数 COUNT の値を変更すると，実行は一時停止します。その後デバッガは次の作業を実行します。
- イベントの発生を知らせ ("watch of MOD2\COUNT...")，ウォッチされている変数の値を変更した命令の記憶位置を表示する ("...at MOD2\%LINE 24")。
- 関連するソース行(24)を表示する。
- 変数の古い値と新しい値(27と28)を表示する。
- 次の行の先頭で実行が停止していることを知らせ ("break at MOD2\%LINE 25")，そのソース行を表示する。
- 別のコマンド入力用のプロンプトを表示する。
ウォッチされている変数の値を変更した命令のアドレスが，ソース行の先頭でない場合，デバッガは，行番号に行の先頭からのバイト・オフセットを追加することによって，その命令の記憶位置を示します。次に例を示します。
DBG> SET WATCH K
DBG> GO
.
.
.
watch of TEST\K at TEST\%LINE 19+5
19: DO 40 K = 1, J
old value: 4
new value: 5
break at TEST\%LINE 19+9
19: DO 40 K = 1, J
DBG>
|
この例では，変数Kを変更した命令のアドレスは，19 行目の先頭から 5 バイトの位置です。ブレークポイントは，変数値を変更した命令の次の命令にあることに注意してください。前の例のように次のソース行の先頭ではありません。
ウォッチポイントは，集合体，すなわち全配列および全レコードに設定することができます。配列またはレコードに設定されたウォッチポイントは，その配列またはレコード内の任意の要素が変更されると検出されます。したがって，個々の配列要素またはレコード構成要素にウォッチポイントを設定する必要はありません。ただし，可変長レコードには集合体ウォッチポイントを設定できません。次の例では，配列 ARR の第 3 要素が変更されたためウォッチポイントが検出されています。
DBG> SET WATCH ARR
DBG> GO
.
.
.
watch of SUBR\ARR at SUBR\%LINE 12
12: ARR(3) := 28
old value:
(1): 7
(2): 12
(3): 3
(4): 0
new value:
(1): 7
(2): 12
(3): 28
(4): 0
break at SUBR\%LINE 13
DBG>
|
ウォッチポイントは，レコードの構成要素，個々の配列要素，または配列断面 ( 配列要素の範囲 ) にも設定できます。配列断面に設定されたウォッチポイントは，その配列断面内の任意の要素が変更されたときに検出されます。ウォッチポイント設定時には，現在の言語の構文を使用します。たとえば，次のコマンドは，Pascal の構文を使用して配列 CHECK の第 7 要素にウォッチポイントを設定します。
現在設定されているすべてのウォッチポイントを示すには， SHOW WATCH コマンドを使用します。
