HP OpenVMS デバッガ・コマンド・ディクショナリ
第 1 章 デバッガ・コマンド・ディクショナリ概要
デバッガ・コマンド・ディクショナリには,すべてのデバッガ・コマンドに関する詳細情報があります。その構成は次のとおりです。
- 「 第 1.2 節 」では,デバッガ・コマンドを入力する方法を説明します。
- 「 第 1.3 節 」では,デバッガの HP DECwindows Motif for OpenVMS ユーザ・インタフェースのコマンド/メッセージ入力ビューで使用不可能なコマンドの一覧を示します。
- 「 第 1.4 節 」には,デバッガ診断メッセージに関する一般的な情報を示します。
- 「 第 1.5 節 」には,デバッガ・コマンドに関する詳しい参考情報があります。
デバッガ・コマンドはキーボードで会話形式で入力するか,または実行プロシージャ (@) コマンドにより,あとで実行されるコマンド・プロシージャの中に保存することができます。
この節では次の情報について記述します。
- デバッガ・コマンドの一般形式
- キーボードで会話形式でコマンドを入力するための規則
- デバッガ・コマンド・プロシージャにコマンドを入力するための規則
1.2.1 一般形式 | |
コマンド文字列 はデバッガ・コマンドの完全な指定です。 1 つのコマンドを 2 行以上に続けることもできますが,コマンド文字列という用語はデバッガに渡されるコマンド全体を定義する際に使用されます。
デバッガ・コマンド文字列は動詞で構成され,パラメータと修飾子が付くこともあります。
動詞は実行の対象となるコマンドを指定します。デバッガ・コマンド文字列の中には,次の例のように 1 つの動詞だけか,1 対の動詞だけで構成されるものもあります。
パラメータは指定された動詞が作用する対象 ( たとえばファイル指定 ) を指定します。修飾子は動詞による処理を記述または変更するものです。コマンド文字列によっては,パラメータまたは修飾子を 1 つまたは複数入れられるものがあります。次の例では,COUNT,I,J,K,OUT2,PROG4.COM はパラメータで (@ は実行プロシージャ・コマンド ),/SCROLL と /OUTPUT が修飾子です。
DBG> SET WATCH COUNT
DBG> EXAMINE I,J,K
DBG> SELECT/SCROLL/OUTPUT OUT2
DBG> @PROG4.COM
|
コマンドの中には,省略可能な WHEN 句または DO 句を受け付けるものもあります。DO 句はある種の画面表示定義の中でも使用されます。
WHEN 句の構成はキーワードの WHEN を記述し,続いて現在の言語で評価結果が真か偽かになる条件式を ( 括弧で囲んで ) 指定します。 DO 句の構成はキーワードの DO を記述し,続いて 1 つまたは複数の ( 括弧で囲まれた ) コマンド文字列を指定します。これらのコマンドは指定した順に実行されます。複数のコマンド文字列があるときは,それぞれをセミコロン (;) で区切らなければなりません。これらの点について次の例で説明します。
次のコマンド文字列は SWAP というルーチンにブレークポイントを設定します。実行時に J の値が 4 になるといつでもブレークポイントが検出されます。ブレークポイントが検出されると,デバッガは指示された順番で 2 つのコマンド,SHOW CALLS と EXAMINE I,K を実行します。
DBG> SET BREAK SWAP WHEN (J = 4) DO (SHOW CALLS; EXAMINE I,K)
|
デバッガは DO 句の実行時に DO 句の中のコマンドの構文を調べます。 DO 句の中でコマンドをネストできます。
1.2.2 会話形式入力の規則 | |
キーボードで会話形式でコマンドを入力するとき,すべてのデバッガ・キーワード群にわたって固有であるために最低必要な文字数までキーワード ( 動詞,修飾子,パラメータ ) を短縮できます。ただし,よく使用されるコマンドのいくつか ( たとえば EXAMINE,DEPOSIT,GO,STEP) は最初の文字だけに短縮できます。また,固有でない短縮形でもデバッガが状況に基づいて正しく解釈できる場合もあります。
Return キーを押すと,現在の行が終了し,デバッガはその行を処理します。長いコマンド文字列を次の行に続けるには,Return キーを押す前にハイフン (-) を入力します。こうすると,デバッガ・プロンプトにはアンダスコア文字 (_DBG>) が接頭辞として付き,まだコマンド文字列の入力中であることを示します。
各コマンド文字列をセミコロン (;) で区切ることにより, 1 行に複数のコマンド文字列を入力できます。
コメント ( デバッガ・ログ・ファイルには記録されているが,その他の点ではデバッガから無視される説明文 ) を入力するには,入力するコメント・テキストの前に感嘆符 (!)を入れます。コメントが次の行に続く場合には,新しい行を感嘆符で始めてください。
DCL プロンプト ($) が表示された状態で使用できるコマンド行編集機能は,上向き矢印キーと下向き矢印キーによるコマンドの再呼び出しも含めて,デバッガ・プロンプト (DBG>) が表示された状態でも使用できます。たとえば,左向き矢印キーを押すとカーソルが左に 1 文字移動し,右向き矢印キーを押すと右に 1 文字移動します。 Ctrl/H を押すとカーソルは行頭に移動し,Ctrl/E を押すと行末に移動します。 Ctrl/U を押すと,カーソルの左側にある文字がすべて削除されます。
デバッガで処理中のコマンドに割り込みをかけるには,Ctrl/C を押します。 Ctrl/C コマンドを参照してください。
1.2.3 コマンド・プロシージャでのコマンド入力 | |
コマンドを読みやすくするために,コマンド・プロシージャの中ではコマンド・キーワードを短縮しないでください。将来のリリースでの潜在的な矛盾を避けるために,コマンド・キーワードを ( 否定の /NO... を数えずに ) 有意文字 3 文字以下に短縮しないでください。
デバッガ・コマンド行は左マージンから始めます。 (DCL コマンド・プロシージャを記述するときのように,ドル記号 ($) でコマンド行を始めないでください。)
新しい行を開始すると以前のコマンド行が終結します ( ファイルの終端文字によっても以前のコマンド行は終結します )。コマンド文字列を次の行に続けるには,新しい行を開始する前にハイフン (-) を入力してください。
セミコロン (;) で各コマンド文字列を区切ることにより, 1 行に複数のコマンド文字列を入力できます。
コメント ( コマンド・プロシージャの実行には影響しない説明文 ) を入力するには,入力するコメント・テキストの前に感嘆符 (!) を入れます。コメントが次の行に続く場合には,新しい行を感嘆符で始めてください。
次のコマンドは,デバッガへの HP DECwindows Motif for OpenVMS ユーザ・インタフェースでは使用できません。このうちの多くはコマンド・インタフェースの画面モードにだけ関係があります。
ATTACH
|
SELECT
|
CANCEL MODE
|
(SET,SHOW) ABORT_KEY
|
CANCEL WINDOW
|
(SET,SHOW) KEY
|
DEFINE/KEY
|
(SET,SHOW) MARGINS
|
DELETE/KEY
|
SET MODE [NO]KEYPAD
|
DISPLAY
|
SET MODE [NO]SCREEN
|
EXAMINE/SOURCE
|
SET MODE [NO]SCROLL
|
EXPAND
|
SET OUTPUT [NO]TERMINAL
|
EXTRACT
|
(SET,SHOW) TERMINAL
|
HELP
1
|
(SET,SHOW) WINDOW
|
MOVE
|
(SHOW,CANCEL) DISPLAY
|
SAVE
|
SHOW SELECT
|
SCROLL
|
SPAWN
|
1コマンドに関するヘルプはデバッガ・ウィンドウのHelpメニューから入手できます。
コマンド・プロンプトに対して上記の使用できないコマンドを入力しようとした場合,またはデバッガが上記のコマンドのうちのどれか 1 つでも含むコマンド・プロシージャを実行すると,デバッガはエラー・メッセージを発行します。
MONITOR コマンドは HP DECwindows Motif for OpenVMS ユーザ・インタフェースでだけ作用します ( このコマンドはモニタ・ビューを使用するためです )。
次の例でデバッガ診断メッセージの要素を示します。
%DEBUG-W-NOSYMBOL, symbol 'X' is not in the symbol table
(1) (2) (3) (4)
|
- ファシリティ名 (DEBUG)。
- 重大度 (この例では W)。
- メッセージ識別子 ( この例では NOSYMBOL)。メッセージ識別子はメッセージ文の短縮形になっている。
- メッセージ文。
識別子を使用すれば,デバッガのオンライン・ヘルプから診断メッセージの説明を ( 必要ならそのメッセージに対するアクションも ) 見つけられます。
デバッガ・メッセージについてのオンライン・ヘルプを獲得するには,次のコマンド形式を使用します。
HELP MESSAGES message-identifier
|
診断メッセージの重大度として考えられるものは次のとおりです。
S (正常終了)
I (情報)
W (警告)
E (エラー)
F (回復不可能,または重大なエラー)
正常終了メッセージと情報メッセージは,デバッガが要求を実行したことをユーザに通知します。
警告メッセージは,要求の一部しか実行しなかったため結果を調べる必要があるということを通知します。
エラー・メッセージは,デバッガが要求を実行できなかったが,デバッグ・セッションの状態は変更されなかったことを示します。ただし,メッセージ識別子が DBGERR または INTERR だった場合は例外です。これらの識別子は内部デバッガ・エラーを意味するため,その場合には弊社のサポート要員にご連絡ください。
回復不可能なエラー・メッセージは,デバッガが要求を実行できなかったことと,デバッグ・セッションが不確定な状態になって,その状態からユーザが抜け出せないかもしれないということを示します。通常,このエラーが発生するとデバッグ・セッションは終了します。
デバッガ・コマンド・ディクショナリはデバッガ・コマンドの 1 つ 1 つを詳しく説明します。コマンドはアルファベット順に並んでいます。各コマンドごとに説明,形式,パラメータ,修飾子,例を示します。ドキュメントの表記法については,本書のまえがきを参照してください。
|