SGD login scripts use and support a number of variables. The variables can be divided into guaranteed variables, that are always available, and optional variables, that are only available if they have a value.
To be able to use a variable in a login script, it must be defined
in the runsubscript.exp
login script.
The following sections list the guaranteed and optional variables, and a description of their purpose.
Guaranteed variables store the names of commands to run, the application server to log in to, and the connection method to use.
All login scripts use at least some of the guaranteed variables.
Guaranteed variables always exist, though they might have a null value.
Variable | Description |
---|---|
| The fully qualified Domain Name System (DNS) name of the user's client device and the display number being used. |
| The IP address of the user's client device and the display number being used. |
| Whether to use the manual or dialog method of dealing with aged passwords. |
| Whether to show a dialog box on the application server if the user's password is aged, missing or incorrect. This variable can have the following values:
|
| Any auxiliary commands to run on the application server. This corresponds to the application object's Window Manager attribute. |
| The IP address of the user's client device. This is the IP address obtained by the SGD Client. |
| The command to run on the application server. This corresponds to the application object's Application Command attribute. |
| The transport used to connect to the application server. This corresponds to the application object's Connection Method attribute. |
| Any environment variable settings required on the application server. This corresponds to the application object's Environment Variables attribute. |
| The application server that the login script connects to. This is chosen by application load balancing, from those listed on the Hosting Application Servers tab for the application object. |
|
The path to the |
| The application server's IP address. |
| The name of a file where error and diagnostic messages are logged.
By default, this has the form
If set to null, messages are not stored. To log messages in this file, include the following code in your login script:
|
| The port used to connect to the application server for the Connection Method configured for the application object. |
| The primary SGD server's fully qualified DNS name.
This lets the login script choose the correct
SGD printer when setting the default
printer value. It is used to differentiate between
multiple entries in the
|
|
The Expect script that runs after
|
| The fully qualified DNS name of the SGD server hosting the application session.
Used with |
| The fully qualified DNS name of the application server hosting the application.
Used with |
| The list of variables to export to the environment on the application server. |
| A temporary error file. |
| Whether the connection is broken once the command is executed. |
|
Whether the application is an X application. The value
of this variable is |
The following guaranteed variables are also defined in
runsubscript.exp
. These are variables used
by the SGD server when starting applications:
LANG
LANGUAGE
LC_ALL
LC_CTYPE
LC_NUMERIC
LC_TIME
LC_COLLATE
LC_MONETARY
LC_MESSAGES
LC_PAPER
LC_NAME
LC_ADDRESS
LC_TELEPHONE
LC_MEASUREMENT
LC_IDENTIFICATION
PATH
TTA_PreferredLocale
TTABASEDATADIR
TTADATADIR
TTADIR
Optional variables store additional information about the application, the user, and their session.
Optional variables are often used to test conditions and modify
the login script's behavior accordingly. Optional variables only
exist if they have a value. For example, the
TTA_ResumeTimeOut
variable only exists if the
application object's Application Resumability attribute has a
value.
Most optional variables contain the values of object attributes. The application being started has its application object's attributes made available as optional variables. Similarly, the attributes of the user profile are also made available in the same way. Other optional variables contain additional information about the user's session.
Variable | Description |
---|---|
| Corresponds to the Windows application object's Console Mode attribute. |
| Corresponds to a character application object's Border Style attribute. |
| Corresponds to the application object's Window Size: Height attribute. |
| Corresponds to the application object's Window Size: Width attribute. |
| The application object's fully qualified name. |
| Corresponds to the application object's Window Type attribute.
This variable can have the value
|
| Corresponds to the application object's Arguments For Command attribute. |
| Corresponds to the Windows Audio Quality attribute on the Global Settings → Client Device tab in the Administration Console.
This variable can have the value
|
| Corresponds to the character application object's Line Wrapping attribute. |
| Corresponds to the Background Color attribute for a 3270 or 5250 application object. |
| Corresponds to the 3270 or 5250 application object's Displayed Soft Buttons attribute.
This variable can have the value |
| Whether the user selected the Save This Password? box when they supplied a user name and password for the application server. |
| Corresponds to the character application object's Code Page attribute.
This variable can have the value
|
| Corresponds to the character application object's Color Map attribute. |
| Corresponds to the character application object's Window Size: Columns attribute. |
| Corresponds to the application object's Command Compression attribute.
This variable can have the value
|
| Corresponds to the application object's Command Execution attribute.
This variable can have the value
|
| Corresponds to the character application object's Escape Sequences attribute.
This variable can have the value
|
| Corresponds to the character application object's Cursor attribute.
This variable can have the value
|
| Corresponds to the character application object's Cursor Key Codes Modification attribute.
This variable can have the value
|
| Corresponds to the application object's Delayed Updates attribute. |
| Corresponds to the Windows application object's Cursor Settings attribute. |
| Corresponds to the Windows application object's Cursor Shadow attribute. |
| Corresponds to the Windows application object's Full Window Drag attribute. |
| Corresponds to the Windows application object's Menu Animations attribute. |
| Corresponds to the Windows application object's Theming attribute. |
| Corresponds to the Windows application object's Desktop Wallpaper attribute. |
| Corresponds to the application object's Emulator Applet Page attribute. Note This attribute is no longer used. |
| Corresponds to the user profile's Name attribute. |
| Corresponds to the application object's Domain Name attribute. |
| Corresponds to the Windows application object's Font Smoothing attribute. |
| Corresponds to the application object's Euro Character attribute.
This variable can have the value
|
| Corresponds to the application object's Application Command attribute. |
| Corresponds to the character application object's Font Size: Fixed attribute. |
| Corresponds to the character application object's Font Family attribute.
This variable can have the value
|
| Corresponds to the character application object's Font Size attribute. |
| Corresponds to the 3270 or 5250 application object's Foreground Color attribute. |
| Corresponds to the application object's Graphics Acceleration attribute. |
| Corresponds to the application object's Window Size: Height attribute.
This variable provides the same information as
|
| Corresponds to the application server object's Prompt Locale attribute. |
| The application server that the login script connects to. This is chosen by application server load balancing, from those listed on the Hosting Application Servers tab for the application object. |
| Corresponds to the 3270 or 5250 application object's Server Address attribute. |
| Corresponds to the application object's Icon attribute. |
| The application session ID. |
| Corresponds to the application object's Interlaced Images attribute.
This variable can have the value
|
| Corresponds to the 3270 or 5250 application object's Keyboard Type attribute.
This variable can have the value
|
| Corresponds to the application object's Keyboard Map attribute. |
| Corresponds to the character application object's Numpad Codes Modification attribute.
This variable can have the value
|
| Corresponds to the character application object's Window Size: Lines attribute. |
| The IP address of the SGD host. |
| Corresponds to the application object's Login Script attribute. |
| Corresponds to the 3270 or 5250 application object's Window Size attribute. |
| Corresponds to the application object's Middle Mouse Timeout attribute. |
| Corresponds to the Windows application object's Printer Preference Caching attribute. |
| The application object's fully qualified name.
This variable provides the same information as
|
| Corresponds to the 3270 or 5250 application object's Server Port attribute. |
| Corresponds to the Windows application object's Arguments attribute. |
| The IP address of the application server used to run the application. |
| Corresponds to the Windows application object's Remote Audio attribute. |
| Whether or not the application requires a display engine. |
| Corresponds to the application object's Application Resumability: Timeout attribute. |
| Corresponds to the application object's Window Color: Custom Color attribute. |
| Corresponds to the application object's Window Color attribute.
This variable can have the value
|
| Corresponds to the character application object's Scroll Style attribute.
This variable can have the value
|
| Corresponds to the user profile's Security tab. |
| Corresponds to the application object's Session Termination attribute.
This variable can have the value
|
| Corresponds to the 3270 or 5250 application object's 'File' and 'Settings' Menus attribute. |
| Corresponds to the character application object's Status Line attribute.
This variable can have the value
|
| Corresponds to the application object's Application Resumability attribute.
This variable can have the value
|
| Corresponds to the character application object's Emulation Type attribute.
This variable can have the value
|
| Corresponds to the character application object's Terminal Type attribute. |
| Corresponds to the 3270 or 5250 application object's Connection Closed Action attribute.
This variable can have the value |
| Corresponds to the 3270 or 5250 application object's Menu Bar attribute. |
| Corresponds to the application object's Connection Method attribute.
This variable can have the value
The guaranteed variable
|
| The fully qualified name of the user this application session is for. |
| Corresponds to the user profile's User Name attribute. |
| Corresponds to the UNIX Audio Quality attribute on the Global Settings → Client Device tab in the Administration Console.
This variable can have the value
|
| Corresponds to the X application objects Audio Redirection Library attribute. |
| Corresponds to the application object's Keep Launch Connection Open attribute. |
| Corresponds to the Webtop Theme attribute. Note This attribute is no longer used. |
| Corresponds to the application object's Window Size: Width attribute.
This variable provides the same information as
|
| Corresponds to the application object's Use Windows Cursor attribute. Note This attribute is no longer used. |
| The protocol used to connect to a Windows application server.
This variable can have the value
|
| Corresponds to the Windows application object's Local Client Launch attribute. Note This attribute is no longer used. |
| Corresponds to the Windows application object's Working Directory attribute. |