TRACE_TABLE - OMS configuration option

Description

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

(Trace data can be written to the trace table or written to a file as it is produced.)

The trace table is written to a file 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

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.