Debug-Kommandoübersicht und -syntax

#### Search Results

Search

# 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

- Syntax-Diagramme

## 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 Breakpoint Maintenance (Verwaltung der Breakpoints).
`SPY` | Breakpoints und Watchpoints aktivieren, siehe auch Spy aktivieren in Spy Maintenance (Verwaltung der Debug-Einträge).
`WATCHPOINT` oder `WP` | Watchpoints aktivieren, siehe Watchpoint Maintenance (Verwaltung der Watchpoints).
`BM` |  | Menü Breakpoint Maintenance aufrufen, siehe Breakpoint Maintenance (Verwaltung der Breakpoints).
`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 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 Breakpoint Maintenance (Verwaltung der Breakpoints).
`SPY` | Breakpoints und Watchpoints deaktivieren, siehe auch Spy deaktivieren.
`WATCHPOINT` oder `WP` | Watchpoint deaktivieren, siehe auch Watchpoint Maintenance (Verwaltung der Watchpoints).
`DELETE` (Syntax siehe unten) | `BREAKPOINT` oder `BP` | Breakpoint löschen, siehe auch Breakpoint Maintenance (Verwaltung der Breakpoints).
`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 Breakpoint Maintenance (Verwaltung der Breakpoints).
`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 Variable Maintenance (Anzeigen und Ändern von Variablen).
`XSTATISTICS` | Statistik-Zusammenfassung von Ausführungsstatistiken anzeigen, siehe auch Statement-Ausführungsstatistiken anzeigen.
`EM` |  | Menü Debug Environment Maintenance aufrufen, siehe Debug Environment Maintenance (Verwaltung der Debug-Umgebung).
`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 Breakpoint Maintenance (Verwaltung der Breakpoints).
`SPY` | Bildschirm Modify Breakpoint oder Modify Watchpoint aufrufen, siehe auch Debug-Einträge (Spies) ändern in Spy Maintenance (Verwaltung der Debug-Einträge).
`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 List Object Source (Objekt-Quellcode anzeigen)). 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 Breakpoint Maintenance (Verwaltung der Breakpoints).
`CALL ON` oder `CALL OFF` | Call-Statistik aktivieren oder deaktivieren, siehe Call Statistics Maintenance (Statistiken über gerufene Objekte).
`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 Spy Maintenance (Verwaltung der Debug-Einträge).
`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

- DEACTIVATE

- DELETE

- DISPLAY

- LIST

- LOAD

- MODIFY

- PRINT

- RESET

- SAVE

- SET

### 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`

### On this page

- Alle Debug-Kommandos
- Syntax-Diagramme