Citrix states in their article: CTX554864

CTX554864 - How to Turn Bitmap Caching and Compression on with the ICA Web Client When Using NFuse or Citrix Application Launching or Embedding

This document was published at: http://support.citrix.com/kb/entry.jspa?externalID=CTX554864

Document ID: CTX554864, Created on: May 14, 2001, Updated: Apr 23, 2003

Products: Citrix WinFrame 1.8

The following describes the steps required to turn bitmap caching and compression on with the ICA Web Client when using NFuse or Citrix Application Launching or Embedding:

Caching and compression are not enabled by default in the Web Client. They have to be configured manually. These changes are not made in the NFuse Classic 1.7 Admin Tool or in the NFuse.conf file.

Enabling Compression

1. Verify that the client you are using is using PdcompN.dll.

2. Add Compress=On under the [Application] section of your Ica file.

3. Add the following section to the end of your Ica file:

[Compress]
DriverNameWin32=pdcompn.dll

Below are two examples of Ica files that have compression enabled — Template.ica and guest_template.ica used with NFuse:

[[NFuse_AppFriendlyName]]
Address=[NFuse_IPV4AddressAlternate]
InitialProgram=#[NFuse_AppName]
DesiredColor=[NFuse_WindowColors]
TransportDriver=TCP/IP
WinStationDriver=ICA 3.0
Compress=On
[Compress]
DriverNameWin16=pdcompw.dll
DriverNameWin32=pdcompn.dll

Below is a sample Ica file written using Published Application Manager or Citrix Management Console:

[WFClient]
Version=2
[ServerNameApplicationName]
Address=ServerNameApplicationName
InitialProgram=#ServerName
ApplicationNameScreenPercent=75
DesiredColor=8
TransportDriver=TCP/IP
WinStationDriver=ICA 3.0
Compress=On
DriverNameWin16=pdcompw.dll
DriverNameWin32=pdcompn.dll

NOTES: Using the Citrix Management Console, your Ica files will give you a GUI option to Compress ICA Data Stream.
Make sure you are using the latest version of the Web Client with the compression dll as indicated above.

You can toggle compression on and off by changing Compress=On to Compress=Off. It is not necessary to remove the line if you want to disable compression.

Enabling Bitmap Caching

Add the following lines to the [WFClient] or [ThinWire 3.0] section of the Ica file:

PersistentCacheEnabled=On
PersistentCacheSize=42935633
PersistentCacheMinBitmap=8192
PersistentCachePath=M:\WTSRV\Profiles\\Application Data\ICAClient\Cache

In the section for the application (for example, [MS Word]) add the following line:

PersistentCacheEnabled=On

Here is an example of an Ica file for Microsoft Word:

[WFClient]
Version=2
TcpBrowserAddress=10.x.x.x
TcpBrowserAddress2=10.x.x.x
IpxBrowserAddress=0:00....
IpxBrowserAddress2=FF:00....
NetBiosBrowserAddress=CITRIX1
NetBiosBrowserAddress2=CITRIX2
PersistentCacheEnabled=On
PersistentCacheSize=42935633
PersistentCacheMinBitmap=8192
PersistentCachePath=N:\WTSRV\Profiles\Administrator\Application Data\ICAClient\Cache

[ApplicationServers]
MS Word=

[MS Word]
Address=MS Word
InitialProgram=#MS Word
DesiredHRES=640
DesiredVRES=480
DesiredColor=2
TransportDriver=TCP/IP
WinStationDriver=ICA 3.0
PersistentCacheEnabled=On

You can disable bitmap caching by changing the following in the [ ] section:

PersistentCacheEnabled=Off

This takes precedence over the value set in the [WFClient] section if the two values are different. If necessary, you can change the values for PersistentCachePath, PersistentCacheSize, and PersistentCacheMinBitmap.

The ThinWire3.0 section heading enables the client to use the ThinWire flags.

The PersistentCacheEnabled entry allows you to turn persistent bitmap caching on and off.

The PersistentCacheSize entry allows you to set the maximum cache size. The maximum allowable size is 0 to 10240KB.

The PersistentCacheMinBitmap entry allows you to set the minimum size for each bitmap. The allowable size for each bitmap is from 2 to 64KB.

The PersistentCachePath entry specifies where the Cache folder will be created. Create the Cache folder under the users profile under the hidden folder \Application Data\ICAClient\.

NOTE: For the entries PersistentCacheSize and PersistentCacheMinBitmap you have to convert Kilobytes to bytes when setting the sizes in the Ica files.