Debug-Kommandoübersicht und -syntax

Dieser Abschnitt beschreibt alle Debugger-Kommandos, mit denen Sie Debugging-Funktionen per Direktaufruf ausführen oder in Debugger-Bildschirmen navigieren können.

Eine Erklärung komplexerer Kommandostrukturen mit benutzerdefinierten Operanden finden Sie im Abschnitt Syntax-Diagramme weiter unten.

Dieser Abschnitt behandelt folgende Themen:


Alle Debug-Kommandos

Die in der folgenden Tabelle aufgelisteten Kommandos können in der Kommandozeile eines beliebigen Debugger-Bildschirms eingegeben werden. Ein unterstrichener Teil eines Debug-Kommandos oder -Unterkommandos stellt dessen minimale Abkürzung dar.

Kommando Unterkommando(s) Erklärung
-    In einer Liste eine Seite nach oben blättern.
--   An den Anfang einer Liste blättern.
TOP
+   In einer Liste eine Seite nach unten blättern
++    An das Ende einer Liste blättern.
BOTTOM
ACTIVATE

(Syntax siehe unten)

BREAKPOINT

oder

BP

Breakpoints aktivieren, siehe Breakpoints verwalten - Menü: Breakpoint Maintenance.
SPY Breakpoints und Watchpoints aktivieren, siehe auch Spy aktivieren in Debug-Einträge verwalten - Menü: Spy Maintenance.
WATCHPOINT

oder

WP

Watchpoints aktivieren, siehe Watchpoints verwalten - Menü: Watchpoint Maintenance.
BM   Menü Breakpoint Maintenance aufrufen, siehe Breakpoints verwalten - Menü: Breakpoint Maintenance.
BREAK    Fenster Debug Break anzeigen, siehe auch BREAK in Kommandos zum Navigieren und Anzeigen von Informationen.
CANCEL    Aktuelle Operation abbrechen und/oder Bildschirme ohne Speicherung der Änderungen verlassen.
DBLOG A

oder

Q

oder

D

Utility DBLOG aus dem Debugger heraus aufrufen (siehe Utilities-Dokumentation).

Um eine Datenbankumgebung anzugeben, können Sie eines der folgenden Unterkommandos benutzen:

  • A = Adabas (Standardeinstellung)

  • Q = SQL

  • D = DL/I

Anmerkung:
Während einer Debug-Unterbrechung können Sie nur eines der oben genannten Unterkommandos angeben.

DEACTIVATE

oder

DA

(Syntax siehe unten)

BREAKPOINT

oder

BP

Breakpoint deaktivieren, siehe Breakpoints verwalten - Menü: Breakpoint Maintenance.
SPY Breakpoints und Watchpoints deaktivieren, siehe auch Spy deaktivieren.
WATCHPOINT

oder

WP

Watchpoint deaktivieren, siehe auch Watchpoints verwalten - Menü: Watchpoint Maintenance.
DELETE

(Syntax siehe unten)

BREAKPOINT

oder

BP

Breakpoint löschen, siehe auch Breakpoints verwalten - Menü: Breakpoint Maintenance.
SPY Breakpoints und Watchpoints löschen, siehe auch Spy löschen.
WATCHPOINT

oder

WP

Watchpoint löschen, siehe Watchpoint Maintenance (Verwaltung der Watchpoints).
ENVIRONMENT Angegebene Debug-Umgebung löschen, siehe auch Debug-Umgebung löschen.
DISPLAY

(Syntax siehe unten)

BREAKPOINT

oder

BP

Breakpoint anzeigen, siehe Breakpoints verwalten - Menü: Breakpoint Maintenance.
SPY Breakpoints und Watchpoints anzeigen, siehe auch Spy anzeigen.
WATCHPOINT

oder

WP

