INI Files Reference Guide for Cisco Virtualization Experience Client 2112/2212 ICA Firmware Release 8.0_215
ICA and RDP connection options
Downloads: This chapterpdf (PDF - 1.17MB) The complete bookPDF (PDF - 2.48MB) | The complete bookePub (ePub - 210.0KB) | Feedback

ICA and RDP connection options

ICA and RDP connection options

ICA Connect Options

This section describes the supported options used for ICA connections (after you use the Connect=ICA parameter/selection).

Important:

If an option has an underlined value (default), that option and default value will automatically be used with Connect=ICA (options without underlined values can also be used if you want to, but are not automatically used with Connect=ICA). In addition, when using options, you can leave the default value or change it to another value shown.

For example, in the following case where:

Connect=ICA

[Option1={0, 1}]

[Option2={1, 2, 3, 4}]

Since you are using Connect=ICA, 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.


Tip


Any option in the following table that is used in a {username}.ini file will return to the default value set for that option in the wnos.ini file after a user sign-off. For example, if your {username}.ini file contains the option Reconnect=yes (so that a lost connection will restart 20 seconds after disconnection) and you sign off of the zero client, then the Reconnect value will return to the original default value of no (Reconnect=no) contained in the wnos.ini file - so that others who sign in can use their own “user profile” (assuming the administrator has not changed the default values in the wnos.ini file).


The following table describes the supported options used for ICA connections (after you use the Connect=ICA parameter/selection).

Table 1 ICA Connect Options
Option Description
Alternate=[no, yes]

Default is no.

Yes/no option to use an alternate IP address returned from an ICA master browser to get through firewalls.

AudioQualityMode={0, 1, 2, 3}

Default is 0.

Specifies the audio quality of a session.

  • 0 Default
  • 1 High Quality
  • 2 Medium Quality
  • 3 Low Quality
Autoconnect={0 to 99}

Default is 0.

Use for automatically starting a session (after sign-in, if sign-in is enabled).

The value of 0-99 is the delay in seconds before auto-starting the session.

AppendUsername=1 This enhancement allows user names to display in the title bar of an ICA session at the client side.

BranchRepeater ={no, yes}

Important: DO NOT USE as this parameter is being deprecated.

Default is no.

Yes/no option to enable a branch repeater function including Reducer V3 and High Throughput.

Important: DO NOT USE as this parameter is being deprecated.
Browserip=list of browsers List of IP addresses or DNS registered names to specify ICA browsers. List items must be separated by semicolons or commas.
Colors={256, 32k, 64k or high, 16m, true}

Default is high.

Session color mode. For faster display performance, use 256 colors for the session.

  • 256 is 8-bits
  • 32k is 15-bits
  • 64k or high is 16-bits
  • 16m is 24-bits
  • true is 32-bits
Note   
  • 64k is the same value as high.
  • 16m — 24-bits over ICA is only supported by Windows XP and Windows 2003 server. It is not supported by Windows Server 2008 or newer.
  • true — 32-bit remote connections are not supported by Windows XP or Windows 2003 server. It requires Windows Vista, Windows Server 2008, or newer with ICA.
Command=start command A string of commands to be executed after signing in to the server. This entry is limited to 127 characters.
Description=string description Connection description. Enclose the string description in quotation marks if there are embedded blanks or single quotes. For quotation marks, use common-practice nesting rules. Maximum of 38 characters are allowed.
Directory=working directory A directory to be used as the working directory after signing in to the server. Maximum of 63 characters is allowed.
Disablesound={no, yes, 2} or {0, 1, 2}

Default is no.

Specifies whether or not to disable remote sound upon connection start.

Domainname={domain name,$DN} Domain name to use in a Windows network. $DN specifies that the zero client sign-in domain name is used. Maximum of 19 characters is allowed.
Encryption={None, Basic, 40, 56, 128, Login-128}

Default is Basic.

Connection security encryption level. The highest level is 128-bit security (Login-128 option is 128 bit encryption for sign-in only). The lowest is None.

Note   

