Attachmate e-Vantage Host Access Server
Version 3.2

Release Notes
June, 2003


This file contains late-breaking information about this release of Attachmate e-Vantage Host Access Server.

In addition to this product-level readme file, there are several readme files included in this product that address component-specific issues:

This file
Contains information about
readme_mcs.htm Management & Control Services (MCS), a Web-based server console that administrators can use to centrally manage and configure compatible Attachmate products.
readme_mcs_update.htm This update provides improvements to MCS directory services and ID management. It can be applied to Management & Control Services (MCS) version 2.0.3.
readme_presintegrator.htm Presentation Integrator, a designer with which you can add headers and footers to your presentations, as well as combining them with viewers or Web pages.
readme_presmanager.htm Presentation Manager, a management component that runs within MCS. Using Presentation Manager, you can manage presentations created using Presentation Integrator.
readme_termviewers.htm Terminal Viewers, a component that allows you to provide secure access to mission-critical host applications through a Web-based interface. Terminal Viewers is installed as a component of MCS.
readme_termviewers_express.htm Attachmate 3270, 5250, and VT Express Terminal Viewers. These viewers provide browser-based access to host applications on IBM® mainframe, IBM AS/400®, and UNIX®/VMS hosts.
readme_termviewers_utst27.htm Attachmate UTS and T27 Terminal Viewers and T27 Printer. UTS and T27 Terminal Viewers and T27 Printer provide browser-based access to host applications on Unisys® 2200 Series (ClearPath® IX) and Unisys A Series (ClearPath NX/LX) hosts.
readme_termviewers_alceprint.htm ALC Terminal Viewer and e-Print Java Applet provide browser-based access to host applications on IBM® TPF hosts, Unisys® 2200 Series (ClearPath® IX) hosts, and other computer reservation systems. e-Print Remote allows a custom application to send print jobs to e-Print Java Applet.
readme_hasviewers_3270.htm Attachmate 3270 Terminal Viewer provides web-based terminal emulation to an IBM 3270 host, as well as the capabilities to print screen data and to cut, copy, and paste data among different applications. Attachmate 3270 Printer provides web-based host printing from an IBM 3270 host.

Installation Notes

Installing Both HAS and myEXTRA! Presentation Services Together on UNIX

If you are installing both Host Access Server (HAS) and myEXTRA! Presentation Services, it is recommended that you install myEXTRA! Presentation Services first.

Note If you install HAS first, you will be prompted during the myEXTRA! Presentation Services install to overwrite certain files with older ones. Do not replace these files with older versions. Doing so will cause T27 and UTS Terminal Viewers and T27 Printer to stop functioning.

Known Issues

Incompatibility Between JDK 1.4.1_01 and Some Video Drivers

If you experience either of the following two problems, please update your video driver.

Updating your video driver should eliminate these problems.

Reassigning File Ownership when Installing in a UNIX Environment

When installing Host Access Server on UNIX while logged in as the root user, you can re-assign file ownership for all Attachmate files to another user. You can choose a user name, other than the default, "evantage." If this user does not exist on the system, the installation script will create it for you, and will prompt you for group name, home directory, and password. If you specify a user other than the default, you must specify an existing user account for which a home directory already exists. Assigning files to a system user account such as "nobody" or "other" without an existing home directory will prevent the MCS server from restarting properly.

Using Tomcat on UNIX Systems

If you are using Tomcat on a UNIX system that will receive a high volume of traffic for MCS, you should increase your system's default setting for the number of "files" that can be concurrently opened by a particular process to 1024. This is advisable because UNIX considers a network connection to be a kind of file. Many systems have a default value of 64 or 256 for this setting, which may limit the concurrent connections available to your MCS Server.

To increase the number of files allowed by the Java process in which MCS is running
  1. After the UNIX installation is complete, edit, located in the Attachmate/tomcat/bin directory, by adding the following line near the top of the file:

    ulimit -n 1024

  2. Restart Tomcat.

MCS Discovery Agent

Designer components provide a Discovery Agent intended to allow them to identify the main MCS server in their network. The MCS Discovery Agent is not fully implemented in this release. When installing Presentation Integrator, accept the default Discovery Agent values.

Terminal Viewers with Windows 98 Second Edition

If problems arise when using Terminal Viewers and Windows 98 Second Edition, please install JDK or JRE 1.3.0x prior to downloading. When a Terminal Viewer is downloaded that requires Java, JRE 1.4.0_01 will be installed automatically. This overlay of JREs allows Terminal Viewers to function correctly in the Windows 98 environment.

Errors in the Tomcat Log

You may see several bad read errors in your Tomcat log file. This is a known bug in Tomcat v. 4.0.4, which is documented on the Apache Web site at The errors are harmless and can be safely ignored.

UnsupportedEncodingException Cp1386

When a browser accesses the WebSphere 4.0 App Server and it throws an "UnsupportedEncodingException Cp1386" exception, you will need to change the line in <was_root>\properties\ as follows:

From this
GB2312=Cp1386 GB2312=Gb2312

When you restart the App Server, the problem should go away. (There is a note about this in this the WebSphere readme file.)

Automatically Detecting IP Address Changes for your MCS Server

By default, if the IP address of your MCS server changes, the change is automatically detected. This is controlled by an option in your file, MCS.IntegrityCheck.CheckForIPChange.

MCS checks for changes when it starts. Because this can make startup slower, if you know that the address will never change, you may want to change the value for this option to false. Then, MCS will never check for IP changes.

Modifying Connection Information for a Configuration Server in a Clustered Environment

If, after installation, the IP address, host name, or port number of your MCS server or another configuration server changes, you will need to manually reconfigure values for all the servers in the server cluster so that they point to the new location. If the change is in your MCS cluster, you may also need to reconfigure values in other server clusters.

Note This procedure is necessary only if you work in a clustered environment. If you work in a single MCS server environment, a change in its IP address can be automatically detected.

The following procedure assumes that your Web server has also been updated with the new values.

To manually update connection information for a configuration server
  • Search the MCS install directory and subdirectories of your MCS servers and replace the values on all MCS servers on which they occur.

    Values that may need to be updated:
    In this file
    Note The location of the file varies, depending on your application server environment. In most cases, it is located in the WEB-INF directory, but it could also be in the mcs directory.

    MCS.dataservices.primary (This value should be blank for primary servers, including the MCS server.)


    mcs/resources/ServerMgt_Content.xml References to the name, address, or port number under the <MCS Cluster> node.


      where n is the server number of the affected server. For example, 10001.xml is the XML file for the MCS server.

    The following attributes to the <server> element:

    name, and/or

Uninstaller Lists Components Multiple Times

When different components have been installed from different CDs that have common components, such as MCS, the uninstaller dialog will list these common components, such as MCS, more than once. The common component will be listed under each main header section. Make sure that all references to a given component are treated the same, either checked or unchecked.

SOAP Errors During Upgrades

You may encounter a SOAP error when upgrading from version 7.1 to version 7.11 on a computer which meets the minimum system requirements but is below the preferred system requirements. The error message will state "The MCS server is not running or not reachable." In some cases, clicking the Retry button may allow you to continue without additional errors.