Order Number: AA--N686P--TE
This document provides information about installing the Compaq ACMS for OpenVMS, Version 4.4 software.
Revision/Update Information: This manual supersedes the Compaq ACMS for OpenVMS Version 4.3 Installation Guide.
Compaq OpenVMS Alpha, Version 6.2, 7.2--1, or 7.3
Compaq OpenVMS VAX, Version 6.2, 7.2, or 7.3
Software Version: Compaq ACMS for OpenVMS, Version 4.4
Compaq Computer Corporation Houston, Texas
© 2001 Compaq Computer Corporation
Compaq and the Compaq logo Registered in U.S. Patent and Trademark Office.
ACMS, DECforms, DECnet, DECset, OpenVMS, PATHWORKS, and Tru64 are trademarks of the Compaq Information Technologies Group, L.P. in the United States and other countries.
Motif is a registered trademark of The Open Group in the United States and other countries.
All other product names mentioned herein may be the trademarks of their respective companies.
Confidential computer software. Valid license from Compaq required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.
Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statments accompanying such products. Nothing herein should be construed as constituting an additional warranty.
The OpenVMS documentation set is available on CD-ROM.
This document was prepared using DECdocument, Version V3.3-1e.
This installation guide describes how to install kits for the following Compaq ACMS for OpenVMS (ACMS) product packages:
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.
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.|
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 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:
Compaq welcomes your comments on this manual.
Print or edit the online form SYS$HELP:OPENVMSDOC_COMMENTS.TXT and send us your comments by:
|Fax||603 884-0120, Attention: OSSG Documentation, ZKO3-4/U08|
Compaq Computer Corporation
OSSG Documentation Group, ZKO3-4/U08
110 Spit Brook Rd.
Nashua, NH 03062-2698
Use the following World Wide Web address for information about how to order additional documentation:
To reach the OpenVMS documentation website, click the Documentation link.
If you need help deciding which documentation best meets your needs, call 1--800--ATCOMPA.
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.|
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 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 HTML 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.|
The ACMS documentation set to which this manual belongs often refers to certain products by abbreviated names:
|ACMS||Compaq ACMS for OpenVMS Alpha, and Compaq ACMS for OpenVMS VAX|
|Ada||Compaq Ada for OpenVMS Alpha Systems, and Compaq Ada for OpenVMS VAX Systems|
|BASIC||Compaq BASIC for OpenVMS, and Compaq BASIC for OpenVMS|
|C||Compaq C for OpenVMS Alpha Systems, and Compaq C for OpenVMS VAX Systems|
|CDD||Oracle CDD/Administrator, and Oracle CDD/Repository|
|COBOL||Compaq COBOL for OpenVMS Alpha Systems, and Compaq COBOL for OpenVMS VAX Systems|
|DATATRIEVE||Compaq DATATRIEVE for OpenVMS Alpha, and Compaq DATATRIEVE for OpenVMS VAX|
|DBMS||Oracle CODASYL DBMS|
|DECforms||Compaq DECforms for OpenVMS|
|FORTRAN||Compaq Fortran for OpenVMS Alpha Systems, and Compaq Fortran for OpenVMS VAX Systems|
|OpenVMS||The Compaq OpenVMS Alpha operating system, and the Compaq OpenVMS VAX operating system|
|Pascal||Compaq Pascal for OpenVMS Alpha, and Compaq Pascal for OpenVMS VAX|
|PL/I||PL/I for OpenVMS Systems|
|SQL||The SQL interface to Oracle Rdb|
|TDMS||Compaq TDMS for OpenVMS VAX|
The DECtrace product is the predecessor to the Oracle Trace product. Some information in the ACMS documentation, particularly in some examples, refers to DECtrace. Except where version specific, the information applies to the Oracle Trace product as well and, as you read the information, you can use the product name Oracle Trace instead of the product name DECtrace with no significant difference in meaning.
This chapter describes the available ACMS kits. It also discusses the dependencies among ACMS Version 4.4, 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
1.1 Types of ACMS Kits
ACMS is available in three different kits:
Each ACMS kit has an unlimited-use ACMS license associated with it. Table 1-1 shows the licenses that are applicable to each ACMS kit.
|ACMS Kit||Unlimited Use||Concurrent Use|
|Development System||ACMS||Not available|
For more information about these ACMS licenses, refer to Compaq ACMS for OpenVMS Managing Applications.
To install an ACMS Version 4.4 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 for OpenVMS Alpha Version 4.4 requires OpenVMS Alpha Version 6.2, 7.2--1, or 7.3.
Compaq ACMS for OpenVMS VAX Version 4.4 requires OpenVMS VAX Version 6.2, 7.2, or 7.3.
For distributed processing with ACMS, you must have DECnet software installed.
If you install ACMS Version 4.4 on an Alpha system running a version of OpenVMS Alpha lower than OpenVMS Alpha Version 7.x, you must reinstall ACMS Version 4.4 after you upgrade to OpenVMS Alpha Version 7.x.
The ACMS Version 4.4 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.4. The ACMS Version 4.4 Software Product Description (SPD) identifies the minimum layered product versions required to successfully install ACMS Version 4.4 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.4, 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.4.
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.
|Oracle CODASYL DBMS||SYS$LIBRARY:DBMSHR.EXE|
|TP Desktop Connector||SYS$SYSTEM:ACMSDI$SERVER.EXE|
|Oracle CODASYL DBMS||SYS$LIBRARY:DBMSHR.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 4.2 installed:
$ ANALYZE/IMAGE SYS$SYSTEM:LSEDIT.EXE /OUTPUT=ACMS_VERSION.TMP $ SEARCH ACMS_VERSION.TMP "image file id" image file identification: "LSEDIT V4.2-17"
Oracle CDD/Repository Version 7.0 is supported by ACMS Version 4.4.
The following paragraphs discuss the requirements for Oracle CDD when installing the different ACMS kit types.
If you are installing the ACMS development kit, at least the minimum version of CDD as identified in the ACMS SPD must be installed on your system. If CDD is not installed or if a lower version of CDD is installed, VMSINSTAL terminates the installation procedure.
If you are installing the ACMS run-time kit, CDD is optional; however, the minimum version of CDD is required for the run-time kit to be fully functional. Specifically, if you install the ACMS run-time kit with CDD available, you can create new applications and menus and modify existing applications and menus, on your ACMS run-time system. If you install the ACMS run-time kit without CDD available, you can use only existing applications and menus; you cannot create new ones on your run-time system. If you subsequently install CDD, you can make the ACMS run-time CDD-related features available by reinstalling the ACMS Version 4.4 run-time kit and choosing the CDD-related files option at the beginning of the installation.
If you are installing the ACMS remote-access kit, CDD is not required.