The server must support the specified level of encryption or the connection will fail.

Fullscreen={no, yes}

Default is no.

Yes/no option to run the session in full screen. If Fullscreen=no then the session runs in a windowed screen.

Host=[name, IP, $SYS VAR] or Application=published application

Host-A list of server hostnames or IP addresses to which the zero client will attempt to connect (the next server on the list is attempted if the previous one failed). List items must be separated by semicolons or commas.

Note   

$UN (for information on this system variable, see Rules and Recommendations for WTOS INI Files) specifies that the sign-in user name is used and should be set in a {username}.ini file. If set to Host=$UN in a {username}.ini file, the hostname will display as the sign-in user name. If set to Host=$UN in a wnos.ini file, the hostname will display as the default Start.

Application-Defines the published application to launch. Application is required if no host is specified.

HttpBrowsing={no, yes}

Default is no.

Yes/no option to select an http browsing protocol. Use HttpBrowsing=no for User Datagram Protocol (UDP).

Note   

This option is used to override the default method of browsing established in the ICABrowsing parameter (see Connection Settings (wnos.ini, username.ini, and $MAC.ini Files)).

Icon={default, bitmap file} Specifies an icon to appear on the zero client desktop for a connection. Use Icon=default to display a system default icon for a connection. To use an icon other than the default icon, enter the name (with extension) of the bitmap file (ensure that the file is located in the FTP server wnos\bitmap directory). If Icon= is not specified and the icon is not specified by a PNAgent/PNLite server, no icon is displayed for a connection.
KeepAlive={0 to 127} Specifies the number of minutes to keep a session connected (alive) after the session is inactive. During this period, one dummy packet will be sent to the server if network traffic is lost. Default=10.
LocalCopy={no, yes}

Default is no.

Yes/no option to save the connection to the local NVRAM.

The connection description of the Description option is used as the index key into the local connection table. If a match is found, then the entry is updated. Otherwise, a new entry is created.

Maximum total of local entries is 16.

Logon_mode={local-user, smartcard, user-specified}

Default is local-user.

Specifies how users authenticate to the selected application set or ICA connection.

Lowband={no, yes}

Default is no.

Yes/no option to enable optimization for low speed connections (such as reducing audio quality and/or decreasing protocol-specific cache size).

Mapdisks={no, yes}

Default is no.

Yes/no option to auto-connect and map any connected USB flash drive upon connection start.

Mapdisksunderz

Important:

Do not use as this parameter option is being deprecated.

Important:

Do not use as this parameter option is being deprecated.

[NO_FontSmoothing={no, yes}]

Default is no (font smoothing is enabled by default).

Yes/no option to disable font smoothing. Set to yes to disable font smoothing.

NoReducer={no, yes}

Default is no.

Yes/no option to turn off compression. Default is no, which enables compression. To turn off compression, enter yes.

Used here this option is an option of the "Connect" statement. It sets the value of NoReducer only for this specified connection.

Note   

By default both the ICA and RDP protocols compress their data to minimize the amount of data that needs to traverse the network. This compression can be as much as 50% for text-based applications (for example, Microsoft Word) and 40% less for graphics applications than the uncompressed data streams.

Password={password, $SYS_VAR}

Password to sign-in to the application server. Either a conventional sign-in password or a variable can be used. Maximum of 19 characters is allowed.

The value of password is a conventional sign-in password.

The value of $SYS_VAR is a system variable as described in Rules and Recommendations for WTOS INI Files.

Caution   

The application server password is not encrypted; it is strongly recommended not to specify it. The user will be prompted to enter the password when the connection is made. This application server password directive never starts a line, so it can be distinguished from the zero client user sign-in password (which does start a line).

Note   

The Password option is not written into a {username}.ini file by a user. When the New Password check box is selected, the system writes the new, changed password into the {username}.ini file with encryption. This password is then checked against the sign-in password with encryption to determine whether sign-in is successful.

Password-enc= an encrypted password Specifies an encrypted string as a password for a connection.
Reconnect={no, yes, 1 to 3600 (seconds)}

