TRACE - Define Components to be Traced

#### Search Results

Search

# 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

- NTTRACE Macro Syntax

- Example of TRACE Parameter

- Example of NTTRACE Macro

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

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

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

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

### On this page

- TRACE Parameter Syntax
- NTTRACE Macro Syntax
- Example of TRACE Parameter
- Example of NTTRACE Macro