UTMPATH
Meaning
Directory in which all components of openUTM and the applifile file are located. This environment variable must be specified in order to be able to run openUTM.
Range of values
Directory in which the files needed to run openUTM are located (utmpath, see "Installing UTM system functions on Unix and Linux systems").
Default value
Unix and Linux systems: no default value. UTMPATH must always be set.
Windows systems: UTMPATH is set at installation.
Process
Evaluated by every UTM process and when a UTM tool is started.
LANG
Meaning
Language in which the UTM messages are output.
Range of values
Language code, e.g. De_DE.646. An NLS catalog must be available for the language.
Default value
If LANG is not set or is set incorrectly (e.g. no NLS catalog was found for the language code specified), then the messages are output in English.
Process
Evaluates in every UTM process that outputs UTM messages when the process is started.
UTM_IPC_LETTER
Meaning
Specifies the size of the data area in IPC shared memory. The data area is used to store messages that are exchanged between the processes of an application. In UTM_IPC_LETTER you specify the number of 4KB blocks that are to comprise the data area.
Range of values
Minimum: 5 (i.e. 20KB)
Default value
Depends on the number of semaphores generated.
Process
Evaluated in the first work process at the start of a UTM application.
UTM_IPC_EXTP_LETTER
Meaning
Specifies the maximum size of the data area in IPC shared memory that is available for each connection. The value specified in UTM_IPC_EXTP_LETTER is interpreted as a number of 4KB blocks (see also "Improving performance: Changing the size of the data area in the IPC shared memory").
Range of values
Minimum: 1 (i.e. 4KB)
Default value
16 (i.e. 64KB).
Process
Evaluated in the first work process at the start of a UTM application.
UTM_REDIRECT_FILES
Meaning
Specifies whether output should be written to the existing system files stderr and stdout or their redirection destinations or not after the UTM application has been started. If UTM_REDIRECT_FILES is set to "YES", output is not written to stdout and stderr. The files are automatically switched over and output is written to the files prefix.out.YY-MM-DD.HHMMSS and prefix.err.YY-MM-DD.HHMMSS (see section "System files stderr and stdout").
Value range
The following values are possible:
Not set
"YES" (Unix and Linus systems)
Default
Not set. This behavior is compatible with previous versions of openUTM.
Process
This is evaluated by the utmmain process when a UTM application is started.
UTM_MAIN_KILL_TIME
Meaning
Contains the time in seconds by which the utmmain process is delayed by calling sleep():
before a work process is started
before all resources are deleted at the end of the application
before the named pipe to the utmlog process is deleted
after the utmshut process has been started. (Windows systems)
Range of values
1 through 99(sec)
Default value
1 sec
You can decrease the time it takes to terminate the UTM application or to subsequently start processes by setting UTM_MAIN_KILL_TIME to a smaller value.
Process
UTM_MAIN_KILL_TIME is evaluated when the UTM application is started in the process utmmain .
UTM_CORE_DUMP
Meaning
Prevents core dumps on Unix and Linux systems and mini dumps on Windows systems respectively from being created if
a UTM dump is created in the work process, or if
external UTM processes are terminated abnormally.
Range of values
If UTM_CORE_DUMP is set to "NO", no core dump or mini dump is created.
Default value
None. If not set at all or not set to "NO", a core dump or a mini dump is created in the situations described above.
Process
Evaluated in each UTM process when a core dump or a mini dump is requested.
UTM_MSG_DATE
Meaning
Prevents the date and time from being prefixed to the outputs with destinations STDOUT and STDERR.
Range of values
If the environment variable is set and contains the value "NO", neither the date nor time is prefixed to messages output to STDOUT and STDERR.
Default value
None. If the environment variable is not set or does not contain the value "NO", the date and time are prefixed to all UTM messages in order to aid diagnostics. Messages from UTM tools are exceptions; in this case, the date and time are never prefixed.
Process
UTM_MSG_DATE is evaluated in each UTM process when the process is started.
UTM_MSG_PID
Meaning
Prevents the PID from being prefixed to the outputs with destinations STDOUT and STDERR.
Range of values
If the environment variable is set and contains the value "NO", the PID is not prefixed to messages output to STDOUT and STDERR.
Default value
None. If the environment variable is not set or does not contain the value "NO", the PID is prefixed to all UTM messages in order to aid diagnostics.
Process
Evaluated once in the utmmain process when the UTM application is started.
UTMTRAC
Meaning
Optional switch to activate the dynamic trace.
Range of values
Selection of the UTM programs to be traced and the trace units. See the openUTM manual “Messages, Debugging and Diagnostics on Unix, Linux and Windows Systems” for the syntax.
Default value
None. If it is not set, then no dynamic trace will be created.
Process
Evaluated by every UTM process when the process is started.