Compaq OpenVMS
デバッガ・コマンド・ディクショナリ

前へ 次へ 目次 索引

SHOW OUTPUT

現在の出力オプションを示します。

形式

SHOW OUTPUT

説明

現在の出力オプションは SET OUTPUT コマンドで前回設定したオプションです。省略時の設定では，SET OUTPUT コマンドを入力しなかった場合，出力オプションは NOLOG，NOSCREEN_LOG，TERMINAL，NOVERIFY です。

関連コマンド

SET LOG
SET MODE SCREEN
SET OUTPUT

例


DBG> SHOW OUTPUT
noverify, terminal, screen_log, 
    logging to USER$:[JONES.WORK]DEBUG.LOG;9
DBG>

このコマンドは次の現在の出力オプションを示します。

SHOW PROCESS

現在デバッガの制御下にあるプロセスについての情報を表示します。

形式

SHOW PROCESS [process-spec[,...]]

パラメータ

process-spec

現在デバッガの制御下にあるプロセスを指定します。次のいずれかの形式で指定します。

[%PROCESS_NAME]process-name スペースや小文字を含まないプロセス名。プロセス名にはワイルドカード文字(*)を含めることができる。
[%PROCESS_NAME] "process-name" スペースまたは小文字を含むプロセス名。二重引用符(")の代わりに，一重引用符を(')使用することもできる。
%PROCESS_PIDprocess_id プロセス識別子(PID，16 進数)。
[%PROCESS_NUMBER]process-number
(または %PROCprocess-number)		 デバッガの制御下に入ったときにプロセスに割り当てられた番号。新しい番号は，1 から順番に各プロセスに割り当てられる。EXIT コマンドまたは QUIT コマンドによってプロセスが終了しても，そのデバッグ・セッション中はその番号は再割り当てできる。プロセス番号は SHOW PROCESS コマンドの実行で表示される。プロセスは，組み込みシンボル %PREVIOUS_PROCESS および %NEXT_PROCESS によってインデックスづけできるように，循環リスト内に順序づけされる。
process-group-name DEFINE/PROCESS_GROUP コマンドで定義された，プロセスのグループを表すシンボル。
%NEXT_PROCESS デバッガの循環プロセス・リスト中で可視プロセスの次のプロセス。
%PREVIOUS_PROCESS デバッガの循環プロセス・リスト中で可視プロセスの前のプロセス。
%VISIBLE_PROCESS シンボル，レジスタ値，ルーチン呼び出し，ブレークポイントなどの検索時に現在のコンテキストになっているスタック，レジスタ・セット，およびイメージを持つプロセス。

すべてのプロセスを指定するためにワイルドカード文字のアスタリスク(*)または /ALL 修飾子を使用することもできます。/ALL または /DYNAMIC を指定する場合，プロセスは指定できません。プロセスを指定しないか，/ALL を /BRIEF，/FULL または /[NO]HOLD とともに指定しないと，可視プロセスが選択されます。

修飾子

/ALL

表示の対象としてデバッガが知っているプロセスすべてを選択します。

/BRIEF

(省略時の設定。)表示の対象として選択されたプロセス 1 つにつき 1 行だけの情報を表示します。

/DYNAMIC

動的プロセス設定が有効と無効のどちらになっているかを示します。動的プロセス設定は省略時の設定では有効になっていて，SET PROCESS/[NO]DYNAMIC コマンドで制御されます。

/FULL

表示の対象として選択されたプロセスごとに最大の情報を表示します。

/VISIBLE

(省略時の設定。)表示の対象として可視プロセスを選択します。

説明

SHOW PROCESS コマンドは指定されたプロセスとそれらのプロセスで実行中のイメージに関する情報を表示します。

SHOW PROCESS/FULL コマンドはベクタ型プロセッサの可用性と使用法に関する情報も表示します。この情報は，ベクタ命令を使用するプログラムをデバッグする場合に役立ちます。

プロセスはデバッガの制御下に置かれるとすぐ，まず SHOW PROCESS 表示に表示できます。プロセスは EXIT コマンドまたは QUIT コマンドによって終了されると，SHOW PROCESS コマンドを実行しても表示できなくなります。

省略時の設定(/BRIEF)では，次の情報も含め，1 つのプロセスにつき 1 行の情報が表示されます。

表 2-2 デバッグ状態
状態 説明
Activated イメージとそのプロセスがデバッガの制御下に置かれている。
Break
Break on branch
Break on call
Break on instruction
Break on lines
Break on modify of
Break on return
Exception break
Exception break preceding 		ブレークポイントが検出された。
Interrupted 実行が他のプロセスで中断されているためか，またはユーザが強制終了キー・シーケンス(省略時の設定では Ctrl/C)を使用してプログラムの実行に割り込みをかけたために実行がそのプロセスで割り込みをかけられた。
Step
Step on return 		コマンドが完了した。
Terminated 指示されたイメージは実行を終了したが，そのプロセスは依然としてデバッガの制御下にある。したがって，イメージとそのプロセスに関する情報を獲得できる。プロセスを終了するには，EXIT コマンドまたは QUIT コマンドを使用できる。
Trace
Trace on branch
Trace on call
Trace on instruction
Trace on lines
Trace on modify of
Trace on return
Exception trace
Exception trace preceding 		トレースポイントが検出された。
Unhandled exception 未処理例外が検出された。
Watch of ウォッチポイントが検出された。

SHOW PROCESS/FULL コマンドはプロセスに関する補足的な情報を表示します。(例を参照してください。)

関連コマンド

CONNECT
Ctrl/C
DEFINE/PROCESS_SET
EXIT
QUIT
SET PROCESS

例

#1 

all> SHOW PROCESS
 Number  Name             State      Current PC 
*    2 _WTA3:             break      SCREEN\%LINE 47
all>

省略時の設定では，SHOW PROCESS コマンドは左端の欄に可視プロセス(アスタリスク(*)で示される)に関する情報を 1 行表示します。可視プロセスはプロセス名として _WTA3: を持っています。_WTA3: はデバッガの制御下に置かれた 2 番目のプロセス(プロセス番号 2)です。このプロセスは凍結状態になっていて，イメージの実行は SCREEN モジュールの 47 行目のブレークポイントで中断されます。

#2 

all> SHOW PROCESS/FULL %PREVIOUS_PROCESS
Process number: 1                  Process name: JONES_1: 
                                   Visible process: NO 
Current PC: TEST_VALVES\%LINE 153 
State: interrupted 
PID: 20400885                      Owner PID: 00000000 
Current/Base priority:  5/4        Terminal: VTA79: 
 
Image name: USER$:[JONES.PROG1]TEST_VALVES.EXE;31 
 
Elapsed CPU time:   0 00:03:17.17  CPU Limit:         Infinite 
Buffered I/O Count:         14894  Remaining buffered I/O quota:       80 
Direct I/O Count:            6956  Remaining direct I/O quota:         40 
Open file count:                7  Remaining open file quota:          43 
Enqueue count:                200  Remaining enqueue quota:           198 
Vector capable:               Yes 
Vector consumer:              Yes  Vector CPU time:           00:00:00.00 
Fast Vector context switches:   0  Slow Vector context switches:        0 
Current working set size:    1102  Working set size quota:           1304 
Current working set extent: 12288  Maximum working set extent:      12288 
Peak working set size:       4955  Maximum authorized working set:   1304 
Current virtual size:         255  Peak virtual size:               16182 
Page faults:                41358 
 
Active ASTs:                       Remaining AST Quota:                27 
Event flags:    FF800000 60000003  Event flag wait mask:         7FFFFFFF
all>

SHOW PROCESS/FULL %PREVIOUS_PROCESS コマンドはプロセスの循環リスト中の前のプロセス(この場合にはプロセス番号 1)に関する最大レベルの情報を表示します。

#3 

all> SHOW PROCESS TEST_3
 Number  Name          State       Current PC 
     7 TEST_3          watch of TEST_3\ROUT4\COUNT 
                                       TEST_3\%LINE 54
all>

この SHOW PROCESS コマンドは TEST_3 プロセスに関する情報を 1 行表示します。イメージは変数 COUNT のウォッチポイントで中断されます。

#4 

all> SHOW PROCESS/DYNAMIC
Dynamic process setting is enabled
all>

このコマンドは動的プロセス設定が有効になることを表します。

SHOW RADIX

整数データの入力や表示のための現在の基数を示します。/OVERRIDE が指定された場合には，現在の上書き型の基数を示します。

形式

SHOW RADIX

修飾子

/OVERRIDE

現在の上書き型の基数を示します。

説明

デバッガは 2 進数，10 進数，16 進数，8 進数の 4 つの基数のどれか 1 つで整数データを解釈したり表示したりできます。整数データの入力や表示のための現在の基数は前回 SET RADIX コマンドで設定した基数です。

SET RADIX コマンドを入力していなかった場合，データの入力や表示のための省略時の基数はほとんどの言語の場合 10 進数です。VAX プロセッサでは，BLISS と MACRO-32 です。この 2 つの省略時の基数は 16 進数です。Alpha プロセッサでは，例外は BLISS と MACRO-32 と MACRO-64です。この 3 つの省略時の基数は 16 進数です。

すべてのデータの表示用の現在の上書き型の基数は前回 SET RADIX/OVERRIDE コマンドで設定した上書き型の基数になります。SET RADIX/OVERRIDE コマンドを入力していなかった場合，変更型の基数は "ありません"。

関連コマンド

DEPOSIT
EVALUATE
EXAMINE
(SET,CANCEL)RADIX

例

#1 

DBG> SHOW RADIX
input radix: decimal 
output radix: decimal
DBG>

このコマンドは入力基数と出力基数を 10 進数として表示します。

#2 

DBG> SET RADIX/OVERRIDE HEX
DBG> SHOW RADIX/OVERRIDE
output override radix: hexadecimal
DBG>

この例では，SET RADIX/OVERRIDE コマンドは上書き型の基数を 16 進数に設定し，SHOW RADIX/OVERRIDE コマンドは上書き型の基数を示します。これは，EXAMINE などのコマンドがすべてのデータを 16 進整数データとして表示することを意味します。

SHOW SCOPE

シンボル検索のための現在の有効範囲検索リストを示します。

形式

SHOW SCOPE

説明

現在の有効範囲検索リストは，デバッガ・コマンドにパス名接頭辞を付けずに指定されるシンボルの解釈に使用する(パス名またはその他の特殊文字で指定される)1 つまたは複数のプログラム記憶位置を指定します。

現在の有効範囲検索リストは前回 SET SCOPE コマンドで設定された有効範囲検索リストです。省略時の設定では，SET SCOPE コマンドが入力されていなかった場合，現在の有効範囲検索リストは 0,1,2,...,nになります。

省略時の有効範囲検索リストは，パス名接頭辞を持たないシンボルに対して，EXAMINE X のようなシンボル検索の場合，最初に現在実行中のルーチン(有効範囲 0)で X を検索し，そこで X が可視になっていなければ，そのルーチンの呼び出し元(有効範囲 1)を検索していくというように，呼び出しスタックを順々に検索していくことを指定します。有効範囲 n にも X が見つかれなければ，デバッガは実行時シンボル・テーブル(RST)の残り，つまり，設定されているすべてのモジュールと必要であればグローバル・シンボル・テーブル(GST)を検索します。

呼び出しスタックのルーチンを表現するために SET SCOPE コマンドに 10 進整数を使用した場合には，SHOW SCOPE コマンドは可能であれば，整数で表現されるルーチン名を表示します。

関連コマンド

(SET,CANCEL)SCOPE

例

#1 

DBG> CANCEL SCOPE
DBG> SHOW SCOPE
scope: 
 *  0 [ = EIGHTQUEENS\TRYCOL\REMOVEQUEEN ], 
    1 [ = EIGHTQUEENS\TRYCOL ], 
    2 [ = EIGHTQUEENS\TRYCOL 1 ], 
    3 [ = EIGHTQUEENS\TRYCOL 2 ], 
    4 [ = EIGHTQUEENS\TRYCOL 3 ], 
    5 [ = EIGHTQUEENS\TRYCOL 4 ], 
    6 [ = EIGHTQUEENS ]
DBG> SET SCOPE/CURRENT 2
DBG> SHOW SCOPE
scope: 
    0 [ = EIGHTQUEENS\TRYCOL\REMOVEQUEEN ], 
    1 [ = EIGHTQUEENS\TRYCOL ], 
 *  2 [ = EIGHTQUEENS\TRYCOL 1 ], 
    3 [ = EIGHTQUEENS\TRYCOL 2 ], 
    4 [ = EIGHTQUEENS\TRYCOL 3 ], 
    5 [ = EIGHTQUEENS\TRYCOL 4 ], 
    6 [ = EIGHTQUEENS ]
DBG>

CANCEL SCOPE コマンドは省略時の有効範囲検索リストを復元します。省略時の有効範囲検索リストは(最初の)SHOW SCOPE コマンドで表示されます。この例では，ルーチン TRYCOL への数回の再帰呼び出しのあと，実行は REMOVEQUEEN ルーチンで中断されます。アスタリスク(*)は有効範囲検索リストが有効範囲 0，つまり実行が中断されるルーチンの有効範囲で始まることを示します。

例の SET SCOPE/CURRENT コマンドは有効範囲検索リストの始まりを有効範囲 2 に再設定します。有効範囲 2 は実行が中断されるルーチンの呼び出し元の有効範囲です。(2 番目の)SHOW SCOPE コマンドの出力に付いているアスタリスクは有効範囲検索リストが今度は有効範囲 2 で始まることを表します。

#2 

DBG> SET SCOPE 0,STACKS\R2,SCREEN_IO,\
DBG> SHOW SCOPE
scope: 
    0, [= TEST ], 
    STACKS\R2, 
    SCREEN_IO, 
    \
DBG>

この例では，SET SCOPE コマンドはデバッガに次の有効範囲検索リストに従ってパス名接頭辞を持たないシンボルを検索するように指示します。最初に，デバッガは PC 範囲(0 で示され，モジュール TEST にある)を検索します。PC 範囲内に指定されたシンボルが見つからないと，次にモジュール STACKS のルーチン R2 を検索します。必要であれば，次にモジュール SCREEN_IO を検索し，最後に(グローバル有効範囲(\)で示される)グローバル・シンボル・テーブルを検索します。SHOW SCOPE コマンドはシンボル検索のための現在の有効範囲検索リストを示します。省略時の有効範囲検索リストが有効になっているか，または SET SCOPE/CURRENT コマンドを入力した場合を除き，SHOW SCOPE 表示にアスタリスクは示されません。

SHOW SEARCH

SEARCH コマンドに対して現在有効になっている省略時の修飾子(/ALL か /NEXT，/IDENTIFIER か /STRING)を示します。

形式

SHOW SEARCH

説明

SEARCH コマンドの省略時の修飾子は前回 SET SEARCH コマンドで設定された省略時の修飾子です。SET SEARCH コマンドを入力していなかった場合には，省略時の修飾子として /NEXT と /STRING が使用されます。

関連コマンド

SEARCH
(SET,SHOW)LANGUAGE
SET SEARCH

例


DBG> SHOW SEARCH
search settings: search for next occurrence, as a string
DBG> SET SEARCH IDENT
DBG> SHOW SEARCH
search settings: search for next occurrence, as an identifier
DBG> SET SEARCH ALL
DBG> SHOW SEARCH
search settings: search for all occurrences, as an identifier
DBG>

この例では，最初の SHOW SEARCH コマンドは SET SEARCH コマンドの省略時の設定を表示します。省略時の設定では，デバッガは指定文字列が次に現れる箇所を検索し，表示します。

2 番目の SHOW SEARCH コマンドは，デバッガが指定文字列の次に現れる箇所を検索するものの，その前後が現在の言語の識別子の一部になり得る文字に接していない場合だけその文字列を表示することを通知します。

3 番目の SHOW SEARCH コマンドはデバッガが指定文字列の現れる箇所すべてを検索するものの，その前後が現在の言語の識別子の一部になり得る文字に接していない場合だけそれらの文字列を表示することを通知します。

前へ 次へ 目次 索引