TRACE_TABLE - UCMD Manager configuration option

Description

The TRACE_TABLE option specifies the size of a wrap-around trace 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

UNIX

Windows

z/OS

Command Line, Short Form

n/a





Command Line, Long Form

-trace_table size, cond


(tick)

(tick)

(tick)

Environment Variable

UCMDTRACETABLE=size,condition

(tick)

(tick)

(tick)


Configuration File Keyword

trace_table size, cond

(tick)

(tick)

(tick)

(tick)

STRUCM Parameter

TRCTBL(size,cond)

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