Default is no.

Controls automatic reconnection to an application after a server disconnection.

yes-Use to restart the connection (the default delay time for yes reconnect is 20 seconds).

no-Use to prevent reconnection after a disconnect.

1 to 3600-Use an integer value of 1 to 3600 seconds to restart the connection after the delay you want (for example, use 50 and the automatic reconnection to an application will occur after 50 seconds).

Resolution=[default, Seamless, <monitor resolution>]

Default is default.

Specifies the connection display resolution.

default-Starts the connection using the current desktop display setting with no window frame and border.

Seamless-Available for use if the connection is to a published application. For Seamless connections, the MetaFrame hosts select the best-fit connection window for applications.

<monitor resolution>-Resolutions values you can use are as follows: 640X480, 800X600, 1024X768, 1152X864, 1280X720, 1280X768, 1280X1024, 1360X768, 1366X768, 1368X768, 1400X1050, 1440X900, 1600X900, 1600X1200, 1680x1050, 1920X1080, 1920X1200

SessionReliability={no, yes}

Default is no.

Yes/no option to enable session reliability.

Note   

WTOS zero clients do not support UDP browsing to obtain a new configuration about session reliability on the server. The zero client always connects to the default port.

UniSession={no, yes}

Default is no.

Yes/no option to use a unisession (a connection will launch only once at a time).

UnmapClipboard={no, yes}

Default is no.

Yes/no option to disable clipboard redirection for ICA and RDP sessions if redirecting the clipboard.

UnmapPrinters={no, yes}

Default is no.

Yes/no option to not auto-connect to local printers when the connection starts.

UnmapSerials={no, yes}

Default is no.

Yes/no option to not auto-connect to local serials when the connection starts.

UnmapUSB={no, yes}

Default is no.

Yes/no option to not auto-connect to local USB devices (Virtual USB) when the connection starts.

Username=[username, $SYS_VAR] Username to sign-in to the application server. Either a conventional sign-in username or a variable can be used. Maximum of 31 characters is allowed. The value of username is a conventional sign-in username. The value of $SYS_VAR is a system variable as described in Rules and Recommendations for WTOS INI Files. The combination of all the variables such as $IP@$DN are also supported.
Username-enc= an encrypted username Specifies an encrypted string as a username for a connection.

RDP Connect Options

This section describes the supported options used for RDP connections (after you use the Connect=RDP parameter/selection).

Important:

If an option has an underlined value (default), that option and default value will automatically be used with Connect=RDP (options without underlined values can also be used if you want to, but are not automatically used with Connect=RDP). In addition, when using options, you can leave the default value or change it to another value shown.

For example, in the following case where:

Connect=RDP

[Option1={0, 1}]

[Option2={1, 2, 3, 4}]

Since you are using Connect=RDP, 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.


Tip


Any option in the following table that is used in a {username}.ini file will return to the default value set for that option in the wnos.ini file after a user sign-off. For example, if your {username}.ini file contains the option Reconnect=yes (so that a lost connection will restart 20 seconds after disconnection) and you sign off of the zero client, then the Reconnect value will return to the original default value of no (Reconnect=no) contained in the wnos.ini file - so that others who sign in can use their own “user profile” (assuming the administrator has not changed the default values in the wnos.ini file).


The following table describes the supported options used for RDP connections (after you use the Connect=RDP parameter/selection).

Table 2 RDP Connect Options
Option Description
Autoconnect={0 to 99}

Default is 0.

Use for automatically starting a session (after sign-in, if sign-in is enabled). The value of 0-99 is the delay in seconds before auto-starting the session.

Colors={256, 32k, 64k or high, 16m, true}

Default is high.

Session color mode. For faster display performance, use 256 colors for the session.

  • 256 is 8-bits
  • 32k is 15-bits
  • 64k or high is 16-bits
  • 16m is 24-bits
  • true is 32-bits
