TRACE_TABLE - UEC configuration option

Description

The TRACE_TABLE option specifies the size of a wrap-around trace table maintained in memory.

The trace table is written to a file / data set when the program ends under the conditions specified in this option. Tracing is activated, and a trace file is generated, when the MESSAGE_LEVEL option is set to trace.

Usage

Method

Syntax

IBM i

HP NonStop

UNIX

Windows

z/OS

Command Line, Short Form

n/a






Command Line, Long Form

n/a






Configuration File Keyword

trace_table size, condition




(tick)

(tick)

Values

size is the size (in bytes) of the trace table.

The size can be suffixed with either of the following characters:

  • M indicates that the size is specified in megabytes
  • K indicates that the size is specified in kilobytes

For example, 50M indicates that 50 X 1,048,576 bytes of memory is allocated for the trace table.

Note

If size is 0, the trace table is not used.

Default is 0.



condition is the condition under which the trace table is written.

Possible values for condition are:

  • error
    Write the trace table if the program ends with a non-zero exit code.
  • always
    Write the trace table when the program ends regardless of the exit code.
  • never
    Never write the trace table.

Default is never.