Order Number: AA--N686N--TE

This document provides information about installing the Compaq ACMS Version 4.3 for OpenVMS software.

Revision/Update Information: This manual supersedes the Digital ACMS for OpenVMS Installation Guide, Version 4.2.

Operating System: Compaq OpenVMS Alpha Version 6.2 or higher, excluding Version 7.0
Compaq OpenVMS VAX Version 6.2 or higher, excluding Version 7.0

Software Version: Compaq ACMS Version 4.3 for OpenVMS

Compaq Computer Corporation Houston, Texas

Compaq Computer Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description.

Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Compaq Computer Corporation or an authorized sublicensor.

© 1999 Compaq Computer Corporation.

Compaq, the Compaq logo, and the DIGITAL logo are registered in the U.S. Patent and Trademark Office.

ACMS, ACMS Desktop, ALL-IN-1, Alpha, AlphaServer, AlphaServer, DATATRIEVE, DEC, DECdesign, DECdtm, DECforms, DEC FORTRAN, DECnet, DECset, HSC, MicroVAX, OpenVMS, OpenVMS Cluster, PATHWORKS, Tru64, ULTRIX, VAX, VAX C, VAX COBOL, VAX DATATRIEVE, VAX DOCUMENT, VAX FMS, VAX FORTRAN, VAX RMS, VAX SMG, VAX 9000, VMS, VT, VT100, VT200, VT300, are trademarks of Compaq Computer Corporation.

The following are third-party trademarks:

IBM is a registered trademark of International Business Machines, Inc.
Oracle is a registered trademark of Oracle Corporation.
Oracle CODASYL DBMS, Oracle CDD/Administrator, Oracle CDD/Repository, Oracle Rdb, Oracle SQL/Services, Oracle Trace, and Oracle Trace Collector are trademarks of Oracle Corporation.

Other product names mentioned herein may be the trademarks of their respective companies.

ZK6613

The OpenVMS documentation set is available on CD-ROM.

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

Contents

Index

This installation guide describes how to install kits for the following Compaq ACMS for OpenVMS (ACMS) product packages:

• ACMS Development System
• ACMS Run-Time Option
• ACMS Remote Access Option

Intended Audience

Read this manual if you are responsible for installing and maintaining software for ACMS. To perform the installation procedures described in this manual, you must have access to a privileged OpenVMS system manager's account and be familiar with the OpenVMS installation procedure, VMSINSTAL.

Document Structure

This manual has the following chapters and appendixes:

Chapter 1	Describes ACMS kits and licenses, the recommended order for updating layered products used with ACMS, and special dependencies and considerations.
Chapter 2	Explains how to prepare your system for installing ACMS.
Chapter 3	Describes how to install the ACMS software and sample applications and run the Installation Verification Procedure (IVP). It also tells you how to recover from system and installation failures.
Chapter 4	Describes postinstallation steps that prepare your OpenVMS system for running ACMS.
Chapter 5	Describes how to run the ACMS IVP separately from the installation procedure.
Chapter 6	Describes how to deinstall ACMS.
Appendix A	Contains a sample installation for each ACMS development kit.
Appendix B	Contains information on registering and loading your ACMS license.
Appendix C	Describes how to modify ACMS help and message text, for example, to translate them to a language other than English.
Appendix D	Describes considerations for creating DECdtm log files.

Related Documents

Consult the OpenVMS System Manager's Manual for information about installing or upgrading layered product software on the OpenVMS operating system.

Three other manuals contain information about managing your ACMS system once it is installed:

• Compaq ACMS for OpenVMS Managing Applications
  Explains how to start and stop the ACMS system, monitor system performance, and perform some tuning operations. This manual also discusses installing applications, and authorizing users, applications, and devices.
• Compaq ACMS Version 4.3 for OpenVMS Release Notes
  Contains information about new features and current restrictions for ACMS. Compaq ACMS Version 4.3 for OpenVMS Release Notes are available to you on line. They are stored in the file SYS$HELP:ACMS043.RELEASE_NOTES during the ACMS installation procedure. The installation procedure allows you to print Compaq ACMS Version 4.3 for OpenVMS Release Notes at the start of the installation.
• Compaq ACMS for OpenVMS Remote Systems Management Guide
  Describes how to use the Remote Manager to manage Compaq ACMS for OpenVMS software systems remotely.

Compaq ACMS for OpenVMS Systems Interface Programming gives directions for building the BLISS library file and an environment file for Pascal agents.

For additional information on the compatibility of other software products with this version of ACMS, refer to the Compaq ACMS for OpenVMS Software Product Description (SPD 25.50.xx).

