E.3. 登录脚本变量

SGD 登录脚本使用并支持许多变量。变量可分为保证变量和可选变量,前者始终可用,后者仅在有值时才可用。

要在登录脚本中使用一个变量,必须在 runsubscript.exp 登录脚本中对其进行定义。

以下各节列出了保证变量和可选变量,并说明了它们的用途。

E.3.1. 保证的登录脚本变量

保证变量存储要运行的命令的名称、要登录的应用服务器以及要使用的连接方法。

所有的登录脚本都至少要使用一部分保证变量。

保证变量始终存在,即使值为空。

变量

描述

ALTDISPLAY

用户客户端设备的全限定域名系统 (Domain Name System, DNS) 名称以及要使用的显示编号。

DISPLAY

用户客户端设备的 IP 地址以及要使用的显示编号。

TTA_AGEDPASSWORD

是使用人工方法还是对话框方法来处理过期的密码。

TTA_ALLOWTHIRDTIERDIALOG

如果用户的密码过期、丢失或不正确,是否在应用服务器上显示一个对话框。此变量可以使用以下值:

  • user-如果用户在单击应用程序链接时按下 Shift 键,或者如果密码有问题,才显示对话框

  • system-仅当密码有问题时才显示对话框

  • none-从不显示对话框

TTA_AUXCOMMANDS

任何要在应用服务器上运行的辅助命令。这对应于应用程序对象的 "Window Manager"(窗口管理器)属性。

TTA_CLIENT_IPADDR

用户客户端设备的 IP 地址。这是 SGD 客户端所获得的 IP 地址。

TTA_COMMAND

要在应用服务器上运行的命令。这对应于应用程序对象的 "Application Command"(应用程序命令)属性。

TTA_CONNECTIONSERVICE

用于连接到应用服务器的传输方式。这对应于应用程序对象的 "Connection Method"(连接方法)属性。

TTA_ENVIRONMENT

应用服务器上所需的任何环境变量设置。这对应于应用程序对象的 "Environment Variables"(环境变量)属性。

TTA_HOSTNAME

登录脚本所连接到的应用服务器。这是通过应用程序负载平衡从应用程序对象的 "Hosting Application Servers"(托管应用服务器)选项卡上所列的应用服务器中选择的。

TTA_HOSTPROBE

ttahostprobe 二进制文件的路径。用于检查应用服务器是否可用。

TTA_IPADDRESS

应用服务器的 IP 地址。

TTA_LOGFILE

记录错误和诊断消息的文件的名称。

默认情况下,格式为 scriptID.log,其中,script 是登录脚本的名称,ID 是其在 SGD 服务器上的进程 ID。

如果设置为空,将不存储消息。

要将消息记录到此文件中,请在登录脚本中包含以下代码:

log_file $env(TTA_LOGFILE)

TTA_PORT

对于为应用程序对象配置的连接方法,这是用于连接到应用服务器的端口。

TTA_PRIMARY_DNSNAME

主 SGD 服务器的全限定 DNS 名称。

这使得登录脚本在设置默认打印机值时,可以选择正确的 SGD 打印机。该名称用于区分 /etc/ttaprinter.conf 文件中的多个项。

TTA_SCRIPT

runsubscript.exp 之后运行的 Expect 脚本,例如 unix.exp

TTA_SECOND_TIER_DNSNAME

承载应用程序会话的 SGD 服务器的全限定 DNS 名称。

TTA_THIRD_TIER_DNSNAME 一起使用可确定应用服务器和 SGD 服务器是否是同一服务器,如果是,则使用优化启动过程。

TTA_THIRD_TIER_DNSNAME

承载应用程序的应用服务器的全限定 DNS 名称。

TTA_SECOND_TIER_DNSNAME 一起使用可确定应用服务器和 SGD 服务器是否是同一服务器,如果是,则使用优化启动过程。

TTA_THIRD_TIER_VARS

要导出到应用服务器上的环境的变量列表。

TTA_STDERR

一个临时错误文件。

TTA_WILLDISCONNECT

执行命令后,是否中断连接。

TTA_XLAUNCH

应用程序是否是 X 应用程序。此变量的值为 01

