tuxputenv - change or add value to environment
#include <atmi.h> int tuxputenv(char *string)
string points to a string of the form ``name=value.'' tuxputenv makes the value of the environment variable name equal to value by altering an existing variable or creating a new one. In either case, the string pointed to by string becomes part of the environment.
This function provides a portable interface to environment variables across the different platforms on which TUXEDO is supported, including those platforms that don't normally have environment variables.
Note that tuxputenv is case-sensitive.
tuxputenv() returns a non-zero integer if it was unable to obtain enough space via malloc for an expanded environment, otherwise zero.
On MS Windows, this function overcomes the inability to share environment variables between an application and a Dynamic Link Library. The TUXEDO /WS DLL maintains an environment copy for each application that is attached to it. This associated environment and context information is destroyed when tpterm(3c) is called from a Windows application. The value of an environment variable may be changed after the application program calls tpterm(3c).
We recommended using uppercase variable names for the DOS, Windows, and OS/2 environments ( tuxreadenv(3c) converts all environment variable names to upper case).