Top of Form
This document contains a description of the syntax of a sample ICA file so that you can manually create or modify an ICA file if desired.ICA File Syntax
ICA files are usually generated by an application such as the ICA File Editor or Application Configuration. An ICA file can also be used to create custom WinFrame client diskettes.
The Contents of an ICA File
Use a simple text editor (such as Notepad) to create and modify ICA files. A sample ICA file is shown below:
; CUSTOMER.ICA - ICA file to access a Customer Database using Microsoft Access
;
; The [ApplicationServers] section contains the name of the
; connection or published application defined by the ICA file.
; The name below (Access) appears in the title bar of the client window.
;
[ApplicationServers]Access=
; The [] section describes the attributes of the connection or
; published application defined in the [ApplicationServers] section above.
; The name in the square brackets must exactly match the name defined in the
; [Application Servers] section above; in this example, Access.
;
[Access]
TransportDriver=TCP/IP
Address=206.103.132.12
WinStationDriver=ICA 3.0
Username=JBLOGGS
Domain=ABC
Password=000100
InitialProgram=d:\access\msaccess.exe d:\shareacc\access\nwind.mdb /X customer
WorkDirectory=d:\access
UseAlternateAddress=0
;
KeyboardTimer=100
MouseTimer=50
;
; Use either ScreenPercent or DesiredHRES and DesiredVRES to specify
; the size of the client window.
; If both ScreenPercent and DesiredHRES and DesiredVRES are specified,
; only ScreenPercent is used. ScreenPercent is available only with
; the Citrix Web Client.
ScreenPercent=75
DesiredHRES=640
DesiredVRES=480
DesiredColor=2
; The [WFClient] section describes the WinFrame Client.
;
[WFClient]
Version=2
The [ApplicationServers] section defines the remote application entry referred to by the ICA file. The [ApplicationServers] section contains the following fields:
[Application Server]
This is the section header. This field is required and must be entered exactly as shown.
EntryName=
Defines the name of the remote application entry. The name must be followed by an equal sign. This name is used in the title bar of the client window.
The [EntryName] Section
The [EntryName] section begins with the EntryName defined in the [ApplicationServers] section enclosed in square brackets, or [Access] in the above example. The [EntryName] section contains the following fields:
TransportDriver=
The data transport type. Usually TCP/IP, but can also be IPX, SPX, or NetBIOS. This is a required field.
Address=
The address of the remote Citrix server. For TCP/IP connections, it can be the DNS name of a Citrix server, the IP address of a Citrix server, or the name of a published application, for example Database. For IPX, SPX, and NetBIOS connections, it can be the name of a Citrix server or the name of a published application. This is a required field.
WinStationDriver=ICA 3.0
Defines the presentation protocol as ICA 3.0. This is a required field.
Username=
Specifies the name of a user account to log on as. This is an optional field.
Domain=
Specifies the domain to log on to. This is an optional field.
Password=
Specifies the password for the user account. This is an optional field. The password, if used, must be encrypted. To enter an encrypted password into the ICA file, use the Citrix ICA Client Remote Application Manager New Entry Wizard to create a remote application entry. When you are prompted for the username and password, enter the password that you want to use in the ICA file. Finish the New Entry wizard. Open the file APPSRV.INI in the Windows directory and locate the entry you just created. Copy the password value and paste it into your ICA file.
ClearPassword=
Specifies the clear text (unencrypted) password for the user account. This is an optional field. To use a clear text password, the Password field must be set to a null value (for example: Password=).
InitialProgram=
Specifies the path of the application on the Citrix server to be automatically launched when the connection is made. Include any command line options. This is an optional field. If no initial program is specified, Program Manager is launched. If the name of a published application is specified in the Address field, the name of the published application must appear here prefixed with a pound sign (#), for example #Database. The published application name must be entered exactly as it is in the Address field.
WorkDirectory=
Specifies the working directory used for the application.
ScreenPercent=
Specifies the horizontal and vertical pixel resolution as a percentage of the client desktop size. If the ScreenPercent field is present, the DesiredHRES and DesiredVRES fields are ignored.
DesiredHRES=
Specifies the horizontal window size in pixels. If the ScreenPercent field is present, the DesiredHRES and DesiredVRES fields are ignored.
DesiredVRES=
Specifies the vertical window size in pixels. If the ScreenPercent field is present, the DesiredHRES and DesiredVRES fields are ignored.
DesiredColor=1 | 2 | 4 | 8
DesiredColor sets the color palette depth. Use 1 for 16-color and 2 for 256-color. The default is 2 (256-color). Use 4 for High Color. For True Color, use 8.
UseAlternateAddress=0 | 1
This is an optional field, only used to support accessing a Citrix server across a firewall. Firewalls use IP address translation to convert public (Internet) IP addresses into private (Intranet) IP addresses. Public IP addresses are called "external" addresses because they are external to the firewall, while private IP addresses are called "internal" addresses.
When an ICA client is configured for TCP/IP server location, it sends a directed UDP datagram to the server location IP address using TCP/IP port 1604. For communication to be successful between an ICA client and a Citrix server with an intervening firewall, the firewall must be configured so it will pass UDP port 1604 packets. Server location is configured in Remote Application Manager by selecting Settings from the Options menu.
If a fixed server location address is specified, the ICA client contacts that server to determine the address of the ICA master browser. When the ICA client connects by server or published application name, the ICA master browser returns the address of the desired server or published application.
If UseAlternateAddress=1 is specified, the client will request the IP address of the Citrix server’s alternate address. UseAlternateAddress can only be used for TCP/IP connections. You must specify the IP address of the Citrix server that is configured for server location by including the statement TcpBrowserAddress=ipaddress in the [WFClient] section of the ICA file, where ipaddress is the IP address of the Citrix server; for example, 123.321.234.23. You must also use the ALTADDR command on the Citrix server with IP address ipaddress that is accessed by the ICA file.
See the "Load Balancing and Application Publishing Across a Firewall" topic in the WinFrame Readme for more information about alternate addresses and the ALTADDR command.
KeyboardTimer=value
Specifies a time interval, in milliseconds, during which keyboard input is collected before being sent to the Citrix server. The default value of 100 milliseconds is optimized for WANs; in a Dial-In or LAN environment; reducing this value may give better responsiveness. Using too low a value in a LAN environment may cause a large number of small packets to be generated, which may affect network performance.
MouseTimer=value
Specifies a time interval, in milliseconds, during which mouse input will be collected before being sent to the Citrix server. The default value of 100 milliseconds is optimized for WANs; in a Dial-In or LAN environment, reducing this value may give better responsiveness. Using too low a value in a LAN environment may cause a large number of small packets to be generated, which may affect network performance.
The [WFClient] Section
Version=2
Specifies the version of the client software. Do not change this value. This is a required field.
TcpBrowserAddress=ipaddress
Specifies the IP address of a Citrix server used for server location. This field is required if UseAlternateAddress=1 is specified in the [EntryName] section.
***FOR BITMAP CACHING TO WORK WITH THE WEB CLIENT:
In the section WFClient add the following lines:
PersistentCacheEnabled=On
PersistentCacheSize=42935633
PersistentCacheMinBitmap=8192
PersistentCachePath=C:\WINNT\Profiles\amitb\Application Data\ICAClient\Cache
In the section for the application add the following line:
PersistentCacheEnabled=On
Now bitmap caching will work. For switching off, you can switch off PersistentCacheEnabled in the application setting. Please note that if setting under application name and WFClient differ then setting under application name will take precedence. PersistentCachePath should be suitably changed to correspond with the actual user and the directory where he wants to put the cache files. PersistentCacheSize and PersistentCacheMinBitmap may also be changed according to the requirement.
This Solution pertains to the following:
- MetaFrame 1.8 for Microsoft NT Server 4.0, Terminal Server
- WinFrame 1.8
Bottom of Form
/ back to topYour feedback is welcome. Send us an email.
Please remember that this feeback area is not designed to respond to technical support requests. For technical support contact information, please go to
Copyright 2000 © Citr