以下保证变量也会在 runsubscript.exp 中进行定义。这些变量是 SGD 服务器在启动应用程序时所使用的:

  • 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

E.3.2. 可选登录脚本变量

可选变量存储有关应用程序、用户及其会话的附加信息。

可选变量通常用于测试运行条件并相应地修改登录脚本的行为。可选变量仅在有值时存在。例如,TTA_ResumeTimeOut 变量仅在应用程序对象的 "Application Resumability"(应用程序可恢复性)属性有值时存在。

大多数可选变量都包含对象属性的值。要启动的应用程序会将其应用程序对象的属性作为可选变量提供。类似地,用户配置文件的属性也以同样的方式提供。其他可选变量包含有关用户会话的附加信息。

变量

描述

TTA_AdminMode

对应于 Windows 应用程序对象的 "Console Mode"(控制台模式)属性。

TTA_Appearance

对应于字符应用程序对象的 "Border Style"(边框样式)属性。

TTA_AppletHeight

对应于应用程序对象的 "Window Size: Height"(窗口大小:高度)属性。

TTA_AppletWidth

对应于应用程序对象的 "Window Size: Width"(窗口大小:宽度)属性。

TTA_ApplicationName

应用程序对象的全限定名称。

TTA_ApplicationPlacement

对应于应用程序对象的 "Window Type"(窗口类型)属性。

此变量的值可以为:multiplewindows-客户端窗口管理,awtwindow-独立窗口,kiosk-kiosk,localx-本地 X 服务器,以及 seamlesswindows-无缝窗口。

TTA_Arguments

对应于应用程序对象的 "Arguments For Command"(命令的参数)属性。

TTA_AudioQuality

对应于管理控制台中 "Global Settings"(全局设置)→ "Client Device"(客户端设备)选项卡上的 "Windows Audio Quality"(Windows 音频质量)属性。

此变量的值可以为 lowmediumhigh

TTA_Autowrap

对应于字符应用程序对象的 "Line Wrapping"(自动换行)属性。

TTA_BackgroundColor

对应于 3270 或 5250 应用程序对象的 "Background Color"(背景色)属性。

TTA_ButtonLevels

对应于 3270 或 5250 应用程序对象的 "Displayed Soft Buttons"(显示的软按钮)属性。

此变量的值可以为:0-无按钮,1-2 行,2-4 行,3-6 行,以及 4-8 行。

TTA_CachePassword

用户提供应用服务器的用户名和密码时是否选择了 "Save This Password?"(是否保存此密码?)框。

TTA_CodePage

对应于字符应用程序对象的 "Code Page"(代码页)属性。

此变量的值可以为 4378508528608638658859-18859-2MultinationalMazoviaCP852

TTA_ColorMap

对应于字符应用程序对象的 "Color Map"(颜色映射)属性。

TTA_Columns

对应于字符应用程序对象的 "Window Size: Columns"(窗口大小:列数)属性。

TTA_Compression

对应于应用程序对象的 "Command Compression"(命令压缩)属性。

此变量的值可以为 automaticonoff

TTA_ContinuousMode

对应于应用程序对象的 "Command Execution"(命令执行)属性。

此变量的值可以为 automaticonoff

TTA_ControlCode

对应于字符应用程序对象的 "Escape Sequences"(转义序列)属性。

此变量的值可以为 7-bit8-bit

TTA_Cursor

对应于字符应用程序对象的 "Cursor"(光标)属性。

此变量的值可以为 offblockunderline

TTA_CursorKeyMode

对应于字符应用程序对象的 "Cursor Key Codes Modification"(光标键代码修改)属性。

此变量的值可以为 applicationcursor

TTA_DelayedUpdate

对应于应用程序对象的 "Delayed Updates"(延迟的更新)属性。

TTA_DisableCursorSettings

对应于 Windows 应用程序对象的 "Cursor Settings"(光标设置)属性。

TTA_DisableCursorShadow

对应于 Windows 应用程序对象的 "Cursor Shadow"(光标阴影)属性。

TTA_DisableFullWindowDrag

对应于 Windows 应用程序对象的 "Full Window Drag"(全窗口拖动)属性。

TTA_DisableMenuAnimations

对应于 Windows 应用程序对象的 "Menu Animations"(菜单动画)属性。

