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.

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

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

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]