DBGAT - Debug Attach Server für NaturalONE

Dieser Natural-Profilparameter ermöglicht im Zusammenhang mit NaturalONE die Fehlerbeseitigung (Debugging) in einer externen Natural-Anwendung von einem z/OS- oder z/VSE-Host-Rechner aus. DBGAT entspricht dem Makro NTDBGAT im Natural-Parametermodul.

Mögliche Werte Siehe DBGAT-Parameter-Syntax.
Standard-Einstellung keine  
Dynamische Angabe ja  
Angabe innerhalb der Session nein  

Ausführliche Informationen zur Fehlerbeseitigung (Debugging) in externen Natural-Anwendungen siehe NaturalONE-Dokumentation.

Dieses Dokument behandelt folgende Themen:

DBGAT-Parameter-Syntax

Der Profilparameter DBGAT wird wie folgt angegeben:

DBGAT=(keyword-subparameter=value,...)

Dabei ist:

Schlüsselwort-Subparameter Wert Erklärung
ACTIVE ON ON bedeutet, dass der Debug Attach-Mechanismus aktiv ist. Die Natural-Laufzeitumgebung ist bereit für das Debugging.
OFF
HOST 1 - 64 Zeichen Name des Debug Attach Server, zu dem die Verbindung hergestellt werden soll.
PORT 0 - 65535 Nummer des Port, an dem der Debug Attach Server empfängt.
CLID 1 - 64 Zeichen Client-Kennung des NaturalONE-Projekts, das ausgetestet werden soll.
TRACE 1 - 8 hexadezimale Ziffern Trace Level zur Fehlerbeseitigung (Debugging) bei externen Natural-Anwendungen.

Siehe auch Trace Level.

Trace Level

Jedes Bit des Subparameters TRACE repräsentiert eine bestimmte Trace-Information:

Bit Information
00000001 Verfolgung von Fehlerereignissen.
00000002 Verfolgung von Hauptereignissen, z.B. Initialisierung und Beendigung des Debugging von externen Natural-Anwendungen.
00000004 Verfolgung von Einzelereignissen, z.B. Einstieg und Verlassen von Funktionen mit Rückgabecode.
00000008 Speicherauszug von internen Speicherbereichen erstellen.
00000010 Speicherauszug von Anforderungs- und Antwortpuffern in EBCDIC erstellen.
00000020 Speicherauszug von Anforderungs- und Antwortpuffern in ASCII erstellen.
00000040 Verarbeitung von Hauptereignissen anfordern.
00000080 Verarbeitung von Einzelereignissen anfordern.

Sie können verschiedene Trace-Optionen miteinander kombinieren. Beispiel: TRACE=00000007 bewirkt die Verfolgung von Fehlerereignissen, Hauptereignissen und Einzelereignissen.

NTDBGAT-Makro-Syntax

Das Makro NTDBGAT wird wie folgt angegeben: 

         NTDBGAT ACTIVE=value,                                          *
               HOST=value,                                              *
               PORT=value,                                              *
               CLID=value,                                              *
               TRACE=value

Beispiel für DBGAT-Parameter

DBGAT=(ACTIVE=ON,HOST=MYHOST,PORT=9999,CLID=MYCLIENTID,TRACE=00000097)

Beispiel für NTDBGAT-Makro

         NTDBGAT ACTIVE=ON,                                            *
               HOST=MYHOST,                                            *
               PORT=50882,                                             *
               TRACE=00000097