TRACE_TABLE - USAP 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 | |||||
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.