TTA_DisableTheming

对应于 Windows 应用程序对象的 "Theming"(主题)属性。

TTA_DisableWallpaper

对应于 Windows 应用程序对象的 "Desktop Wallpaper"(桌面壁纸)属性。

TTA_DisplayEnginePage

对应于应用程序对象的 "Emulator Applet Page"(仿真器 Applet 页)属性。

注意

此属性不再使用。

TTA_DisplayName

对应于用户配置文件的 "Name"(名称)属性。

TTA_Domain

对应于应用程序对象的 "Domain Name"(域名)属性。

TTA_EnableFontSmoothing

对应于 Windows 应用程序对象的 "Font Smoothing"(字体平滑)属性。

TTA_EuroMapping

对应于应用程序对象的 "Euro Character"(欧洲字符)属性。

此变量的值可以为 iso8859-15unicode

TTA_FilePath

对应于应用程序对象的 "Application Command"(应用程序命令)属性。

TTA_FixedFontSize

对应于字符应用程序对象的 "Font Size: Fixed"(字体大小:固定)属性。

TTA_FontFamily

对应于字符应用程序对象的 "Font Family"(字体系列)属性。

此变量的值可以为 courierhelveticatimesroman

TTA_FontSize

对应于字符应用程序对象的 "Font Size"(字体大小)属性。

TTA_ForegroundColor

对应于 3270 或 5250 应用程序对象的 "Foreground Color"(前景色)属性。

TTA_GraphicsAcceleration

对应于应用程序对象的 "Graphics Acceleration"(图形加速)属性。

TTA_Height

对应于应用程序对象的 "Window Size: Height"(窗口大小:高度)属性。

此变量提供与 TTA_AppletHeight 相同的信息。

TTA_HostLocale

对应于应用服务器对象的 "Prompt Locale"(提示语言环境)属性。

TTA_HostName

登录脚本所连接到的应用服务器。

这是通过应用服务器负载平衡从应用程序对象的 "Hosting Application Servers"(托管应用服务器)选项卡上所列的应用服务器中选择的。

TTA_IBMHostName

对应于 3270 或 5250 应用程序对象的 "Server Address"(服务器地址)属性。

TTA_Icon

对应于应用程序对象的 "Icon"(图标)属性。

TTA_InstanceName

应用程序会话 ID。

TTA_InterlacedImages

对应于应用程序对象的 "Interlaced Images"(交错式图像)属性。

此变量的值可以为 automaticonoff

TTA_KeyboardType

对应于 3270 或 5250 应用程序对象的 "Keyboard Type"(键盘类型)属性。

此变量的值可以为 pcsun4sun5hp

TTA_KeymapLock

对应于应用程序对象的 "Keyboard Map"(键盘映射)属性。

TTA_KeypadMode

对应于字符应用程序对象的 "Numpad Codes Modification"(数字键盘代码修改)属性。

此变量的值可以为 applicationnumeric

TTA_Lines

对应于字符应用程序对象的 "Window Size: Lines"(窗口大小:行数)属性。

TTA_LocalAddr

SGD 主机的 IP 地址。

TTA_LoginScript

对应于应用程序对象的 "Login Script"(登录脚本)属性。

TTA_Maximise

对应于 3270 或 5250 应用程序对象的 "Window Size"(窗口大小)属性。

TTA_MiddleMouseTimeout

对应于应用程序对象的 "Middle Mouse Timeout"(鼠标中键超时时间)属性。

TTA_NoPrintPrefs

对应于 Windows 应用程序对象的 "Printer Preference Caching"(打印机首选项缓存)属性。

TTA_ParentName

应用程序对象的全限定名称。

此变量提供与 TTA_ApplicationName 相同的信息。

TTA_PortNumber

对应于 3270 或 5250 应用程序对象的 "Server Port"(服务器端口)属性。

TTA_ProtocolArguments

对应于 Windows 应用程序对象的 "Arguments"(参数)属性。

TTA_RemoteAddr

用于运行应用程序的应用服务器的 IP 地址。

TTA_RemoteAudio

对应于 Windows 应用程序对象的 "Remote Audio"(远程音频)属性。

TTA_RequiresDisplayEngine

应用程序是否需要显示引擎。

