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
Environment Variable	n/a
Configuration File Keyword	trace_table size, condition

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 usap messages.