5.3.2 シンボルを一意に指定するための SHOW SYMBOL コマンドとパス名の使用 |
 |
シンボル参照が一意でないことをデバッガが示している場合は，SHOW SYMBOL コマンドを使用して，そのシンボルの可能なパス名をすべて表示し，そのうちの 1 つを指定することによってシンボルを一意に指定します。次に例を示します。
DBG> EXAMINE COUNT
%DEBUG-W-NOUNIQUE, symbol 'COUNT' is not unique
DBG> SHOW SYMBOL COUNT
data MOD7\ROUT3\BLOCK1\COUNT
data MOD4\ROUT2\COUNT
routine MOD2\ROUT1\ROUT3\COUNT
DBG> EXAMINE MOD4\ROUT2\COUNT
MOD4\ROUT2\COUNT: 12
DBG>
|
SHOW SYMBOL COUNT コマンドは，RST 内に存在するシンボル COUNT のすべての宣言を表示します。COUNT の最初の 2 つの宣言は変数 (データ) です。最後の宣言はルーチン名です。各宣言は，そのパス名接頭識別子とともに表示され，その宣言に到達するためにたどらなければならないパス ( 検索範囲 ) を示しています。たとえば，MOD4\ROUT2\COUNT は，モジュール MOD4 内のルーチン ROUT2 に存在するシンボル COUNT の宣言を示しています。
パス名の形式は，次のとおりです。すなわち，パス名の最も左の要素は，シンボルを含むモジュールを示します。その後，右に移動するに従って，連続してネストされたルーチンおよびブロックが続き，最後にシンボルの特定の宣言 ( 一番右側の要素 ) に到達します。
シンボルは常にパス名とともに表示されますが，ユーザが，デバッガ・コマンドにパス名を指定する必要があるのは，あいまいさを解消する必要があるときだけです。
デバッガは，行番号を他のシンボルと同じように検索します。省略時の設定では，最初に，実行が停止したモジュール内を検索します。よく使用されるパス名の使用法に，任意のモジュール内の行番号を指定する場合があります。次に例を示します。
DBG> SET BREAK QUEUE_MANAGER\%LINE 26
|
次の例では SHOW SYMBOL コマンドが，グローバル・シンボルを 2 回示しています。これは，グローバル・シンボルが DST と GST の両方に含まれているためです。
DBG> SHOW SYMBOL X
data ALPHA\X ! グローバル X
data ALPHA\BETA\X ! ローカル X
data X (global) ! ALPHA\X と同じ
DBG>
|
共用可能イメージの場合は，その中に含まれるグローバル・シンボルはユニバーサル・シンボルなので，SHOW SYMBOL コマンドは，ユニバーサル・シンボルを 2 回示します ( 第 5.1.2 項 および 第 5.4 節 を参照 )。
パス名は長くなることがあります。ユーザは，次の 3 つの方法でパス名の指定を単純化できます。
- パス名を簡略化する。
- パス名として簡単なシンボルを定義する。
- パス名を指定しなくてもよいように，新しい検索有効範囲を設定する。
パス名を簡略化するには，ネストされたプログラム単位を左から順番に削除して，一意にシンボルを指定するのに十分なパス名だけを残します。たとえば， 第 5.3.2 項 の最初の例では， ROUT3\COUNT は有効な簡略化されたパス名です。
パス名のシンボルを定義するには，DEFINE コマンドを使用します。次に例を示します。
DBG> DEFINE INTX = INT_STACK\CHECK\X
DBG> EXAMINE INTX
|
新しい検索有効範囲を設定するには，SET SCOPE コマンドを使用します。このコマンドについては， 第 5.3.3 項 を参照してください。
5.3.2.2 呼び出しスタック上ルーチン内のシンボルの指定
ユーザは，数値パス名を使用して，SHOW CALLS の表示によって示される呼び出しスタック上のルーチンに対応する有効範囲を指定できます。パス名接頭識別子の "0\" は PC 範囲を示し，"1\" は有効範囲 1 ( 呼び出し元の有効範囲 ) を示します。
たとえば，次のコマンドは，それぞれ有効範囲 0 および有効範囲 2 の中で見える，2 つの異なる宣言 Y の現在値を表示します。
DBG> EXAMINE 0\Y
DBG> EXAMINE 2\Y
|
省略時の設定では，EXAMINE Y コマンドは，EXAMINE 0\Y を意味します。
第 5.3.3 項 の SET SCOPE/CURRENT コマンドの説明を参照してください。このコマンドを使用すれば，省略時の有効範囲検索リストの参照を呼び出しスタックの相対位置に再設定できます。
グローバル・シンボルを一意に指定するには，シンボルの接頭辞としてバックスラッシュ(\) を使用します。たとえば，次のコマンドはグローバル・シンボル X の値を表示します。
あるルーチンが再帰的に呼び出された場合，同じルーチンに対するいくつかの呼び出しを区別する必要があります。その結果，これらの呼び出しすべてに対して，同じ名前の新しいシンボルが作成されます。
ユーザは，パス名の中に起動番号を含めて，そのルーチンに対する特定の呼び出しを示すことができます。起動番号は，パス名の一番右側のルーチン名の後ろに非負の整数として置かなければなりません。0 は，最も最近の起動を意味します。1 はその前の起動，というように続きます。たとえば，PROG が COMPUTE を呼び出し，COMPUTE が自身を再帰的に呼び出しているとします。各呼び出し時に新しい変数 SUM が生成されるとき，次のコマンドは，COMPUTE の最近の呼び出し時の SUM の値を表示します。
DBG> EXAMINE PROG\COMPUTE 0\SUM
|
1 つ前の COMPUTE の呼び出し時に生成された変数 SUM を参照するには，上記のパス名の 0 の箇所に 1 を指定します。
起動番号を指定しないと，デバッガは，そのルーチンに対する最近の呼び出しへの参照と仮定します。省略時の起動番号は 0です。
第 5.3.3 項 で説明する SET SCOPE/CURRENT コマンドを参照してください。このコマンドを使用すれば，省略時の有効範囲検索リストの参照位置を呼び出しスタックの相対位置に再設定できます。
5.3.3 シンボル検索の有効範囲を指定する SET SCOPE の使用 |
|
省略時の設定では，デバッガはパス名接頭識別子の指定のないシンボルを検索する場合，
第 5.3.1 項 で説明した有効範囲検索リストを使用します。
SET SCOPE コマンドを使用すれば，シンボル検索用の新しい有効範囲を設定できます。その結果，設定された有効範囲内のシンボルを参照するときに，パス名を指定する必要がなくなります。
次の例では，SET SCOPE コマンドを使用して，シンボル検索用の新しい有効範囲としてパス名 MOD4\ROUT2 を設定しています。その後，パス名接頭識別子の指定なしで Y を参照すると，新しい有効範囲内で見える Y の宣言が使用されます。
DBG> EXAMINE Y
%DEBUG-E-NOUNIQUE, symbol 'Y' is not unique
DBG> SHOW SYMBOL Y
data MOD7\ROUT3\BLOCK1\Y
data MOD4\ROUT2\Y
DBG> SET SCOPE MOD4\ROUT2
DBG> EXAMINE Y
MOD4\ROUT2\Y: 12
DBG>
|
SET SCOPE コマンドによってパス名が設定されると，そのコマンド内に指定したパス名が，パス名で個別に修飾されていないすべての参照に適用されます。
SET SCOPE コマンドには，数値パス名を指定することができます。たとえば次のコマンドは，現在の有効範囲を PC 範囲から 3 コール分さかのぼったルーチン呼び出しに設定します。
また，有効範囲検索リストを使用すれば，デバッガがシンボルを検索する順序を指定できます。たとえば，次のコマンドによって，デバッガは最初に PC 範囲 ( 有効範囲 0) を検索し，次にモジュール MOD4 内のルーチン ROUT2 によって示される有効範囲を検索します。
DBG> SET SCOPE 0, MOD4\ROUT2
|
デバッガの省略時の有効範囲検索リストは，各有効範囲が存在すると仮定すれば次のコマンドを入力した場合と同じです。
DBG> SET SCOPE 0,1,2,3,...,n
|
この場合，デバッガは，シンボルを見つけるために，呼び出しスタックを順番にさかのぼって検索します。
また，SET SCOPE/CURRENT コマンドを使用して，省略時の有効範囲検索リストの参照位置を呼び出しスタック内の別のルーチンに変更することができます。たとえば，次のコマンドは，有効範囲検索リストを 2,3,4,...,n のように設定します。
シンボル検索用の現在の有効範囲検索リストを表示するには， SHOW SCOPE コマンドを使用します。省略時の有効範囲検索リストを復元する (
第 5.3.1 項 を参照 ) には，CANCEL SCOPE コマンドを使用します。