Watchpoint anzeigen, siehe Watchpoint Maintenance (Verwaltung der Watchpoints).
CALL Statistiken anzeigen zu Natural-Objekten, die während der Ausführung einer Operation aufgerufen worden sind, siehe auch Aufgerufene Objekte anzeigen.
EXEC Statistiken anzeigen zu ausgeführten Statement-Zeilen von aufgerufenen Natural-Objekten, siehe auch Nur die ausgeführten Statement-Zeilen anzeigen.
HEXADECIMAL Inhalt von Variablen in hexadezimalem Format anzeigen.
NOCALL Statistiken anzeigen zu Natural-Objekten, die während der Ausführung einer Operation nicht aufgerufen worden sind, siehe auch Nicht aufgerufene Objekte anzeigen.
NOEXEC Statistiken anzeigen zu nicht ausgeführten Statement-Zeilen von aufgerufenen Natural-Objekten, siehe auch Nur die nicht ausgeführten Statement-Zeilen anzeigen.
OBJECT Statistiken anzeigen zur Aufrufhäufigkeit von Objekten, siehe auch Alle Objekte anzeigen.
STATEMENT Statistiken anzeigen zu ausgeführten und nicht ausgeführten Statement-Zeilen von aufgerufenen Natural-Objekten, siehe Alle Statement-Zeilen anzeigen .
VARIABLE Variablen anzeigen für unterbrochene Natural-Objekte, siehe Variablen verwalten - Funktion: Variable Maintenance.
XSTATISTICS Statistik-Zusammenfassung von Ausführungsstatistiken anzeigen, siehe auch Statement-Ausführungsstatistiken anzeigen.
EM   Menü Debug Environment Maintenance aufrufen, siehe Debug-Umgebung verwalten - Menü: Debug Environment Maintenance.
ESCAPE BOTTOM Verarbeitung einer Schleife stoppen und Verarbeitung mit dem ersten Statement nach der Schleife fortsetzen, siehe ESCAPE BOTTOM in Kommandos zur Ausführungssteuerung.
ROUTINE Verarbeitung eines unterbrochenen Natural-Objekts stoppen und, falls vorhanden, mit einem anderen Objekt fortsetzen, siehe ESCAPE ROUTINE in Kommandos zur Ausführungssteuerung.
EXIT    Aktuellen Bildschirm verlassen, siehe EXIT in Kommandos zur Ausführungssteuerung.
FLIP    Anzeige der beiden PF-Tastenreihen umschalten (PF1 bis PF12 und PF13 bis PF24).
GO    Rückgabe der Steuerung an die Ausführung des unterbrochenen Natural-Objekts, siehe GO in Kommandos zur Ausführungssteuerung.
LAST    Zuletzt eingegebenes Kommando anzeige. Die drei letzten Kommandos werden gespeichert und können abgerufen werden.
LEFT    Zur linken Seite einer Quellcode-Auflistung verschieben.
LIST

(Syntax siehe unten)

   Quellcode eines Objekts anzeigen.
BREAK Quellcode eines Objekts mit der aktuellen Unterbrechung anzeigen. Die relevante Statement-Zeile wird hervorgehoben.
LASTLINE Quellcode eines Objekts mit der letzten Zeile anzeigen, die vor der aktuellen Unterbrechung ausgeführt wurde.
LOAD

(Syntax siehe unten)

ENVIRONMENT Angegebene Debug-Umgebung laden, siehe Debug-Umgebung laden.
MENU    Hauptmenü Debug Main Menu aufrufen.
MODIFY

(Syntax siehe unten)

BREAKPOINT

oder

BP

Breakpoint ändern, siehe Breakpoints verwalten - Menü: Breakpoint Maintenance.
SPY Bildschirm Modify Breakpoint oder Modify Watchpoint aufrufen, siehe auch Debug-Einträge (Spies) ändern in Debug-Einträge verwalten - Menü: Spy Maintenance.
WATCHPOINT

oder

WP

Watchpoint ändern, siehe Watchpoint Maintenance (Verwaltung der Watchpoints).
HEXADECIMAL Inhalt von Variablen in hexadezimalem Format ändern.
VARIABLE Bildschirm Display Variable zwecks Änderung aufrufen, siehe Variable ändern.
NEXT    Nächstes, für einen Breakpoint oder Watchpoint angegebenes Kommando ausführen.
OBJCHAIN   Ausgeführte Objekte auf verschiedenen Programmebenen anzeigen, siehe OBJCHAIN in Kommandos zum Navigieren und Anzeigen von Informationen.
ON