TTA_ResumeTimeOut

对应于应用程序对象的 "Application Resumability: Timeout"(应用程序可恢复性:超时时间)属性。

TTA_RootColor

对应于应用程序对象的 "Window Color: Custom Color"(窗口颜色:定制颜色)属性。

TTA_RootType

对应于应用程序对象的 "Window Color"(窗口颜色)属性。

此变量的值可以为 defaultcolor

TTA_ScrollStyle

对应于字符应用程序对象的 "Scroll Style"(滚动样式)属性。

此变量的值可以为 normaljumpsmooth

TTA_SecureConnection

对应于用户配置文件的 "Security"(安全)选项卡。

TTA_SessionExit

对应于应用程序对象的 "Session Termination"(会话终止)属性。

此变量的值可以为:lastclient-最后一个客户端退出,windowmanager-窗口管理器退出,windowmanageralone-仅剩下窗口管理器,loginscript-登录脚本退出,nowindows-无可见脚本,以及loginscriptnowindows-登录脚本退出或无可见窗口。

TTA_SettingsItem

对应于 3270 或 5250 应用程序对象的 "File"(文件)和 "Settings"(设置)菜单属性。

TTA_StatusLine

对应于字符应用程序对象的 "Status Line"(状态行)属性。

此变量的值可以为 noneindicatorhost writablestandardextended

TTA_Suspend

对应于应用程序对象的 "Application Resumability"(应用程序可恢复性)属性。

此变量的值可以为 neversession(表示“用户会话”)和 forever(表示“始终”)。

TTA_TerminalClass

对应于字符应用程序对象的 "Emulation Type"(仿真类型)属性。

此变量的值可以为 scoconsolevt420wyse60

TTA_TerminalType

对应于字符应用程序对象的 "Terminal Type"(终端类型)属性。

TTA_TNClose

对应于 3270 或 5250 应用程序对象的 "Connection Closed Action"(连接关闭后执行的操作)属性。

此变量的值可以为:0-提示用户执行操作,1-退出仿真器,2-重新连接,以及 3-关闭连接。

TTA_TopMenuBar

对应于 3270 或 5250 应用程序对象的 "Menu Bar"(菜单栏)属性。

TTA_Transport

对应于应用程序对象的 "Connection Method"(连接方法)属性。

此变量的值可以为 rexectelnetssh

保证变量 TTA_CONNECTIONSERVICE 也提供此信息。

TTA_UserName

执行此应用程序会话的用户的全限定名称。

TTA_UserSecurityEquivalent

对应于用户配置文件的 "User Name"(用户名)属性。

TTA_UNIXAUDIO_QUALITY

对应于管理控制台中 "Global Settings"(全局设置)→ "Client Device"(客户端设备)选项卡上的 "UNIX Audio Quality"(UNIX 音频质量)属性。

此变量的值可以为 lowmediumhigh

TTA_UNIXAUDIOPRELOAD

对应于 X 应用程序对象的 "Audio Redirection Library"(音频重定向库)属性。

TTA_ViewHostReply

对应于应用程序对象的 "Keep Launch Connection Open"(使启动连接保持打开状态)属性。

TTA_WebTop

对应于 "Webtop Theme"(Webtop 主题)属性。

注意

此属性不再使用。

TTA_Width

对应于应用程序对象的 "Window Size: Width"(窗口大小:宽度)属性。

此变量提供与 TTA_AppletWidth 相同的信息。

TTA_WinCursor

对应于应用程序对象的 "Use Windows Cursor"(使用 Windows 光标)属性。

注意

此属性不再使用。

TTA_WindowsApplicationServer

用于连接到 Windows 应用服务器的协议。

此变量的值可以为:wincenterwincentermf-Citrix UNIX Integration Services,merge-SCO Merge,winframe-Citrix ICA,wts-Microsoft RDP,或 none。仅支持 Microsoft RDP。其他协议只能用于传统的 SGD Windows 应用程序对象。

TTA_WindowsApplicationSupport

对应于 Windows 应用程序对象的 "Local Client Launch"(本地客户端启动)属性。

注意

此属性不再使用。

TTA_WorkingDir

对应于 Windows 应用程序对象的 "Working Directory"(工作目录)属性。