TRACE_TABLE - UEM Manager configuration option

Description

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

Tracing is activated when the MESSAGE_LEVEL option is set to trace.


UNIX

The trace table is written to a file named uem.trc when the program ends under the conditions specified by TRACE_TABLE.

Windows

The trace table is written to a file named uem.trc when the program ends under the conditions specified by TRACE_TABLE.

z/OS

The trace table is written to a data set when the program ends under the conditions specified by TRACE_TABLE.

Usage

Method

Syntax

IBM i

HP NonStop

UNIX

Windows

z/OS

Command Line, Short Form

n/a

Command Line, Long Form

trace_table size[units],cond

(tick)

(tick)

(tick)

Environment Variable

UEMTRACETABLE=size[units][,cond]

(tick)

(tick)

Configuration File Keyword

trace_table size[units],cond

(tick)

(tick)

(tick)

Values

size is the size of the trace table.

If size is set to 0 (zero), the trace table is not used.

Default is 0.



units is the unit of storage for that size.

The valid values for units, and the maximum value that can be specified for size for that unit of storage, is:

  • b: bytes (2,147,483,647)
  • k: kilobytes (2,097,152)
  • m: megabytes (2,048)
  • g: gigabytes (2)

If a value for units is not specified, the file size is assumed to be in bytes.



cond specifies the condition under which the trace table is written.

Valid values for cond are:

  • error
    Writes the trace table if the program ends with a non-zero return code.
  • always
    Writes the trace table when the program ends regardless of the return code.
  • never
    Never write the trace table.

Default is never.