Attachmate Verastream SDK for Unisys and Airlines Release Notes

Attachmate Verastream SDK for Unisys and Airlines
Version 4.0

Release Notes
August 2007

Introduction
New in This Release
Installation Notes
Application Support
Known Issues

INTRODUCTION

This file contains late-breaking information about the Attachmate Verastream SDK for Unisys and Airlines.

NEW IN THIS RELEASE

The following changes were made for this release:

Microsoft's .NET Framework v. 2.0 is now supported, and the SDK objects are documented in the .NET Reference Guide.
Connection via the Airlines Gateway is now supported.
The following INT-1 features are now supported:
- Three new methods were added to allow you to control peripheral devices from SDK applications: getPeripheralControl, setPeripheralControl, and SendStatus.
  For more information, see the Javadoc and .NET reference guides.
- The INT-1 XML configuration can now contain embedded XML environments.
- The new parameter AltInetAddress allows IP rollover.
- Unisys Outbound Open requests are now supported.
The RawDataTransmitBytes, setDataCaptureEx, getCapturedBytes, OpenEx, and SendStatus methods were added to this release. For more information, see the Javadoc and .NET reference guides.
The IStatusListener event interface returns host transport status events.
The following MATIP features are now supported:
- MATIP can now accept connections originating from the MATIP host. (ALC and UTS)
- MATIP host-to-host is now supported. (ALC and UTS)
- The Extended Worldspan WSE MATIP protocol is now supported. (ALC only)
Limited tracing capabilities for ALC and UTS screen objects have been added. See the Visual Basic and C# sample applications, which are documented in the Verastream SDK Help.
The MOD3, MOD4, and MOD5 screen geometries are now supported in the 3270 Screen Object.
The following development tools are now supported: Active Server Pages, Eclipse, Visual Basic 6.0, Visual C++ 6.0, and Visual Studio 2005.
This release includes updated sample applications.

INSTALLATION NOTES

(Windows users only) You must uninstall any previous versions of the Verastream SDK before installing this version.

To install the Verastream SDK on a UNIX machine:
Insert the Verastream SDK CD into the CD-ROM drive. -or- Copy or FTP the contents of the install CD to your UNIX system. Use the utilities appropriate for your particular UNIX system to g-unzip verastreamSDKunix.tar.gz. This produces verastreamSDKunix.tar. Un-tar verastreamSDKunix.tar to a temporary directory. Change directories to the temporary directory. Execute the VSDK_setup.sh script and follow the prompts. The install script confirms your acceptance of the license agreement and the install location. Once the Verastream SDK has been successfully installed, you may remove the temporary installation directory.

To install the Verastream SDK on a UNIX machine:

Insert the Verastream SDK CD into the CD-ROM drive.
-or-

Copy or FTP the contents of the install CD to your UNIX system.
Use the utilities appropriate for your particular UNIX system to g-unzip verastreamSDKunix.tar.gz.
This produces verastreamSDKunix.tar.
Un-tar verastreamSDKunix.tar to a temporary directory.
Change directories to the temporary directory.
Execute the VSDK_setup.sh script and follow the prompts.
The install script confirms your acceptance of the license agreement and the install location.

Once the Verastream SDK has been successfully installed, you may remove the temporary installation directory.

To install the Verastream SDK on a Windows Machine:

Note:

You must log on with administrator privileges to install the product. If you do not have the necessary access rights, ask your system administrator to elevate your privileges.

From the distribution (or CD) image or an administrative installation image, click the vhisdk-4.0-prod-w32.exe file, and then follow the instructions for the installer.
(Optional) To personalize the installation, click the User Information tab and enter the name, organization, and Volume Purchase Agreement (VPA) number (if you have a VPA).
VPA numbers are issued by Attachmate for volume purchase agreements. These numbers allow customer support to expedite service requests.
(Optional) To change the default installation folder, click the File Location tab and browse to the folder in which you want to install the Verastream SDK.
(Optional) If you are planning to use the SDK to develop .NET or COM-based applications, click the Feature Selection tab and select the VSDK COM/.NET Support option.
The Microsoft .NET Framework 2.0 is required for this option.
Click the Advanced Tab, and select Install To This PC. If you want to create a log file, check Create A Log File For This Installation.
If selected, the log file is created in the Windows Temp folder with a naming format of atm-tendigitnumber.log.
When you have reviewed all the prompts for the product configuration, click Install Now.
The install summary page appears.

APPLICATION SUPPORT

The original Attachmate e-Vantage Airlines SDK interface is supported in this version. However, the Verastream SDK no longer supports the Microsoft JVM. As a result, the Verastream SDK contains different .tlb, .jar, .dll, and .h files than previous versions, and the screen object files have been consolidated into fewer files.

To use applications developed with the e-Vantage Airlines SDK, any existing CLASSPATH environment variables or makefiles/projects should be updated to reference the new jar files (Mutable.jar, SessionLoader.jar, ObjectManager.jar, jScreenUts.jar, jScreenAlc.jar, jScreenTn5250.jar, jScreenTn3270.jar, jScreenVt.jar, and jScreenT27.jar) where applicable.

KNOWN ISSUES

Help Links to the Javadoc and .NET Reference Guides Fail on CD

Because of differences between the CD image and the installed image of the Verastream SDK Help, links to the Javadoc and .NET Reference Guides fail when you browse the Help on the product CD; these links work properly in the installed Help. Likewise, links from the Javadoc and .NET Reference Guides to the Help also fail when you browse the product CD; those links also work properly in the installed reference guides. You can, however, review both the Javadoc and the .NET reference guides as well as the Help before you install the product.

Once the product is installed, these documents are available in the following locations, which you may want to bookmark for later reference:

Documentation	Location
Verastream SDK Help	<Installation Location>\documentation\content\airlinessdk.htm
Javadoc Reference Guide	<Installation Location>\javadoc\index.html
.NET Reference Guide	<Installation Location>\documentation\ndoc\index.html OR <Installation Location>\documentation\ndocs\VerastreamSDK40Reference.chm

Documentation

Location

Verastream SDK Help

<Installation Location>\documentation\content\airlinessdk.htm

Javadoc Reference Guide

<Installation Location>\javadoc\index.html

.NET Reference Guide

<Installation Location>\documentation\ndoc\index.html

<Installation Location>\documentation\ndocs\VerastreamSDK40Reference.chm

Links to the Verastream SDK Help from the .NET Reference Guide Fail

The links to the Verastream SDK Help from VerastreamSDK40Reference.chm fail. However, these links are valid in the installed .html version of the .NET Reference Guide.