バージョン 4.2.5	検索   索引   目次   |   PDF ブック   |   ホーム   上へ   戻る   次へ

変数値が変わると常に、ウォッチポイントによって Natural オブジェクトの実行が中断されます。 また下記の「ウォッチポイント演算子」で説明しているように（「ウォッチポイントの設定」も参照）、特定の変数値に関連付けた条件に応じて中断させることもできます。

ウォッチポイントを使用すると、エラーがあるオブジェクトによって予期せず変更された変数を検出できます。

変数が変更されたと見なされるのは、変数の現在の値が、ウォッチポイントが前回トリガされたときに記録された値または初期値と異なる場合です。 ウォッチポイント値の比較検証は、253 バイトのフィールド長に制限されています。 最大長を超えるラージ変数の場合は、最初の 253 バイトのみが比較に使用されます。

ウォッチポイントは、Natural オブジェクトの名前と適切な変数の名前を指定して定義します。

ウォッチポイントの一意の識別子は、デバッガによって割り当てられるスパイ番号です。

ウォッチポイントを指定すると、そのウォッチポイントを削除するまで Natural セッション全体で有効になります。

Watchpoint maintenance 機能を呼び出すには

• デバッグメインメニューでファンクションコード「W」を入力します。

  または:
  次のダイレクトコマンドを入力します。

  WM

  ［Watchpoint Maintenance］メニューが表示されます。

このセクションでは、［Watchpoint Maintenance］メニューの機能、およびウォッチポイント画面のフィールドと列について説明します。

• テストモードを ON/OFF に設定

• ウォッチポイントの有効化

• ウォッチポイントの無効化

• ウォッチポイントの削除

• ウォッチポイントの表示

• ウォッチポイントの変更

• ウォッチポイントの設定

• ウォッチポイント画面のフィールドと列

テストモードを ON/OFF に設定

「テストモードのオンとオフの切り替え」を参照してください。

ウォッチポイントの有効化

指定したウォッチポイントの現在の状態をアクティブに設定するには

• ［Watchpoint Maintenance］メニューで、ファンクションコード「A」、オブジェクト名または変数名、あるいはその両方を入力します。

  または:
  ダイレクトコマンド ACTIVATE を使用します。その構文については、「コマンドの概要とコマンド構文」セクションで説明しています。

オブジェクトまたは変数を指定しない場合（または［Variable］フィールドでデフォルトのアスタリスクをそのまま使用する場合）は、すべてのウォッチポイントが有効になります。

ウォッチポイントの無効化

指定したウォッチポイントの現在の状態を非アクティブに設定するには

• ［Watchpoint Maintenance］メニューで、ファンクションコード「B」、オブジェクト名または変数名、あるいはその両方を入力します。

  または:
  ダイレクトコマンド DEACTIVATE を使用します。その構文については、「コマンドの概要とコマンド構文」セクションで説明しています。

オブジェクト名または変数を指定しない場合（または［Variable］フィールドでデフォルトのアスタリスクをそのまま使用する場合）は、すべてのウォッチポイントが無効になります。

ウォッチポイントの削除

指定したウォッチポイントを削除するには

• ［Watchpoint Maintenance］メニューで、ファンクションコード「C」、オブジェクト名または変数名、あるいはその両方を入力します。

  または:
  ダイレクトコマンド DELETE を使用します。その構文については、「コマンドの概要とコマンド構文」セクションで説明しています。

オブジェクト名または変数を指定しない場合（または［Variable］フィールドでデフォルトのアスタリスクをそのまま使用する場合）は、すべてのウォッチポイントが削除されます。

ウォッチポイントの表示

ウォッチポイントを表示するには

1. ［Watchpoint Maintenance］メニューで、ファンクションコード「D」、オブジェクト名または変数名、あるいはその両方を入力します。 オブジェクト名を入力しない場合は、デフォルトオブジェクト（指定されている場合）が使用されます。

   または:
   ダイレクトコマンド DISPLAY を使用します。その構文については、「コマンドの概要とコマンド構文」セクションで説明しています。

   指定されたオブジェクト名と変数名にウォッチポイントが設定されている場合は、下の例のような、すべてのウォッチポイントの定義を示す［Display Watchpoint］画面が表示されます。

   10:25:32 ***** NATURAL TEST UTILITIES ***** 2006-02-14 Test Mode ON - Display Watchpoint - Object Spy number .............. 12 Initial state ........... active Current state .. active Watchpoint name ......... WATCHTEST1 DBID/FNR ....... 10/32 Object name ............. WATCHPGM Library ........ SAG Variable name ........... WATCHVARIABLE Skips before execution .. 0 Format/length .. A 10 Max number executions ... 0 Persistent ..... N Act.level ... 0 Number of activations ... 0 Error in definition ..... - none - Commands ... BREAK Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Last Mod Flip Alpha Hex Canc

   ［Display Watchpoint］画面のフィールドについては、「ウォッチポイント画面のフィールドと列」で説明します。

   一意のウォッチポイントが見つからない場合は、［List Watchpoints］画面（下記を参照）が表示されます。