Note   
  • 64k is the same value as high.
  • 16m — 24-bits over RDP is only supported by Windows XP and Windows 2003 server. It is not supported by Windows Server 2008 or newer.
  • true — 32-bit remote connections are not supported by Windows XP or Windows 2003 server. It requires Windows Vista, Windows Server 2008, or newer with RDP.
Command=start command A string of commands to be executed after signing in to the server. This entry is limited to 127 characters.
Console={no, yes}

Default is no

Yes/no option to sign-in to a session in Console mode.

If Console=yes is set behind the RDP connection, the TimeZone redirection feature will be disabled.

Description=string description Connection description. Enclose the string description in quotation marks if there are embedded blanks or single quotes. For quotation marks, use common-practice nesting rules. Maximum of 38 characters are allowed.
Directory=working directory A directory to be used as the working directory after signing in to the server. Maximum of 63 characters is allowed.
Disablesound={no, yes, 2} or {0, 1, 2}

Default is no.

or Default is 0

Specifies whether or not to disable remote sound upon connection start.

Note   

Disablesound=2 only works in RDP sessions and indicates that the remote computer sound should be disabled at the remote computer.

Domainname={domain name,$DN} Domain name to use in a Windows network. $DN specifies that the zero client sign-in domain name is used. Maximum of 19 characters is allowed.
Fullscreen={no, yes}

Default is no.

Yes/no option to run the session in full screen. If Fullscreen=no then the session runs in a windowed screen.

Note   

Fullscreen=Yes and DualHead=Yes will result in Span Mode when connecting to a Windows server 2003 or a Windows XP Pro Client.

Fullscreen=Yes and DualHead=Yes will result in Extended mode when connecting to a Windows Server 2008 (any version) and to a Windows 8 or above desktop.

Host=[name, IP, $SYS VAR]

Host-A list of server hostnames or IP addresses to which the zero client will attempt to connect (the next server on the list is attempted if the previous one failed). List items must be separated by semicolons or commas.

Note   

$UN (for information on this system variable, see Rules and Recommendations for WTOS INI Files) specifies that the sign-in user name is used and should be set in a {username}.ini file. If set to Host=$UN in a {username}.ini file, the hostname will display as the sign-in user name. If set to Host=$UN in a wnos.ini file, the hostname will display as the default Start.

Icon={default, bitmap file} Specifies an icon to appear on the zero client desktop for a connection. Use Icon=default to display a system default icon for a connection. To use an icon other than the default icon, enter the name (with extension) of the bitmap file (ensure that the file is located in the FTP server wnos\bitmap directory). If Icon= is not specified and the icon is not specified by a PNAgent/PNLite server, no icon is displayed for a connection.
KeepAlive={0 to 127} Specifies the number of minutes to keep a session connected (alive) after the session is inactive. During this period, one dummy packet will be sent to the server if network traffic is lost. Default=10.
LocalCopy={no, yes}

Default is no.

Yes/no option to save the connection to the local NVRAM.

The connection description of the Description option is used as the index key into the local connection table. If a match is found, then the entry is updated. Otherwise, a new entry is created.

Maximum total of local entries is 16.

Logon_mode=prompt Specifies one dialog box will pop up to allow a user to enter username, password, and domain before connecting to the RDP session. This can prevent the need to input credentials twice in some cases of server redirection (load balancing).
Lowband={no, yes}

Default is no.

Yes/no option to enable optimization for low speed connections (such as reducing audio quality and/or decreasing protocol-specific cache size).

Mapdisks={no, yes}

Default is no.

Yes/no option to auto-connect and map any connected USB flash drive upon connection start.

NoReducer={no, yes}

Default is no, which enables compression.

Yes/no option to turn off compression. To turn off compression, enter yes. Used here this option is an option of the "Connect" statement. It sets the value of NoReducer only for this specified connection.

Note   

By default both the ICA and RDP protocols compress their data to minimize the amount of data that needs to traverse the network. This compression can be as much as 50% for text-based applications (for example, Microsoft Word) and 40% less for graphics applications than the uncompressed data streams.

Password={password, $SYS_VAR}