oder

OFF

   Test-Modus ein- und ausschalten, siehe auch Test-Modus ein- und ausschalten.
PRINT

(Syntax siehe unten)

CALL Statistiken drucken zu Natural-Objekten, die während der Ausführung einer Anwendung aufgerufen wurden, siehe auch Aufgerufene Objekte anzeigen.
EXEC Statistiken drucken zu ausgeführten Statement-Zeilen von aufgerufenen Natural-Objekten, siehe auch Nur die ausgeführten Statement-Zeilen anzeigen.
NOCALL Statistiken drucken zu Natural-Objekten, die während der Ausführung einer Anwendung nicht aufgerufen wurden, siehe auch Nicht aufgerufene Objekte anzeigen.
NOEXEC Statistiken drucken zu nicht ausgeführten Statement-Zeilen von aufgerufenen Natural-Objekten, siehe auch Nur die nicht ausgeführten Statement-Zeilen anzeigen.
OBJECT Statistiken drucken zur Aufrufhäufigkeit (Call Frequency) von Objekten, siehe auch Aufgerufene Objekte anzeigen.
STATEMENT Statistiken drucken zu ausgeführten und nicht ausgeführten Statement-Zeilen von aufgerufenen Natural-Objekten, siehe auch Alle Statement-Zeilen anzeigen.
XSTATISTICS Statistiken drucken zu ausgeführten Statement-Zeilen, siehe auch Statement-Ausführungsstatistiken anzeigen.
PROFILE    Bildschirm User Profile anzeigen. Dort können Sie die Profileinstellungen des Debuggers ändern, siehe Kommandos zum Navigieren und Anzeigen von Informationen.
RESET

(Syntax siehe unten)

ENVIRONMENT Aktuelle Debug-Umgebung zurücksetzen, siehe Debug-Umgebung zurücksetzen.
RIGHT    Zur rechten Seite einer Quellcode-Auflistung verschieben.
RUN   Test-Modus ausschalten und Programmausführung fortsetzen.
SAVE

(Syntax siehe unten)

ENVIRONMENT Aktuelle Umgebung zurücksetzen und die Debug-Angaben speichern, siehe auch Debug-Umgebung speichern.
SCAN ABS Nur anwendbar bei der Funktion List object source (siehe Objekt-Quellcode anzeigen - Funktion: List Object Source).

Suche nach einem Wert im Quellcode eines Objekts, siehe SCAN in Kommandos zum Navigieren und Anzeigen von Informationen and Syntax-Diagramme weiter unten.

SCREEN    Wenn bei Unterbrechung eines Objekts eingegeben, wird die aktuelle Bildschirmausgabe des unterbrochenen Natural-Objekts angezeigt. Rückkehr in den Debug-Modus nach Drücken von ENTER.
SET

(Syntax siehe unten)

BREAKPOINT

oder

BP

Bildschirm Set Breakpoint aufrufen, siehe Breakpoints verwalten - Menü: Breakpoint Maintenance.
CALL ON

oder

CALL OFF

Call-Statistik aktivieren oder deaktivieren, siehe Statistiken über gerufene Objekte verwalten - Menü: Call Statistics Maintenance.
OBJECT Das für den Debugger angegebene Standard-Objekt ändern, siehe auch SET OBJECT in Kommandos zum Navigieren und Anzeigen von Informationen.
WATCHPOINT

oder

WP

Bildschirm Watchpoint setzen aufrufen, siehe Watchpoint Maintenance (Verwaltung der Watchpoints).
XSTATISTICS ON

oder

XSTATISTICS COUNT

oder

XSTATISTICS OFF

