DBGAT - Debug Attach Server für NaturalONE

#### Search Results

Search

# 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

- NTDBGAT-Makro-Syntax

- Beispiel für DBGAT-Parameter

- Beispiel für NTDBGAT-Makro

## 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

- DBGAT-Parameter-Syntax
- NTDBGAT-Makro-Syntax
- Beispiel für DBGAT-Parameter
- Beispiel für NTDBGAT-Makro