Version 4.2.6 for Mainframes (Update)
 —  Parameter Reference  —

TRACE - Define Components to be Traced

This Natural profile parameter is intended primarily for Software AG internal use for debugging purposes. It can be used to define the components for which trace data are to be written. It does not activate trace recording.

Trace recording can be activated by the profile parameters ITRACE (internal trace) and ETRACE (external trace) or during the session by the corresponding terminal commands %TRI and %TRE.

Warning:
Do not use this parameter without prior consultation of Software AG Support.

TRACE corresponds to the macro NTTRACE in the Natural parameter module NATPARM.

Possible settings list of trace-IDs trace-IDs (each 1-8 bytes) define the names of the Natural components to be traced. Component names have to be entered in upper case.
Default setting none  
Dynamic specification yes This parameter can only be specified dynamically. In the Natural parameter module NATPARM, the macro NTTRACE must be used instead.
Specification within session no  

The setting lists of multiple TRACE parameter specifications are not concatenated; that is, a TRACE parameter overrides any previously specified TRACE parameter and any NTTRACE macro definitions.

The following topics are covered below:


TRACE Parameter Syntax

The TRACE parameter is specified as follows:

TRACE=(trace-ID1,trace-ID2,...)

Top of page

NTTRACE Macro Syntax

The NTTRACE macro is specified as follows:

NTTRACE trace-ID1,trace-ID2,...

Multiple specifications of the NTTRACE macro are concatenated to one trace list.

Top of page

Example of TRACE Parameter

TRACE=(NATGETM,NATFREM,DYNPARMS) 

This defines traces to be written for the Natural nucleus components "storage acquisition", "storage release" and "dynamic parameter evaluation".

Top of page

Example of NTTRACE Macro

Equivalent specification in the Natural parameter module:

NTTRACE NATGETM,NATFREM,DYNPARMS

Top of page