Mit dieser Funktion können Sie innerhalb des Debuggers Variablen anzeigen und ändern, wenn ein Natural-Objekt unterbrochen wurde.
Die Funktion Variable maintenance zeigt für das
unterbrochene Natural-Objekt Benutzervariablen, globale Variablen und die
datenbankbezogenen Systemvariablen *COUNTER,
*ISN und *NUMBER mit
Natural-Datenformaten, Längen und Inhalten an.
Folgende Themen werden behandelt:
Dieser Abschnitt beschreibt, wie Sie entweder den Bildschirm Display Variables (Übersicht) mit einer Liste aller Variablen oder den Bildschirm Display Variable (einzeln) mit allen Einzelheiten zu einer bestimmten Variablen aufrufen.
Um eine Übersicht über Benutzervariablen, globale Variablen und
datenbankbezogene Systemvariablen anzuzeigen:
Geben Sie im Hauptmenü Debug Main Menu
oder im Fenster Debug Break den Funktionscode
V ein.
Oder:
Geben Sie folgendes Direktkommando ein:
DISPLAY VARIABLE variable,variable,...
Der Bildschirm Display Variables (Übersicht) erscheint mit einer Liste der Variablen, die für das unterbrochene Natural-Objekt angegeben sind. Lange Werte können im Bildschirm abgeschnitten angezeigt werden. Bei Arrays wird nur der Inhalt der ersten Ausprägung angezeigt.
Sie können mit den Funktionstasten PF10 (Alpha) und PF11 (Hex) zwischen der alphanumerischen und der hexadezimalen Darstellung des Variableninhalts wechseln.
Mit PF5 (Zoom) können Sie zwischen der verkürzten Anzeige einer Variablen und der vollständigen Namensanzeige mit Gruppenname, Variablenname und Indizes (falls relevant) umschalten.
Für variable können Sie
auch eine Systemvariable angeben. Weitere Informationen siehe
Systemvariablen
anzeigen.
Um eine einzelne Variable vollständig anzuzeigen:
Wählen Sie im Bildschirm Display
Variables (Übersicht) eine Variable aus und markieren Sie sie mit
dem Zeilenkommando DI.
Oder:
Geben Sie folgendes Direktkommando ein:
DISPLAY VARIABLE variable
Oder:
Positionieren Sie im Bildschirm List Object
Source in der Spalte Source den Cursor auf
einem Variablennamen und drücken Sie PF18 (Di Va).
Bei der Benutzung von PF18 (Di Va) gelten die folgenden Einschränkungen:
Wenn sich ein Variablenname (einschließlich der
Ausprägungen eines Arrays) über mehr als eine Zeile erstreckt, wird nur der
Inhalt der ersten Zeile ausgewertet.
Wenn auf einen Array-Namen kein Index folgt, wird
das gesamte Array angezeigt.
Wenn der Inhalt eines Arrays konstant ist, z.B.
Array (3,2,6), wird nur diese Ausprägung angezeigt.
Wenn der Inhalt eines Arrays variabel ist, z.B.
Array (i,j) oder Array (3:i), werden die Variablen ausgewertet, bevor die
jeweiligen Ausprägungen des Arrays angezeigt werden.
Oder:
Positionieren Sie im Bildschirm List Object
Source in der Source den Cursor auf einem
Variablennamen und drücken Sie ENTER.
Bei der Benutzung von ENTER gelten die gleichen Einschränkungen wie bei PF18, siehe oben. Allerdings wird die Variable oder die Variablen-Ausprägung in einem Fenster Display Variable statt über den Bildschirm Display Variable (einzeln) angezeigt, wenn der Index für ein Array nicht mehr als eine Ausprägung angibt. Wenn der Index für ein Array mehr als eine Ausprägung angibt, werden die Daten über den Bildschirm Display Variable (einzeln) angezeigt.
Oder:
Anstatt den Cursor manuell zu positionieren und
ENTER zu drücken, können Sie zur einfacheren Bedienung auch Entire
Connection benutzen. Hier positioniert ein Doppelklick mit der linken Maustaste
den Cursor und simuliert die ENTER-Taste.
Es erscheint der Bildschirm Display Variable (einzeln) bzw. ein Fenster mit allen relevanten Angaben zur jeweiligen Variablen.
Wenn Daten über ein Fenster angezeigt werden und die Länge des Variableninhalts 256 Bytes überschreitet, werden nur die ersten 256 Bytes angezeigt. Beim Bildschirm Display Variable (einzeln) gibt es keine solchen Einschränkungen und Sie können, wie nachfolgend beschrieben, durch den gesamten Inhalt der Variablen navigieren.
Um den gesamten Inhalt der Variablen anzuzeigen oder im Inhalt
zu navigieren:
Mit PF22 können Sie vorwärts, mit PF23 rückwärts navigieren.
Oder:
Geben Sie im Feld Position einen
numerischen Wert ein, damit die Anzeige an einer bestimmten Stelle beginnt.
Mit PF10 (Alpha) und PF11 (Hex) können Sie zwischen alphanumerischer und hexadezimaler Darstellung des Variableninhalts wechseln.
Um alle Ausprägungen eines Arrays mittels Bildschirmfunktionen
anzuzeigen:
Wählen Sie im Bildschirm Display
Variables eine Variable aus und markieren Sie sie mit dem
Zeilenkommando DI.
Oder:
Mit PF7 (-) und PF8 (+) können Sie
zwischen den einzelnen Ausprägungen hin und her wechseln.
Um eine oder mehrere Ausprägungen eines Arrays mittels
Direktkommando anzuzeigen:
Benutzen Sie folgendes Direktkommando:
DISPLAY VARIABLE variable-name(index-specification)
Dabei ist
variable-name der Name der Variablen
und index-specification eines der
Folgenden: eine Index-Notation, ein Index-Bereich oder ein Stern (*) für alle
Ausprägungen einer Dimension. Variablen, die Teil einer Indexangabe
(index-specification) sind, werden ausgewertet,
bevor die jeweiligen Ausprägungen angezeigt werden.
Beispiele:
DISPLAY VARIABLE
ARRAY1(*) |
Eindimensionales Array:
Zeigt alle Ausprägungen des eindimensionalen
Arrays |
DISPLAY VARIABLE
ARRAY1(1)
or
|
Eindimensionales Array:
Zeigt die erste Ausprägung des eindimensionalen
Arrays |
DISPLAY VARIABLE
ARRAY2(2,3:4) |
Zweidimensionales Array:
Zeigt die zweite Ausprägung der ersten Dimension
und die Index-Notation der zweiten Dimension des zweidimensionalen Arrays
|
DISPLAY
VARIABLE ARRAY3(1,3:4,*) |
Dreidimensionales Array:
Zeigt die erste Ausprägung der ersten Dimension,
die Index-Notation der zweiten Dimension und alle Ausprägungen der dritten
Dimension des dreidimensionalen Arrays |
DISPLAY
VARIABLE ARRAY4(I,J + 1) |
Zweidimensionales Array:
Zeigt die Ausprägung des zweidimensionalen Arrays
|
Um Systemvariablen anzuzeigen (außer datenbankbezogenen
Systemvariablen):
Geben Sie folgendes Direktkommando ein:
SYSVARS
Der Bildschirm System Variables erscheint mit einem eingeschränkten Satz Systemvariablen.
Um eine einzelne Systemvariable anzuzeigen:
Benutzen Sie folgendes Direktkommando:
DISPLAY VARIABLE system-variable-name
Dabei ist
system-variable-name der Name der
Systemvariablen, der auch mit dem Direktkommando
SYSVARS angezeigt werden kann.
Bei Variablen des Typs Handle wird der Name der Class der Instanz,
auf die sich das Handle bezieht, in alphanumerischer Darstellung angezeigt.
Wenn der Name der Class nicht verfügbar ist, wird stattdessen der Globally
Unique Identifier (GUID) angezeigt. Wenn die Class innerhalb von Natural
definiert wurde, wird der Name der Class oder die GUID mit dem Suffix
(NAT) versehen.
Der Inhalt von Properties (Eigenschaften) einer Instanz kann im Debugger nicht angezeigt werden.
Diese Funktion gilt nicht bei Systemvariablen.
Mit dieser Funktion können Sie den Wert von Benutzervariablen, globalen Variablen und datenbankbezogenen Variablen ändern.
Um den Inhalt einer Variablen vom Bildschirm Modify Variable aus
zu ändern:
Rufen Sie den Bildschirm Modify Variable
auf, indem Sie die betreffende Variable mit dem Zeilenkommando MO
markieren.
Oder:
Drücken Sie im Bildschirm Display
Variable die Taste PF5 (Mod).
Ändern Sie im Bildschirm Modify Variable im Feld Contents den Wert der Variablen.
Der neue Inhalt muss in Bezug auf das Natural-Datenformat der geänderten Variablen gültig sein, weil innerhalb des Debuggers keine Formatänderung bei einer Variablen vorgenommen werden kann.
Sie können im Bildschirm Modify Variable mit PF10 (Alpha) und PF11 (Hex) zwischen alphanumerischer und hexadezimaler Darstellung des Variablenwerts umschalten.
Um den Inhalt einer Variablen mittels Direktkommando zu ändern:
Geben Sie folgendes Direktkommando ein:
MODIFY VARIABLE variable = new value
Eine Meldung erscheint, die die Änderung des Variablenwerts bestätigt.
Anmerkung:
Die Benutzung der Funktion Modify Variables
oder des Kommandos MODIFY VARIABLE kann durch
Natural Security unterbunden werden. Siehe Abschnitt
Components
of an Environment Profile in der Natural
Security-Dokumentation.