Dynamic openUTM trace via an environment variable

A dynamic trace can be activated by setting the UTMTRAC environment variable.

The environment variable is evaluated when the process is started.
Default: the trace is disabled.

Syntax

Unix and Linux systems:

UTMTRAC=prog1#trace1[,[-]trace2 [, ...]][.file1][:prog2#trace1, ...][: ...]

export UTMTRAC

Windows systems

SET UTMTRAC=prog1#trace1[,[-]trace2 [, ...]][.file1][:prog2#trace1, ...][: ...]

Meaning of the parameters:

progn	Either all, when all openUTM programs are to be traced, or the openUTM program that is to be traced. The following programs are allowed: utmmain, utmwork, utmtimer, utmnet, utmdtp, ... kdcdef, kdcrem, ..., kdcupd and read and write accesses from kdcupd, kdcrV..., kdcrWV62A.
tracen	Either all, when all trace units are to be activated, or a number between 1 and UTM_MAX_TRACE_UNITS, inclusive, to activate the specified trace unit. Note: The optional minus sign in front of the respective entry explicitly disables trace units.
filen	Optional specification of the output file. file n can contain %d (Unix and Linux systems) or %%d (Windows systems): this placeholder is replaced by the current pid. If file n is not specified, the trace sends its output to stderr.

You can specify a list of programs in UTMTRAC with different specifications for the individual programs, trace units and output files, or you can enable the trace for all programs and trace units. You will find the definitions of the trace units in the xidyntrc.h header file supplied in the utmpath/include directory.

Example 1

Unix and Linux systems

UTMTRAC=all#all

export UTMTRAC

Windows systems

SET UTMTRAC=all#all ()

All trace units are enabled for all processes. The trace output is sent to stderr.

Example 2

Unix and Linux systems

UTMTRAC=utmwork#1.wrkp.%d

export UTMTRAC

Windows systems

SET UTMTRAC=utmwork#1.wrkp.%dd (Windows systems)

Trace unit 1 (KCXPIPE) is activated for utmwork. The trace is output to wrkp.pid (pid= current process ID of the utmwork process).

Example 3

Unix and Linux systems

UTMTRAC=utmwork#all,-1

export UTMTRAC

All trace units except unit 1 (KCXPIPE) are activated for utmwork. The trace output is sent to stderr.