For additional information about the Open Systems Software Group (OSSG) products and services, access the following OpenVMS World Wide Web address:

http://www.compaq.com/openvms

Reader's Comments

Compaq welcomes your comments on this manual.

Print or edit the online form SYS$HELP:OPENVMSDOC_COMMENTS.TXT and send us your comments by:

Internet	openvmsdoc@compaq.com
Fax	603 884-0120, Attention: OSSG Documentation, ZKO3-4/U08
Mail	Compaq Computer Corporation OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698

How To Order Additional Documentation

Use the following World Wide Web address for information about how to order additional documentation:

http://www.compaq.com/openvms

To reach the OpenVMS documentation website, click the Documentation link.

If you need help deciding which documentation best meets your needs, call 1--800--ATCOMPAQ.

Conventions

The following conventions are used in this manual:

Ctrl/ x	A sequence such as Ctrl/ x indicates that you must press and hold the key labeled Ctrl while you press another key or a pointing device button.
[Return]	In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.) In the HTML version of this document, this convention appears as brackets rather than a box.
. . .	A vertical ellipsis indicates the omission of items from a code example or command format; the items are omitted because they are not important to the topic being discussed.
Monospace text	Monospace type indicates code examples and interactive screen displays. In the C programming language, monospace type in text identifies the following elements: keywords, the names of independently compiled external functions and files, syntax summaries, and references to variables or identifiers introduced in an example. In the HMTL version of this document, this text style may appear as italics.
-	A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line.
numbers	All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated.
italic text	Italic text indicates important information, complete titles of manuals, or variables. Variables include information that varies in system output (Internal error number), in command lines (/PRODUCER= name), and in command parameters in text (where dd represents the predefined code for the device type).
UPPERCASE	Uppercase text indicates the name of a routine, the name of a file, the name of a file protection code, or the abbreviation for a system privilege.
<lowercase>	In command format descriptions, lowercase text in angle brackets indicates a required clause or phrase.

References to Products

The ACMS documentation set to which this manual belongs often refers to certain products by abbreviated names:

Abbreviation	Product
ACMS	Compaq ACMS for OpenVMS Alpha, and Compaq ACMS for OpenVMS VAX
Ada	DEC Ada for OpenVMS Alpha Systems, and DEC Ada for OpenVMS VAX Systems
BASIC	DEC BASIC for OpenVMS, and VAX BASIC
C	DEC C for OpenVMS Alpha Systems, and DEC C for OpenVMS VAX Systems
CDD	Oracle CDD/Administrator, and Oracle CDD/Repository
COBOL	DEC COBOL for OpenVMS Alpha Systems, and VAX COBOL for OpenVMS VAX Systems
DATATRIEVE	DEC DATATRIEVE for OpenVMS Alpha, and DEC DATATRIEVE for OpenVMS VAX
DBMS	Oracle CODASYL DBMS
DECforms	Compaq DECforms
FORTRAN	DEC Fortran for OpenVMS Alpha Systems, and DEC Fortran for OpenVMS VAX Systems
OpenVMS	The Compaq OpenVMS Alpha operating system, and the Compaq OpenVMS VAX operating system
Pascal	DEC Pascal, and VAX Pascal
PL/I	PL/I for VAX VMS
Rdb	Oracle Rdb
SQL	The SQL interface to Oracle Rdb
TDMS	Compaq TDMS

This chapter describes the available ACMS kits. It also discusses the dependencies among ACMS Version 4.3, the OpenVMS operating system, and other layered products, and considerations for upgrading and using these products in a distributed environment.

The Part List, found in the transparent plastic envelope in your kit, specifies the number and contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged or if you find that parts of it are missing, contact your Compaq representative.

1.1 Types of ACMS Kits

ACMS is available in three different kits:

• ACMS Development Kit
  This kit provides all the features of ACMS. You can define, build, and debug multiple-step tasks, task groups, menus and applications, as well as use the ACMS task queuing facilities. You can use DECforms or TDMS as standard presentation services, or use the Request Interface (RI) and Systems Interface (SI) to access other presentation services. You are provided with samples of ACMS applications using standard presentation services and the Request Interface.
  The development kit also includes the features provided by the run-time and remote-access kits.
• ACMS Run-Time Kit
  This kit allows you to use existing applications or programs under the control of ACMS. It also allows you to define and debug menus, applications, task groups, and single-step tasks that use DCL servers, if Oracle CDD is present when this kit is installed. It allows ACMS users to sign in and select tasks that are implemented on the local node as well as remote nodes. The run-time kit allows you to use the ACMS Queued Task Initiator (QTI) to submit tasks to run on the local node as well as remote nodes.
  The run-time kit also includes the features provided by the remote-access kit.
