Attachmate TCP/IP Socket Server
Version 2.0

Release Notes
August 2007

© 2007 Attachmate Corporation.

INTRODUCTION

The Attachmate TCP/IP Socket Server works together with the Unisys Open Message Switching Engine (OMSE) to provide TCP/IP host connectivity. OMSE passes UTS data in an internally defined protocol to ATSS, and then ATSS connects to the Unisys host via the INT-1 protocol.

SYSTEM REQUIREMENTS

Sun JRE 1.5 or higher.

ATSS works together with the Unisys Open Message Switching Engine (OMSE). See the OMSE documentation for additional system requirements.

INSTALLATION NOTES

UNIX Installation

To install the Attachmate TCP/IP Socket Server on a UNIX 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.
  1. Insert the ATSS CD into the CD-ROM drive.

    -or-

    Copy or FTP the contents of the install CD to your UNIX system.

  2. Use the utilities appropriate for your particular UNIX system to g-unzip atssunix.tar.gz.

    This produces atssunix.tar.

  3. Un-tar atssunix.tar to a temporary directory.

  4. Change directories to the temporary directory.

  5. Execute ATSS_setup.sh and follow the prompts.

    The install script confirms your acceptance of the license agreement and the install location. Once ATSS has been successfully installed, you may remove the temporary installation directory.

  6. Verify that the atss.sh and gui.sh scripts and the atss sample daemon script contain the correct ATSS_HOME environment variable. ATSS_HOME should point to the installation destination directory.

Windows Installation

To install the Attachmate TCP/IP Socket Server 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.
  1. From the distribution (or CD) image or an administrative installation image, click the vhiatss-4.0-prod-w32.exe file, and then follow the instructions for the installer.

  2. (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.

  3. (Optional) To change the default installation folder, click the File Location tab and browse to the folder in which you want to install ATSS.

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

  5. When you have reviewed all the prompts for the product configuration, click Install Now.

    The install summary page appears.

Back to top

APPLICATION SUPPORT

Environment Variables

The Java path must be in the system path or in the environment variable before you can use ATSS.

Configuration File

The ATSS configuration file, config.xml, controls all (non-tracing) configuration options within ATSS. In most cases, you can use the default values for everything, including ports. Config.xml is located in <Installation Location>\config.

Log File Options

Several tracing options are available in the ATSS log file (<Installation Location>\config\LogConfig.xml). Each level of tracing contains different information, as follows:

For general use, it is recommended that you set the tracing option to ERROR or WARN. The log files are placed into a log subdirectory. The log file names contain the date and time in yyyymmdd-hhmmss format (for example, 20070711-155356_0.log is from July 11, 2007 at 3:53 PM).

Launching ATSS

To launch the ATSS Server, execute the appropriate batch file from a command prompt (atss.bat for Windows and atss.sh for UNIX). The batch files are located in the installation location. For Windows, the ATSS Server is available in the Start Menu (Attachmate TCP-IP Socket Server | ATSS Server). Once you have launched the ATSS Server, it runs in the background.

To launch the ATSS GUI, execute the appropriate batch file from a command prompt (gui.bat for Windows and gui.sh for UNIX). The batch files are located in the installation location. For Windows, the ATSS GUI is available in the Start Menu (Attachmate TCP-IP Socket Server | ATSS Administration). You will be prompted to enter a userid and password, which are system and system. You can change the userid and password in <Installation Location>\config\config.xml.

The ATSS Server must be running before you can launch the ATSS GUI.

Back to top

TECHNICAL SUPPORT

Should you encounter a problem with ATSS, you might want to search the Attachmate Technical Support site for more information, or contact Attachmate Technical Support.

Back to top

  Footer