Environment Variables

ToolTalk Environment Variables

There are several ToolTalk environment variables that may be set:

TTSESSION_CMD
TT_ARG_TRACE_WIDTH
TT_FILE
TT_HOSTNAME_MAP
TT_PARTITION_MAP
TT_SESSION
TT_TOKEN
TTPATH
DISPLAY

Table 3-1 describes these variables.

Table 3-1 Environment Variables

Variable	Description
TTSESSION_CMD	Overrides the standard options specified when tools automatically start ttsession. If this variable is set, all ToolTalk clients use this command to automatically start their X sessions.
TT_ARG_TRACE_WIDTH	Defines the number of characters of argument and context values to print when in trace mode. The default is to print the first 40 characters.
TT_FILE	ttsession places a pathname in this variable when a tool is invoked by a message scoped to the defined file.
TT_HOSTNAME_MAP	Points to a map file. The defined map file is read into the ToolTalk client for redirecting host machines.
TT_PARTITION_MAP	Points to a map file. The defined map file is read into the ToolTalk client for redirecting file partitions.
TT_SESSION	ttsession communicates its session identifier to the tools that it starts. If this variable is set, the ToolTalk client library uses its value as the default session identifier. NOTE: The string stored in this variable can be passed to tt_default_session_set.
TT_TOKEN	Notifies the ToolTalk client library that it has been started by ttsession; the client can then confirm to ttsession that the start was successful.
TTPATH	Tells the ToolTalk service where the ToolTalk Types databases reside. The format of this variable is: userDB[:systemDB[:networkDB]]
DISPLAY	Causes ttsession to communicate its session identifier to the tools that it starts if the TT_SESSION variable is not set.If the DISPLAY variable is set, the ToolTalk client library uses its value as the default session identifier.

A process is given a modified environment when it is automatically started by the ToolTalk service. The modified environment includes the environment variables $TT_SESSION, $TT_TOKEN, and any contexts in the start-message whose keyword begins with the dollar sign symbol ($). Optionally, the environment variable $TT_FILE may also be included in the modified environment if it is a file-scoped message.




	NOTE: If the tt_open call will be invoked by a child process, the parent process must propagate the modified environment to that child process.

Other Environment Variables

The TMPDIR environment variable is another environment variable that you can set to manipulate the ToolTalk development environment; for example:

TMPDIR=/var/tmp

redirects files to the /var/tmp directory.

Using Context Slots to Create Environment Variables

Message contexts have a special meaning when the ToolTalk service starts an application. If the name of a context slot begins with a dollar sign ($), the ToolTalk service interprets the value as an environment variable: for example

start "my_application $CON1"

uses the value of context slot $CON1.

Environment Variables

Technical documentation

» Table of Contents

» Glossary

ToolTalk Environment Variables

Other Environment Variables

Using Context Slots to Create Environment Variables