1.3.1 保持デバッガの起動 |
 |
この項では，DCL レベル ($) から保持デバッガを起動して，そのあとでプログラムをデバッガの制御下に置く方法について説明します。その他の起動方法については， 第 1.6 節 および
第 1.7 節 で説明します。
第 1.3.3 項 で説明する再実行機能と 第 1.3.4 項 の実行機能を使用するには，ここで説明する方法に従って保持デバッガを起動してください。
 | 注意
次の問題点または制限事項は保持デバッガ固有のものです。
|
保持デバッガを起動して，プログラムをデバッガの制御下に置くには，次の手順に従ってください。
- 第 1.2 節 の説明どおりにプログラムをコンパイルおよびリンクしたことを確認する。
- 次のコマンド行を入力する。
デバッガが起動するとそのバナーが表示され，ユーザ定義の初期化ファイルが実行される (
第 13.2 節 を参照 )。表示された DBG> プロンプトは， 第 2.1 節 で説明する方法でデバッガ・コマンドを入力できるようになったことを示す。
- デバッガの RUN コマンドを使用してユーザ・プログラムをデバッガの制御下に置く。RUN コマンドには，ユーザ・プログラムの実行可能なイメージをパラメータとして指定する。次に例を示す。
DBG> RUN FORMS
%DEBUG-I-INITIAL,Language: C, Module: FORMS
DBG>
|
表示されているメッセージは，このデバッガ・セッションがCプログラム用に初期化されており，メイン・プログラム単位(イメージ転送アドレスを持ったモジュール)の名前がFORMSであることを示しています。初期化によって言語固有のデバッガ・パラメータが設定されます。これらのパラメータは，デバッガが名前や式を解析する方法や，デバッガの出力の書式などを制御します。言語固有のパラメータについての詳しい説明は， 第 4.1.9 項 を参照してください。
メイン・プログラム・ユニットを起動するときや，特定のプログラムで何らかの初期化コードを起動するときに，(一時的なブレークポイントを設定することにより) デバッガはプログラムの実行を中断します。その場合，デバッガは次のメッセージを表示します。
%DEBUG-I-NOTATMAIN, Type GO to reach main program
|
これらのプログラム ( たとえば Ada プログラム ) では，一時的なブレークポイントで完全なシンボル情報を使用して，初期化コードをデバッグすることができます。詳細については， 第 14.3 節 を参照してください。
第 2 章 で説明されているように，これでプログラムをデバッグすることができます。
◆引数が必要なプログラムのRUNおよびRERUNコマンド・オプション
プログラムによっては，引数が必要なものもあります。この節では，デバッガの RUN コマンドと RERUN コマンドの使用方法，および /ARGUMENTS 修飾子と /COMMAND 修飾子でデバッガ制御を行う場合に，このようなプログラムを実行する方法について説明します。
保持デバッガでデバッガを起動した後，RUN コマンドにイメージ名を入力するか，または RUN/COMMAND コマンドと DCL フォーリン・コマンドを使用して，デバッグするイメージを指定できます。DCL フォーリン・コマンドを指定するには，RUN コマンドの /COMMAND 修飾子を使用します。
RUN コマンドと RERUN コマンドの /ARGUMENTS 修飾子には，引数リストを指定できます。
次のデバッガ・セッションの例には，複数の方法が示されています。デバッグするプログラムは
echoargs.c であり，入力引数を端末に表示するプログラムです。
#include <stdio.h>
main(int argc, char *argv[])
{
int i;
for (i = 0; i < argc; i++)
printf("%s\n", argv[i]);
}
|
このプログラムを，次のようにコンパイル，リンクします。
$ cc/debug/noopt echoargs.c
$ link/debug echoargs
|
DCLフォーリン・コマンドは，次のように定義します。
$ ECHO == "$ sys$disk:[]echoargs.exe"
|
保持デバッガを起動します。次の例のデバッガ・セッションでは，引数を渡す方法として 3 種類の方法を紹介しています。
- /COMMANDと/ARGUMENTSをRUNに指定
- /ARGUMENTSをRERUNに指定
- /ARGUMENTSとイメージ名をRUNに指定
◆/COMMAND と /ARGUMENTS を指定した RUN
デバッガ・セッションのこのセクションでは，デバッガの RUN コマンドに /COMMAND 修飾子と /ARGUMENTS 修飾子を指定する方法について説明します。
/COMMAND 修飾子は，DCL フォーリン・コマンド
echo を指定します。/ARGUMENTS 修飾子は引数 fa sol la mi を指定します。最初の GO コマンドは
echoargs.exe の初期化コードを実行します。その後，デバッガはプログラムの起動時に一時的なブレークポイントでプログラムの実行を中断します。2 番目の GO コマンドは
echoargs.exe を実行します。これは引数を画面に正しく表示します。
$ DEBUG/KEEP
Debugger Banner and Version Number
DBG> RUN/COMMAND="echo"/ARGUMENTS="fa sol la mi"
%DEBUG-I-NOTATMAIN,Language: C, Module: ECHOARGS
%DEBUG-I-NOTATMAIN,Type GO to reach main program
DBG> GO
break at routine ECHOARGS\main
1602: for (i = 0; i < argc; i++)
DBG> GO
_dsa1:[jones.test]echoargs.exe;2
fa
sol
la
mi
%DEBUG-I-EXITSTATUS,is '%SYSTEM-S-NORMAL, Normal successful completion'
|
◆/ARGUMENTS を指定した RERUN
デバッガ・セッションのこのセクションでは，RERUN コマンドの /ARGUMENTS 修飾子を使用して，新しい引数 fee fii foo fum によって同じイメージを再実行する方法を示します (/ARGUMENTS 修飾子を指定しなかった場合には，デバッガは前に使用した引数を使用してプログラムを再実行します)。
最初の GO コマンドは echoargs.exe の初期化コードを実行します。そのあと，デバッガはプログラムの起動時に一時的なブレークポイントでプログラムの実行を中断します。 2 番目の GO コマンドは echoargs.exe を実行します。これは引数を画面に正しく表示します。
DBG> RERUN/ARGUMENTS="fee fii foo fum"
%DEBUG-I-NOTATMAIN,Language: C, Module: ECHOARGS
%DEBUG-I-NOTATMAIN,Type GO to reach main program
DBG> GO
break at routine ECHOARGS\main
1602: for (i = 0; i < argc; i++)
DBG> GO
_dsa1:[jones.test]echoargs.exe;2
fee
fii
foo
fum
%DEBUG-I-EXITSTATUS,is '%SYSTEM-S-NORMAL, Normal successful completion'
|
◆/ARGUMENTS とイメージ名を指定した RUN
デバッガ・セッションのこのセクションでは，RUN コマンドを使用して echoargs の新しいイメージを起動し，/ARGUMENTS 修飾子を使用して引数 a b c を指定します。
最初の GO コマンドは echoargs.exe の初期化コードを実行します。そのあと，デバッガはプログラムの起動時に一時的なブレークポイントでプログラムの実行を中断します。 2 番目の GO コマンドは echoargs.exe を実行します。これは引数を画面に正しく表示します。
DBG> RUN/ARGUMENTS="a b c" echoargs
%DEBUG-I-NOTATMAIN,Language: C, Module: ECHOARGS
%DEBUG-I-NOTATMAIN,Type GO to reach main program
DBG> GO
break at routine ECHOARGS\main
1602: for (i = 0; i < argc; i++)
DBG> GO
_dsa1:[jones.test]echoargs.exe;2
a
b
c
%DEBUG-I-EXITSTATUS,is '%SYSTEM-S-NORMAL, Normal successful completion'
DBG> quit
|
◆RUNコマンドの制限事項
デバッガのRUNコマンドについては，次の制限事項に注意してください。
- RUN コマンドを使用できるのは，DCL の DEBUG/KEEP コマンドを使用してデバッガを起動した場合のみです。
- 実行中のプログラムにデバッガを接続するために RUN コマンドを使用することはできません (
第 1.7 節 を参照 )。
- デバッガ・クライアント/サーバ・インタフェースを使用しないと，ネットワーク・リンクを通してデバッガの制御下でプログラムを実行することはできません。デバッガ・クライアント/サーバ・インタフェースの使用についての詳細は， 第 9.9 節 および
第 11 章 を参照してください。
1.3.2 プログラム実行の終了 |
|
デバッガ・セッション中にプログラムの実行が正常に終了すると，次のメッセージが表示されます。
%DEBUG-I-EXITSTATUS,is '%SYSTEM-S-NORMAL, Normal successful completion')
|
このときユーザには次のオプションがあります。
- 同じデバッガ・セッションからプログラムを再実行することができる ( 第 1.3.3 項 を参照)。
- 同じデバッガ・セッションから他のプログラムを実行することができる ( 第 1.3.4 項 を参照)。
- デバッガ・セッションを終了することができる(
第 1.8 節 を参照)。
