Order Number: AA--PG9DJ--TE
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.
Compaq TP Desktop Connector
Version 3.1A for ACMS
Compaq Computer Corporation
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.
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.
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.
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.
This document is intended for:
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.
Compaq TP Desktop Connector is part of a transaction processing software suite that also contains the following product variants:
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.
Installation instructions for the ACMSxp and Portable TP versions of TP Desktop Connector software appear in the following manuals, respectively:
The following manuals contain information about building client applications with TP Desktop Connector products:
The following documents contain information on the TP Desktop Connector Client Services Interface:
Other manuals contain information about installing and managing your ACMS system and TP Desktop Connector Gateway for ACMS software:
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:
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.
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.
|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.|
Describes how to install the TP Desktop Connector software on a 32-bit
Microsoft operating system:
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:
|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.|
|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.
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:
|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.|
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.
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 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:
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.
|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
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.