Debug-Umgebungen bearbeiten

#### Search Results

Search

# Debug-Umgebungen bearbeiten

Alle SYSMAIN-Funktionen, mit Ausnahme der Funktion Find, können in Debug-Umgebungen ausgeführt werden.

Die Angabe der Debug-Umgebung muss immer mit der Datenbankkennung (DBID) und der Dateinummer (FNR) der entsprechenden FUSER-Systemdatei übereinstimmen.

Dieses Kapitel beschreibt die Menüfunktionen und Auswahllistenoptionen, die zur Ausführung einer SYSMAIN-Funktion in Debug-Umgebungen zur Verfügung stehen, sowie die Syntax, die bei der Verwendung von Direktkommandos gilt.

- Felder im Menü Debug Environments

- Auswahllisten für Debug-Umgebungen

- Direktkommando-Syntax für Debug-Umgebungen

#### Verwandtes Thema:

Debug Environment Maintenance (Verwaltung der Debug-Umgebung) in der Debugger-Dokumentation

## Felder im Menü Debug Environments

Das Menü Debug Environments enthält alle SYSMAIN-Funktionen, die für die Bearbeitung von Debug-Umgebungen erforderlich sind. Die Felder in diesem Menü sind in der folgenden Tabelle beschrieben:

Feld | Erläuterung
--- | ---
Code |
Gibt die auszuführende Funktion an. Siehe Beschreibung der Funktionen:
`C` | Copy - Debug-Umgebung kopieren.
`D` | Delete - Debug-Umgebung löschen.
`L` | List - Debug-Umgebung auflisten.
`M` | Move - Debug-Umgebung verschieben.
`R` | Rename - Debug-Umgebung umbenennen.
Anmerkung Wenn eine Debug-Umgebung von einer Library in eine andere verschoben oder kopiert wurde, müssen die Breakpoints und Watchpoints an die neue Library angepasst werden. Einzelheiten siehe Debug-Umgebung in verschiedenen Libraries verwalten in der Debugger-Dokumentation.
Sel. List |
Gibt an, ob selektive oder automatisierte Verarbeitung verwendet wird:
`Y` | Ja: Die selektive Verarbeitung ist aktiviert. Bei der Verarbeitung von Debug-Umgebungen wird eine Auswahlliste angezeigt. Dies ist die Standardeinstellung. Welche Spalten, Felder und Zeilenkommandos in einer Auswahlliste zur Verfügung stehen, erfahren Sie unter Auswahllisten für Debug-Umgebungen.
`N` | Nein: Die selektive Verarbeitung ist ausgeschaltet. Name
Name | Der Name der zu bearbeitenden Debug-Umgebung oder ein Bereich von Namen: siehe auch Angabe eines Namensbereichs. Die Standardeinstellung ist ein Stern (*), was bedeutet, dass alle Namen ausgewählt werden.
New Name | Neuer Name: Der Name, der einer Debug-Umgebung gegeben werden soll, wenn sie mit der Funktion Rename umbenannt wird.
Library | Der Name einer Quell- oder Ziel-Library. Die Quell-Library enthält die zu bearbeitende Debug-Umgebung. Die Ziel-Library ist die Library, in die die Debug-Umgebung kopiert oder verschoben werden soll, oder in die die Debug-Umgebung umbenannt wird. Siehe auch Auflisten und Auswählen von Libraries.
Database | Datenbank: Die Datenbankkennung (DBID) einer Quell- oder Zieldatenbank. Die Quelldatenbank enthält die Library und die Systemdatei, in der die zu bearbeitende Debug-Umgebung gespeichert ist. Die Zieldatenbank enthält die Library und die Systemdatei, in die die Debug-Umgebung kopiert oder verschoben werden soll, oder in der die Debug-Umgebung umbenannt wird. Gültige Datenbankkennungen: `1` bis `65535`.
File | Datei: Die Dateinummer (FNR) einer Quell- oder einer Ziel-Systemdatei (FNAT oder FUSER). Gültige Dateinummern: `1` bis `65535`. Die Quelldatei enthält die Library, in der die zu bearbeitende Debug-Umgebung gespeichert ist. Die Zieldatei enthält die Library, in die die Debug-Umgebung kopiert oder verschoben werden soll, oder in der die Debug-Umgebung umbenannt wird.
Replace |
Ersetzen: Gibt an, ob eine Debug-Umgebung bei der Verwendung der Funktionen Move (Verschieben), Copy (Kopieren) oder Rename (Umbenennen) ersetzt werden soll:
`Y` | Ja: Eine Debug-Umgebung mit demselben Namen, die in der Zielumgebung existiert, wird ersetzt.
`N` | Nein: Eine Debug-Umgebung mit demselben Namen, die in der Zielumgebung existiert, wird nicht ersetzt. Dies ist die Standardeinstellung.
Siehe auch Option Replace (Ersetzen) verwenden.

## Auswahllisten für Debug-Umgebungen

Wenn die selektive Verarbeitung aktiviert wurde, wird auf einem Auswahlbildschirmbild (Selection) eine Auswahlliste mit allen Debug-Umgebungen angezeigt, die den angegebenen Auswahlkriterien entsprechen.

