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

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.

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.