2. ［Display Watchpoint］画面では、ウォッチポイント演算子で指定したウォッチポイントの有効化の条件を表示できます（「ウォッチポイント演算子」も参照）。

   演算子またはオペランド値、あるいはその両方を英数字形式で表示するには、PF10（Alpha）キーを押します。 .

   または:
   演算子またはオペランド値、あるいはその両方を 16 進形式で表示するには、PF11（Hex）キーを押します。

   ［Commands］フィールドがある［Display Watchpoint］画面のデフォルト表示に戻るには、PF22（Cmds）キーを押します。

ウォッチポイントをリストするには

• ［Watchpoint Maintenance］メニューで、ファンクションコード「D」、オブジェクト名または変数名を入力します。 ABC* のように、アスタリスク（*）記号を使用すると、一定の範囲のオブジェクト名や変数名を指定できます。 アスタリスク（*）のみを入力すると、すべての名前が選択されます。 オブジェクト名を入力しない場合は、デフォルトオブジェクト（指定されている場合）が使用されます。

  または:
  ダイレクトコマンド DISPLAY を使用します。その構文については、「コマンドの概要とコマンド構文」セクションで説明しています。

  下の例のような［List Watchpoints］画面が表示されます。この画面には、指定したオブジェクト名または変数名に設定されたすべてのウォッチポイントがリストされます。

  10:14:05 ***** NATURAL TEST UTILITIES ***** 2006-02-14 Test Mode ON - List Watchpoints - Object Top of data Co No. WP Name Library Object DBID FNR Stat Skips Execs Count P E *___________ *_______ *_______ I C *_______________________________________________________________________ __ 1 NAME SAG DEBPGM 10 32 A A 0 0 0 N EMPLOYEES-VIEW.NAME __ 5 #MAKE SAG DEBPGM 10 32 A A 0 0 0 N #MAKE __ 10 LEAVE-DUE SAG DEBPGM 10 32 A A 0 0 0 N EMPLOYEES-VIEW.LEAVE-DUE __ 11 WATCHTEST2 SAG DEBPGM 10 32 A A 0 0 0 N TESTWP __ 12 WATCHTEST1 SAG WATCHPGM 10 32 A A 0 0 0 N WATCHVARIABLE __ 13 WATCHTEST3 SAG DEBPGM 10 32 A A 0 0 0 N WPTEST Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Last Flip - + Canc

  このリストは、［No.］ 列のスパイ番号によって昇順でソートされます。

  ［List Watchpoints］画面の列や、リスト項目に対して実行できる行コマンドの詳細については、「ウォッチポイント画面のフィールドと列」を参照してください。

ウォッチポイントの変更

ウォッチポイントを変更するには

1. ［Watchpoint Maintenance］メニューで、ファンクションコード「M」、オブジェクト名および変数名を入力します。 オブジェクト名を入力しない場合は、デフォルトオブジェクト（指定されている場合）が使用されます。

   または:
   ダイレクトコマンド MODIFY を使用します。その構文については、「コマンドの概要とコマンド構文」セクションで説明しています。

   一意のウォッチポイントが指定されている場合は、［Modify Watchpoint］画面が表示され、ここでフィールドのエントリを変更できます。 ［Modify Watchpoint］画面のフィールドについては、「ウォッチポイント画面のフィールドと列」で説明しています。

   一意のウォッチポイントが見つからない場合は、［List Watchpoints］画面（「ウォッチポイントの表示」を参照）が表示されます。

2. ［Modify Watchpoint］画面では、ウォッチポイント演算子で指定したウォッチポイントの有効化の条件を変更できます（「ウォッチポイント演算子」も参照）。

   演算子またはオペランド値、あるいはその両方を英数字形式で変更するには、PF10（Alpha）キーを押します。 .

   または:
   演算子またはオペランド値、あるいはその両方を 16 進形式で変更するには、PF11（Hex）キーを押します。

   ［Commands］フィールドがある［Modify Watchpoint］画面のデフォルト表示に戻るには、PF22（Cmds）キーを押します。

3. ウォッチポイント定義の編集を完了したら、PF3（Exit）または PF5（Save）キーを押して変更を保存します。 PF12（Canc）キーを押すと、ウォッチポイントは変更されないままになります。

ウォッチポイントの設定

セッションのウォッチポイントを追加するには

