# Compaq TP Desktop Connector
for ACMS

# Installation Guide

Order Number: AA--PG9DJ--TE

# August 1999

This document provides information about installing the Compaq TP Desktop Connector software on desktop systems, and about installing the Compaq TP Desktop Connector Gateway for ACMS software on systems running the Compaq OpenVMS operating system and Compaq ACMS software. It also describes activities associated with these installations, such as the verification procedure.

Revision/Update Information: This is a revised manual.

Software Version: Compaq TP Desktop Connector
Version 3.1A for ACMS

Compaq Computer Corporation
Houston, Texas

August 1999

The information in this publication is subject to change without notice.

COMPAQ COMPUTER CORPORATION SHALL NOT BE LIABLE FOR TECHNICAL OR EDITORIAL ERRORS OR OMISSIONS CONTAINED HEREIN, NOR FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES RESULTING FROM THE FURNISHING, PERFORMANCE, OR USE OF THIS MATERIAL. THIS INFORMATION IS PROVIDED "AS IS" AND COMPAQ COMPUTER CORPORATION DISCLAIMS ANY WARRANTIES, EXPRESS, IMPLIED, OR STATUTORY, AND EXPRESSLY DISCLAIMS THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR PARTICULAR PURPOSE, GOOD TITLE, AND AGAINST INFRINGEMENT.

This publication contains information protected by copyright. No part of this publication may be photocopied or reproduced in any form without prior written consent from Compaq Computer Corporation.

#### © 1999 Digital Equipment Corporation. All rights reserved.

The software described in this guide is furnished under a license agreement or nondisclosure agreement. The software may be used or copied only in accordance with the terms of the agreement.

Compaq and the Compaq logo are registered in the United States Patent and Trademark Office.

ACMS, ACMS Desktop, ACMSxp, ACMSxp Desktop, AlphaServer, AltaVista, DEC, DECnet, DECthreads, DIGITAL, OpenVMS, VAX, and VMS are trademarks of Compaq Computer Corporation.

Intel is a registered trademark of Intel Corporation.

Java, JavaScript, and JavaBeans are trademarks of Sun Microsystems, Inc.

Microsoft, Microsoft Access, MS, MS-DOS, Visual Basic, Visual C++, Windows, Windows 95, and Windows NT are registered trademarks and ActiveX is a trademark of Microsoft Corporation.

Oracle is a registered trademark of Oracle Corporation.

UNIX and X/Open are registered trademarks and The Open Group is a trademark of The Open Group in the United States and other countries.

Other product names mentioned herein may be trademarks and/or registered trademarks of their respective companies.

Contents | Index

# Preface

This guide presents information about installing the Compaq TP Desktop Connector software on desktop platforms, and the TP Desktop Connector Gateway for ACMS software on OpenVMS platforms.

# Intended Audience

This document is intended for:

- Programmers developing client applications with TP Desktop Connector software.
- System managers responsible for Compaq ACMS transaction processing installations.

To perform the installation and deinstallation procedures described in this guide, you must have administrator (for Windows NT platforms), SYSTEM (for OpenVMS platforms), or superuser (for Tru64 UNIX platforms) privileges, and you should be familiar with your operating system's installation procedure.

# Related Software

Compaq TP Desktop Connector is part of a transaction processing software suite that also contains the following product variants:

- Compaq TP Desktop Connector for ACMSxp
- Compaq TP Desktop Connector for Portable TP
- Compaq TP Web Connector
- Compaq Portable TP for Windows NT
- Compaq Application Optimizer for Windows NT

Complete information about the relationships of other software products with TP Desktop Connector software is available in the Software Product Description (SPD). The SPD also identifies which versions of your operating system are compatible with TP Desktop Connector software.

A copy of the SPD is included in your product kit and on the Compaq Web site at `www.compaq.com` by searching for TP Desktop Connector in Software Product Descriptions. Refer to Compaq TP Desktop Connector for ACMS Release Notes for the actual URL.

# Related Documents

Installation instructions for the ACMSxp and Portable TP versions of TP Desktop Connector software appear in the following manuals, respectively:

- Compaq TP Desktop Connector for ACMSxp Installation Guide
- Compaq TP Desktop Connector for Portable TP Installation Guide

The following manuals contain information about building client applications with TP Desktop Connector products:

- Compaq TP Desktop Connector Getting Started
- Compaq TP Web Connector Getting Started
- Compaq Portable TP for Windows NT Getting Started
- Compaq Application Optimizer for Windows NT Getting Started

The following documents contain information on the TP Desktop Connector Client Services Interface:

