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 C Function Reference

tuxgetenv() - return value for environment name

#include <atmi.h>  
char *tuxgetenv(char *name)

tuxgetenv() searches the environment list for a string of the form name=value and, if the string is present, returns a pointer to the value in the current environment. Otherwise, it returns a null pointer.

This function provides a portable interface to environment variables across the different platforms on which the BEA Tuxedo system is supported, including those platforms that do not normally have environment variables.

Note that tuxgetenv is case-sensitive.

A thread in a multithreaded application may issue a call to tuxgetenv() while running in any context state, including TPINVALIDCONTEXT.

If a pointer to the string exists, tuxgetenv() returns that pointer. If a pointer does not exist, tuxgetenv() returns a null pointer.

On MS Windows, this function overcomes the inability to share environment variables between an application and a Dynamic Link Library. The BEA Tuxedo Workstation DLL maintains an environment copy for each application that is attached to it. This associated environment and context information is destroyed when tpterm() is called from a Windows application. The value of an environment variable could be changed after the application program calls tpterm().

It is recommended that upper case variable names be used for the DOS, Windows, OS/2, and NetWare environments. (tuxreadenv() converts all environment variable names to upper case.)

tuxputenv(3c), tuxreadenv(3c)