Setting Environment variables on Unix, Linux and Windows systems

For XATMI applications, openUTM-Client interprets a number of environment variables. The environment must be set before the application is started.

For diagnostics while an application is running, traces can be activated.

Environment variables

The following environment variables are evaluatey by an XATMI application:

XTPATH	Path name for trace files. If this variable is not set, the trace files are written to the current directory (= directory from which the XATMI application was started).
XTLCF	Name of the local configuration file (LCF) The file name of the local configuration file must comply with the operating system conventions. If this variable is not set, a search is made under the name xatmilcf in the current directory.
XTPALCF	Defines the search path for additional descriptions of typed buffers. The buffer descriptions are read from local configuration files with the name xatmilcf or from the name specified in XTLCF. A search for all important XATMI versions (e.g. SVCU ...) is performed in the local configuration file specified using XTLCF. A search for local configuration files is performed in all the directories specified in XTPALCF and the typed buffer descriptions are gathered internally (If multiple buffers have the same name only the first buffer description is used). The search path structure is exactly the same as in the default Unix, Linux and Windows systems variable PATH: (directory1 : directory2 : ... or directory1 ; directory2 ; ...). If the specified search path has more than 1024 characters the path is truncated! There is a maximum of 128 LCF entries.
XTSVRTR E I F	Trace mode for the XATMI application. Possible specifications: (error): activates the error trace (interface): activates the interface trace for XATMI calls (full): activates the full XATMI trace as well as the trace for sub-layers.

Setting environment variables on Windows systems

On Windows systems, you can set environment variables using the Start/Settings/Control Panel. You can then create or expand the environment variables here. On Windows systems, these settings remain valid until you change them again.

Setting environment variables on Unix and Linux systems

On Unix and Linux systems, environment variables are set using the following command:

SET variablename = value

The environment variables are valid for one shell only; other values may apply for applications in another shell.