Parameters for WLX INI, $MAC INI, and {username} INI Files

Table Of Contents

Parameters for WLX INI, $MAC INI, and {username} INI Files

General Settings (wlx.ini, $MAC.ini, and {username}.ini Files)

Peripheral Settings (wlx.ini, $MAC.ini, and {username}.ini Files)

Connection Settings (wlx.ini, $MAC.ini, and {username}.ini Files)

Parameters for WLX INI, $MAC INI, and {username} INI Files

---

This chapter provides the supported parameters that you can use in a wlx.ini file, a $MAC.ini file, and a {username}.ini file.

---

Tip For information to help you construct and use the supported INI files, see Getting Started: Learning INI File Basics.

---

To increase usability, the supported parameters are separated into the following categories:

•General Settings (wlx.ini, $MAC.ini, and {username}.ini Files)

•Peripheral Settings (wlx.ini, $MAC.ini, and {username}.ini Files)

•Connection Settings (wlx.ini, $MAC.ini, and {username}.ini Files)

General Settings (wlx.ini, $MAC.ini, and {username}.ini Files)

Table 3-1 contains the parameters that you can use for configuring general settings.

Table 3-1 General Settings: wlx.ini files, $MAC.ini files, and {username}.ini files 

Parameter	Description
DesktopTaskBar={bottom, top, left, right} AutoHide={no, yes} [AlwaysOnTop={no, yes}]	DesktopTaskBar—Specifies the position of the taskbar. For example: DesktopTaskBar=left AutoHide—Specifies whether to hide the taskbar until the user moves the mouse cursor over the taskbar area. AlwaysOnTop—Specifies whether to always display the taskbar on top of all other windows.
EncryptPasswords={0,1}	Specifies whether to enable or disable encryption/decryption (encoding/decoding). •0—specifies plain password •1—specifies encrypted/encoded password (Default) Note •Cisco recommends that you define this parameter as the first parameter in the INI file. •If you create the connections using the Connection Manager before setting this INI parameter through the INI file, the connections will have encryption/encoding enabled by default. That is, these connections will not work after you set this INI parameter in the registry. A solution for this is to either re-create all such connections or re-edit the password (using the Connection Manager GUI) for these connections. •In an INI file, if you place any connection or parameter that has a password before this INI parameter, the preceding connection or parameter will not work.
Include=path/filename	Includes another INI file at the position of this command. Note Only one level of include is allowed (nesting is not allowed).
Password=password [PasswordEncryptionCode={yes, no}]	Specifies the encrypted password for the INI user. Use the crypt utility available on standard Linux machines to encrypt the plain-text password and use the encrypted string for the password. For example: Password=lF2Sqd7qEqBg PasswordEncryptionCode—Specifies whether to use a Base64 encoded password. If no, a plain-text password is used. For example: All passwords in the INI file must be Base64 encoded (for connections, printers, users, and so on): 1. Log in to the thin client. 2. Open xterm. 3. Type regencode followed by password in plain text. For example: admin@LWT:~>regencode passwordc GFzc3dvcmQ= 4. Encoded output for the password=cGFzc3dvcmQ=
Privilege={High, None, Low,} [LockDown={no, yes}]	Controls access to thin client resources. Value and Operator Privileges High—(default) For administrators. All thin client resources are available with no restrictions. A high-level user can reset the device to factory defaults. Low—For a typical user. Access is granted to the Connection Manager and desktop panel, but not the More Applications button or Control Center. The user can view connections, but not add or modify them. None—For a kiosk or other restricted-use deployment. Users have access only to icons put on the desktop by the administrator, not the Connection Manager, desktop panel, More Applications button, or Control Center. LockDown—Specifies whether to lock the default privilege for the thin client. If LockDown=yes, the privilege is saved in the permanent registry; if LockDown=no, the privilege level is set to the default high in the permanent registry. Note If LockDown=yes the system saves the privilege level in the flash device. If LockDown=no, the system clears the privilege level from the flash device to the default unlocked state. The default high privilege level is stored in the permanent registry; if you do not specify a privilege in either the wlx.ini or user.ini files or the network is unavailable, the setting of the LockDown parameter takes effect. You can modify this setting with a clause. For example, privilege=<None|Low|High> LockDown=yes in the wlx.ini or {username}.ini sets up the default privilege to the specified level. And a clause such as privilege=<None|Low|High> LockDown=no sets up the default privilege back to high regardless of the specified level and the current effective privilege level.

