Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary
Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo File Formats and Data Descriptions Reference

tuxenv - list of environment variables in the BEA Tuxedo system

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 and View Files

• File System and TLOG Variables

• Workstation Variables

• BEA Tuxedo /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 user name 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 nlpaths(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 a directory in which temporary files may be written. (Temporary files may also be written to a location specific to an operating system, as specified with the tmpnam() function, which is called by the BEA Tuxedo MIB and code used for transferring message files. When a call is made to tmpnam(), then the TMPDIR variable is ignored by the BEA Tuxedo system.)

TZ

on systems where the ANSI C mktime functions does not exist, TZ must be set to use the BEA Tuxedo gp_mktime(3c) function.

More information on these variables is available in the UNIX System reference page environ(5).

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.

The following environment variables are used by FML and VIEWS:

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.

The following variables are used by the BEA Tuxedo system file system and the transaction log.

FSCONFIG

the pathname for the Universal Device List.

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.

The following variables are used on Workstation client machines:

WSALLOWPRE71

determines whether the workstation machine running BEA Tuxedo 7.1 or later software is allowed to interoperate with pre-Release 7.1 BEA Tuxedo applications. Setting the variable to Y (WSALLOWPRE71=Y) allows interoperability.

WSBUFFERS

the number of packets per application.

WSDEVICE

the network device to be used for network access. For Workstation clients in BEA Tuxedo Release 6.4 and higher, this variable is no longer required.

WSENVFILE

pathname of a file containing Workstation client environment variables.

WSFADDR

the network address used by the Workstation client when connecting to other machines. This variable, along with the WSFRANGE variable, determine the range of TCP/IP ports to which a process will attempt to bind before making an outbound connection.

WSFRANGE

the range of TCP/IP ports to which a native process will attempt to bind before making an outbound connection. The WSFADDR variable specifies the base address of the range.

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.

The following environment variable is used by BEA Tuxedo /Q:

QMCONFIG

sets the device where queue space is available to BEA Tuxedo /Q.

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.

Note: On a Windows NT system, the ALTCC and ALTCFLAGS environment variables are not applicable and setting them will produce unexpected results. You must compile your application first using a COBOL compiler and then pass the resulting object file to the buildclient(1) or buildserver(1) command.

COBCPY

directories to be searched for COBOL Copy files.

specifies the directory where COBOL compiler software is located.

COBOPT

contains command line arguments for the COBOL compiler.

There is more information on these variables in the Programming a BEA Tuxedo Application Using COBOL.

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".

See Also

buildclient(1), buildserver(1), viewc, viewc32(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.