• ACMS Remote-Access Kit
  This kit is suitable for installation on a network node that does not have any ACMS applications running on it, but requires access to ACMS applications running on another network node. The remote-access kit allows users to sign in to ACMS and select tasks on remote nodes, and handles the terminal I/O associated with those tasks. The remote access kit allows you to use the ACMS QTI to submit tasks to run on remote nodes.

Each ACMS kit has an unlimited-use ACMS license associated with it. ACMS Version 3.3 introduced support for concurrent-use licenses for the run-time and remote-access kits. Table 1-1 shows the licenses that are applicable to each ACMS kit.

Table 1-1 ACMS Licenses

ACMS Kit	Unlimited Use	Concurrent Use
Development System	ACMS	Not available
Run-Time Option	ACMS-RT	ACMS-RT-USER
Remote-Access Option	ACMS-REM	ACMS-REM-USER

For more information about these ACMS licenses, refer to Compaq ACMS for OpenVMS Managing Applications.

To install an ACMS Version 4.3 kit, you must register and load an ACMS software license, using the OpenVMS License Management Facility (LMF). You must register and load your ACMS license before you perform the installation.

For more information on registering and loading your ACMS license, refer to Appendix B.

1.3 Required Operating System Components

Compaq ACMS Version 4.3 for OpenVMS Alpha requires OpenVMS Alpha Version 6.2 or higher, excluding Version 7.0.

Compaq ACMS Version 4.3 for OpenVMS VAX requires OpenVMS VAX Version 6.2 or higher, excluding Version 7.0.

For distributed processing with ACMS, you must have DECnet software installed.

The ACMS Version 4.3 installation procedure and IVP interact with a number of OpenVMS layered products. Some of these products are required, while others are optional.

Each of these layered products has a minimum version (based on the OpenVMS version) that is supported with ACMS Version 4.3. The ACMS Version 4.3 Software Product Description (SPD) identifies the minimum layered product versions required to successfully install ACMS Version 4.3 and run the IVP.

If a product is required, you must make the minimum version available before you can install ACMS. If a product is not required, you do not need to make it available before installing ACMS, however, you must upgrade it to the minimum required version before using it with ACMS.

1.4.1 Determining Software Version Numbers

Before installing ACMS Version 4.3, identify the other products that you need to upgrade. The ACMS SPD contains a complete list of the products that are compatible with this version of ACMS, including information about the minimum version of OpenVMS and layered products that interact with ACMS Version 4.3. To check the current version of the products, execute the DCL commands ANALYZE/IMAGE and SEARCH in the following formats:

ANALYZE/IMAGE file-name /OUTPUT=ACMS_VERSION.TMP

SEARCH ACMS_VERSION.TMP "image file id"

In the ANALYZE/IMAGE command, substitute for file-name the file name listed in Table 1-2 or Table 1-3 for each product.

Table 1-2 Compatible Products Image Files for OpenVMS Alpha

Product	File Name
LSE (DECset)	SYS$SYSTEM:LSEDIT.EXE
Oracle CDD	SYS$LIBRARY:CDDSHR.EXE
Oracle CODASYL DBMS	SYS$LIBRARY:DBMSHR.EXE
Oracle Rdb	SYS$LIBRARY:RDBSHR.EXE
Oracle Trace	SYS$LIBRARY:EPC$FUNCSHRP.EXE
TP Desktop Connector	SYS$SYSTEM:ACMSDI$SERVER.EXE

Table 1-3 Compatible Products Image Files for OpenVMS VAX

Product	File Name
DECforms	SYS$LIBRARY:FORMS$MANAGER.EXE
LSE (DECset)	SYS$SYSTEM:LSEDIT.EXE
Oracle CDD	SYS$LIBRARY:CDDSHR.EXE
Oracle CODASYL DBMS	SYS$LIBRARY:DBMSHR.EXE
Oracle Rdb	SYS$LIBRARY:RDBSHR.EXE
Oracle Trace	SYS$LIBRARY:EPC$FUNCSHRP.EXE
TDMS	SYS$LIBRARY:TSSSHR.EXE
TP Desktop Connector	SYS$SYSTEM:ACMSDI$SERVER.EXE

The line that OpenVMS displays in response to the SEARCH command shows the current version of the product. The following example shows that the system has LSE Version 3.0 installed:

$ ANALYZE/IMAGE SYS$SYSTEM:LSEDIT.EXE /OUTPUT=ACMS_VERSION.TMP $ SEARCH ACMS_VERSION.TMP "image file id" image file identification: "LSEDIT V3.0-23"