Natural for Mainframes Version 8.2.5 for Mainframes
 —  Parameter Reference  —

TRACE - Define Components to be Traced

This Natural profile parameter can be used to define the components for which trace data are to be written. It corresponds to the macro NTTRACE in the Natural parameter module.

Warning:
Do not use this parameter without prior consultation of Software AG Support.
Possible settings See TRACE Parameter Syntax.
Default setting none  
Dynamic specification yes This parameter can only be specified dynamically. In the Natural parameter module, the macro NTTRACE is used instead.
Specification within session no  

Notes:

  1. This Natural profile parameter is intended primarily for Software AG internal use for debugging purposes. It does not activate trace recording.
  2. To activate trace recording, use the profile parameters ITRACE (internal trace) or ETRACE (external trace). During the session, you can use the corresponding terminal commands %TRI and %TRE.
  3. 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-id,trace-id,...)

Where:

Syntax Element Value Explanation
trace-id 1-8 bytes each. Trace IDs define the names of the Natural components to be traced. Component names have to be entered in upper case.

Top of page

NTTRACE Macro Syntax

The NTTRACE macro is specified as follows:

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

Notes:

  1. For an explanation of the syntax elements, see TRACE Parameter Syntax.
  2. Multiple specifications of the NTTRACE macro are concatenated to one trace list.

Top of page

Example of TRACE Parameter

TRACE=(NATGETM,NATFREM,DYNPARMS)

This specification 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

         NTTRACE NATGETM,NATFREM,DYNPARMS

This specification defines traces to be written for the Natural nucleus components "Storage Acquisition", "Storage Release" and "Dynamic Parameter Evaluation".

Top of page