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.
; Use either ScreenPercent or DesiredHRES and DesiredVRES to specify
; the size of the client
window.
; If
both ScreenPercent and
DesiredHRES and DesiredVRES are
specified,
; onlyScreenPercent 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 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.