Peripheral Settings (wlx.ini, $MAC.ini, and {username}.ini Files)

Table 3-2 contains the parameters that you can use to configure peripheral settings (such as keyboard, monitor, mouse, and printer).

Table 3-2 Peripheral Settings: wlx.ini files, $MAC.ini files, and {username}.ini files 

Parameter	Description
DeskColor=<color> [{solid | horizontal-gradient | verticalgradient}<color>]	Specifies the desktop background color where <color> can be one of the following values: •rrggbb—An RGB color specification in the form commonly used in HTML. •<color name>—A color name from the /usr/share/X11/rgb.txt file. Note that these names are case sensitive. •0-255 0-255 0-255—Three integers in the range of 0 to 255 representing the amount of red, green, and blue, respectively. CAUTION: This form is deprecated. it is available for backward compatibility only. For example: Deskcolor=DarkGoldenrod horizontal-gradient LightGoldenrod The first <color> is the primary color and is used if no shading is specified or if the shading is solid. The second color is the secondary color. When shading is specified, the primary color appears on the left (horizontal) or top (vertical) edge with a smooth transition to the secondary color on the opposite edge.
Desktop=image file [Layout={Center, Tile, Stretch, Scale, None} Opacity={0-100}]	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. The default is no wallpaper. Layout—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—Specifies the amount of transparency. Default is 100. 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}	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> [; MON2 <resolution> <position>]	Defines the display settings for single and multimonitor display, clone and span mode. Possible values for: resolution={{x}X{y}, DDC} position={mirror, on-left, on-right, on-above, on-below} Note Meaning of different position values: mirror—Clone mode on-left—Span on left side on-right—Span on right side on-above—Span on top on-below—Span on bottom Examples: DisplaySettings=MON1 rotate-normal 1024x768@75 MON2 rotate-normal 1024x768@75 on-below DisplaySettings=MON1 rotate-normal 1280x1024 DisplaySettings=MON1 1280x1024 DisplaySettings=MON1 1280x768 DisplaySettings=MON1 960x540 DisplaySettings=MON1 1024x768 rotate-right DisplaySettings=MON1 1024x768 rotate-normal MON2 1024x768 rotate-right on-right DisplaySettings=MON1 1024x768 rotate-normal MON2 1024x768 rotate-right on-left DisplaySettings=MON1 1024x768 rotate-normal MON2 1024x768 rotate-left on-left DisplaySettings=MON1 1024x768 rotate-normal MON2 1024x768 rotate-normal on-left DisplaySettings=MON1 800x600@60 rotate-normal MON2 800x600 rotate-left on-left DisplaySettings=MON1 800x600@75 rotate-normal DisplaySettings=MON1 800x600@75 rotate-normal MON2 800x600@75 rotate-normal on-above DisplaySettings=MON1 1280x1024 rotate-normal MON2 1280x1024 rotate-normal mirror DisplaySettings=MON1 1280x1024 rotate-normal MON2 1280x1024 rotate-normal on-right DisplaySettings=MON1 720x400 rotate-right
EnableNumLock={no, yes}	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={options}	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 Parameters: Options".
Keyboard.layouts={Keyboard layout value}	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}	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. 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={0-100}	Specifies the speed when moving the mouse. Note When the value includes a decimal point, it is taken as a direct multiplier of mouse motion. You can use the following values for backward compatibility. Value and Mouse Speed 0—Slow (0.2) 1—Medium (default) (2.0) 2—Fast (6.0)
MouseSwap={no, yes}	Specifies whether to swap the button order on the mouse. The default value is no.
NetworkPrinter={options}	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 Parameters: Options"
Printer={options}	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 Parameters: Options".
PrinterURI={options}	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 Parameters: Options".
RepeatDelay=value	Expresses, in milliseconds (100-10000), the delay before a repeat key press is recognized. Enter a value greater than 100. The default value is 660 milliseconds. 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	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 Rate 0—Slow (GUI value is 10) 1—Medium (default) (no GUI value) 2—Fast (GUI value is 110)
SMBPrinter={options}	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 Parameters: Options".
TransparentKeyPassThrough= {Local/Remote/FullScreenOnly}	Enables keyboard shortcut sequences defined by the local Windows manager in the session. Default is FullScreenOnly. 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

