Attachmate EXTRA! Mainframe Server Edition
Version 8

Release Notes
April 2004


This file contains late-breaking information about this release of Attachmate EXTRA! Mainframe Server Edition.

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_extra.htm EXTRA! X-treme, which provides access to IBM mainframe, AS/400, VAX/VMS, UNIX, or other asynchronous host applications.
readme_extra_connpak.htm EXTRA! X-treme Connections Pack, which provides additional connection types.
readme_extra_optionpak.htm EXTRA! X-treme Options Pack, which includes tools to provide AS/400 file sharing, API access to 16-bit HLLAPI and APPC applications, additional keyboard drivers, and support for the CASL macro language.
readme_mcs.htm Management & Control Services (MCS), a Web-based server console that administrators can use to centrally manage and configure compatible Attachmate products.

Known Issues

Unable to Connect via 802.2 on a Terminal Server when Running APPN Node as a Service

Microsoft has changed their default security settings for the following operating systems to tighten desktop security: Windows 2003, Windows 2000 Service Pack 4, and Windows XP Service Pack 2. As a result, a client running EXTRA! as a restricted user on a Terminal Server will need additional rights to connect via 802.2 when running the APPN node as a service. To provide the necessary rights, in the Local Security Policy, under User Rights Assignment, grant the user rights to create global objects.

Error with IBM z/OS Java v. 1.4 VM

A bug exists in the IBM z/OS Java v. 1.4 virtual machine (JVM) implementation, which prevents proper HTTP chunked data decoding. HTTP headers are encoded in ASCII, but the JVM is decoding it as IBM-1047 (EBCDIC). This leads to a NumberFormatException when trying to parse the chunk size header value.

IBM has acknowledged this issue and will address it in their next SR. To install centralized management under JDK v. 1.4.x on USS, you will need to obtain this patch from IBM.

Reassigning File Ownership when Installing in a UNIX Environment

When installing myEXTRA! 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, "myextra." 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 myEXTRA! server from restarting properly.

Using the Attachmate HTTP engine on UNIX Systems

If you are using the Attachmate HTTP engine 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 (InstallDir)/HTTPEngine/bin directory, by adding the following line near the top of the file:

    ulimit -n 1024

  2. Restart the Attachmate HTTP engine.

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.

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.)

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.