Setting Domain-Level Environment Variables

In most cases, you may not need to modify or add domain-level environment variables.

Some reasons to set a domain-level environment variable are:

  • custom PeopleCode may require a domain-level environment variable.

  • additional tracing may require additional Tuxedo environment variables, if specified in your Tuxedo documentation.

  • an Oracle Support analyst may request a specific environment setting for troubleshooting issues.

Note:

PS_HOME, PS_CFG_HOME, PS_APP_HOME and PS_CUST_HOME environment variables should not be set at the domain-level and can cause undesirable results if set at the domain level.

The following table describes the default environment settings for the Application Server that are exposed at the domain level:

Environment Setting Description

TEMP

Path to the temp log access for that domain.

TMP

Path to the temp log access for that domain.

TM_BOOTTIMEOUT

Time allowed before Tuxedo performs a timeout for a domain boot.

TM_RESTARTSRVTIMEOUT

Time allowed before Tuxedo performs a timeout for a server process restart.

TM_BOOTPRESUMEDFAIL

TM_BOOTPRESUMEDFAIL is an indicator to the Tuxedo system that dictates how the domain should behave if a process fails to start before TM_BOOTTIMEOUT (above) has been reached.

When set to Y, no further domain processes will be started and any existing domain processes will be terminated.

If set to N, the boot process will proceed. By default, this is set toY because domains cannot be relied upon to function correctly if any of the domain processes fail to start in a timely fashion.

FLDTBLDIR32

The directory in which field buffer descriptor files are located. This is an internal Tuxedo setting.

Modification of this value could result in unpredictable behavior as Tuxedo will be unable to locate its buffer descriptor files.

FIELDTBLS32

The list of the buffer descriptor files that are required by the domain runtime. These files are located in the directory defined by the FLDTBLDIR32 variable. This is an internal Tuxedo setting.

Modification of this value could result in unpredictable behavior as Tuxedo may allocate buffers incorrectly.

ALOGPFX

Path to the Tuxedo access log for that domain.

COBPATH

COBOL path for that domain.

IPC_EXIT_PROCESS

Indicates that the process should be shutdown in a graceful fashion, allowing cleanup functions to execute.

This is analogous to normal shutdown and is achieved by using the MS C++ ExitProcess function.

Typically this value or IPC_TERMINATE_PROCESS is set. These values should be considered to be mutually exclusive.

IPC_TERMINATE_PROCESS

IPC_TERMINATE_PROCESS is an indication that the process should exit immediately.

This is analogous to a process kill or forced shutdown. The exit handlers do not have an opportunity to run. This would typically be used in a situation where the process has failed to respond to a normal shutdown instruction.

Typically this value or IPC_EXIT_PROCESS is set. These values should be considered to be mutually exclusive.

PATH

Specifies a set of directories where executable programs are located for that domain.

The following table describes the default environment settings for the Process Scheduler Server that are exposed at the domain level:

Environment Setting Description

COBPATH

COBOL path for that domain.

PATH

Specifies a set of directories where executable programs are located for that domain