This chapter provides the supported parameters that you can use in a wlx.ini file, a $MAC.ini file, and in a {username}.ini file.
The underlined value for a parameter is the default value. Some parameters also have options shown within brackets [ ]. If an option has an underlined value (default), that option and default value will automatically be used with the parameter (options without underlined values can also be used if you want to, but are not automatically used with the parameter). In addition, when using parameters and options, you can leave the default value or change it to another value shown.
For example, in the following case where:
ParameterX={yes, no}
[Option1={0, 1}]
[Option2={1, 2, 3, 4}]
If you use ParameterX, then Option1 and its default value 0 will automatically be used as Option1 has an underlined value (default of 0). You can still use Option2 if you want to, however, Option2 is not automatically used with the parameter as Option2 does not have a default (underlined) value.
To increase usability (such as relation to thin client dialog box equivalents), the supported parameters are separated into the following categories:
The following table describes the parameters that you can use to configure general settings. Default values are underlined. You can use the parameters in a wlx.ini file or a $MAC.ini file.
Depending on the type of application window you are using (full screen, standard, or seamless), you can use shortcut keys to manage windows.
You can disable some of these shortcuts by including the INI parameters listed below in your INI file. By default, every shortcut listed is enabled. (Possible values for each parameter are yes or no.)
![]() Note | The keyboard shortcuts listed below are applicable only in the SUSE Linux desktop. The disable INI parameters listed are provided so that you can disable the shortcuts in the SUSE Linux desktop, so that they do not conflict with shortcuts entered in the HVD. |
Press | Action | INI parameter to disable shortcut |
---|---|---|
Alt+F4 | Close window | Cisco.DisableKeyBinding.Close=yes |
Ctrl+F4 | Close browser window | Cisco.DisableKeyBinding.Close=yes |
Alt+F10 | Maximize window | Cisco.DisableKeyBinding.ToggleMaximized=yes |
Alt+F9 | Minimize window | Cisco.DisableKeyBinding.Minimize=yes |
Alt+Ctrl+DownArrow | Minimize or maximize all windows | Cisco.DisableKeyBinding.ShowDesktop=yes |
Alt | Mouse modifier (used by default as a mouse modifier) | Cisco.DisableKeyBinding.MouseButtonModifier=yes |
Alt+Esc | Move focus to next window | Not applicable |
Alt+Shift+Esc | Move focus to previous window | Not applicable |
Alt+F7 and press an arrow key | Move window with arrow keys | Cisco.DisableKeyBinding.Move=yes |
Alt+F8 and press an arrow key | Resize the window | Cisco.DisableKeyBinding.Resize=yes |
Alt+F5 | Restore maximized window to previous size | Cisco.DisableKeyBinding.UnMaximize=yes |
Ctrl+F2 | Switch keyboard focus back to thin client (used by Citrix Linux receiver to bring keyboard focus back to thin client locally) | Not applicable |
Alt+DownArrow | Switch windows using a dialog box | Cisco.DisableKeyBinding.SwitchWindows=yes |
Alt+Ctrl+Shift+DownArrow | Switch panel focus | Not applicable |
Alt+Ctrl+Delete | Show Logout option | Cisco.DisableKeyBinding.RunCommand1=yes |
Alt+F1 | Show Computer Menu window | Cisco.DisableKeyBinding.PanelMainMenu=yes |
Ctrl+Esc | Show Windows start menu | Cisco.DisableKeyBinding.PanelMainMenu=yes |
Windows Key | Show main panel list when keyboard focus is shifted to the thin client | Cisco.DisableKeyBinding.PanelMainMenuList=yes |
Alt+Space (you can also right-click the window title bar or border, or click the window icon) | Show window menu | Cisco.DisableKeyBinding.WindowMenu=yes |
PrintScreen key | Print screen | Cisco.DisableKeyBinding.PrintScreen=yes |
CTRL+ALT+l | Lock screen | Cisco.DisableKeyBinding.ScreenSaver=yes |
CTRL+ALT+UP Arrow | Change window between kiosk and normal mode | Cisco.DisableKeyBinding.ToggleFullscreen=yes |
![]() Tip | The shortcut keys Alt+DownArrow (allows you to switch windows using a dialog box) and Alt+Ctrl+DownArrow (minimizes or maximizes all windows) are useful for navigating multiple remote sessions without having to log out. |
The following table contains parameters used for configuring peripheral settings such as keyboard, monitor, mouse, printer, and so on (underlined values are defaults).
Parameter | Description | ||
---|---|---|---|
DeskColor="<primary color> [{solid, horizontal-gradient, vertical-gradient}<secondary color>]" |
Specifies the desktop background color where <primary color> and <secondary color> can be one of the following values:
Note that an optional shading can be specified (solid, horizontal-gradient, vertical- gradient). The <primary color> is the primary color and the one which will be used if no shading is specified or if the shading is solid. The optional <secondary color> is the secondary color. When shading is specified (for example Deskcolor= "DarkGoldenrod horizontal-gradient LightGoldenrod"), the primary color (in this example, DarkGoldenrod) appears on the left (horizontal) or top (vertical) edge with a smooth transition to the secondary color (in this example, LightGoldenrod) on the opposite edge. |
||
Desktop=<image file> [Layout={Center, Tile, Stretch, Scale, None} [Opacity=<value of 0-100>] |
Default
is no wallpaper.
Desktop-Specifies an image file to use as wallpaper for the local desktop. The file must be located in the wlx/bitmap directory on the server. The image file can be any type that is supported by SUSE/GNOME for use as wallpaper (such as PNG, JPG, and GIF). The filename is case sensitive. Layout- Default is Center. Specifies the arrangement on the desktop background of the specified image file. The tile value replicates the image across the desktop; the stretch value adjusts the image to fill the screen; the scale value enlarges the image to fill either the screen width or height. Opacity- Default is 100. Specifies the amount of transparency. At less than 100, the image is blended with the colors specified by the DeskColor option as though the image is not entirely opaque. A value of 0 indicates total transparency, and the image is not displayed at all. For Example: Desktop=ciscologo.gif Layout=Tile Opacity=25 |
||
DesktopColorDepth={8, 16, 24} |
Default
is 24.
Specifies the number of colors of the desktop in bits. 8 is 256 colors; 16 is High Color; and 24 is True Color. |
||
DisplaySettings=MON1 <resolution> <position> [ MON2 <resolution> <position>] |
MON1 and MON2 define the display settings for single and multi-monitor displays (clone and span mode). Possible values for: resolution={{X}x{Y}, DDC} position={mirror, on-left, on-right, on-above, on-below}
Examples: DisplaySettings=MON1 1024x768 on-left MON2 1024x768@75 on-right DisplaySettings=MON1 1024x768 on-above MON2 1024x768@75 on-below |
||
EnableNumLock={no, yes} |
Default
is no.
Specifies whether to enable the default state of the numeric keypad. If set to yes, the numeric keypad is activated, if set to no (default), the numeric keypad becomes the cursor control pad. |
||
JetDirectPrinter=<value of an option> |
The JetDirectPrinter command line defines a printer served by an HP JetDirect print server. For parameter options that are used in the command line, see JetDirectPrinter in Printer Parameter Options. |
||
Keyboard.layouts=<value of Keyboard.layouts> |
The Keyboard.layouts parameter specifies the keyboard layout. For a list of supported keyboard layout values, see Keyboard.layouts Parameter Values. Example: Keyboard.layouts=us (for United States) Keyboard.layouts=ru (for Russia) |
||
MouseLocate={no, yes) |
Default
is no.
Specifies whether to briefly display an animated graphic showing the location of the mouse pointer when pressing and releasing the Ctrl key (with no other keys pressed). |
||
MouseSendsControlV={no, yes} |
For ICA
only.
Default is no.
Allows the administrator to control the mouse button action in a UNIX environment. The values are: yes-In a UNIX environment, a middle mouse performs the same Paste function as the Ctrl+V keystroke combination in Windows. no-(default) Disables "enable middle button paste" when used in the wlx.ini file with ICA v.10. |
||
MouseSpeed=<value of 0 to 100> |
Specifies the speed when moving the mouse.
0-Slow (0.2) 1-Medium (default) (2.0) 2-Fast (6.0) |
||
MouseSwap={no, yes} |
Default
is no.
Specifies whether to swap the button order on the mouse. The default value is no. |
||
NetworkPrinter=<value of an option> |
Defines a printer that uses traditional UNIX Line Printer Daemon protocols. For parameter options that are used in the command line, see NetworkPrinter in Printer Parameter Options. |
||
Printer=<value of an option> |
Defines a locally attached printer that is connected through the noted interface. For parameter options that are used in the command line, see Printer in Printer Parameter Options. |
||
PrinterURI=<value of an option> |
Defines a printer using a URI supported by the Common UNIX Printing System (CUPS). This command is useful when you want the thin client to access a printer for which you already have a working CUPS client because you can simply copy the URI from the /cups/printers.conf file on the existing client. For parameter options that are used in the command line, see PrinterURI in Printer Parameter Options. |
||
RepeatDelay={<value in milliseconds>, <supported value for backwards compatibility>} |
Default
is 660 milliseconds.
Expresses, in milliseconds (100-10000), the delay before a repeat key press is recognized. Enter a value greater than 100. For backward compatibility, you can also use the following values: 0-1/4 second 1-1/4 second 2-1/2 second (default) 3-1/2 second 4-3/4 second 5-3/4 second 6-1 second 7-1 second |
||
RepeatRate={<value of 3 to 255>, <supported value of 0 to 2>} |
Expresses the number of allowable repeat key presses per second. Enter a value between 3 and 255 or a designated rate, as follows: Value and Keyboard Repeat Rate0-Slow (GUI value is 10) 1-Medium (default) (no GUI value) 2-Fast (GUI value is 110) |
||
SMBPrinter=<value of an option> |
Defines a network printer shared through the Windows Server Message Block protocols. For parameter options that are used in the command line, see SMBPrinter in Printer Parameter Options. |
||
TransparentKeyPassThrough= {Local, Remote, FullScreenOnly} |
Default
is FullScreenOnly.
Enables keyboard shortcut sequences defined by the local Windows manager in the session. FullScreenOnly-Key event is processed locally except in Fullscreen mode Local-Key event is processed locally in order to use ICA hotkeys Remote-Key event is forwarded to the server so that ICA hotkeys do not work. |
The following table describes the parameters that you can use to configure connection settings. Default values are underlined.
Parameter | Description | ||||
---|---|---|---|---|---|
Alternate={no, yes} |
For ICA only. Default is no. Specifies the use of an alternate IP address returned from an ICA master browser to get through firewalls. |
||||
Browser.ClearBrowserData={yes,no} |
For Browser only. Yes/no option to clear out or persist the browser history across different thin client users. Yes - Clears out browser data across different user logins. No - Persists the browser data across different user logins. |
||||
Browser.Homepage=<URL> |
If the browser add-on is installed, this is the home page for the browser. |
||||
Browser.Prefsurl=<URL> |
If the browser add-on is installed, this is the URL to download preferences. |
||||
Connect={BROWSER, Custom, ICA, RDP, SSH, Ericom_PowerTerm, Ericom_WebConnect, VMWARE_VIEWCLIENT, VNC_VIEWER, XDMCP} |
Specifies the connection protocol. To create a connection using an INI file, you must specify the Connect= parameter, as well as the mandatory connect options associated with the specified connection type. Connect Parameter Options describes these parameters:
|
||||
EnableUDPAudio={no, yes} |
For ICA only Default is no. Yes/no option to enable the transport of audio data as UDP. |
||||
H264Enabled={yes, no} |
For ICA only Default is yes. Yes/no option to enable deep compression codec support. |
||||
HDXH264CaptureBin=<name> |
For ICA only Default is null. Name of the customized H264 CaptureBin. |
||||
HDXH264InputEnabled={no, yes} |
For ICA only Default is no. Yes/no option to enable H264 encoding is attempted because an H264 encoder (gstreamer plugin) is present. The default is no, which enables Theora encoding. |
||||
HDXWebCamDevice=<webcam device> |
For ICA only Default is /dev/video0. Selects the webcam device. |
||||
HDXWebCamFramesPerSec= <integer> |
For ICA only Default is 15. Sets the preferred frame rate. |
||||
HDXWebCamWidth=<integer> HDXWebCamHeight=<integer> |
For ICA only These settings control the resolution parameters. The defaults are HDXWebCamWidth=352 and HDXWebCamHeight=288. |
||||
HomePage=<URL> |
If the browser add-on is installed, this is the URL to the home page for the browser. |
||||
ICABrowsing={udp, http, https} |
For ICA only. Default is http. Specifies the default browsing protocol. This setting can be overridden by the HttpBrowsing={yes,no,ssl} in each connection property. |
||||
ICAComports=COMx={COMy, USBSERz}, COMx=... |
For ICA
only.
Maps serial devices on the server to serial devices on the thin client, where x=1 to 4; if COMy, map to that serial port on the thin client; if USBSERz, map to that USB serial port.
|
||||
ICADesktopApplianceMode={yes, no} |
For ICA only. Default is yes. Specifies whether to enable Citrix HDX USB startup (for Desktop Appliance Mode) for any USB devices that are already plugged in (the USB device will start up provided the device is not disallowed with a deny rule in the USB policies on either the server [registry entry] or the client [policy rules configuration file]). This parameter requires two thin client reboots. |
||||
ICADrives=<drive letter>={floppy, cdrom, disk}, {rw, ro}, basedir [drive letter=...] |
For ICA
only.
To map drives on the server to USB mass storage devices that are attached to the thin client, where: drive letter=A to Z floppy=USB floppy cdrom=USB CDROM disk=USB drive or memory stick rw=read/write ro=read only basedir is an optional directory on the USB device to use.
|
||||
ICAEnhancedAudio={no, yes} |
For ICA only. Default is no. Enables/Disables Citrix enhanced audio. true—enables Citrix enhanced audio false—disables Citrix enhanced audio |
||||
ICAhotkey={yes, no} [<hotkey value>=<supported value>] |
For ICA only. Default is yes. Specifies whether to allow mapping of the hotkeys. For example: ICAhotkey=yes Hotkey1Char=F1 Hotkey1Shift=Shift Hotkey2Char=F3 Hotkey2Shift=Shift Hotkey3Char=F2 Hotkey3Shift=Shift Hotkey4Char=F1 ..... Hotkey11Char=plus Hotkey11Shift=Ctrl
|
||||
ICAMMAudio={yes, no} |
For ICA only. Default is yes. Specifies whether to enable Citrix HDX MultiMedia audio (see also ICADesktopApplianceMode and ICAMMVideo parameters). This parameter requires two thin client reboots. For example: To redirect audio to a USB audio device, set the following parameters as shown: ICADesktopApplianceMode=yes ICAMMVideo=yes ICAMMAudio=no To redirect audio to an analog audio device, set the following parameters as shown: ICADesktopApplianceMode=yes ICAMMVideo=yes ICAMMAudio=yes |
||||
ICAMMVideo={yes, no} |
For ICA only. Default is yes. Specifies whether to enable Citrix HDX MultiMedia video (see also ICADesktopApplianceMode and IcaMMAudio parameters). This parameter requires two thin client reboots. For example: To redirect audio to a USB audio device, set the following parameters as shown: ICADesktopApplianceMode=yes ICAMMVideo=yes ICAMMAudio=no To redirect audio to an analog audio device, set the following parameters as shown: ICADesktopApplianceMode=yes ICAMMVideo=yes ICAMMAudio=yes |
||||
ICAMultiMedia={no, yes} |
For ICA only. Default is no. Specifies whether to enable Citrix multimedia redirection. yes—Enables Citrix multimedia redirection no—Disables multimedia redirection |
||||
ICAProxyHost=<proxy server IP address> |
For ICA
only.
Specifies the firewall server address for the ICA connection. When you configure an alternate address for firewalls, and you specify HTTPS or SOCKS for the ICAProxyType, you must specify the proxy server IP address and port. You must specify each entry as host:port, where :port is optional. If you do not specify the port, the value depends on the browsing protocol. |
||||
ICAProxyType=[None, HTTP, SOCKS] |
For ICA
only.
Defines the proxy type for the ICA connection. When you configure an alternate address for firewalls, you can select the proxy type of None, HTTP, or SOCKS. |
||||
ICAStoreName =<global ICA store name> |
For ICA only. Specifies the Global ICA Store name which is used for PNAgent Login. |
||||
NFuseServer=<host address>[:<port>][;<host address> [:<port>]] |
DO NOT
USE.
This parameter is being deprecated and the use of PNAgentServer is recommended. |
||||
NLA={no, yes} |
For RDP only. Default is no. Specifies whether to enable Network Level Authentication for RDP sessions. |
||||
PNAgentServer=<host address or URL>[:<port>][;<host address or URL> [:<port>]] |
Specifies a list of PNAgent servers or complete URL. If you do not specify a port, the port value depends on the browsing protocol. Default is Empty. |
||||
PNLiteServer=<host address>[:<port>][;<host address> [:<port>]] |
DO NOT
USE.
This parameter is being deprecated and the use of PNAgentServer is recommended. |
||||
UseLastLoginName={True, False} |
Default is False. If this ini parameter is set, then in the GDM login window, the username field is populated with the previous logged in domain username value. This ini parameter is valid only for domain login and not for local user login. |
||||
UseLastDomainName={True, False} |
Default is False. If this ini parameter is set, then in the GDM login window, the domain field is populated with the previous logged in domain name value. This ini parameter is valid only for domain login not for local user login. |
||||
Serial={COM1, COM2, COM3, COM4} {Baud={1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200}} {Parity={None, Even, Odd, Mark, Space}} {Stop={1, 1.5, 2}} {Size={5, 6, 7, 8}} {Flow={None, XON/XOFF, CTS/RTS, Both}} |
Default
is COM1.
Configures local serial ports: Serial—Specifies the configuration for local serial ports. Baud—Specifies the local serial port baud rate. Parity—Specifies the local serial port parity. Stop—Specifies the local serial port stop. Size—Specifies the local serial port size. Flow—Specifies the local serial port flow.
|
||||
SpeedScreenMMAClosePlayerOnEOS={no, yes} |
For ICA only Default is no. Yes/no option to close gst_play at the end of a media clip. This ensures only one gst_play process runs at a time. |
||||
SpeedScreenMMACSFEnabled={yes, no} |
For ICA only Default is yes. Yes/no option to enable Speed Screen MMACSF. Setting to no disables this functionality, and media will revert to the traditional streaming mode of HDX MediaStream where possible. |
||||
SpeedScreenMMAEnablePlaybin2={yes, no} |
For ICA only Default is yes. Yes/no option to enable all MediaStream features to use playbin2. Setting to no configures all other MediaStream features to use playbin except Client-Side Fetching, which continues to use playbin2. |
||||
SpeedScreenMMAGstPlayExitTimeout=<int eger> |
For ICA only Default is 20. Period of time, in seconds, allowed for gst_play processes to exit before being closed. |
||||
SpeedScreenMMAGstPlayKillAtExit={yes, no} |
For ICA only Default is yes. Yes/no option to enable Receiver to quit any gst_play processes that do not exit within a specified timeout period. |
||||
SpeedScreenMMARebaseTimestampsOnSeek={yes, no} |
For ICA only Default is yes. Yes/no option to enable re-basing of timestamps to a positive value following seek. |
||||
SpeedScreenMMAStopOverlayHandlingEvents={no, yes} |
For ICA only Default is no. Yes/no option to enable the correction of a mouse pointer issue where the mouse pointer disappears in full-screen WMP. Set to no to fix potential issues with videos not playing in the correct location or at the correct size, not resizing properly, or with the video window remaining black, but causes an issue where the mouse pointer disappears in full-screen WMP and does not return when the mouse is moved. Set to yes to correct the mouse-pointer issue. |
||||
StopWatchMin=<integer value> |
Controls over-scrolling when using some published applications. Specify an integer value to control over-scrolling; for example 100. Users may experience problems with over-scrolling when using some published applications. You can address this problem by adjusting the value to a greater number. |
||||
ThreadQueueSize=<integer value> |
For ICA only Default is 65536 for Thinwire and 32768 for client audio. If threading is enabled, this defines the size of the thread's data queue in bytes. A larger queue size may result in more lag because the overall buffering increases. |
||||
TimeoutDelayLoginForNetwork=<integer> |
Range is 0 to 120 seconds. Specifies the amount of time to for wait for the network to connect (in seconds).
Setting to 120 seconds will enable the wait to 120 seconds. |
||||
UDPAudioPortHigh=<integer value> |
For ICA only Default is 16509. Specifies the maximum port number for UDP audio on the user device. |
||||
UDPAudioPortLow=<integer value> |
For ICA only Default is 16500. Specifies the minimum port number for UDP audio on the user device. |
||||
UseThread={yes, no} |
For ICA only Default is yes. Yes/no option to enable the use of a thread to be used for this virtual channel. |
||||
VPNGroup=<Group name>,... (optional) |
If you configure groups on the Cisco ASA, this parameter allows you to specify the group name or names (separated by commas) that the Cisco AnyConnect Client can use for the VPN connection. |
||||
VPNHeadendAddress= <FQDN or IP address> (required) |
Specifies the VPN headend FQDN or IP Address to autoconfigure the Cisco AnyConnect Client. For example, VPN.Cisco.com or 192.168.0.1. |