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

前へ 次へ 目次 索引

CANCEL TYPE/OVERRIDE

前回の SET TYPE/OVERRIDE コマンドで設定された変更型を上書きします。

形式

CANCEL TYPE/OVERRIDE

説明

CANCEL TYPE/OVERRIDE コマンドは現在の上書き型を "none"に設定します。その結果，コンパイラ生成型に対応するプログラム記憶位置はその型に従って解釈されます。

関連コマンド

DEPOSIT
EXAMINE
(SET,SHOW)EVENT_FACILITY
(SET,SHOW)TYPE/OVERRIDE

例


DBG> CANCEL TYPE/OVERRIDE

このコマンドは前回の SET TYPE/OVERRIDE コマンドの作用を取り消します。

CANCEL WATCH

ウォッチポイントを取り消します。

形式

CANCEL WATCH [address-expression[,...]]

パラメータ

address-expression

取り消すウォッチポイントを指定します。高級言語を使用する場合，これは通常変数の名前になります。ワイルドカード文字のアスタリスク(*)は使用できません。代わりに /ALL 修飾子を使用してください。/ALL を指定する場合は，アドレス式は指定できません。

修飾子

/ALL

すべてのウォッチポイントを取り消します。

説明

CANCEL WATCH コマンドの作用は SET WATCH コマンドの作用の反対です。SET WATCH コマンドで特定の記憶位置に設定されたウォッチポイントを取り消すには，CANCEL WATCH で同じ記憶位置を指定します。したがって，集合体全体に設定されたウォッチポイントを取り消すには，CANCEL WATCH コマンドでその集合体を指定します。集合体の 1 つの要素に設定されたウォッチポイントを取り消すには，CANCEL WATCH コマンドでその要素を指定します。

CANCEL ALL コマンドもすべてのウォッチポイントを取り消します。

ウォッチポイントを取り消す手間をかけずに，デバッガにそのウォッチポイントを無視させたい場合には，DEACTIVATE WATCH コマンドを使用してください。あとで，ACTIVATE WATCH を使用してそのウォッチポイントを有効にすることができます。

関連コマンド

(ACTIVATE,DEACTIVATE,SET,SHOW)WATCH
CANCEL ALL
(SET,SHOW,CANCEL)BREAK
(SET,SHOW,CANCEL)TRACE

例

#1 

DBG> CANCEL WATCH SUB2\TOTAL

このコマンドはモジュール SUB2 にある変数 TOTAL でのウォッチポイントを取り消します。

#2 

DBG> CANCEL WATCH/ALL

このコマンドはユーザが設定したすべてのウォッチポイントを取り消します。

CANCEL WINDOW

画面ウィンドウ定義を永久に削除します。

注意
このコマンドは，デバッガへの Compaq DECwindows Motif for OpenVMS ユーザ・インタフェースでは使用できません。

形式

CANCEL WINDOW [window-name[,...]]

パラメータ

window-name

取り消す画面ウィンドウ定義の名前を指定します。ワイルドカード文字のアスタリスク(*)は使用できません。代わりに /ALL 修飾子を使用してください。/ALL を指定する場合は，ウィンドウ定義の名前は指定できません。

修飾子

/ALL

すべての定義済みウィンドウ定義とユーザ定義ウィンドウ定義を取り消します。

説明

ウィンドウ定義を取り消すと，その名前は DISPLAY コマンドで使用できなくなります。CANCEL WINDOW コマンドは表示にはまったく影響を及ぼしません。

関連コマンド

(SHOW,CANCEL)DISPLAY
(SET,SHOW)WATCH

例


DBG> CANCEL WINDOW MIDDLE

このコマンドは画面ウィンドウ定義の MIDDLE を永久に削除します。

CONNECT

(保持デバッガのみ。)他のプロセスでデバッガによる制御を受けずに実行されているイメージに割り込みをかけ，そのプロセスをデバッガの制御下に置きます。パラメータを指定しないで CONNECT を使用すると，CONNECT はデバッガに接続されるのを待っている作成されたプロセスすべてをデバッガの制御下に置きます。

Alpha システムの場合，CONNECT コマンドは，Alpha オペレーティング・システムを稼動しているターゲット・システムを OpenVMS Alphaシステム・コード・デバッガの制御下に置きます。OpenVMS Alphaシステム・コード・デバッガは，OpenVMS デバッガから起動するカーネル・デバッガです。

CONNECT コマンドを使用して Alpha オペレーティング・システムをデバッグする場合は，このコマンドを実行する前に，『OpenVMS Alpha System Analysis Tools Manual』の "System Code Debugger" の章で説明されている指示を完了していなければなりません。これらの指示には，Alpha デバイス・ドライバの作成や，OpenVMS Alpha システム・コード・デバッガを起動するコマンドの設定などがあります。また，OpenVMS デバッガを DCL コマンドの DEBUG/KEEP で起動していなければなりません。

形式

CONNECT [process-spec]

CONNECT %NODE_NAME node-name

パラメータ

process-spec

