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 |