Order Number: AA--PG9DH--TE

This document provides information about installing the DIGITAL TP Desktop Connector for ACMS software on desktop systems, and about installing the DIGITAL TP Desktop Connector Gateway for ACMS software on systems running the DIGITAL OpenVMS operating system and DIGITAL 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: DIGITAL TP Desktop Connector
Version 3.1 for ACMS

Compaq Computer Corporation
Houston, Texas

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 FURNISHINGS, 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.

Copyright ©Digital Equipment Corporation 1999

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, DEC DEC C, DECforms, DECnet, DECthreads, DECwindows, DIGITAL OpenVMS, PATHWORKS, VAX, VAX C, and VAXshare are trademarks of Compaq Computer Corporation.

Apple, AppleShare, AppleTalk, HyperCard, Macintosh, MacTcl, and MacTerminal are registered trademarks of Apple Computer, Inc.

HP and HP-UX are registered trademarks of Hewlett-Packard Company.

IBM is a registered trademark of International Business Machines 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 of Microsoft Corporation.

Motif, 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.

NetWare and Novell are registered trademarks of Novell Corporation.

ORACLE is a registered trademark and Oracle Rdb is a trademark of Oracle Corporation.

PostScript is a registered trademark of Adobe Systems Incorporated.

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

This document is available on :CD-ROM.

This document was prepared using VAX DOCUMENT, Version V3.2-1h.

Contents

Index

This guide presents information about installing the DIGITAL TP Desktop Connector for ACMS 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 for ACMS software.
• System managers responsible for DIGITAL ACMS transaction processing installations.

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

Related Software

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

• DIGITAL TP Desktop Connector for ACMSxp
• DIGITAL TP Desktop Connector for Portable TP
• DIGITAL TP Web Connector
• DIGITAL Portable TP for Windows NT
• DIGITAL 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. You can also find it on the DIGITAL Web site at www.digital.com by searching for TP Desktop Connector in Software Product Descriptions. See the TP Desktop Connector release notes for the actual URL.

Related Documents

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

• DIGITAL TP Desktop Connector for ACMSxp Installation Guide
• DIGITAL TP Desktop Connector for Portable TP Installation Guide

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

• DIGITAL TP Desktop Connector Getting Started
• DIGITAL TP Web Connector Getting Started
• DIGITAL Portable TP for Windows NT Getting Started
• DIGITAL Application Optimizer for Windows NT Getting Started

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

• DIGITAL TP Desktop Connector for ACMS Client Application Programming Guide
• DIGITAL TP Desktop Connector for ACMS Client Services Reference Manual
• DIGITAL TP Desktop Connector for ACMS Gateway Management Guide
• DIGITAL ACMS Desktop 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 software:

• DIGITAL ACMS for OpenVMS Installation Guide
  Describes the installation of ACMS software on OpenVMS systems.
• DIGITAL 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. That information can be found in the Installation and Operations manual for the particular device 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 TP Desktop Connector release notes contain information about new features and current restrictions for TP Desktop Connector software. Point your Web browser to the dskcon_release_notes.htm file on either the TPware Product Suite CD or the Software Products Library CD.

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 or TP Desktop Connector Gateway for ACMS CD, you should start with Part 2 or 3, respectively.

The following table describes the contents of each part.

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 TP Desktop Connector 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.
Using the TPware Product Suite CD
Chapter 4	Explains how to prepare your system for installing TP Desktop Connector software from the TPware 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 DIGITAL Alpha processor Windows 95 or 98 on an Intel processor
Chapter 6	Describes how to install the TP Desktop Connector Services Interface client software and sample client applications on the following non--Windows 32-bit desktop platforms: Microsoft DOS Microsoft Windows 3.11 DIGITAL OpenVMS DIGITAL UNIX
Chapter 7	Describes how to install the TP Desktop Connector Services Interface client software and sample client applications on Apple Macintosh systems.
Using the TP Desktop Connector Gateway for ACMS 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 TP Desktop Connector 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.

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 information specific to either operating system.

Additional typographic conventions used in this document are listed below:

Convention	Description
TP Desktop Connector	Represents the DIGITAL TP Desktop Connector for ACMS product software.
TP Desktop Connector gateway	Represents the DIGITAL TP Desktop Connector Gateway for ACMS product 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 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 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 or the TP Desktop Connector Gateway for ACMS CD, see Parts 2 and 3, respectively.

This chapter discusses the preparations and requirements necessary for installing DIGITAL TP Desktop Connector for ACMS and DIGITAL 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 for ACMS software is delivered in two distinct product savesets, one for the OpenVMS gateway and one for desktop clients:

• The gateway saveset (ACMSDI031.*)
  Delivers the software required on an OpenVMS system to enable access to DIGITAL ACMS from the desktop systems. Also includes server-side sample applications.
  You install the gateway software with a regular VMSINSTAL command.
• The client saveset (TPW031.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 for ACMS software.

1.2 Software and Hardware Prerequisites

The DIGITAL TP Desktop Connector Version 3.1 Software Product Description (SPD), included on the Software Products Library CD, 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 TP Desktop Connector gateway and client installations from the Software Products Library CD use the VMSINSTAL commannd. See Chapter 8 for instructions.