割り込みをかけたいイメージが実行されているプロセスを指定します。指定するプロセスはデバッガが起動されたプロセスと同じ OpenVMS ジョブにあるものでなければなりません。次のいずれかの形式で指定します。

[%PROCESS_NAME] proc-name スペースや小文字を全く含まない OpenVMS プロセス名。プロセス名にはワイルドカード文字のアスタリスク(*)を含むこともできます。
[%PROCESS_NAME] " proc-name" スペースや小文字を含む OpenVMS プロセス名。二重引用符(")の代わりに一重引用符(')を使用することもできます。
%PROCESS_PID proc-id OpenVMS プロセス識別子(PID，16 進数)。

node-name

(Alpha のみ)Alpha オペレーティング・システムをデバッグするときは，接続先のマシン(Alpha オペレーティング・システムを稼動しているターゲット・マシン)のノード名を指定します。

修飾子

/PASSWORD="password"

(Alpha のみ)Alpha オペレーティング・システムをデバッグするときは，接続先のマシン(Alpha オペレーティング・システムを稼動しているターゲット・マシン)に対するパスワードを指定します。そのマシンに対してパスワードが設定されていなかった場合は，この修飾子を省略することができます。

/IMAGE_PATH="image-path"

(Alpha のみ)Alpha オペレーティング・システムをデバッグするときは，接続元のマシン(デバッガを実行しているホスト・マシン)に対するイメージ・パスを指定します。イメージ・パスは，システム・イメージの位置を指し示す論理名です。省略時の論理名は DBGHK$IMAGE_PATH: です。

説明

(保持デバッガのみ。)プロセスを指定するとき，CONNECT コマンドを使用すれば，指定するプロセスでデバッガによる制御を受けずに実行されているイメージに割り込みをかけ，そのプロセスをデバッガの制御下に置くことができます。このコマンドは，DCL コマンドの RUN/NODEBUG でデバッグ可能なイメージを実行している場合，またはプログラムがデバッガを起動しない LIB$SPAWN 実行時ライブラリ呼び出しを行う場合などに役立ちます。$CREPRC システム・サービス呼び出しで作成したプロセスには接続することはできません。

システムで実行中のデバッガのバージョンに応じて，ユーザは，ユーザが作成したプロセスとの接続に限定される場合もあり，また利用者識別コード(UIC)グループのメンバが作成したプロセスに接続することができる場合もあります。ときには，プロセスの作成前に SYSGEN SECURITY_POLICY パラメータを 8 に設定しなければならないことがあります。 表 2-1 は，デバッガの個々のバージョンに適用される制限事項の一覧表です。

表 2-1 プロセス作成の制限事項(デバッガのバージョン別)
デバッガのバージョン 接続可能なプロセス SYSGEN パラメータ設定の有無
VAX バージョン 5.5-2 以前，
Alpha バージョン 6.0 以前		 ユーザ自身が起動したプロセス なし
VAX バージョン 6.0 ユーザ自身が起動したプロセスと，UIC グループのメンバが起動したプロセス あり
VAX バージョン 6.1 以降，
Alpha バージョン 6.1 以降		 ユーザ自信が起動したプロセスと，UIC グループのメンバが起動したプロセス なし

デバッガ論理名(JSY$DEBUG, JSY$DEBUGSHR, JSY$DEBUGUISHR, JSY$DBGTBKMSG, DBG$PROCESS, JSY$DBG_HELP, JSY$DBG_UIHELP, DEBUGAPPCLASS, JSY$VMSDEBUGUIL)がある場合，デバッガおよびターゲット・プロセスの両方で同一の定義に変換しなければなりません。

/DEBUG 修飾子付きでコンパイルおよびリンクしておかなければなりません。このイメージは，/NOTRACEBACK 修飾子付きでリンクしておくことはできません。

プロセスがデバッガの制御下に置かれたとき，イメージの実行は割り込みをかけられた時点で中断されます。

プロセスを指定しないと，CONNECT コマンドはデバッグ・セッションに接続されるのを待っているプロセスすべてをデバッガの制御下に置きます。待機中のプロセスがない場合には，Ctrl/C を押せば CONNECT コマンドを強制終了することができます。

省略時の設定では，プロセスがデバッガの制御下に置かれると，トレースポイントが検出されます。この定義済みトレースポイントは SET TRACE/ACTIVATING コマンドを入力した結果生じるものと同じです。デバッガの制御下に置かれたプロセスはデバッガによって認識されるようになり，SHOW PROCESS コマンドで表示できるようになります。

CONNECT コマンドを使用して，デバッガの制御下にあるプロセスのサブプロセスに接続することはできません。そのようなサブプロセスに接続するには，SET PROCESS コマンドを使用してください。

CONNECT コマンドを使用した Alpha オペレーティング・システムのデバッグ(Alpha のみ)

CONNECT コマンドを使用して OpenVMS Alpha System-Code Debugger(SCD)で，Alpha オペレーティング・システム・コードをデバッグできます。通常，タイムシェアリング(ホスト)Alpha マシン(SCD が実行中の)からこのコマンドを実行して，スタンドアロンの(ターゲット)Alpha マシン(Alpha オペレーティング・システムが実行中の)に接続します。この 2 台のマシンの通信は，イーサネット・ネットワークを通じて行います。

注意
接続先のマシンで SCD に対して使用されるポートはまったく構成されないため，DECnet や LAT，ユーザ・アプリケーションなどの他の目的で使用することはできません。したがって，SCD を使用しているときに DECnet を使用したり，クラスタ内で動作するには，そのトラフィックに対して別のイーサネット・ポートが必要です。

場合によっては，ロバスト性の低い Delta/XDelta デバッガを使用してオペレーティング・システム・コードをデバッグしなければならないこともあります。たとえば，次のような場合です。

ただし，一般的には OpenVMS AXP システム・コード・デバッガの方が Alpha オペレーティング・システム・コードのデバッグによく使用されます。このデバッガの使用方法の詳細については，『OpenVMS Alpha System Analysis Tools Manual』を参照してください。

関連コマンド

DISCONNECT
Ctrl/Y
(SET,SHOW,CANCEL)TRACE

例

#1 

DBG_1> CONNECT

このコマンドはデバッガに接続されるのを待っているプロセスをすべてデバッガの制御下に置きます。

#2 

DBG_1> CONNECT JONES_3

このコマンドは JONES_3 というプロセスで実行されているイメージに割り込みをかけ，そのプロセスをデバッガの制御下に置きます。JONES_3 プロセスはデバッガが起動されたプロセスと同じ UIC グループになければなりません。また，イメージは /NOTRACEBACK 修飾子でリンクされていたものであってはなりません。

#3 

DBG> CONNECT %NODE_NAME SCDTST /PASSWORD="eager_beaver"
%DEBUG-I-NOLOCALS, image does not contain local symbols
DBG>

Alpha システムの場合，この CONNECT コマンドは，Alpha オペレーティング・システム・コードを実行しているターゲット・システムをデバッガの制御下に置きます。この例では，Alpha ターゲット・マシン(オペレーティング・システム側)のノード名に SCDTST を，パスワードに eager_beaver を指定しています。Alpha ホスト・マシン(デバッガ側)のイメージ・パスは省略時の DBGHK$IMAGE_PATH: です。

Ctrl/C

デバッグ・セッション中に入力された場合，Ctrl/C はデバッグ・セッションを中断せずに，デバッガ・コマンドの実行を強制終了するか，プログラムの実行を中断します。

注意
デバッグ・セッション中は Ctrl/Y は使用できません。

形式

[Ctrl/C]

説明

Ctrl/C を押せば，デバッグ・セッションを中断せずに，デバッガ・コマンドの実行を強制終了するか，プログラムの実行を中断できます。この機能は，たとえばプログラムがブレークポイントのない無限ループを実行している場合や，完了するまでに長い時間を要するデバッガ・コマンドを強制終了したい場合に役立ちます。Ctrl/C を押すと，デバッガ・プロンプトが表示され，デバッガ・コマンドを入力できる状態になります。

プログラムがすでに Ctrl/C AST サービス・ルーチンを使用可能にしている場合には，SET ABORT_KEY コマンドを使用して，デバッガの強制終了機能を他の Ctrl キー・シーケンスに割り当てます。ただし，多くのCtrl キー・シーケンスの機能が定義済みであり，SET ABORT_KEY コマンドを使用すれば，そのような定義も上書きできることに注意してください(『OpenVMS ユーザーズ・マニュアル』を参照)。オペレーティング・システムによって使用されていない Ctrl キー文字としては，G，K，N，P があります。

プログラムが Ctrl/C AST サービス・ルーチンを使用可能に していない 場合，デバッガの強制終了機能を他の Ctrl キー・シーケンスに割り当てると，Ctrl/C は Ctrl/Y と同じように動作します。つまり，デバッグ・セッションに割り込みをかけ，DCL レベルに戻します。

デバッグ・セション中には Ctrl/Y は使用できません。代わりに Ctrl/C を使用するか，SET ABORT_KEY コマンドで設定した同等の Ctrl キー・シーケンスを使用してください。

SPAWN コマンドと ATTACH コマンドを使用すれば，デバッグ・コンテキストを失わずに，デバッグ・セッションから移行したり，デバッグ・セッションに戻ったりすることができます。

関連コマンド

ATTACH
Ctrl/Y
(SET,SHOW)ABORT_KEY
SPAWN

例


DBG> GO
    ...
    [Ctrl/C]
DBG> EXAMINE/BYTE 1000:101000  !should have typed 1000:1010
1000: 0 
1004: 0 
1008: 0 
1012: 0 
1016: 0
    [Ctrl/C]
%DEBUG-W-ABORTED, command aborted by user request
DBG>

この例は，Ctrl/C を使用して，プログラム実行を中断し，デバッガ・コマンドの実行を強制終了する方法を示しています。

Ctrl/W

Ctrl/W は(DISPLAY/REFRESH と同様に)画面モードで画面を再表示します。

形式

[Ctrl/W]

説明

Ctrl/W についての詳しい説明は，DISPLAY コマンドの /REFRESH 修飾子の項目を参照してください。

前へ 次へ 目次 索引