Version 4.2.6 for Mainframes
 —  Parameter Reference  —

ETRACE - External Trace Function

This Natural profile parameter is used to activate/deactivate the (normal) external trace function or the Generalized Trace Facility (GTF) offered under z/OS and TSO.

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

The trace function is intended primarily for Software AG internal use for debugging purposes. It writes trace data to an external trace dataset depending on the TP environment in which Natural is running. In batch and TSO environments, a dataset (see also CMTRACE - Optional Report Output for Natural Tracing in the Operations documentation) is required for the external trace.

Possible settings ON Activates the (normal) external trace function.
OFF Deactivates the (normal) external trace function.

(ON,GTF)
(OFF,GTF)

Activates/deactivates the Generalized Trace Facility (GTF). The trace records are written to the GTF.

(ON,NOGTF)
(OFF,NOGTF)

Activates/deactivates the (normal) external trace function.
(,GTF) Equivalent to ETRACE=GTF. Trace data is written to the GTF. ON or OFF is not altered.
Default setting OFF  
Dynamic specification yes  
Specification within session yes Within a Natural session, the terminal command %TRE can be used to activate/deactivate the external trace function, except GTF.

Top of page