TRACE_TABLE - UPPS configuration option

Description

The TRACE_TABLE option specifies the size of a wrap-around trace table, and under what conditions the table is written to a file when the process ends.

Trace data can be written to a file / data set as it is produced, or it can be written to a 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

-trace_table size, condition



(tick)

(tick)


Environment Variable

n/a






Configuration File Keyword

trace_table size, condition



(tick)

(tick)


Values

size is the size (in bytes) of the 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.

Default is 0 (trace table is not used).


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

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

Command Usage

The TRACE_TABLE option is a MESSAGE option.

MESSAGE options are associated with program execution, not commands. They specify different characteristics of upps messages.