3.2 Setting Environment Variables
Initially, the application administrator sets the variables that
define the environment in which your application runs. These
environment variables are set by assigning values to the
ENVFILE parameter in the MACHINES section
of the UBBCONFIG file. (Refer to Setting Up an
Oracle Tuxedo Application for more information.)
For the client and server routines in your application, you can update existing environment variables or create new ones. The following table summarizes the most commonly used environment variables. The variables are listed by functional category.
Table 3-2 Programming-related Environment Variables by Functional Category
| Functional Category | Environment Variable | Defines the . . . | Used by . . . |
|---|---|---|---|
| Global | TUXDIR
|
Location of the Oracle Tuxedo system binary files. | Oracle Tuxedo application programs. |
| Configuration | TUXCONFIG
|
Location of the Oracle Tuxedo configuration file. | Oracle Tuxedo application programs. |
| Compilation | cc
|
command that invokes the C compiler. Default is cc .
|
buildclient(1) and buildserver(1) commands. |
CFLAGS
|
Link edit flags to be passed to the C compiler. Link edit flags are optional. | buildclient(1) and buildserver(1) commands. | |
| Data compression | TMCMPPRFM
|
Level of compression (between 1 and 9). | Oracle Tuxedo application programs that perform data compression. |
| Load balancing | TMNETLOAD
|
Numeric value that is added to the load value for remote queues, making the remote queues appear to have more work than they actually do. As a result, even if load balancing is enabled, local requests are sent to local queues more often than to remote queues. | Oracle Tuxedo application programs that perform load balancing. |
| Buffer management | FIELDTBLS or FIELDTBLS32
|
Comma-separated list of field table filenames for FML and FML32 typed buffers, respectively. Required only for FML and VIEW types. | FML and FML32 typed buffers and FML VIEWs |
FLDTBLDIR or FLDTBLDIR32
|
Colon-separated list of directories to be searched for the field table files for FML and FML32, respectively. For Windows 2003, a semicolon-separated list is used. | FML and FML32 typed buffers and FML VIEWs | |
VIEWFILES or VIEWFILES32
|
Comma-separated list of allowable filenames for VIEW and VIEW32 typed buffers, respectively. | VIEW and VIEW32 typed buffers | |
VIEWDIR orVIEWDIR32
|
Colon-separated list of directories to be searched for VIEW and VIEW32 files, respectively. For Windows 2003, a semicolon-separated list is used. | VIEW and VIEW32 typed buffers | |
| Buffer management | FIELDTBLS or FIELDTBLS32
|
Comma-separated list of field table filenames for FML and FML32 typed buffers, respectively. Required only for FML and VIEW types. | FML and FML32 typed buffers and FML VIEWs |
FLDTBLDIR or FLDTBLDIR32
|
Colon-separated list of directories to be searched for the field table files for FML and FML32, respectively. For Windows 2003, a semicolon-separated list is used. | FML and FML32 typed buffers and FML VIEWs | |
VIEWFILES or VIEWFILES32
|
Comma-separated list of allowable filenames for VIEW and VIEW32 typed buffers, respectively. | VIEW and VIEW32 typed buffers | |
VIEWDIR orVIEWDIR32
|
Colon-separated list of directories to be searched for VIEW and VIEW32 files, respectively. For Windows 2003, a semicolon-separated list is used. | VIEW and VIEW32 typed buffers | |
| Code-set encoding conversion | TPMBENC
|
Code-set encoding name to be included in an MBSTRING typed buffer or in an FLD_MBSTRING field in an FML32 typed buffer.
|
MBSTRING and FML32 typed buffers |
TPMBACONV
|
Non-Null or Null value that determines whether the encoding of the MBSTRING data or the FLD_MBSTRING field data in an FML32 typed buffer is converted when received by the destination process.
|
MBSTRING and FML32 typed buffers | |
| Cache external DTD, Schema, and entity files | URLENTITYCACHING
|
Flag to turn caching on/off for externally referenced files (DTD, Schemas, and entity reference.) | Oracle Tuxedo application programs that parse XML files. |
URLENTITYCACHEDIR
|
Absolute path of the directory to store the cached files. If the URLENTITYCACHING flag is turned on and no path is specified, the current working directory is used to store the cached files (provided appropriate permissions are set.).
|
Oracle Tuxedo application programs that parse XML files. | |
| Automatic conversion of XML to and from FML/FML32 | TPXARSFILE
|
Absolute path to a file containing pairs of XercesDOMParser class attributes and settings. | Oracle Tuxedo application programs that automatically parse XML data to and from FML/FML32 data. |
If operating in a UNIX environment, add $TUXDIR/bin
to your environment PATH to ensure that your
application can locate the executables for the Oracle Tuxedo system
commands. For more information on setting up the environment, see
Setting Up an Oracle Tuxedo Application.
See Also:
- Setting Up an Oracle Tuxedo Application
- “Setting Up Your Environment for FML and VIEWS” in Programming Oracle Tuxedo ATMI Applications Using FML
Parent topic: Programming Environment