Statement-Ausführungsstatistik aktivieren (ON oder COUNT) deaktivieren (OFF), siehe Funktion Statement Execution Statistics auf ON/OFF/COUNT setzen.
SM    Menü Spy Maintenance aufrufen, siehe Debug-Einträge verwalten - Menü: Spy Maintenance.
STACK    Inhalt des obersten Eintrags im Natural-Stack anzeigen, siehe STACK in Kommandos zum Navigieren und Anzeigen von Informationen.
STEP    [n] Unterbrochenes Natural-Objekt für eine mit dem Kommando angegebene Anzahl (n) ausführbarer Statements fortsetzen. Wenn Sie n nicht angeben, wird standardmäßig ein ausführbares Statement übersprungen. Siehe auch STEP in Kommandos zur Ausführungssteuerung.
SKIPSUBLEVEL [n] Schrittweise Bearbeitung von Natural-Objekten fortsetzen, ohne Programme auf Unterebenen zu erfassen. Sie können eine Ebenen-Nummer (n) angeben. Siehe auch SKIPSUBLEVEL in Kommandos zur Ausführungssteuerung.
STOP    Debugger und unterbrochenes Natural-Objekt beenden. Die Eingabeaufforderung NEXT erscheint.
SYSVARS    Aktuelle Werte eines begrenzten Satzes an Systemvariablen anzeigen (außer datenbankbezogene Systemvariablen). Siehe auch Systemvariablen anzeigen.
TEST ON

oder

TEST OFF

   Test-Modus ein- und ausschalten.
WM    Ruft das Menü Watchpoint Maintenance auf. Beschreibung siehe Watchpoint Maintenance (Verwaltung der Watchpoints).

Syntax-Diagramme

Die im Folgenden aufgeführten Syntax-Diagramme beziehen sich auf komplexere Kommandosequenzen.

Ausführliche Erläuterungen zu den Symbolen, die innerhalb der Syntax-Beschreibungen verwendet werden, siehe Abschnitt Systemkommando-Syntax in der Systemkommandos-Dokumentation.

Zur besseren Lesbarkeit sind synonyme Schlüsselwörter in den unten aufgeführten Syntax-Diagrammen weggelassen worden. Eine Unterstreichung eines Schlüsselwortteils bedeutet, dass Sie das Schlüsselwort auch in entsprechend abgekürzter Form als eingeben können.

Gültige synonyme Schlüsselwörter sind:

Schlüsselwort Synonym
BREAKPOINT BP
DEACTIVATE DA
WATCHPOINT WP

Dieser Abschnitt behandelt folgende Systemkommandos:

ACTIVATE

ACTIVATE

SPY

name

number
BREAKPOINT [ object ] [ line ]
WATCHPOINT

[ object ]variable

DEACTIVATE

DEACTIVATE

SPY

name

number
BREAKPOINT [ object ] [ line ]
WATCHPOINT

[object]variable

DELETE

DELETE

SPY

name

number
BREAKPOINT [ object ] [ line ]
WATCHPOINT

[ object ] variable

XSTATISTICS

[ library ] object

ENVIRONMENT [ name ]

DISPLAY

DISPLAY

SPY

name

number
BREAKPOINT [ object ] [ line ]
WATCHPOINT

[ object ] variable

CALL

library [ object ]

OBJECT
NOCALL
XSTATISTICS
STATEMENT
EXEC
NOEXEC
VARIABLE

variable-name [index-specification],...

HEXADECIMAL

LIST

LIST

LASTLINE

BREAK
object [ line ]

LOAD

LOAD ENVIRONMENT [ name ]

MODIFY

MODIFY

SPY

name

number
BREAKPOINT [ object ] [ line ]
WATCHPOINT

[ object ] variable

VARIABLE

variable [ = new value ]

HEXADECIMAL

PRINT

PRINT

CALL

library [ object ]

OBJECT
NOCALL
XSTATISTICS
STATEMENT
EXEC
NOEXEC

RESET

RESET ENVIRONMENT [ name ]

SAVE

SAVE ENVIRONMENT [ name ]  

SET

SET

OBJECT   object    

BREAKPOINT   object

line

label
WATCHPOINT

[ object] variable

CALL

OFF

 
ON
XSTATISTICS

OFF

library [ object ]

ON
COUNT