- Compaq TP Desktop Connector for ACMS Client Application Programming Guide
- Compaq TP Desktop Connector for ACMS Client Services Reference Manual
- Compaq TP Desktop Connector for ACMS Gateway Management Guide
- Compaq TP Desktop Connector for ACMS 4D Externals User's Guide---online only
  (Look in the `acmsdi-examples` folder of your Macintosh after installation.)

Other manuals contain information about installing and managing your ACMS system and TP Desktop Connector Gateway for ACMS software:

- Compaq ACMS for OpenVMS Installation
  Describes the installation of ACMS software on OpenVMS systems.
- Compaq ACMS for OpenVMS Managing Applications
  Explains how to start and stop the ACMS system, monitor system performance, and perform some tuning operations. It also tells how to install applications and how to authorize users, devices, and applications.

This guide does not provide details about the OpenVMS installation procedure. For that information, refer to the Installation and Operations for the particular device that you use. That manual describes the following procedures:

- Handling and mounting the distribution media
- Readying the current system and target system devices

For information on recommended system management and operations policies and procedures, refer to your site management guide and the volumes in the OpenVMS documentation set that pertain to system management and operations.

Finally, the Compaq TP Desktop Connector Release Notes contain information about new features and current restrictions for TP Desktop Connector software. In your Web browser, open the `dskcon_release_notes.htm` file on the TPware Product Suite CD. On the OpenVMS Software Products Library CD, the Release Notes are contained in the installation procedures. Compaq recommends that you read the Release Notes before you install the software.

# Structure

This manual is divided into three parts, according to how you received the TP Desktop Connector software. If you have the OpenVMS Software Products Library CD, you should start with Part 1. If you have the TPware Product Suite CD, you should start with Part 2. If you have the TP Desktop Connector Gateway for ACMS CD, start with Part 3.

The document has the following components.

Component | Description
--- | ---
Part 1 | Using the Software Products Library CD
Chapter 1 | Explains how to prepare your OpenVMS system for installing TP Desktop Connector software from the Software Products Library CD.
Chapter 2 | Explains how to install TP Desktop Connector and gateway software from the Software Products Library CD.
Chapter 3 | Describes tasks that might be needed on your OpenVMS system after installing TP Desktop Connector software from the Software Products Library CD. It also provides references to information on post-installation tasks for TP Desktop Connector client software on other platforms.
Part 2 | Using the TPware Product Suite CD
Chapter 4 | Explains how to prepare your system for installing TP Desktop Connector software from the TPware Product Suite CD.
Chapter 5 | Describes how to install the TP Desktop Connector software on a 32-bit Microsoft operating system: Windows NT running on either an Intel or a Compaq Alpha processor Windows 95 or 98 on an Intel processor
Chapter 6 | Describes how to install the TP Desktop Connector Client Services Interface software and sample client applications on the following non--Windows 32-bit desktop platforms: Microsoft DOS Microsoft Windows 3.11 Compaq OpenVMS Tru64 UNIX
Chapter 7 | Describes how to install the TP Desktop Connector Client Services Interface software and sample client applications on Apple Macintosh systems.
Part 3 | Using the Gateway CD
Chapter 8 | Explains how to prepare your OpenVMS system for installing TP Desktop Connector gateway for ACMS software.
Chapter 9 | Describes how to install the TP Desktop Connector gateway for ACMS software and sample server-side applications and run the Installation Verification Procedure (IVP). It also tells you how to recover from system and installation failures.
Chapter 10 | Describes postinstallation procedures that prepare the OpenVMS system for running gateway software.
Chapter 11 | Describes how to run the installation verification procedure (IVP) separately from the installation procedure.
Part 4 | Appendixes
Appendix A | Lists the files that are installed on your system for the various sample programs.
Appendix B | Contains helpful hints about errors that might occur when you run one of the sample applications.

The information in the Appendixes applies no matter which CD you installed.

# Conventions

The following icons appear in the margin to distinguish information that is specific to either OpenVMS VAX or OpenVMS Alpha:
The Alpha icon denotes the beginning of information specific to OpenVMS Alpha systems.
The VAX icon denotes the beginning of information specific to OpenVMS VAX systems.
The diamond symbol denotes the end of a section of OpenVMS operating system information specific to either the Alpha or VAX platform.

Additional typographic conventions used in this document are listed below:

