TRACE - Komponenten für den Trace angeben

Mit diesem Profilparameter können Sie die Komponenten definieren, für die Trace-Daten geschrieben werden sollen. TRACE entspricht dem Makro NTTRACE im Natural-Parametermodul.

Warnung:
Benutzen Sie diesen Parameter nicht ohne vorherige Rücksprache mit dem Software AG Support.
Mögliche Werte Siehe TRACE-Parameter-Syntax.
Standard-Einstellung keine  
Dynamische Angabe ja Dieser Parameter kann nur dynamisch angegeben werden. Im Natural-Parametermodul wird stattdessen das Makro NTTRACE benutzt.
Angabe innerhalb der Session nein  

Anmerkungen:

  1. Dieser Natural-Profilparameter ist in erster Linie für Debugging-Zwecke zur Software AG-internen Verwendung vorgesehen. Er aktiviert nicht die Trace-Aufzeichnung.
  2. Die Trace-Aufzeichnung kann wie folgt aktiviert werden: Mit den Profilparametern ITRACE (interner Trace) und ETRACE (externer Trace) oder während der Session mit den entsprechenden Terminalkommandos %TRI und %TRE.
  3. Die Listen mit Einstellungen von mehreren TRACE-Parameterangaben werden nicht verkettet; d.h., ein TRACE-Parameter überschreibt die Angaben von zuvor angegebenen TRACE-Parametern und vorhandene NTTRACE-Makro-Definitionen.

Dieses Dokument behandelt folgende Themen:

TRACE-Parameter-Syntax

Der Parameter TRACE wird wie folgt angegeben:

TRACE=(trace-id,trace-id,...)

Dabei ist:

Syntax Element Value Explanation
trace-id 1-8 bytes pro Kennung. Die Trace-Kennungen trace-ID definieren die Namen der Natural-Komponenten, für die ein Trace erfolgen soll. Die Namen der Komponenten müssen in Großbuchstaben angegeben werden.

NTTRACE-Makro-Syntax

Das Makro NTTRACE wird wie folgt angegeben: 

         NTTRACE trace-id,trace-id,...

Anmerkungen:

  1. Erklärung der Syntax-Elemente siehe TRACE-Parameter-Syntax.
  2. Mehrfache Angaben des NTTRACE-Makros werden zu einer Trace-Liste verkettet.

Beispiel für TRACE-Parameter

TRACE=(NATGETM,NATFREM,DYNPARMS)

Diese Angabe definiert, dass Trace-Daten für die Natural-Nukleus-Komponenten "Speicherbeschaffung", "Speicherfreigabe" und "dynamische Parameterauswertung" geschrieben werden sollen.

Beispiel für NTTRACE-Makro

         NTTRACE NATGETM,NATFREM,DYNPARMS

Diese Angabe definiert, dass Trace-Daten für die Natural-Nukleus-Komponenten "Speicherbeschaffung", "Speicherfreigabe" und "dynamische Parameterauswertung" geschrieben werden sollen.