DBGAT - Debug Attach Server für NaturalONE

Der Natural-Profilparameter DBGAT ermöglicht im Zusammenhang mit NaturalONE das Debugging einer externen Natural-Anwendung von einem z/OS-Host-Rechner aus. Er 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 zum Debugging von externen Natural-Anwendungen siehe NaturalONE-Dokumentation.

Siehe auch Natural für Attached-Debugging vorbereiten in der Natural Debugger-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, an dem das Debugging durchgeführt werden soll.
SSL ON Die Kommunikation mit dem Debug Attach Server erfolgt über SSL/TLS-Verschlüsselung.
OFF Für die Kommunikation mit dem Debug Attach Server wird keine SSL/TLS-Verschlüsselung verwendet.
TLS ON Siehe Beschreibung für den Schlüsselwort-Subparameter SSL.
OFF
TRACE 1 - 8 hexadezimale Ziffern Trace-Level für das Attached-Debugging.

Siehe auch Trace Level.

VERIFY ON Natural verifiziert die SSL/TLS-Verbindung zum Debug-Attach-Server.

Natural sucht zunächst nach dem CA-Zertifikat in der Datei das.client.ca.crt, die sich am Speicherort der Natural-Binärdatei befindet. Wenn die Datei nicht vorhanden ist, versucht Natural, in der Umgebungsvariablen SSL_CERT_FILE oder SSL_CERT_DIR nach dem Speicherort des CA-Zertifikats zu suchen (OpenSSL-Standard).

OFF Natural prüft die SSL/TLS-Verbindung nicht.

Trace Level

Jedes Bit von TRACE steht, wie in der folgenden Tabelle angegeben, für bestimmte Trace-Informationen:

Bit Information
00000001 Trace-Fehlerereignisse.
00000002 Trace-Hauptereignisse, wie z.B. Attach-Debug-Initialisierung und Beendigung.
00000008 Dump der internen Speicherbereiche.
00000004 Verfolgung detaillierter Ereignisse, wie z. B. Start und Ende von Funktionen mit Rückgabecode.
00000010 Dump von Anfrage- und Antwortpuffern in EBCDIC.
00000020 Dump von Anfrage- und Antwortpuffern in ASCII.
00000040 Anfrageverarbeitung Hauptereignisse.
00000080 Anfrageverarbeitung Detailereignisse.

Sie können verschiedene Trace-Optionen kombinieren, z.B. TRACE=00000007 verfolgt Fehlerereignisse, Hauptereignisse und Detailereignisse.

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

On this page