Convention | Description
--- | ---
TP Desktop Connector | Represents the Compaq TP Desktop Connector product software.
Gateway | Represents the Compaq TP Desktop Connector Gateway for ACMS software.
UPPERCASE | In text, the names of OpenVMS directories, commands, logicals, and so on, are set in all capital letters.
FTP | Represents the file transfer program of your choice, not necessarily File Transfer Protocol. You can substitute any method that works on your installation and target platforms.
italics | In text, italics indicate emphasis, a product name, or the title of a book.
`courier` | This font indicates a command, programming language, or an object on your screen.
user input | In examples, letters that you actually type are highlighted in boldface type.
node | In syntax format and examples, italic type indicates variables, parameters, or arguments. You need to substitute the appropriate value.
E:\ | In examples, the CD-ROM device is assumed to be drive E:. Substitute the correct letter for your system, if needed.
C:\TPware_Products\ | This is the default destination for the TPware Product Suite installation program. All the examples in this book use the default. If you choose a different folder during the installation, substitute that drive and folder name.
. . . | In examples, a vertical ellipsis indicates that information not directly related to the example has been omitted.

# Part 1
Using the Software Products Library CD

Part 1 describes how to install Compaq TP Desktop Connector and Compaq TP Desktop Connector Gateway for ACMS software from the OpenVMS Software Products Library compact disk, also known as the consolidated distribution (CONDIST) CD.

For installations using the TPware Product Suite CD, see Part 2. For installations using the TP Desktop Connector Gateway for ACMS CD, see Part 3.

# Chapter 1
Before Installing TP Desktop Connector from the Software Products Library CD

This chapter discusses the preparations and requirements necessary for installing Compaq TP Desktop Connector and Compaq TP Desktop Connector Gateway for ACMS software on an OpenVMS system from the Software Products Library CD. This chapter also provides a general overview of the installation process.

If you have the TPware Product Suite or TP Desktop Connector Gateway for ACMS CD, see Part 2 or 3, respectively.

TP Desktop Connector software includes online Release Notes and gives you the option of printing or displaying them during the installation procedure. Compaq strongly recommends that you read the Release Notes before proceeding with the installation, in case they contain important information regarding the installation procedure.

# 1.1 Overview of the Software Products Library Installation

The TP Desktop Connector software is delivered in two distinct product savesets, one for the gateway software that run on the OpenVMS platform and one for desktop clients:

- The gateway saveset (ACMSDIA031.*)
  Delivers the software required on an OpenVMS system to enable access to Compaq ACMS from the desktop systems. Also includes server-side sample applications.
  You install the gateway software with a regular VMSINSTAL command.
- The client saveset (TPWA031.A)
  Delivers the software required for application development in a multiplatform, networked, desktop systems environment. Also includes sample client applications.
  You install the client software by starting with a VMSINSTAL command on an OpenVMS system. The next steps depend on your target desktop platform.

The clients are provided as self-extracting archive files that expand upon execution. In general, the procedure for installing the client software and accompanying sample client application files consists of the following steps:

1. Transfer a client archive file to your target desktop platform, using a file transfer program such as FTP.
2. Expand the archive file by executing it.
3. If your target desktop is a Win32 system, run the resulting `setup.exe` file as explained in Section 5.1.
   If your target desktop is non--Win32:
   1. Set up your system for the TP Desktop Connector environment.
   2. Set up your network transport.
   These steps are explained in Section 5.2.
   If your target desktop is an Apple Macintosh, see Chapter 7
4. Run the sample application to verify that the installation functions properly.

The following sections discuss the preparations and requirements necessary before installing the TP Desktop Connector software.

# 1.2 Software and Hardware Prerequisites

The Compaq TP Desktop Connector Software Product Description (SPD), included in the product kit, contains complete information on software products, networks, and systems required for installing and using TP Desktop Connector client and gateway software.

In addition, installing TP Desktop Connector software requires a certain amount of free storage space. Table 1-1 summarizes the storage requirements for TP Desktop Connector during and after installation.

Table 1-1 TP Desktop Connector Disk Space Requirements
| Blocks During Installation | Blocks After Installation
--- | --- | ---
TP Desktop Connector Gateway for ACMS software | 23 304 | 6 500
OpenVMS client files | 34 383 | 3 300

To determine the number of free disk blocks on the current system disk, enter the following command at the DCL prompt:

    $ SHOW DEVICE SYS$SYSDEVICE

In the output column under the heading `Free Blocks` is the number of 512-byte blocks available on the device.

# 1.3 Installation Procedure Requirements

Both the gateway and client installations from the Software Products Library CD use the VMSINSTAL command (see Section 2.1 and Chapter 8 for gateway and server-side instructions). Section 2.2 describes the client installation process.

Next | Contents | Index