• ［Watchpoint Maintenance］メニューで、ファンクションコード「S」、オブジェクト名および変数名を入力します。

  または:
  ダイレクトコマンド SET を使用します。その構文については、「コマンドの概要とコマンド構文」セクションで説明しています。

  または:
  Natural オブジェクトの実行前：

  • ［List Object Source］画面を表示します（「オブジェクトソースのリスト」を参照）。

  • ［Source］列で、変数名にカーソルを置いて PF18（Se Wp）キーを押します。

  オブジェクト名ではなく、有効な変数名を指定すると、デフォルトオブジェクトの名前が使用されます（「デバッガの開始」を参照）。 デフォルトオブジェクトが指定されていない場合は、現在のライブラリで使用可能なすべてのオブジェクトを示す選択ウィンドウが表示されます。

  オブジェクト名と変数名が適切に指定されている場合、ウォッチポイントがすぐに設定され、対応する確認メッセージが画面に表示されます。 ダイナミック変数または X-array に設定したウォッチポイントは、プログラムの実行時にのみチェックされます。 デバッグエントリの有効性チェックの詳細については、「メンテナンスと検証」も参照してください。

  ウォッチポイントはデフォルトコマンド（BREAK）を受信し、初期の状態と現在の状態がアクティブに設定され、実行に関する制限は指定されません。 ウォッチポイントの設定時にデフォルトコマンド BREAK を削除し、ダイアログを表示するコマンドを何も指定しないと、プログラムの中断時にデバッガが制御を受け取れなくなります。

このセクションでは、次のトピックについて説明します。

• ウォッチポイント演算子

ウォッチポイント演算子

［Watchpoint Maintenance］画面で演算子と適切なオペランド（対応するオペランドがある場合）を指定することで、ウォッチポイントの有効化に対して条件を指定することができます。

ウォッチポイント演算子を指定するには

1. 英数字形式で演算子オペランドを指定する場合は、選択したウォッチポイントの［Set Watchpoint］または［Modify Watchpoint］画面で PF10（Alpha）キーを押します。

   または:
   16 進形式で演算子オペランドを指定する場合は、選択したウォッチポイントの［Set Watchpoint］または［Modify Watchpoint］画面で PF11（Hex）キーを押します。

   2 つの入力フィールドが画面の下半分に表示されます。

2. 左の入力フィールドには、次の表に示すウォッチポイント演算子のいずれかを入力します。

   右の入力フィールドには、変数と比較するオペランド値（対応するオペランドがある場合）を入力します。 ダイナミック変数（英数字またはバイナリ）に対して指定した演算子があるウォッチポイントの場合、オペランド値は左から右へ比較されます。 ダイナミック変数のフィールド長は変化するため、最大 253 バイトを比較値として入力できます。 ダイナミック変数の現在の長さが 253 バイトの最大比較長よりも短い場合、比較はダイナミック変数の現在の長さの範囲内でのみ実行されます。

   演算子	説明
   MOD	変更。 変数の内容が変更されるたびに、ウォッチポイントが有効になります。 これはデフォルト設定です。
   EQ	等しい。 変数が変更され、変数の現在値が指定されたオペランド値と等しい場合、ウォッチポイントが有効になります。
   NE	等しくない。 変数が変更され、変数の現在値が指定されたオペランド値と等しくない場合、ウォッチポイントが有効になります。
   GT	より大きい。 変数が変更され、変数の現在値が指定されたオペランド値よりも大きい場合、ウォッチポイントが有効になります。
   GE	より大きいまたは等しい。 変数が変更され、変数の現在値が指定されたオペランド値以上の場合、ウォッチポイントが有効になります。
   LT	より小さい。 変数が変更され、変数の現在値が指定されたオペランド値よりも小さい場合、ウォッチポイントが有効になります。
   LE	より小さいまたは等しい。 変数が変更され、変数の現在値が指定されたオペランド値以下の場合、ウォッチポイントが有効になります。
   INV	無効な内容です。 タイプ N、P、D または T の変数に割り当てられた値が次の条件に一致しないとき、ウォッチポイントが有効になります。 N  アンパック型数値。 P パック型数値。 D 1582-01-01 から 2700-12-31 までの日付。 T 1582-01-01 00:00:00.0 から 2700-12-31 23:59:59.9 までの時刻。

   PF22（Cmds）キーを押すと、［Commands］入力フィールドのある［Set Watchpoint］または［Modify Watchpoint］画面のデフォルト表示に戻ることができます。

3. 演算子の定義を保存するには、PF5（Save）キーを押します。

   または:
   演算子の定義を変更しないままで［Modify Watchpoint］画面を終了するには、PF12（Canc）キーを押します。

ウォッチポイント画面のフィールドと列

次の表では、［Display Watchpoint］または［Modify Watchpoint］画面のフィールドと、［List Watchpoints］画面の列について説明します。

www.softwareag.com

Copyright © Software AG 1979-2009. All rights reserved.

検索   索引   目次   |   PDF ブック   |   ホーム   上へ   戻る   次へ