Connection Settings (wlx.ini, $MAC.ini, and {username}.ini Files)

Table 3-3 contains the parameters that you can use for configuring connection settings.

Table 3-3 Connection Settings: wlx.ini files, $MAC.ini files, and {username}.ini files 

Parameter	Description
Alternate={no, yes}	For ICA only. Specifies the use of an alternate IP address returned from an ICA master browser to get through firewalls. Default is no.
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 (for example, ICA or VMWare View). Appendix A describes these parameters: •BROWSER, see Mozilla Firefox Connect Options •Custom, see Custom Connect Options •Ericom_PowerTerm, see Ericom PowerTerm TEC Connect Options •Ericom_WebConnect, see Ericom PowerTerm WebConnect Connect Options •ICA, see ICA Connect Options •RDP, see RDP Connect Options •SSH, see SSH Connect Options •VMWARE_VIEWCLIENT, see VMware View Client Connect Options •VNC_VIEWER, see VNC Viewer Connect Options •XDMCP, see XDMCP Connect Options Note The availability of connection types depends on the add-ons that are installed on the client.
Drives=drive letter={floppy, cdrom, disk}, {rw, ro} [, basedir] drive letter=...	Maps 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. Note Be sure each drive command is separated by a space.
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. Specifies the default browsing protocol. Default is http. 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. Note Be sure each serial device command is separated by a comma and space.
IcaDesktopApplianceMode={yes, no}	For ICA only. 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. Note Be sure each drive command is separated by a space.
IcaEnhancedAudio={no, yes}	For ICA only. Enables/Disables Citrix enhanced audio. true—enables Citrix enhanced audio false—disables Citrix enhanced audio Default is false.
ICAhotkey={yes, no} [hotkey value]	For ICA only. 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 Note You must enter all hotkey options on one line.
IcaMMAudio={yes, no}	For ICA only. 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. 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. Specifies whether to enable Citrix multimedia redirection. yes—Enables Citrix multimedia redirection no—Disables multimedia redirection Default is no.
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.
NFuseServer=host[:port][;host [:port]] OR PNAgentServer=host[:port][;host [:port]] OR PNLiteServer=host[:port][;host [:port]]	Specifies a list of PN-Agent servers. If you do not specify a port, the port value depends on the browsing protocol. Default is Empty.
NLA={no, yes}	For RDP only. Specifies whether to enable Network Level Authentication for RDP sessions.
PNAgentServer	See NFuseServer.
PNLiteServer	See NFuseServer.
RdpClipBoard={yes, no}	For RDP only. Specifies whether to enable or disable the clipboard in an RDP session. Default is yes.
RdpDriveMap={yes, no}	For RDP only. Specifies whether to enable or disable drive mapping in an RDP session. Default is yes.
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}}	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. Note You must specify the parameters in the order shown.
StopWatchMin=integer	Specifies an integer value to control over-scrolling; for example 100. Users may experience problems with over-scrolling when using some published applications. Prevent this problem by adjusting the value to a greater number.