tuxenv(5)
Name
tuxenv-list of environment variables in the BEA Tuxedo system
Description
In order to compile application clients and servers, and run the BEA Tuxedo system, it is important that the proper environment variables be set and exported. This reference page provides a list of the most frequently used variables.
The environment variables are grouped in the following sections:
- Operating System Variables
- Key BEA Tuxedo System Variables
- Variables for Field Table Files, View Files and MIO
- File System and TLOG Variables
- Workstation Variables
- System/Q Variables
- COBOL Variables
- DEBUG Variables
- Additional Miscellaneous Variables
Operating System Variables
- CC
- Standard C compiler for use by buildserver and other BEA Tuxedo commands.
- CFLAGS
- Contains flags to be used by the C compiler.
- EDITOR
- Specifies the editor to be invoked by the BEA Tuxedo system.
- LANG
- Used to set the locale for language specification. See nl_types(5).
- LOGNAME
- Specifies the username for use in error messages.
- LD_LIBRARY_PATH
- Must be set to the pathname for run-time shared libraries.
- NLSPATH
- Specifies the pathname for the message catalog. If not specified, a default path is used. See nl_paths(5).
- PAGER
- Specifies the paging command used for paging output in qmadmin(1), tmadmin(1). This overrides the system default (pg(1) on UNIX operating systems).
- PATH
- Contains pathnames to be searched for executables.
- SHELL
- The shell program to be invoked by the BEA Tuxedo system.
- TERM
- Specifies terminal type, if a terminal is used.
- TMPDIR
- The pathname of the directory where all temporary files should be written.
- TZ
- On systems where the ANSI C mktime functions does not exist, TZ must be set to use the BEA Tuxedo gp_mktime(3) function.
More information on these variables is available in the UNIX system reference page environ(5).
Key BEA Tuxedo System Variables
In general, the following environment variables should be set and exported:
- APPDIR
- Full pathname of the base directory for application files.
- APP_PW
- May be used to specify a password for system clients that prompt for an application password (when security is on). Setting the password in a variable allows the password to be provided from a script, rather than demanding manual entry.
- ENVFILE
- This variable is used by tmloadcf(1). It customarily contains setting for other BEA Tuxedo system environment variable, which are set automatically by the system.
- TLOGDEVICE
- The pathname for the transaction log. This should be the same as the TLOGDEVICE specified in the configuration file for the application.
- TUXCONFIG
- The pathname of the binary configuration file to be loaded by tmloadcf(1).
- ULOGPFX
- Prefix of the filename of the central event log; default, ULOG.
- TUXDIR
- Specifies the base directory where the BEA Tuxedo system software is installed.
More information about these variables can be found in the BEA Tuxedo Programmer's Guide and the BEA Tuxedo Administrator's Guide.
Variables for Field Table Files, View Files and Mio
The following environment variables are used by FML and VIEWS and by mio(1) clients:
- FIELDTBLS
- Comma-separated list of field table files.
- VIEWFILES
- Comma-separated list of binary view files.
- FLDTBLDIR
- colon-separated list of directories to search for FIELDTBLS files.
- VIEWDIR
- Colon-separated list of directories to search for VIEWFILES files.
- MASKPATH
- List of directories for mio(1) to search for binary masks.
- MSKIPCKEY
- The IPC key for shared memory for a mask cache.
- NGXACTS
- A comma-separated list of masks the current user is not permitted to use.
- OKXACTS
- A comma-separated list of masks the current user is permitted to use.
More information about these variables can be found in the BEA Tuxedo Administrator's Guide, the BEA Tuxedo Programmer's Guide, and the BEA Tuxedo FML Programmer's Guide.
File System and TLOG Variables
The following variables are used by the BEA Tuxedo system file system and the transaction log.
- FSCONFIG
- The pathname for the Universal Device List (UDL).
- FSMAXCOMMIT
- Sets the maximum size of the commit buffer.
- FSMAXUPDATE
- Sets the size of the update list and the maximum number of updates.
FSMSGREP
Sets the message repetition interval.
- FSOFFSET
- Specifies an offset into the Universal Device List (UDL).
Workstation Variables
The following variables are used on Workstation client machines:
- WSBUFFERS
- The number of packets per application.
- WSDEVICE
- The network device to be used for network access. For Workstation clients in Release 6.4 and higher, this variable is no longer required.
- WSENVFILE
- Pathname of a file containing Workstation client environment variables.
- WSNADDR
- The network address of the native site network listener.
- WSRPLYMAX
- The maximum message size before a message is dumped to a file for transfer.
- WSTYPE
- The machine type of the workstation machine.
More information on these variable can be found in the BEA Tuxedo Workstation Guide.
System/Q Variables
The following environment variable is used by BEA Tuxedo System/Q:
- QMCONFIG
- Sets the device where queue space is available to System/Q.
For more information, refer to the BEA Tuxedo /Q Guide.
COBOL Variables
The following environment variables are used with COBOL:
- ALTCC
- Specifies the compiler for use with COBOL compilations.
- ALTCFLAGS
- Flags to be passed to the COBOL compiler.
- COBCPY
- Directories to be searched for COBOL Copy files.
COBDIR
Specifies the directory where COBOL compiler software is located.
- COBOPT
- Contains command-line arguments for the COBOL compiler.
For more information on these variables, refer to the BEA Tuxedo COBOL Guide.
Additional Miscellaneous Variables
The following additional environment variables may be of use:
- MHSCACHE
- Specifies the number of message catalog handles to keep open (BEA Tuxedo system messages only). The default is 3.
- PMID
- In MP mode, can be used to specify the physical machine ID.
- TAGENTLOG
- Used to set the pathname for the tlisten(1) log.
- TMCMPLIMIT
- Used to specify whether compression should be used on messages and to set thresholds for both local and remote messages. The syntax of the variable is:
- TMCMPLIMIT=[remote_threshold[,local_threshold]]
- A threshold is a number in the range 0 to MAXLONG. It sets the minimum byte size of a message on which data compression will be performed.
- TMCMPPRFM
- This variable sets the compression level for any process that picks it up. Valid values are the integers 1 through 9; 1 results in somewhat less compression that the higher levels, but takes place faster. An informational ULOG message is written when a process reads TMCMPPRFM.
- TMNETLOAD
- Used to establish load balancing over a network. The value is an arbitrary number of units to be added to the load factor of remote services. Use of this variable tends to force the use of a local service.
- UIMMEDSIGS
- To override deferral of signals, set this variable to "Y".
- USPOOLDIR
- Names a directory to be used by the FRMPRT(5) server for temporary files. It defaults to /tmp.
See Also
buildclient(1), buildserver(1), viewc(1) cc(1), environ(5) in a UNIX system reference manual
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
Required browser: Netscape 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher.
|