BEA Logo BEA Tuxedo Release 8.0

  BEA Home  |  Events  |  Solutions  |  Partners  |  Products  |  Services  |  Download  |  Developer Center  |  WebSUPPORT

   http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary

 

   Tuxedo Documentation   |   File Formats and Data Descriptions Reference   |   Local Topics   |   Previous Topic   |   Next Topic   |   Contents

 

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

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 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 other BEA Tuxedo code. When a call is made to tmpnam(), the BEA Tuxedo system ignores the TMPDIR variable.

Note that for BEA Tuxedo release 6.5 or earlier, the BEA Tuxedo code responsible for transferring message files from clients to service queues would write a message file to the temporary location specified with the tmpnam() function if the service queue was too full to hold the message file; the code would then place the pathname of the temporary location on the service queue. For BEA Tuxedo release 7.1 or later, this code operates just like it did in previous releases except that the temporary location, if needed, is the pathname of the directory specified by TMPDIR assuming that the variable is set; if TMPDIR is not set, the temporary location becomes the one specified by the underlying operating 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).

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 Programming BEA Tuxedo ATMI Applications Using C, Setting Up a BEA Tuxedo Application, and Administering a BEA Tuxedo Application at Run Time.

Variables for Field Table Files and Viewfiles

The following environment variables are used by FML and VIEWS:

FIELDTBLS

Comma-separated list of field table files.

VIEWFILES

Comma-separated list of binary viewfiles.

FLDTBLDIR

Colon-separated list of directories to search for FIELDTBLS files.

VIEWDIR

Colon-separated list of directories to search for VIEWFILES files.

More information about these variables can be found in Setting Up a BEA Tuxedo Application, Administering a BEA Tuxedo Application at Run Time, Programming BEA Tuxedo ATMI Applications Using C, and the Programming BEA Tuxedo ATMI Applications Using FML.

File System and TLOG Variables

The following variables are used by the BEA Tuxedo system filesystem 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.

Workstation Variables

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.

More information on these variables can be found in Using the ATMI Workstation Component.

BEA Tuxedo /Q Variables

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

QMCONFIG

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

There is more information on this in Using the ATMI /Q Component.

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.

Note: On a Windows 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.

COBDIR

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 BEA Tuxedo ATMI Applications 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. In addition, in a high availability (HA) environment, PMID can be used to replace the machine name specified in the UBBCONFIG file with an alternate machine name. This allows for moving a master machine from master to backup in an HA cluster.

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.

TMNOTHREADS

To turn off multithreaded processing, set this variable to "yes". For applications that do not use threads, turning them off should significantly improve performance by reducing the amount of calls to mutexing functions.

TMSICACHEENTRIESMAX

Used to specify the amount of service and interface caching on a per-process basis. Valid values are the integers 0 through 32767. The value set for this variable will override any value in the UBBCONFIG file.

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

 

back to top previous page next page

 

Copyright © 2001 BEA Systems, Inc. All rights reserved.
Required browser: Netscape 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher.