READ ME Citrix ICA Client for IBM OS/2 Warp (ICA OS/2 Client) Filename: icaos2.exe Software Version: 6.012 Replaces: All versions prior to November 1, 2001 Date: November 1, 2001 Languages: English, French and German (c) 2001 Citrix Systems, Inc. ----------------------------------------------------------- Description ============ The ICA OS/2 Client supports the following platforms: * OS/2 Warp 3 * OS/2 Warp 4 * OS/2 Warp 4.5 Important Note: We recommend upgrading your OS/2 installation with the latest OS/2 Warp FixPak (from IBM) before you install the ICA OS/2 Client. IBM continues to issue FixPaks that fix existing problems in OS/2 Warp platform/s. Upgrading to the latest FixPak may therefore resolve device specific problems that could cause unexpected behavior on the ICA OS/2 Client. Software Enhancements and Problems fixed in this Release ================================================= This main highlights of this release of the ICA OS/2 Client are extended hardware compatiblity, improved graphics rendering performance, and a smaller memory footprint. Details of the changes implemented in this version (6.012) of the ICA OS/2 Client software are as follows: * Extended hardware compatibility range ---------------------------------------- On some hardware/software combinations, with older FixPaks / GRADD driver revisions, graphics corruption was observed in the form of invisible text and/or inverted text on window title bars and controls. The issue has now been resolved. The two old parameters (MonoBitmapInvert and GRADDAutoDetect) used to manually correct this problem are now redundant and have been deleted. Presence of these parameters in the ICA or INI files will be ignored. * Improved graphics rendering and smaller memory footprint ---------------------------------------------------------- The changes made to extend the supported hardware permutations has resulted in improved graphics rendering, as well as a slightly smaller memory footprint at runtime. * Keyboard Compatibility between Operating Systems ------------------------------------------------------ In previous versions of the OS/2 Client software unpredictable behavior was being experienced when using the Shift-Lock, the Caps Lock or the Num Lock keys in a remote session if there was a mismatch between the client-side and the server-side with respect to Shift-Lock processing by the operating system. For example, if the OS/2 Client is configured with KEYB FR, and the MetaFrame for Windows server is configured for French keyboard without Shift-Lock processing (the default) unpredictable behavior may be experienced. This is now resolved by the implementation of the EnableShiftLock parameter in the [WFCLIENT] section of the APPSRV.INI or in the ICA file itself. You can now force the client to use local keyboard settings regardless of what the settings are on the server. To do this set: [WFCLIENT] EnableShiftLock = True This resolves mismatches when connecting to different servers with different default settings. * Issues with connecting to MetaFrame for UNIX farms resolved ------------------------------------------------------------- When connecting to MetaFrame for UNIX farms, the available published applications list is displayed correctly. Where to Find Documentation ============================= This document contains late-breaking information about the ICA OS/2 Client software. For more information about the ICA OS/2 Client, refer to the Citrix ICA Client Administrator's Guide for the ICA OS/2 Client, available in an Adobe Portable Document Format (PDF) file (ICAOS2.PDF). This file is available on the Citrix Downloads page at http://www.citrix.com/download/; click ICA Clients. Use Adobe Acrobat Reader to view PDF files. Acrobat Reader is free software that lets you view and print Adobe Portable Document Format (PDF) files on all major computer platforms. You can download Acrobat Reader from Adobe's Web site at http://www.adobe.com. You can also find documentation on the Web at http://www.citrix.com/support. On the Services Portfolio page; click the Product Documentation tab, and choose ICA Clients. System Requirements ==================== Computers used with the ICA OS/2 Client must meet the following requirements: * Standard PC architecture, 80486 processor or greater * IBM OS/2 Warp 3.0 (FixPak 32 or greater), Warp 4.0 (FixPak 5 or greater), or Warp 4.5 * 8MB RAM or greater * Mouse * Keyboard * VGA or higher resolution * 2MB free hard disk space * Connection to a Citrix server over TCP/IP transport Installation ============= Download the installation package for the Citrix ICA OS/2 Client from the Citrix Download site. 1. Copy the ICA OS/2 Client image (icaos2.exe) to a temporary directory (for instance, c:\temp) on the client machine. The file is a self-extracting archive. 2. Open an OS/2 command window, and change to the directory where the icaos2.exe file was saved: c:\>cd temp 3. Extract the contents of the archive by running icaos2.exe: c:\temp>icaos2 Contents of the archive are extracted to c:\temp. 4. To install the OS/2 Client, run install.exe: c:\temp>install The installation program will begin installing the ICA OS/2 Client. Follow the prompts until installation is complete. Known Problems/Limitations (in this release): ================================== 1. Garbled text ------------------------- Occurrence of garbled text is observed within an ICA session on some older machines using an S3 Trio64 chipset, with FixPak5 and old GRADD drivers. This has been investigated and identified as a third party bug. We recommend that you upgrade the client device with the latest OS/2 FixPak, and/or install the latest GRADD driver versions. 2. Color corruption ------------------------------ On client devices using older chipsets such as Intel 810, with FixPak 5 and old GRADD drivers, some color corruption maybe visible when connecting to a remote session (16 or 256 colors) from a desktop using 16 or 24 bit color This has been investigated and identified as a third party bug. We recommend that you upgrade the client device with the latest OS/2 FixPak, and/or install the latest GRADD driver versions. 3. Some client printer names are not recognized correctly at the server ---------------------------------------------------------------------- You may experience this problem if the client printer name contains international characters. This issue is caused by the fact that on OS/2 extended characters have been mapped to different character codes as compared to their Windows counterparts, even when the same codepage is used. Therefore, their representation will be different on the client and the server. Please note that extended characters should not be used to exchange information between the client and server. The solution is to ensure that client printer names do not contain extended characters. 4. Citrix server connections take longer than usual to time-out ---------------------------------------------------------------------- The "Connecting to ..." message remains on the screen and the Cancel button doesn't seem to work This problem occurs only when an existing server (listed in the ICA browser) is currently not functioning. OS/2 sets a default timeout limit of 75 seconds for TCP/IP connections. This is a global setting that cannot be changed without affecting other applications running at the time. 5. Unable to cut and paste a Euro symbol from the server to a client --------------------------------------------------------------------- The Euro symbol is an extended character. On OS/2, extended characters are mapped to different character codes as compared to their Windows counterparts, even when the same code page is used, therefore their representation is different on the two platforms. This is a basic difference in the implementation of the two operating systems. 6. Code page requirements for Euro symbol and other extended characters ---------------------------------------------------------------------- If you are unable to generate the euro symbol on an OS/2 client, it may be that the code page being used is incorrect. You should use code page 850 to enable generation of extended characters. To set the code page on OS/2, open an OS/2 window and type the following command: c:\>chcp 850 To get the current system code page setting, type: c:\>chcp 7. Applications launched from Netscape are terminated when you quit Netscape ---------------------------------------------------------------------- If you launch ICA sessions using the Netscape browser, or using NFuse, and then close Netscape, all ICA sessions will be disconnected. This is due to the OS/2 specific implementation of Netscape, that is, all child processes (launched ICA connections, in this case) are terminated when the user exits the parent process (Netscape). 8. Problems upgrading ICA OS/2 Client software -------------------------------------------------------------------- We recommend that you always delete any previously installed versions of the client software before installing a newer version. To remove older versions of the client software: a) Run the installer and proceed to the "Installation options" dialog. b) Select the "Delete the installed product and re-install" option. c) Proceed to the "Install" dialog and press the "Cancel" button. 9. Using certain applications on a mapped client drive generates an "Out of file handles" message. ---------------------------------------------------------------------- This problem is encountered when an application running on the server opens too many files on a client mapped drive and causes the ICA session to run out of file handles. This is a third party bug in OS/2 - the operating system does not provide the ICA Client engine sufficient file handles on request. The fix to this problem is to increase the number of initial file handles available to the ICA OS/2 Client by adding the MaxOpenContext parameter to the [ClientDrive] section in the MODULE.INI file . If the user needs to open a large number of files, increase the number of initial file handles to 50 or greater. The default value for MaxOpenContext is 20. [ClientDrive] MaxOpenContext=n where n is the number of initial file handles available to the client. Specifically, this problem occurs when Lotus Notes (Version 5.0) is one of the applications used on a client-mapped drive. The "Out of file handles" error is a direct result of this application using up too many file handles. 10. Problems mapping network printers, with the net use command, to local OS/2 devices --------------------------------------------------------------------- If you've mapped a network printer (with the net use command) to a local OS/2 device, for example, LPT1, then the ICA OS/2 Client will be unable to print to that printer through LPT1. As a workaround, use the printer configuration tool on the MetaFrame server to map network printers to local OS/2 ports. Useful Tips ================= 1. Switches for passing user credentials from the command line: -------------------------------------------------------------------- To pass user credentials, when launching the ICA OS/2 client from the command line, use the following command line switches c:\> wficaos2 /username:your_user_name /clearpassword:your_plain_text_password /domain:your_domain 2. Assigning a unique client name for an OS/2 client machine using the CLIENTNAME variable ---------------------------------------------------------------------- To manually assign a name to an ICA Client running on an OS/2 device, you can set the CLIENTNAME environment variable from the command prompt, or through an entry in the CONFIG.SYS file, on your OS/2 machine. c:\ set CLIENTNAME=YOUR_DESIRED_NAME The order of priority in which the ICA OS/2 Client determines what the client name should be, is as follows: a) Gets the CLIENTNAME environment variable, if one has been set. b) Gets the client machine's host name (this is the name allocated to the device for use with TCP/IP transport). c) Checks the OS/2 LAN Services configuration for a machine name. d) If the above methods fail, then a random name is generated. Please note, unlike the Windows clients, the OS/2 client does not utilize the "wfcname.ini" file for client name determination. Publications Errata ======================= 1. Page 50, of the Administrator's Guide for the ICA OS/2 Client, Version 6.011 describes the use of two ICA/INI file parameters, namely GRADDAutoDetect and MonoBitmapInvert. Fixes made in this release have rendered these settings invalid. These settings have been removed, and will no longer have any effect if present in the ICA file. 2. Page 64, of the Administrator's Guide for the ICA OS/2 Client, Version 6.011, describes GRADD Driver Support on the ICA OS/2 Client. This section is no longer valid. In general, graphics and color corruption issues on the client should be resolved by installing the latest FixPak and GRADD driver revisions available.