Password to sign-in to the application server. Either a conventional sign-in password or a variable can be used. Maximum of 19 characters is allowed.

The value of password is a conventional sign-in password.

The value of $SYS_VAR is a system variable as described in Rules and Recommendations for WTOS INI Files.

Caution   

The application server password is not encrypted; it is strongly recommended not to specify it. The user will be prompted to enter the password when the connection is made. This application server password directive never starts a line, so it can be distinguished from the zero client user sign-in password (which does starts a line).

Note    The Password option is not written into a {username}.ini file by a user. When the New Password check box is selected, the system writes the new, changed password into the {username}.ini file with encryption. This password is then checked against the sign-in password with encryption to determine whether sign-in is successful.
Password-enc= an encrypted password Specifies an encrypted string as a password for a connection.
RDPAudioQualityMode
Important:

DO NOT USE as this option is being deprecated.

RDPAudioRecord={no, yes}

Default is no.

Yes/no option to specify whether users can record audio to the server (requires Windows 7 Server).

Rdp_No_Animation={no, yes}

Default is no.

Yes/no option to disable the Menu and Window animation feature (use yes to disable the feature).

Rdp_No_Dragging={no, yes}

Default is no.

Yes/no option to disable the Show content when dragging a window feature (use yes to disable the feature).

Rdp_No_Fontsmoothing={no, yes}

Default is no.

Yes/no option to disable the Font smoothing feature (use yes to disable the feature).

Rdp_No_Theme={no, yes}

Default is no.

Yes/no option to disable the Theme feature (use yes to disable the feature).

Rdp_No_Wallpaper={no, yes}

Default is no.

Yes/no option to disable the Wallpaper feature (use yes to disable the feature).

Reconnect={no, yes, 1 to 3600 (seconds)}

Default is no.

Controls automatic reconnection to an application after a server disconnection.

yes-Use to restart the connection (the default delay time for yes reconnect is 20 seconds).

no-Use to prevent reconnection after a disconnect.

1 to 3600-Use an integer value of 1 to 3600 seconds to restart the connection after the delay you want (for example, use 50 and the automatic reconnection to an application will occur after 50 seconds).

Resolution=[default, <monitor resolution>]

Default is default.

Specifies the connection display resolution.

default-Starts the connection using the current desktop display setting with no window frame and border.

<monitor resolution>-Resolutions values you can use are as follows: 640X480, 800X600, 1024X768, 1152X864, 1280X720, 1280X768, 1280X1024, 1360X768, 1366X768, 1368X768, 1400X1050, 1440X900, 1600X900, 1600X1200, 1680x1050, 1920X1080, 1920X1200

Note   

If Using DualHead=Yes, setting this resolution value to default will launch the RDP session in Span Mode. If you want to use only the fullscreen of one monitor use Resolution=DDC.

Also note: This option is ignored if Fullscreen=Yes.

Smartcards={no, yes}

Default is no.

Yes/no option to use a smart card sign-in server when the connection starts.

UniSession={no, yes}

Default is no.

Yes/no option to use a unisession (a connection will launch only once at a time).

UnmapClipboard={no, yes}

Default is no.

Yes/no option to disable clipboard redirection for an RDP sessions if redirecting the clipboard.

UnmapPrinters={no, yes}

Default is no.

Yes/no option to not auto-connect to local printers when the connection starts.

UnmapSerials={no, yes}

Default is no.

Yes/no option to not auto-connect to local serials when the connection starts.

UnmapUSB={no, yes}

Default is no.

Yes/no option to not auto-connect to local USB devices (Virtual USB) when the connection starts.

Username=[username, $SYS_VAR]

Username to sign-in to the application server. Either a conventional sign-in username or a variable can be used. Maximum of 31 characters is allowed.

The value of username is a conventional sign-in username.

The value of $SYS_VAR is a system variable as described in Rules and Recommendations for WTOS INI Files.

Note   

The combination of all the variables such as $IP@$DN are also supported.

Username-enc= an encrypted username Specifies an encrypted string as a username for a connection.