Dieser Abschnitt beschreibt die auf einem Auswahlbildschirmbild enthaltenen Spalten und Felder sowie die Zeilenkommandos, die zur weiteren Bearbeitung einer Debug-Umgebung zur Verfügung stehen:

- Spalten und Felder

- Zeilenkommandos

### Spalten und Felder

Die folgenden Spalten und Felder werden auf einem Auswahlbildschirm angezeigt:

Spalte/Feld | Erläuterung
--- | ---
C | Eingabefeld für Zeilenkommandos (siehe unten).
Environment | Umgebung: Der Name der Debug-Umgebung, die den angegebenen Auswahlkriterien entspricht.
Message | Meldung: Die Meldung, die den Verarbeitungsstatus einer Debug-Umgebung angibt. Mögliche Meldungen siehe Status-Meldungen.
Listed Library | Aufgelistete Library: Der Name der Library, die die ausgewählte(n) Debug-Umgebung(en) enthält.

### Zeilenkommandos

Eines der folgenden Zeilenkommandos kann in der Spalte C (Command) eines Auswahlbildschirms (Selection) eingegeben werden:

Zeilen- kommando | Funktion
--- | ---
`A` | Verarbeitet die Debug-Umgebung. Dieses Zeilenkommando ist auf dem List Selection-Bildschirm nicht verfügbar. Auf einem List Selection können Sie nur einen Punkt (.) eingeben, um den Bildschirm zu verlassen.
`L` | Zeigt eine Liste der Debug-Umgebungen an, die in der angegebenen Library enthalten sind. Gilt nur bei einem Library Selection-Bildschirm (siehe auch Auflisten und Auswählen von Libraries).

## Direktkommando-Syntax für Debug-Umgebungen

In diesem Abschnitt wird die Syntax für die Ausführung von SYSMAIN-Funktionen in Debug-Umgebungen mit Hilfe von Direktkommandos im Online- oder Batch-Modus beschrieben. Allgemeine Anleitungen zur Verwendung von Direktkommandos siehe Schlüsselwörter und Variablen in Direktkommandos.

Die Symbole in den Syntax-Diagrammen entsprechen den Syntax-Symbolen, die für Systemkommandos verwendet werden. Diese Symbole werden unter Systemkommando-Syntax in der Systemkommandos-Dokumentation erläutert.

Die Syntax der where-Klausel (where-clause) und der With-Klausel (with-clause) ist bei allen Kommandos identisch.

In diesem Abschnitt werden die folgenden Themen behandelt:

- COPY und MOVE

- DELETE

- LIST

- RENAME

- where-clause

- with-clause

### COPY und MOVE

| `COPY` `MOVE` |  | `DEBUG` | name |
`FM` [`LIBRARY`] lib-name [where-clause]
`TO` [`LIBRARY`] lib-name [where-clause] [with-clause]

#### Beispiele:

    COPY D ENV FM TESTLIB WHERE DBID 1 FNR 5 TO PRODLIB WHERE DBID 2 FNR 5 WITH REP

    C DEBUG ENV FM TESTLIB FNR 6 TO PRODLIB FNR 7 REP

    MOVE DEBUG ENV FM OLDLIB WHERE DBID 1 FNR 5 TO NEWLIB WHERE DBID 2 FNR 5

    M DEBUG ENV FM OLDLIB FNR 6 TO NEWLIB FNR 7 REP

### DELETE

`DELETE` | `DEBUG` | name |  | `IN` [`LIBRARY`] lib-name |  | [where-clause] | [with-clause]

#### Beispiele:

    DELETE DEBUG U* IN TESTLIB FNR 150

    D DEBUG TEST* IN TESTLIB IN DBID 177 FNR 205

### LIST

`LIST` | `DEBUG` | name |  | `IN` [`LIBRARY`] lib-name |  | [where-clause] | [with-clause]

#### Beispiele:

    LIST DEBUG ENV* IN TESTLIB DBID 1 FNR 5

    L D DT* IN TESTLIB DBID 10

### RENAME

`RENAME` | `DEBUG` | name | `AS` new-name [with-clause]
|  |  | `IN` [`LIBRARY`] lib-name [where-clause]
|  |  | `TO` [`LIBRARY`] lib-name [where-clause]

#### Beispiele:

    RENAME D OLDENV AS NEWENV IN TESTLIB RCOP

    R DEBUG OLDENV AS NEWENV IN TESTLIB DBID 1 FNR 4 TO PRODLIB DBID 1 FNR 5

    R DEBUG OLDENV AS NEWENV IN TESTLIB FNR 4 TO PRODLIB FNR 5 REPLACE RCOP

### where-clause

[`WHERE`] [`DBID` dbid `]` [`FNR` fnr] [`NAME` vsam-name `]`
[`CIPHER` cipher] |  |  |  | `PASSWORD` `PSW` |  | password |  |  |  |  |  |  |  |  |  |  |

### with-clause

[`WITH`] [`REPLACE`] [`RCOP`] |  | `PROMPT` `NOPROMPT` |  |  | `MON` `NOMON` |  | [`HELP`]

### On this page

- Felder im Menü Debug Environments
- Auswahllisten für Debug-Umgebungen
- Direktkommando-Syntax für Debug-Umgebungen