 

















                     Compaq_C++____________________________________
                     Installation Guide for OpenVMS Alpha

                     Order Number: AA-PY27J-TE


                     February 2002

                     This guide contains instructions for installing
                     Compaq C++ on OpenVMS Alpha systems. It also
                     explains how to read the online release notes
                     before or after installing the product.






                     Revision/Update Information: This is a revised
                                                  manual, replacing
                                                  AA-PY27H-TE

                     Operating System & Version:  OpenVMS Alpha Version
                                                  6.2 or later.
                                                  Future maintenance
                                                  releases might
                                                  require higher
                                                  versions.

                     Software Version:            Compaq C++ Version
                                                  6.5 for OpenVMS Alpha

                     Compaq Information Technolgies Group, L.P.
                     Houston, Texas

 






           __________________________________________________________
           First Printing, June 1993
           Eighth Printing, February 2002

            2002 Compaq Information Technologies Group, L.P.

           COMPAQ, the Compaq logo, and Alpha, Ladebug, OpenVMS,
           and VMS are trademarks of Compaq Information Technologies
           Group, L.P. in the United States and/or other countries.
           UNIX is a trademark of The Open Group in the United States
           and/or other countries. All other product names mentioned
           herein may be 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
           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 statements accompanying such products. Nothing
           herein should be construed as constituting an additional
           warranty.

           This document is available on CD-ROM.

                                                               ZK6036

           This document was prepared using DECdocument, Version
           3.3-1n.

 













   ________________________________________________________________

                                                           Contents


   Preface..................................................      v


   1  Preparing for Compaq C++ Installation

         1.1   Installation Procedure Requirements..........    1-2
         1.1.1     Process Privileges.......................    1-2
         1.1.2     Process Account Quotas...................    1-2
         1.1.3     System Parameters........................    1-3
         1.1.4     Disk Space...............................    1-4
         1.1.5     Backing Up Your System Disk..............    1-5
         1.1.6     Additional System Maintenance
                   Procedures...............................    1-5
         1.1.6.1     Checking System Parameter Values.......    1-5
         1.1.6.2     Calculating the Values for Global
                     Pagelets and Global Sections...........    1-6
         1.1.6.3     Changing System Parameter Values with
                     AUTOGEN................................    1-6
         1.1.6.4     Setting Dynamic System Parameter
                     Values.................................    1-8

   2  Installing the Compaq C++ Compiler

         2.1   Installing and Using Multiple Compiler
               Versions.....................................    2-1
         2.1.1     Displaying and Selecting the Compiler
                   Version..................................    2-2
         2.1.2     Installation Procedure Changes...........    2-4
         2.2   Installation Procedure.......................    2-5
         2.3   Error Recovery...............................   2-14




                                                                iii

 






     3  After C++ Installation

           3.1   Running the Installation Verification
                 Procedure Separately.........................    3-2
           3.2   Editing and Organizing the System Files......    3-2
           3.3   VMScluster Considerations....................    3-2
           3.4   User Account Requirements....................    3-2
           3.4.1     User Privileges..........................    3-3
           3.4.2     User Account Quotas......................    3-3
           3.4.3     Installing the Compaq C++ Compiler
                     and the C++ Class Library as a Shared
                     Image....................................    3-3
           3.5   Getting Help and Reporting Problems..........    3-5

     4  Installing the Compaq C++ Debugger

           4.1   Installing the Debugger......................    4-2
           4.2   After Debugger Installation..................    4-2

     A  Sample C++ Compiler Installation


     B  Sample C++ Debugger Installation

     C  Files Installed on Your System


     D  Recovering from Errors

           D.1   Failures During Compaq C++ Installation......    D-1
           D.2   Problems During Compaq C++ Use...............    D-2

     Examples

           A-1       Sample Compaq C++ Installation on OpenVMS
                     Alpha Version 7.3........................    A-2

           B-1       Sample C++ Debugger Installation on
                     OpenVMS Alpha............................    B-2






     iv

 






        Tables

              1         Conventions..............................    vii

              1-1       Process Quotas for the Installing
                        Account..................................    1-2

              1-2       Minimum Required System Parameter
                        Values...................................    1-3

              1-3       Disk Space Requirements..................    1-4

              C-1       Files Installed or Modified..............    C-1
































                                                                       v

 











        ________________________________________________________________

                                                                 Preface



              This guide describes how to install Compaq C++ on the
              OpenVMS Alpha operating system. It is intended for system
              managers. Keep this guide with your distribution kit, in
              case you need it to reinstall Compaq C++ for any reason.

              You may send comments or suggestions concerning this
              guide, or any Compaq C++ document, by electronic mail
              to the following Internet address:

                 compaq_cxx@compaq.com

        Document Structure

              This guide contains three chapters and three appendixes:

              o  Chapter 1 describes how to prepare for Compaq C++
                 installation.

              o  Chapter 2 describes how to install the Compaq C++
                 compiler.

              o  Chapter 3 describes postinstallation procedures.

              o  Chapter 4 describes how to install the Compaq C++
                 debugger.

              o  Appendix A shows a sample compiler installation.

              o  Appendix B shows a sample debugger installation.

              o  Appendix C explains how to find a list of the files
                 installed on your system.

              o  Appendix D provides information to help you with
                 failures.

                                                                       v

 






     Associated Documentation

           In addition to this guide, the Compaq C++ Version 6.5
           documentation set includes the following books:

           o  Stroustrup, Bjarne. The C++ Programming Language, 3rd
              Edition. Reading, Massachusetts: Addison-Wesley, 1997.
              This book is available only as hardcopy documentation.

           o  Using Compaq C++ for OpenVMS Alpha

           o  C++ Class Library Reference Manual (online only)

           o  C Run-Time Library Reference Manual for OpenVMS Systems

           For information on the Compaq C++ online release notes,
           see Chapter 1.

           For general information on OpenVMS system management, see
           the OpenVMS operating system documentation set.

           For help understanding OpenVMS system error messages,
           see the OpenVMS System Messages and Recovery Procedures
           Reference Manual or the online HELP/MESSAGE facility.





















     vi

 






        Conventions

              Table 1 lists the conventions used in this guide.

              Table_1_Conventions_______________________________________

              Convention________________Meaning_________________________

              UPPERCASE TEXT            Uppercase text indicates the
                                        name of a command, a file,
                                        a parameter, a procedure, or
                                        utility.

              $ @SYS$UPDATE:VMSINSTAL   In interactive examples, prompts
                                        or displayed text appears in
                                        a monospace font. User input
                                        appears in bold monospace font.

              Ctrl/X                    In interactive examples,
                                        a sequence such as Ctrl/X
                                        indicates that you must hold
                                        down the key labeled Ctrl while
                                        you press another key or a
                                        pointing device button; for
                                        example, Ctrl/C or Ctrl/Z.

              [YES]                     Square brackets indicate that
                                        the enclosed item is a default
                                        value in a VMSINSTAL prompt.
                                        Also, square brackets serve as
                                        delimiters for a directory name
              __________________________in_a_file_specification.________













                                                                     vii

 









                                                                       1
        ________________________________________________________________

                                   Preparing for Compaq C++ Installation



              Your bill of materials (BOM) and indented bills report
              (BIL) specify 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.

              Compaq C++ provides online release notes, which are
              copied to SYS$HELP during installation. Compaq strongly
              recommends that you read the release notes before
              proceeding with the installation. For information on
              accessing the online release notes for the Compaq C++
              compiler, see step 2 in Section 2.2.

              Before you start the installation, you must register and
              load the License Product Authorization Key (License PAK)
              using the OpenVMS License Management Facility (LMF). (For
              complete information on using the LMF, see the OpenVMS
              License Management Utility Manual.)

              You can use the following optional software with Compaq
              C++:

              o  Compaq Language-Sensitive Editor/Source Code Analyzer
                 (LSE/SCA) for OpenVMS Alpha Systems. Support for C++
                 requires that LSE be installed before the compiler is
                 installed.

              o  Compaq Test Manager (DTM) for OpenVMS Alpha Systems

              o  Compaq Performance and Coverage Analyzer (PCA) for
                 OpenVMS Alpha Systems

              o  Compaq Code Management System (CMS) for OpenVMS Alpha
                 Systems

                               Preparing for Compaq C++ Installation 1-1

 






           o  Compaq Module Management System (MMS) for OpenVMS Alpha
              Systems

           For more information on Compaq DECset Release 12.4A for
           OpenVMS Alpha Systems, refer to the Software Product
           Description (SPD 42.29.nn).

     1.1 Installation Procedure Requirements

           This section discusses settings that you should check to
           be sure that your system is ready for the installation of
           Compaq C++ to proceed.

     1.1.1 Process Privileges

           To install Compaq C++, you must be logged in to an account
           that has SETPRV or at least the following privileges:

           o  CMKRNL

           o  WORLD

           o  SYSPRV

           VMSINSTAL turns off BYPASS privileges at the start of the
           installation.

     1.1.2 Process Account Quotas

           VMSINSTAL requires that the installation account have
           minimum quotas as shown in Table 1-1.

           Table_1-1_Process_Quotas_for_the_Installing_Account_______

           Name________Quota_________________________________________

           ASTLM       190

           BIOLM       160

           BYTLM       99,000

           DIOLM       160

           ENQLM       4000

           FILLM_______300___________________________________________

           Use the OpenVMS Authorize Utility to verify and change
           process quotas for the installation account in the user
           authorization file (UAF). (Some sites may restrict the

     1-2 Preparing for Compaq C++ Installation

 






              use of the OpenVMS Authorize Utility to certain accounts
              or people.) For instance, to change the BYTLM quota for
              the account-name installation account, you might enter the
              following command sequence:

              $ RUN SYS$SYSTEM:AUTHORIZE
              UAF> MODIFY account-name /BYTLM = 99000
              UAF> SHOW account-name
              UAF> EXIT
              $ LOGOUT

              After the quotas for the installation account have been
              changed, log out of the installation account and log in
              again for the new quotas to take effect. You can then
              proceed with the installation.

              User account quotas are stored in the file SYSUAF.DAT.
              For more information on modifying account quotas, see the
              description of the Authorize Utility in the OpenVMS System
              Management documentation set.

        1.1.3 System Parameters

              Table 1-2 lists the minimum required system parameter
              values for the installation. Depending on the kinds of
              programs and applications running at your site, you might
              need higher values for some settings.

              Table_1-2_Minimum_Required_System_Parameter_Values________

                                       Minimum
              System_Parameter_________Value________Default_Value_______

              CLISYMTBL[1]             500          500

              [1]The_CLISYMTBL_dynamic_system_parameter_must_be_set_to__

              a minimum value of 500 during the installation procedure.
              You can change the setting to its original value once the
              installation is finished.

                                                (continued on next page)



                               Preparing for Compaq C++ Installation 1-3

 






           Table 1-2 (Cont.) Minimum Required System Parameter
           __________________Values__________________________________

                                    Minimum
           System_Parameter_________Value________Default_Value_______

           GBLPAGES[2]              8400         8400

           GBLPAGFIL                1024         1024

           GBLSECTIONS[2]           2            2
           [2]These_values_represent_the_number_of_free_global_______

           pagelets and global sections required for the
           installation, not the total number you need to run your
           system and other software.
           __________________________________________________________

     1.1.4 Disk Space

           Requirements for free disk storage space are different
           during installation and after installation. Table 1-3
           summarizes the storage requirements.

           Table_1-3_Disk_Space_Requirements_________________________

                             Blocks After       Peak During
           Component_________Installation_______Installation_________

           Compiler          150,000            160,000

           Text Header       13,000             13,000
           Files

           CXXLINK           500                500

           Debugger          15,500             79,500

           __________________________________________________________

           All_Components____179,000____________253,000______________

           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

     1-4 Preparing for Compaq C++ Installation

 






        1.1.5 Backing Up Your System Disk

              At the beginning of the installation, VMSINSTAL asks if
              you have backed up your system disk. Compaq recommends
              that you back up your system disk before installing any
              software.

              Use the backup procedures that are established at your
              site. For details on performing a system disk backup, see
              the section on the Backup Utility in the OpenVMS System
              Management documentation set.

        1.1.6 Additional System Maintenance Procedures

              This section explains how to use the System Generation
              Utility (SYSGEN) and the AUTOGEN Utility to prepare your
              system for an installation of Compaq C++. AUTOGEN uses
              system configuration data to automatically set system
              parameters.

        1.1.6.1 Checking System Parameter Values

              To check the values of your system parameters, enter the
              following command:

              $ RUN SYS$SYSTEM:SYSGEN
              SYSGEN>

              At the SYSGEN> prompt, enter the SHOW command to display
              the value of a system parameter. The following example
              displays the value for the WSMAX system parameter:

              SYSGEN> SHOW WSMAX

              Parameter Name   Current   Default    Min.  Max.      Unit
              --------------   -------   -------    ----  -------   ----
              WSMAX              81920      4096    1024  1048576   Pagelets
               internal value     5120       256      64    65536   Pages

              After checking the parameters with the SHOW command, enter
              the EXIT command at the SYSGEN> prompt to return to DCL
              level. For information on setting dynamic system parameter
              values, see Section 1.1.6.4.


                               Preparing for Compaq C++ Installation 1-5

 






     1.1.6.2 Calculating the Values for Global Pagelets and Global
             Sections

           To install and run Compaq C++, you must have sufficient
           free global pagelets and global sections. You must first
           find out how many free global pagelets and sections you
           have on your system. Then use AUTOGEN if you need to
           increase the global pagelets and global sections system
           parameters.

           Enter the following DCL command to determine the number of
           global pagelets required by SYS$LIBRARY:DCLTABLES.EXE:

           $ DIRECTORY/SIZE SYS$LIBRARY:DCLTABLES.EXE

           This command returns the size (in blocks) of SYS$LIBRARY:DCLTABLES.EXE.
           As an approximation, use this figure as the number of
           global pagelets for the file.

           You can use the WRITE command with the F$GETSYI lexical
           function to find the number of free global pagelets and
           global sections. The following example shows how to
           get this information at your terminal (the default for
           SYS$OUTPUT):

           $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES")
           15848
           $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")
           24

           If the values displayed by the system are greater than
           the values in Table 1-2, you do not need to increase the
           values for these parameters. If the value of free global
           pagelets or global sections is less than the value in
           Table 1-2, you must increase the system parameter setting.

           Section 1.1.6.3 describes the procedures for increasing
           these values using AUTOGEN.

     1.1.6.3 Changing System Parameter Values with AUTOGEN

           Use the AUTOGEN command procedure to change system
           parameters. AUTOGEN automatically adjusts values for
           parameters that are associated with the values you reset
           manually. To change system parameters with AUTOGEN, edit
           the following file:

           SYS$SYSTEM:MODPARAMS.DAT

     1-6 Preparing for Compaq C++ Installation

 






              Use an editor to access the file. To change a parameter
              value listed in this file, delete the current value
              associated with that parameter and enter the new value.

              To add a new parameter, add a line to the file that
              includes both the name of the parameter and its value.
              For example:

              WSMAX = 8096

              To modify incremental parameters such as free global
              pagelets and global sections, use ADD_GBLPAGES or ADD_
              GBLSECTS. The following example increases the global page
              setting by 2000:

              ADD_GBLPAGES = 2000

              When you set the page file quota, do not use a value that
              exceeds the amount of page file space available on the
              system.

              After you make all your changes, exit from the editor and
              execute the AUTOGEN procedure to recalculate your system
              parameters. The following command recalculates your system
              parameters and reboots the system:

              $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT

              When you specify REBOOT, AUTOGEN performs an automatic
              system shutdown and then reboots the system. Any users
              logged on to the system are immediately disconnected
              during the shutdown. The automatic reboot puts the new
              parameter values into effect.

              AUTOGEN automatically adjusts some of the SYSGEN
              parameters based on the consumption of resources since the
              last reboot. If you do not want to take advantage of this
              automatic adjustment, include the /NOFEEDBACK qualifier on
              the AUTOGEN command line.

              For more information about using AUTOGEN, see the system
              management documentation for your operating system.



                               Preparing for Compaq C++ Installation 1-7

 






     1.1.6.4 Setting Dynamic System Parameter Values

           Use SYSGEN to set dynamic parameters. Dynamic parameters
           changed with the SYSGEN command WRITE ACTIVE become
           active immediately without any need to reboot your system.
           Rebooting returns dynamic system parameter values to their
           previous settings.

           After you change the dynamic parameter values, you should
           complete the installation before rebooting the system.
           After you finish the installation, you can reset the
           dynamic parameters to their previous values or let them be
           reset automatically when you reboot your system the next
           time.

           If the dynamic parameter values on your system are less
           than the values previously listed, use the following
           series of commands to change the values. This example
           changes the GBLPAGES value to 100000:

           $ RUN SYS$SYSTEM:SYSGEN
           SYSGEN> USE ACTIVE
           SYSGEN> SET GBLPAGES 100000
           SYSGEN> WRITE ACTIVE
           SYSGEN> EXIT




















     1-8 Preparing for Compaq C++ Installation

 









                                                                       2
        ________________________________________________________________

                                      Installing the Compaq C++ Compiler



              After you register and load the License Product Authorization
              Key (License PAK), the installation takes approximately 10
              to 15 minutes, depending on your system configuration and
              the kit components chosen.

        2.1 Installing and Using Multiple Compiler Versions

              C++ Version 6.5 provides support for installing and using
              multiple versions of the compiler on the same node.

              During installation of Version 6.5, if a Version 6.n
              of the compiler is already installed, you have the
              opportunity to preserve that compiler rather than
              overwrite it. If you choose to preserve the currently
              installed compiler, you are then given a choice to keep
              the currently installed compiler as the system default and
              install the new compiler as an alternate.

              By default, the currently installed system compiler
              is preserved by making it an alternate compiler and
              installing the new compiler as the system default. Users
              can make the choice to use an alternate compiler instead
              of the installed system compiler by running a command
              procedure that changes the behavior of the cxx command for
              the process that invokes it.

              Some details of the following description may change, but
              the mechanism is essentially as follows.







                                  Installing the Compaq C++ Compiler 2-1

 






     2.1.1 Displaying and Selecting the Compiler Version

           This kit provides two command procedures to display and
           control which C++ compiler is used by a process:

           o  SYS$SYSTEM:CXX$SHOW_VERSIONS.COM

              This procedure displays the C++ compilers available on
              the system, along with their version numbers. It also
              displays which compiler is the default for the current
              process. The procedure takes an optional version-number
              argument. Examples:

              $ @sys$system:cxx$show_versions.com

              The following C++ compiler(s) are available in
              SYS$SYSTEM:

              Filename                      Version
              ---------------------------------------
              CXX$COMPILER.EXE             V6.5-020
              CXX$COMPILER_V06_04-002.EXE  V6.5-002
              CXX$COMPILER_V06_04-001.EXE  V6.5-001
              CXX$COMPILER_V06_00-001.EXE  V6.0-001    Process Default
              CXX$COMPILER_V06_02-008.EXE  V6.2-008

              $ @sys$system:cxx$show_versions.com V6.0

              The following C++ compiler(s) are available in
              SYS$SYSTEM:

              Filename                      Version
              ---------------------------------------
              CXX$COMPILER_V06_00-001.EXE  V6.0-001    Process Default

           o  SYS$SYSTEM:CXX$SET_VERSION.COM

              This procedure sets up process logicals that point
              to an alternate C++ compiler in SYS$SYSTEM, or it
              removes the process logicals to revert to using the
              default system compiler. The procedure takes one
              argument, a version number or the keyword SYSTEM.
              If no arguments are specified you are prompted for
              them. The SYSTEM argument selects the installed
              system compiler, which is the one displayed with the
              filename CXX$COMPILER.EXE in the output of CXX$show_
              versions.com. Alternate compilers are shown in that
              output with their version number appended to the simple

     2-2 Installing the Compaq C++ Compiler

 






                 filename; for example, the version 6.2-008 compiler is
                 shown as CXX$COMPILER_V06_02-008.EXE.

                 To select a compiler, pass a full ident string or
                 enough of the ident string to be unique. For example:
                 to select the V6.2-008 compiler from the previous
                 list, pass V6.2-008 or V6.2 to the CXX$set_version.com
                 routine. However, to select a 6.5 compiler, a full
                 ident string is required to distinguish between the
                 V6.5-020, V6.5-001, and the V6.5-002 compiler:

        $ @sys$system:cxx$set_version.com V6.2-008

        $ show logical CXX$*

        (LNM$PROCESS_TABLE)

          "CXX$COMPILER" =
            "SYS$SYSTEM:CXX$COMPILER_V06_02-008.EXE"
          "CXX$MSG_SHR" =
            "SYS$MESSAGE:CXX$MSG_SHR_V06_02-008.EXE"

        $ @CXX$set_version.com 6.5

        The following 6.5 C++ compiler(s) are available in
        SYS$SYSTEM:

        Filename                      Version
        ---------------------------------------
        CXX$COMPILER.EXE             V6.5-020
        CXX$COMPILER_V06_04-001.EXE  V6.5-001
        CXX$COMPILER_V06_04-002.EXE  V6.5-002

        Ambiguous version number, please be specify a full version number, ex: V6.5-020
        Version number : V6.5-020

        $ show logical CXX$COMPILER
          "CXX$COMPILER" = "SYS$SYSTEM:CXX$COMPILER_V06_04-005.EXE" (LNM$PROCESS_TABLE)
        $ show logical CXX$msg_shr
          "CXX$MSG_SHR" = "SYS$MESSAGE:CXX$MSG_SHR_V06_04-005.EXE" (LNM$PROCESS_TABLE)

                 When this procedure is run in a process, subsequent cxx
                 commands invoke the selected compiler version (until
                 the procedure is run again). The process-level logicals
                 used do not affect other processes or users on the
                 system.

              o  SYS$SYSTEM:CXX$DELETE_VERSION.COM

                                  Installing the Compaq C++ Compiler 2-3

 






              This procedure removes the C++ compilers from the
              system. The procedure takes an optional version-number
              argument, as shown in the following example:

              $ @sys$system:cxx$delete_version V6.5-001

              The following V6.5-001 Compaq C++ compiler(s) are available in SYS$SYSTEM

              Filename                      Version
              ---------------------------------------
              CXX$COMPILER_V06_05-001.EXE   V6.5-001

              Really delete these compiler(s)? yes
              Deleting Compaq C++ V6.5-001

              Deleting SYS$COMMON:[CXX$LIB]CXX$CLD_V06_06-001.CLD;
              Deleting SYS$COMMON:[SYSEXE]CXX$COMPILER_V06_06-001.EXE;1
              Deleting SYS$COMMON:[SYSMSG]CXX$COMPILER_MSG_V06_06-001.EXE;1
              Deleting SYS$COMMON:[SYSEXE]CXX$LINK_V06_06-001.EXE;1
              Deleting SYS$COMMON:[SYSMSG]CXX$LINK_MSG_V06_06-001.EXE;1
              Deleting SYS$COMMON:[SYSEXE]CXX$DEMANGLE_V06_06-001.EXE;1
              Deleting SYS$COMMON:[SYSLIB]CXXL$ANSI_DEF_V06_06-001.TLB;1
              Deleting SYS$COMMON:[SYSLIB]LIBCXXSTD_V06_06-001.OLB;1
              Deleting SYS$COMMON:[CXX$LIB]CXXDEMANGLE_V06_06-001.CLD;
              Deleting SYS$COMMON:[CXX$LIB]CXXLINK_V06_06-001.CLD;

     2.1.2 Installation Procedure Changes

           When you install C++ Version 6.5 on a system that already
           has a Version 6.0 or higher compiler installed, you are
           given the chance to preserve the currently installed
           system compiler. To do this, answer YES to the following
           question (the xxx will be replaced by the full version
           number of the existing system compiler):

           "Should the existing xxx system compiler be preserved [NO]:"

           If you answer NO, the installation proceeds in the
           traditional manner, overwriting the currently installed
           system compiler.

           If you answer YES, you are then asked an additional
           question. To get the traditional behavior of installing
           the kit compiler as the system default, answer NO to the
           question:

           "Should this xxx system compiler remain the default when cxx is typed [NO]:"

     2-4 Installing the Compaq C++ Compiler

 






              Because you have previously asked to preserve the existing
              system compiler, that compiler is made an alternate
              compiler before the new system compiler is installed
              from the kit. If you answer YES to the question, the kit
              compiler is installed as an alternate compiler with a
              name that is based on its ident, and the existing system
              default compiler remains the default.

        2.2 Installation Procedure

              If it is not already inserted, place the compact disc
              (CD-ROM) media into the CD-ROM drive.

              To abort the installation procedure at any time, press
              Ctrl/Y. When you press Ctrl/Y, the installation procedure
              deletes all files it has created up to that point and
              exits. You can then start the installation again.

                ________________________Note  ________________________

                The kit installation procedure invokes a utility
                program to manipulate header file text libraries.
                Attempts to abort the installation might be ignored
                while the program is executing. If the procedure
                does not abort immediately, press Ctrl/Y until it
                does.

                _____________________________________________________

              When the system prompts you with a question during the
              installation procedure, the default answer is often listed
              in brackets ([]).

              1. Log in to a privileged account and set your default
                 device and directory to SYS$UPDATE.

                  Username: SYSTEM
                  Password:

              2. Invoke VMSINSTAL.

                 @SYS$UPDATE:VMSINSTAL saveset-name device-name option-list



                                  Installing the Compaq C++ Compiler 2-5

 






              To start the installation, invoke the VMSINSTAL command
              procedure from a privileged account, such as the SYSTEM
              account. VMSINSTAL is in the SYS$UPDATE directory. The
              elements that you specify when you invoke the VMSINSTAL
              command procedure are as follows:

              saveset-name
              The installation name for the component. For Compaq
              C++, use the following installation name:

              CXX06n

              n represents the minor (point) release number for
              Compaq C++.

              To obtain the directory location of the Compaq C++
              save set on the CD-ROM, refer to the Software Product
              Library CD-ROM User's Guide booklet that accompanies
              the CD-ROM distribution kit, or before starting
              installation, complete these steps:

              a. To determine whether the CD-ROM drive is already
                 mounted (with the MOUNT command), enter the
                 following command:

                 $ SHOW DEVICE DKA400:

              b. If it is not mounted, enter the appropriate MOUNT
                 command to mount the CD-ROM (omit the /FOREIGN
                 qualifier).

              c. To obtain the save-set name, enter a DIRECTORY
                 command specifying the directory file from the
                 previous command:

                 $ DIRECTORY DKA400:[CXX06n.KIT]CXX06n.A

                 n represents the minor release of Compaq C++.

              device-name
              The name of the device on which you plan to mount the
              media and the directory containing the Compaq C++ save
              set. For example, DKA400: is the device name used in
              examples in this guide. The directory is [CXX06n],
              where n is the minor release number.

     2-6 Installing the Compaq C++ Compiler

 






                 To specify the device name on the @VMSINSTAL command
                 line, enter:

                 DKA400:[CXX06n]

                 option-list
                 The word OPTIONS followed by one or more of the
                 following option designators-A, G, L, N, R:

                 o  Auto_answer option (A)

                    Initially creates a file that contains your answers
                    to VMSINSTAL questions and prompts. You can then use
                    the option (and the answer file) to save time during
                    a reinstallation (typically after upgrading your
                    system).

                 o  Get save-set option (G)

                    Lets you store product save sets temporarily on a
                    magnetic tape or in a disk directory.

                 o  File log option (L)

                    Logs all activity to the terminal during installa-
                    tion.

                 o  Display or print the release notes (N)

                    Indicates that you want to see the installation
                    question on release notes. If you do not include
                    the N option, VMSINSTAL does not ask you about
                    the release notes. You should review the release
                    notes before proceeding with the installation in
                    case they contain additional information about the
                    installation.

                    If you are restarting the installation and have
                    already reviewed the release notes, you do not
                    need to specify the N option. (Even if you omit
                    the N option when you invoke VMSINSTAL, the Compaq
                    C++ release notes are copied automatically to the
                    SYS$HELP directory.)

                 o  Alternate root option (R)

                    Lets you install the product to a system root other
                    than that of the running system.

                                  Installing the Compaq C++ Compiler 2-7

 






              For detailed information on these software installation
              options, see the OpenVMS operating system documenta-
              tion. If you specify more than one option, separate the
              options with commas, such as OPTIONS A,N.

              The following example invokes VMSINSTAL to install
              Compaq C++ and shows the system response. This example
              uses the OPTIONS N release note option.

              $ @SYS$UPDATE:VMSINSTAL CXX06n DKA400:[CXX06n] OPTIONS N

                    OpenVMS AXP Software Product Installation Procedure V7.3

              It is dd-mmm-yyyy at hh:mm.
              Enter a question mark (?) at any time for help.

              If you do not supply either the product name or the
              device name, VMSINSTAL prompts you for this information
              later in the installation procedure.

              Verify user's account and quotas

              When you invoke VMSINSTAL, it checks the following:

              o  Whether you are logged in to a privileged account.
                 Compaq recommends that you install software from the
                 system manager's account with your default device
                 and directory set to SYS$UPDATE.

              o  Whether you have adequate quotas for installation.
                 VMSINSTAL checks for the quota values shown in
                 Table 1-1.

              VMSINSTAL then checks to determine whether any users
              are logged in to the system. If users are logged
              in, VMSINSTAL asks whether you want to continue the
              installation:

              * Do you want to continue anyway [NO]?  YES

              If you want to continue, enter YES. If you want to stop
              the installation, press Return.



     2-8 Installing the Compaq C++ Compiler

 






                 Confirm system backup

                 * Are you satisfied with the backup of your system disk [YES]?

                 If you are satisfied with the backup of your system
                 disk, press Return. Otherwise, enter NO to discontinue
                 the installation. After you back up your system disk,
                 you can restart the installation.

                 Specify distribution

                 If you omitted the device name on the VMSINSTAL command
                 line, the following prompt appears:

                 * Where will the distribution volumes be mounted: DKA400:[CXX06n]

                 If this prompt appears, enter the name of the
                 distribution (media) device and directory that contains
                 the Compaq C++ kit (save set). For example, if the
                 media is contained on a CD-ROM located on unit DKA400:,
                 enter DKA400:[CXX06n] in reply to this question (where
                 n is the minor version number).

                 Specify save set

                 If you omitted the product save set name on the
                 VMSINSTAL command line, the following prompt appears:

                 Enter the products to be processed from the first distribution volume set.
                 * Products: CXX06n

                 If this prompt appears, enter the C++ for OpenVMS Alpha
                 kit name. The name has the format, CXX06n (where n is
                 the minor version number).

                 Verify the product being installed

                  The following products will be processed:

                    CXX V6.n

                      Beginning installation of CXX V6.n  at hh:mm

                    %VMSINSTAL-I-RESTORE, Restoring product save set A...

                 The product name and version are displayed. This save
                 set (A) is restored to a subdirectory of SYS$UPDATE:.

                                  Installing the Compaq C++ Compiler 2-9

 






              Next, VMSINSTAL displays a message like the following:

              %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.

                 Compaq C++ V6.n for OpenVMS Alpha Systems

              The release notes are copied to the following files in
              the SYS$HELP directory (where n is the minor version
              number):

              SYS$HELP:CXX06n.RELEASE_NOTES
              SYS$HELP:CXX06n_RELEASE_NOTES.PS

              After the installation, you can enter the following
              command to view the location of the release notes
              through the Help facility:

              $ HELP CXX RELEASE_NOTES

              ________________________Note ________________________

              The name of the release notes file (installed by
              VMSINSTAL) consists of the current product name and
              version number.

              _____________________________________________________

              Choose the Installation Verification Procedure option

              If you have chosen to install the compiler component,
              the installation procedure now asks if you want to run
              the Installation Verification Procedure (IVP). The IVP
              checks to be sure that the installation is successful.
              Compaq recommends that you run the IVP.

              * Do you want to run the IVP after the installation [YES]?

              After Compaq C++ is installed, you can run the IVP
              independently to verify that the software is available
              on your system. You might need to run the IVP after
              a system failure to make sure that users can access
              Compaq C++.



     2-10 Installing the Compaq C++ Compiler

 






                 Select components to install

                 The installation procedure lets you select the
                 components of the kit that you want to install. The
                 choices are as follows:

                 o  C++ compiler

                    This component includes help text, command
                    definitions, and the IVP for the compiler.

                 o  C Run-Time Library and C++ Class Library text header
                    files

                    For efficiency, the header files are installed
                    on the system in text library format, within
                    SYS$LIBRARY. However, this creates a problem when
                    users need to use the headers as reference. To
                    remedy this, the installation procedure will now
                    prompt you to install a "reference copy" of the
                    text headers. These are in traditional text form,
                    and are suitable for searching, lookup, and so on.
                    When selected, the procedure will break them up and
                    install them into the following subdirectories:

                    SYS$COMMON:[CXX$LIB.REFERENCE.CXXL$DEF_HXX]
                    SYS$COMMON:[CXX$LIB.REFERENCE.CXXL$DEF_H]
                    SYS$COMMON:[CXX$LIB.REFERENCE.CXX$RTLDEF_HXX]
                    SYS$COMMON:[CXX$LIB.REFERENCE.CXX$RTLDEF]

                    By default, they will not be searched by the
                    compiler.

                ________________________Note  ________________________

                The header files (text libraries) are now au-
                tomatically installed based on the time stamps
                found within them. Time stamps on the kit versions
                are compared to those on the system, and the kit
                libraries are installed only if they are found to be
                more recent. All of this occurs without prompting.

                _____________________________________________________

                 o  CXXLINK facility

                                 Installing the Compaq C++ Compiler 2-11

 






              Select the components you want to install by answering
              YES or NO to the questions. If you want a more detailed
              description of any component, enter a question mark
              (?). After the explanation is displayed, you will be
              prompted again for a response.

              If you enter YES, the installation procedure validates
              that your request is possible and installs the
              component.

              If you enter NO, the installation procedure then issues
              prompts for selecting the next component.

              Respond to license registration query

              The Compaq C++ compiler component supports the OpenVMS
              License Management Facility (LMF). (For complete
              information on using the LMF, see the OpenVMS License
              Management Utility Manual.) If you entered YES to
              install the compiler component, the installation
              procedure displays license information about Compaq
              C++. It asks whether you have registered and loaded
              your PAK for each product. The following is an example
              of the information and the queries presented by the
              installation procedure:

                  The Compaq C++ compiler component requires a Product
                  Authorization Key (PAK) for Compaq C++ to be registered and
                  loaded.   Answer the following question with YES if a PAK
                  with the specified product name and a date equal to or
                  later than the date shown is registered and loaded, otherwise
                  answer NO.

                    Product:      CXX-V
                    Producer:     DEC
                    Version:      6.n
                    Release Date: dd-mmm-yyyy

              * Does this product have an authorization key registered and
              loaded?: YES

              If you have not registered and loaded your PAK, you
              must answer NO to this question. You must register
              and load your PAKs to complete the installation
              successfully. If you have not done so, you should stop
              the installation, register and load your PAKs, and then
              restart the installation.

     2-12 Installing the Compaq C++ Compiler

 






                 Read informational messages

                 At this point, the installation procedure displays a
                 number of informational messages that report on the
                 progress of the installation. There are no further
                 questions. If the installation procedure has been
                 successful up to this point, VMSINSTAL moves the new
                 or modified files to their target directories, updates
                 help files, and updates DCL tables, if necessary. See
                 Appendix C for a list of files installed on the system.

                 If you answered YES in response to the prompt that
                 requests a file purge, previous versions of the Compaq
                 C++ files are now purged. The end of the installation
                 is indicated by the following message:

                 %VMSINSTAL-I-MOVEFILES, files will now be moved to their target
                                         directories...

                 Observe the IVP

                 If you chose to run the IVP, VMSINSTAL now invokes
                 the IVP to verify that Compaq C++ was installed
                 successfully.

                 If Compaq C++ was installed successfully, the IVP
                 displays the following:

                 Compaq C++ V6.n Installation Verification Procedure completed successfully.

                 End the installation procedure

                  Installation of CXX V6.n completed at hh:mm

                     Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY

                     Creating installation data file: VMI$ROOT:[SYSUPD]CXX065.VMI_
        DATA

                 Depending on whether you specified parameters on the
                 VMSINSTAL command line, the * Products: prompt or the
                 DCL prompt ($) may appear. If the * Products: prompt
                 appears, you can return to the DCL prompt by pressing
                 Ctrl/Z.

                 If you removed any media from the console drive before
                 beginning the installation, you should replace it now.

                                 Installing the Compaq C++ Compiler 2-13

 






              VMSINSTAL deletes or changes entries in the process
              symbol tables during the installation. Therefore,
              if you are going to continue using the installation
              account (such as SYSTEM) and you want to restore these
              symbols, you should log out and log in again.


     2.3 Error Recovery

           If VMSINSTAL detects any problems during the installation,
           it notifies you and asks if you want to continue the
           installation. In some instances, you can enter YES to
           continue. To stop the installation process and correct the
           situation, enter NO or press Return. Correct the problem
           and restart the installation.

           If errors occur during the installation itself or when
           the Installation Verification Procedure (IVP) is running,
           VMSINSTAL displays failure messages. If the installation
           fails, you will see the following message:

           %VMSINSTAL-E-INSFAIL, The installation of Compaq C++
               Version 6.n has failed.

           If the IVP fails, you will see these messages:

           The Compaq C++ Version 6.n Installation
               Verification Procedure failed.

           %VMSINSTAL-E-IVPFAIL, The IVP for Compaq C++
               Version 6.n has failed.

           Errors can occur during the installation if any of the
           following conditions exist:

           o  The operating system version is incorrect.

           o  A prerequisite software version is incorrect.

           o  Quotas necessary for successful installation are
              insufficient.

           o  System parameter values for successful installation are
              insufficient.

           o  The OpenVMS Help library is currently in use.

           o  The product license has not been registered and loaded.

     2-14 Installing the Compaq C++ Compiler

 






              For descriptions of the error messages generated by these
              conditions, see the OpenVMS documentation on system
              messages, recovery procedures, and OpenVMS software
              installation. If you are notified that any of these
              conditions exist, you should take the appropriate
              action as described in the message. For information on
              installation requirements, see Chapter 1.

              If the installation fails, you must restart the instal-
              lation procedure from step 2. For an explanation of
              any system messages, see the OpenVMS System Messages
              and Recovery Procedures Reference Manual or the online
              HELP/MESSAGE facility. If the installation fails due
              to an IVP failure, contact a Compaq field service
              representative.






























                                 Installing the Compaq C++ Compiler 2-15

 









                                                                       3
        ________________________________________________________________

                                                  After C++ Installation



              Compaq C++ is now installed and can be invoked by all
              users with the cxx command.

              The installation procedure modifies the DCL command table
              so that the cxx command is recognized and processed.
              However, the previous command table is still in effect
              for those users who are currently logged in. All logged-in
              users who want to use the cxx command must log out and log
              in again, or use the following DCL command:

              $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES

              The following tasks can be performed after Compaq C++ is
              installed:

              o  Running the Installation Verification Procedure (IVP)
                 separately

              o  Editing the system startup and shutdown files

              o  Modifying system parameter settings

              o  Making the product usable on a VMScluster

              o  Setting user account quotas

              o  Tailoring your system

              o  Enhancing performance

              o  Reporting problems

              The following sections describe these tasks in detail.


                                              After C++ Installation 3-1

 






     3.1 Running the Installation Verification Procedure Separately

           You usually run the Installation Verification Procedure
           (IVP) during installation. To run the IVP separately to
           ensure the integrity of installed files should system
           problems occur, type the following:

           $ @SYS$TEST:CXX$IVP.COM

           If the IVP fails, you see these messages:

           The Compaq C++ Version 6.5 Installation Verification Procedure failed.

           %VMSINSTAL-E-IVPFAIL, The IVP for Compaq C++ Version 6.5 has failed.

     3.2 Editing and Organizing the System Files

           You do not need to edit the compiler system startup
           (CCXX$STARTUP.COM) and shutdown files to provide
           for automatic startup and shutdown of Compaq C++
           when your system is rebooted. You may optionally add
           SYS$STARTUP:CCXX$STARTUP.COM to the system startup
           procedure to install the images.

     3.3 VMScluster Considerations

           After completing the initial installation, if you want
           to install Compaq C++ on multiple nodes in a cluster, you
           must run INSTALL on each of the other nodes and enter the
           following command:

           INSTALL>  REPLACE SYS$LIBRARY:DCLTABLES.EXE

           If you are using a dual-architecture (VAX and Alpha
           systems) heterogeneous cluster, before executing these
           commands, make sure the appropriate logical names have
           been set to define the scope of the SYSMAN DO commands.
           For more information, see the OpenVMS System Manager's
           Manual.

     3.4 User Account Requirements

           Many products cannot be used unless certain privilege and
           quota requirements are met by user accounts. The following
           sections describe the privilege and quota requirements
           needed to work with Compaq C++.

     3-2 After C++ Installation

 






        3.4.1 User Privileges

              To use Compaq C++, each account must have at least the
              TMPMBX and NETMBX privileges. Use the OpenVMS Authorize
              Utility to determine whether users have the privileges
              they require.

        3.4.2 User Account Quotas

              To use Compaq C++, a user account does not need to meet
              any special quota requirements. However, for users who
              will be compiling very large programs (many program
              units compiled together), consider adjusting the working
              set (WSDEF, WSQUOTA, WSEXTENT) and pagefile (PGFLQUOTA)
              account quotas to improve performance.

              See Section 1.1.2 for a description of how to verify and
              change account quotas.

        3.4.3 Installing the Compaq C++ Compiler and the C++ Class
              Library as a Shared Image

              Compaq highly recommends that you reduce the system
              overhead and memory requirements by installing the Compaq
              C++ compiler and the C++ Class Library as shared images.
              To install Compaq C++ as a shared image on a system that
              is currently running, use the INSTALL Utility. Compaq
              recommends that you install Compaq C++ as shared on
              a system that has been rebooted recently because the
              available space in the global pagelet table is less likely
              to be fragmented.

              To install Compaq C++ and the Class Library as a shared
              image:

              1. Determine the number of available (free) global
                 pagelets and global sections on your system and the
                 number of each needed to install and run Compaq C++
                 (see Section 1.1.6.2).

              2. If necessary, increase the current number of global
                 pagelets and global sections parameters (see Section 1.1.6.2).



                                              After C++ Installation 3-3

 






           After you reset the system parameter values, invoke the
           INSTALL Utility from a privileged account and install the
           Compaq C++ compiler as a shared image:

           $ INSTALL
           INSTALL> ADD SYS$SYSTEM:CXX$COMPILER.EXE /OPEN /SHARED
           INSTALL> EXIT

           Similarly, install the C++ Class Library as a shared
           image:

           $ INSTALL
           INSTALL> ADD SYS$LIBRARY:CXXL$011_SHR.EXE /OPEN /SHARED
           INSTALL> EXIT

           Add the following lines to the appropriate system startup
           command file so that Compaq C++ is available as a shared
           image each time the system is started. (If your site has
           modularized its startup procedures, be sure you add the
           lines to the correct file.) The default startup command
           file is SYS$MANAGER:SYSTARTUP_VMS.COM.

           $ INSTALL
           ADD SYS$SYSTEM:CXX$COMPILER.EXE /OPEN /SHARED
           ADD SYS$LIBRARY:CXXL$011_SHR.EXE /OPEN /SHARED
           EXIT

           Using the /PRIVILEGED qualifier is neither necessary nor
           recommended.

           To install the compiler message file, enter the following
           commands:

           $ INSTALL
           INSTALL> ADD SYS$MESSAGE:CXX$COMPILER_MSG.EXE
           INSTALL> EXIT

           To install the Class Library message file, enter the
           following commands:

           $ INSTALL
           INSTALL> ADD SYS$MESSAGE:CXXL$MSG_SHR.EXE
           INSTALL> EXIT

           When you install Compaq C++ as a shared image you need
           to increase the global pagelets and global sections
           parameters. See Section 1.1.6.2 for information on
           changing these parameters.

     3-4 After C++ Installation

 






        3.5 Getting Help and Reporting Problems

              If an error occurs while Compaq C++ is in use and you
              believe the error is caused by a problem with the product,
              please report it to Compaq.

              If you have a Software Product Services Support Agreement,
              contact your Customer Support Center (CSC) by telephone
              or by using the electronic means provided with your
              support agreement (such as DSNlink). The CSC provides
              telephone support for high-level advisory and remedial
              assistance. When you initially contact the CSC, indicate
              the following:

              o  The name and version number of the operating system you
                 are using

              o  The version number of Compaq C++ you are using

              o  The hardware system you are using (such as a model
                 number)

              o  A brief description of the problem (one sentence if
                 possible)

              o  How critical the problem is

              Whether you submit information electronically or contact
              the appropriate support specialist by telephone, please
              take the following steps:

              1. Describe as accurately as possible the circumstances
                 and state of the system when the problem occurred.
                 Include the description and version number of the
                 Compaq C++ compiler being used. Demonstrate the problem
                 with specific examples.

              2. Reduce the problem to as small a size as possible.

              3. Remember to include listings of any command files,
                 INCLUDE files, or relevant data files, and so forth.

              4. Provide a listing of the program.

              5. If the program is longer than 50 lines, submit a copy
                 of it on machine-readable media (diskette or magnetic
                 tape).

              6. Report only one problem per report. This will
                 facilitate a faster response.

                                              After C++ Installation 3-5

 






           7. Mail the problem report to Compaq.

           If the problem is related to Compaq C++ documentation, you
           can report the problem to the CSC (if you have a Software
           Product Services Support Agreement and the problem is
           severe); otherwise, send your comments about Compaq C++
           documentation to the following Internet address:

           compaq_cxx.bugs@compaq.com

           To obtain information about purchasing a Software Product
           Services Support Agreement or other support services,
           please contact your local Compaq sales representative or
           business partner.































     3-6 After C++ Installation

 









                                                                       4
        ________________________________________________________________

                                      Installing the Compaq C++ Debugger



              A special C++ debugger is provided with the Compaq C++
              Version 6.5 kit and must be installed to debug programs
              compiled with Compaq C++ Version 6.5.

              The special C++ debugger is an early copy of the standard
              OpenVMS debugger that will ship in a future release
              after OpenVMS Alpha Version 7.2 and provide full support
              for languages other than C++. The installation of this
              debugger kit does not replace the debugger supplied with
              the operating system. Thus, you can use either debugger
              after installation. Special steps must be taken if you
              want the special C++ debugger to be the default debugger
              on your system.

                ________________________Note  ________________________

                In an OpenVMS release after Version 7.2, the
                debugger that is shipped with the operating system
                will support the new C++ capabilities. If you are
                using an OpenVMS release after Version 7.2, please
                consult the OpenVMS New Features manual to determine
                if it is necessary to install the debugger shipped
                with C++.

                _____________________________________________________

              If you install the debugger on a version of the operating
              system that does not have DECwindows Motif installed,
              or on a system that has a version of DECwindows Motif
              prior to Version 1.2-4, the C++ debugger's Graphic User
              Interface (GUI) image will not be installed. If you decide
              later to install Motif, or to upgrade Motif to Version
              1.2-4, and you then want to use the debugger's GUI, you
              should then reinstall the C++ debugger, to create the
              debugger's GUI image.

                                  Installing the Compaq C++ Debugger 4-1

 






     4.1 Installing the Debugger

           The C++ debugger must be installed in addition to the
           compiler. The installation procedure is similar to that
           for the compiler kit; to install the debugger, invoke the
           VMSINSTAL command procedure, as described in Section 2.2.
           The saveset-name for the debugger kit is ADX072. The other
           parameters to VMSINSTAL should be the same as specified
           when installing the compiler kit. For example:

           @SYS$UPDATE:VMSINSTAL ADX072 device-name option-list

              ________________________Note ________________________

              The way in which the ADX072 kit links debugger
              images at VMSINSTAL time depends on the version of
              OpenVMS Alpha installed on your system. The ADX072
              debugger linked with Version 6.n of OpenVMS Alpha
              does not function properly on Version 7.n systems.
              For example, if you install ADX072 on a Version 6.2
              system and that system is later upgraded to Version
              7.2, the ADX072 debugger will function improperly
              until you reinstall ADX072.

              _____________________________________________________

     4.2 After Debugger Installation

           The installation of this debugger kit does not replace
           the debugger supplied with the operating system. After
           installing the C++ debugger, you need to invoke a command
           procedure to install the C++ debugger images and define
           the default system debugger.

           If you want the special C++ debugger to be the default
           debugger for the system, you should do the following from
           a privileged account, after installing the ADX072 kit:

           1. Enter the following command and add it to the system
              startup procedure (SYS$STARTUP:SYSTARTUP_VMS.COM):

              @SYS$STARTUP:DEBUG$STARTUP_V72X.COM V72X



     4-2 Installing the Compaq C++ Debugger

 






              If you do not want the special C++ debugger to be the
              default debugger for the system, enter the following
              command from a privileged account and add it to the system
              startup procedure (SYS$STARTUP:SYSTARTUP_VMS.COM):

              @SYS$STARTUP:DEBUG$STARTUP.COM VMS

              Regardless of which debugger you select as the default
              system debugger, individual users can choose the other
              debugger. See the release notes for more information.



































                                  Installing the Compaq C++ Debugger 4-3

 









                                                                       A
        ________________________________________________________________

                                        Sample C++ Compiler Installation



              This appendix contains a Version 7.3 sample installation
              for the Compaq C++ kit. It is only a sample. Sometimes the
              installation procedure is modified in maintenance updates
              of this product.

              Because this installation guide is not usually revised for
              maintenance updates, be sure to read the applicable Read
              Before Installing or Using Compaq C++ letter before you
              install this product. This letter notes any significant
              changes to the installation sample shown here. Such
              information also appears in the online release notes.

              Depending on which layered products you have on your
              system, you might see additional messages and questions
              when you perform your installation.

              This sample installation assumes that DECnet has been shut
              down, that no users are logged in to your system, and that
              OPTIONS N is specified to print the release notes. The
              Installation Verification Procedure (IVP) runs at the end
              of the installation.

              Example A-1 shows a sample installation of Compaq C++
              Version 6.5 on an OpenVMS Alpha Version 7.3 system.











                                    Sample C++ Compiler Installation A-1

 






           Example A-1 Sample Compaq C++ Installation on OpenVMS
                       Alpha Version 7.3

           $ @sys$update:vmsinstal

                   OpenVMS AXP Software Product Installation Procedure V7.3

           It is 15-JANUARY-2002 at 13:35.

           Enter a question mark (?) at any time for help.

           * Are you satisfied with the backup of your system disk [YES]? Y
           * Where will the distribution volumes be mounted: DKA400:[CXX065]

           Enter the products to be processed from the first distribution volume set.
           * Products: cxx
           * Enter installation options you wish to use (none): n

           The following products will be processed:

             CXX V6.5

                   Beginning installation of CXX V6.5 at 13:35

           %VMSINSTAL-I-RESTORE, Restoring product save set A ...
           %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.

               Compaq C++ Version V6.5 for OpenVMS Alpha Systems

               Copyright 2002 Information Technolgies Group, L.P.

               COMPAQ, the Compaq logo, Alpha, DEC, OpenVMS, and VMS are trademarks
               of Compaq Information Technologies Group, L.P. in the U.S. and/or
               other countries. All other product names mentioned herein may be
               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.

           * Should this V6.5-001 system compiler remain the default when cxx is typed [NO]:
               The newly installed compiler will become the system default compiler.
           * Do you want to purge files replaced by this installation [YES]?

                                             (continued on next page)

     A-2 Sample C++ Compiler Installation

 






              Example A-1 (Cont.) Sample Compaq C++ Installation on
                                  OpenVMS Alpha Version 7.3

                  This kit contains an Installation Verification Procedure
                  (IVP) to  verify  the  correct  installation of the
                  Compaq C++ compiler component and  class library headers.
                  IVP will be placed in:

                              SYS$TEST:CXX$IVP.COM

                  After the  installation  is complete, you can invoke the
                  command file at any time to reverify that Compaq C++ is
                  installed and working correctly.   If you wish to invoke
                  it automatically  at the completion of this installation
                  procedure, answer Yes to the following question.

              * Do you want to run the IVP after the installation [YES]? Y

                  The C Runtime Library, and C++ Class Library,  headers
                  will be installed as Text Libraries (.TLBs).   If you
                  also wish to install the traditional text form  of the
                  headers (.H and .HXX  files) for  reference  purposes,
                  please answer yes to the following question.  The text
                  headers will be placed in a subdirectory that will not
                  be searched  by the compiler.   Instead, they  will be
                  placed the subdirectory tree:

                          SYS$COMMON:[CXX$LIB.REFERENCE...]

                  ( SYS$COMMON:[CXX$LIB.REFERENCE...] for the Compaq C RTL
                  header library, CXX$RTLDEF, and the system definition
                  header library, SYS$STARLET_C.)

                  Note that doing this may double the disk space used for
                  the headers.

              * Do you want to install the text form of the headers?  [YES]? Y

                  The Compaq C++ compiler component requires a Product
                  Authorization Key (PAK) for Compaq C++ to be registered and
                  loaded.   Answer the following question with YES if a PAK
                  with the specified product name and a date equal to or
                  later than the date shown is registered and loaded, otherwise
                  answer NO.

                                                (continued on next page)

                                    Sample C++ Compiler Installation A-3

 






           Example A-1 (Cont.) Sample Compaq C++ Installation on
                               OpenVMS Alpha Version 7.3

                   Product:      CXX-V
                   Producer:     DEC
                   Version:      6.5
                   Release Date: 01-JAN-2002

           * Does this product have an authorization key registered and loaded? Y

               All questions and validations regarding the installation of Compaq C++
               kit components have now been asked.  Depending upon your configuration,
               time estimates for the installation(s) are as follows:

               Compiler/Linker/Library:   2  minutes
               Text form of headers:      4  minutes
               IVP:                       2  minutes
               Moving files:              6  minutes

               The existing version of VMI$ROOT:[SYSLIB]DECC$CRTL.OLB is
               identical or newer than the one on this installation kit.
               Installation of the kit version will not be performed.

               You may optionally add the SYS$STARTUP:CCXX$STARTUP.COM to the
               system startup procedure. To use Compaq C++ for OpenVMS Alpha on
               other Alpha nodes of a VMScluster, from a privileged account on each
               such node enter the command "$ @SYS$STARTUP:CCXX$STARTUP.COM".  This
               will install images.

               The existing version of VMI$ROOT:[SYSLIB]DECC$RTLDEF.TLB is
               identical or newer than the one on this installation kit.
               Installation of the kit version will not be performed.

               Your OpenVMS system will now be updated to include the following
               new and modified file(s):

                                             (continued on next page)








     A-4 Sample C++ Compiler Installation

 






              Example A-1 (Cont.) Sample Compaq C++ Installation on
                                  OpenVMS Alpha Version 7.3

                  SYS$HELP:CXX065.RELEASE_NOTES                     [new]
                  SYS$HELP:CXX065_RELEASE_NOTES.PS                  [new]
                  SYS$TEST:CXX$IVP.COM                              [new]
                  SYS$SYSTEM:CXX$DELETE_VERSION.COM                 [new]
                  SYS$SYSTEM:CXX$SET_VERSION.COM                    [new]
                  SYS$SYSTEM:CXX$SHOW_VERSIONS.COM                  [new]
                  SYS$SYSTEM:CXX$COMPILER.EXE                       [new]
                  SYS$MESSAGE:CXX$COMPILER_MSG.EXE                  [new]
                  SYS$LIBRARY:DCLTABLES.EXE                         [modified]
                  SYS$COMMON:[CXX$LIB]CXX$CLD.CLD                   [new]
                  SYS$SYSTEM:CXX$COMPILER_V06_05-002.EXE            [new]
                  SYS$MESSAGE:CXX$COMPILER_MSG_V06_05-002.EXE       [new]
                  SYS$COMMON:[CXX$LIB]CXX$CLD_V06_05-002.CLD        [new]
                  SYS$HELP:HELPLIB.HLB                              [modified]
                  SYS$SYSTEM:CXX$LINK.EXE                           [new]
                  SYS$MESSAGE:CXX$LINK_MSG.EXE                      [new]
                  SYS$COMMON:[CXX$LIB]CXXLINK.CLD                   [new]
                  SYS$SYSTEM:CXX$LINK_V06_05-002.EXE                [new]
                  SYS$MESSAGE:CXX$LINK_MSG_V06_05-002.EXE           [new]
                  SYS$COMMON:[CXX$LIB]CXXLINK_V06_05-002.CLD        [new]
                  SYS$SYSTEM:CXX$DEMANGLE.EXE                       [new]
                  SYS$COMMON:[CXX$LIB]CXXDEMANGLE.CLD               [new]
                  SYS$SYSTEM:CXX$DEMANGLE_V06_05-002.EXE            [new]
                  SYS$COMMON:[CXX$LIB]CXXDEMANGLE_V06_05-002.CLD    [new]
                  SYS$HELP:[CXX$HELP]INTZLN.PDF                     [new]
                  SYS$HELP:[CXX$HELP]IOSTREAM.PDF                   [new]
                  SYS$HELP:[CXX$HELP]INTZLN.PS                      [new]
                  SYS$HELP:[CXX$HELP]IOSTREAM.PS                    [new]
                  SYS$HELP:[CXX$HELP]CXX_CLASSLIB.PS                [new]
                  SYS$HELP:[CXX$HELP]CXX_USERSGUIDE.PS              [new]
                  SYS$HELP:[CXX$HELP]CXX_CLASSLIB.TXT               [new]
                  SYS$HELP:[CXX$HELP]CXX_USERSGUIDE.TXT             [new]
                  SYS$STARTUP:CCXX$STARTUP.COM                      [new]
                  SYS$LIBRARY:LIBCXXSTD.OLB                         [new]
                  SYS$LIBRARY:LIBCXXSTD_MA.OLB                      [new]
                  SYS$LIBRARY:LIBCXXSTD_NOINST.OLB                  [new]
                  SYS$LIBRARY:LIBCXXSTD_MA_NOINST.OLB               [new]
                  SYS$LIBRARY:LIBCXXSTD_V06_05-002.OLB              [new]

                                                (continued on next page)


                                    Sample C++ Compiler Installation A-5

 






           Example A-1 (Cont.) Sample Compaq C++ Installation on
                               OpenVMS Alpha Version 7.3

               SYS$LIBRARY:LIBCXXSTD_MA_V06_05-002.OLB           [new]
               SYS$LIBRARY:LIBCXXSTD_NOINST_V06_05-002.OLB       [new]
               SYS$LIBRARY:LIBCXXSTD_MA_NOINST_V06_05-002.OLB    [new]
               SYS$LIBRARY:CXXL$ANSI_DEF.TLB                     [new]
               SYS$LIBRARY:CXXL$ANSI_DEF_V06_05-002.TLB          [new]

           %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

            Beginning Compaq C++ V6.5-002 Installation Verification Procedure

            Copyright 2002 Information Technolgies Group, L.P.

            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.

            Test compiler operation and error messages...

            Test Class Library operation...

            Compaq C++ V6.5-002 Installation Verification Procedure completed successfully

                Installation of CXX V6.5 completed at 13:45

            Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY

            Creating installation data file: VMI$ROOT:[SYSUPD]CXX065.VMI_DATA

           Enter the products to be processed from the next distribution volume set.

           * Products:

                   VMSINSTAL procedure done at 13:45
           $






     A-6 Sample C++ Compiler Installation

 









                                                                       B
        ________________________________________________________________

                                        Sample C++ Debugger Installation



              This appendix contains a sample installation for the
              C++ Debugger kit. This is only a sample. Sometimes the
              installation procedure is modified in maintenance updates
              of this product.

              Because this installation guide is not usually revised for
              maintenance updates, be sure to read the applicable Read
              Before Installing or Using Compaq C++ letter before you
              install this product. This letter notes any significant
              changes to the installation sample shown here. Such
              information also appears in the online release notes.

              The following sample was installed on a system where
              Compaq C++ was not previously installed. Depending on
              which layered products you have on your system, you might
              see additional messages and questions when you perform
              your installation.

              This sample installation assumes that DECnet has been shut
              down, that no users are logged in to your system, and that
              OPTIONS N is specified to print the release notes. The
              Installation Verification Procedure (IVP) runs at the end
              of the installation.

              Example B-1 shows a sample installation of the C++
              debugger on an OpenVMS Alpha system.









                                    Sample C++ Debugger Installation B-1

 






           Example B-1 Sample C++ Debugger Installation on OpenVMS
                       Alpha

           $ @sys$update:vmsinstal

                   OpenVMS AXP Software Product Installation Procedure V6.2

           It is 15-JANUARY-2002 at 16:10.

           Enter a question mark (?) at any time for help.

           * Are you satisfied with the backup of your system disk [YES]? Y

           * Where will the distribution volumes be mounted: DKA400:[INSTALL.CXX065]

           Enter the products to be processed from the first distribution volume set.
           * Products: ADX

           * Enter installation options you wish to use (none): N

           The following products will be processed:

             ADX V72

                   Beginning installation of ADX V7.2 at 16:10

           %VMSINSTAL-I-RESTORE, Restoring product save set A ...
           %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.

               Copyright 2002 Compaq Computer Corporation

               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.

               This kit installs Debug version V7.2X.  It will install on Alpha OpenVMS
               V6.2 to V7.2 systems.

               This kit requires an installed DCE for its client/server configurations
               (see release motes).  If DCE is not installed, the "server" portion of
               the debugger cannot be linked and a warning is printed during the
               installation, for example, "%ADX-W-LINKABORT, NO DEBUGSRVSHR linked,
               SYS$LIBRARY:DCE$LIB_SHR missing (install DCE)".  You can safely ignore
               this message.  The normal operation of the debugger is not affected,
               however, the client/server mode will NOT be operational.

               A new Heap Analyzer will be also installed on V7.1 or later systems.

                                             (continued on next page)

     B-2 Sample C++ Debugger Installation

 






              Example B-1 (Cont.) Sample C++ Debugger Installation on
                                  OpenVMS Alpha

                  If your system is later upgraded from V6 to V7 or if DCE or MOTIF are
                  later installed, then this kit MUST be rerun, i.e. the V7.2X debugger
                  MUST be reinstalled.

                  System Code Debugger features will NOT be installed as part of this kit,
                  use the system supplied debugger for that.

                  This installation will NOT replace your current OpenVMS system supplied
                  debugger.  However, it will replace any previous versions of the V7.2X
                  debugger that may be installed AND it will remove any earlier network
                  kit debuggers, e.g. V71C.

                  This installation takes ~5 minutes.

              * Do you want to run the IVP after the installation [YES]? Y
              * Do you want to run the interactive DECwindows Motif IVP? [NO]? N
              * Do you want to purge files replaced by this installation [YES]? Y
              %ADX-I-DONEASK, No further questions will be asked during this installation.
              %VMSINSTAL-I-RESTORE, Restoring product save set B ...
              %VMSINSTAL-I-RESTORE, Restoring product save set C ...
              %ADX-I-ENDRESTORE, All Debugger savesets have been restored.
              %ADX-I-LINKING, Linking V6 images.
              %ADX-I-LINKDONE, DEBUGSHR has been linked.
              %ADX-I-LINKDONE, DEBUG has been linked.
              %ADX-I-LINKDONE, DEBUGUISHR has been linked.
              %ADX-W-LINKABORT, NO DEBUGSRVSHR linked, SYS$LIBRARY:DCE$LIB_SHR missing
                                (install DCE)
              %ADX-I-LINKDONE, TRACE has been linked.
              %ADX-I-CLEANUP, Cleanup has been performed.
              %ADX-I-PROHELP, Providing Debugger Help files...
              %ADX-I-PROMSG, Providing Debugger message image...
              %ADX-I-PROMSG, Providing Debugger .CLD file...
              %ADX-I-PROEXE, Providing Debugger files...
              %ADX-I-PROMSG, Providing startup files ...

                  If you want the debugger installed by this kit to be the default system
                  debugger:

                     -   Add add the following line to the system startup procedure:

                             $ @SYS$STARTUP:DEBUG$STARTUP_V72X.COM V72X

                                                (continued on next page)

                                    Sample C++ Debugger Installation B-3

 






           Example B-1 (Cont.) Sample C++ Debugger Installation on
                               OpenVMS Alpha

                      You should remove any other *DEBUG$STARTUP*.COM reference.

                  -   Enter the following command from a privileged account:

                            @SYS$STARTUP:DEBUG$STARTUP_V72X.COM V72X

                      To install the images and define the default system debugger
                      on other Alpha nodes of a VMScluster, enter this command on
                      each such node.  Note, however, that this is a /SYSTEM setup
                      (also see SYS$STARTUP:DEBUGSETUP.COM) and also modifies and
                      install/replaces your SYS$SHARE:DCLTABLES.EXE.

               If you want the regular system debugger installed to be the default
               system debugger, then do the same as above but use "VMS" as the input
               parameter, for example:

                       @SYS$STARTUP:DEBUG$STARTUP_V72X.COM VMS

               Users can also dynamically switch debuggers by using
               SYS$STARTUP:DEBUGSETUP.COM.  It's input options are VMS, V72X, V72,
               V71C, or UNSET.  It also needs the logical table switch /JOB or /SYSTEM.
               For example:

                       @SYS$STARTUP:DEBUGSETUP.COM V72X /JOB

           %ADX-I-PROIVP, Providing test files for IVP...

               The Debugger IVP has been moved to the SYS$TEST directory.  To run the
               IVP after installation, first setup to use the V72X debugger by executing
               the command "@SYS$STARTUP:DEBUGSETUP V72X /JOB" Then, run the character
               cell IVP by executing the command "@SYS$TEST:DBG$IVP.COM" or, if
               DECWindows Motif has been installed on your system, run the interactive
               DECWindows Motif IVP by executing the command "@SYS$TEST:DBG$DW$IVP.COM"

           %ADX-I-INSTALLDONE, OpenVMS Alpha Debug V7.2X installation done
           %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

             Beginning the Debug V7.2X Verification Procedure

               Copyright 2002 Compaq Computer Corporation

               Government notice:

                                             (continued on next page)

     B-4 Sample C++ Debugger Installation

 






              Example B-1 (Cont.) Sample C++ Debugger Installation on
                                  OpenVMS Alpha

                  Restricted Rights: Use, duplication, or disclosure by the U.S.
                  Government is subject to restrictions as set forth in subparagraph
                  (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR
                  52.227-14 Alt. III, as applicable.

                  Licensing notice:

                  This software is proprietary to and embodies the confidential
                  technology of Compaq Information Technologies, Group, L.P.
                  Possession, use, or copying of this software and media is
                  authorized only pursuant to a valid written license from Compaq
                  or an authorized sublicensor.

                Debug verification procedure successful.

                      Installation of ADX V7.2 completed at 16:15

                  Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY

                  Creating installation data file: VMI$ROOT:[SYSUPD]ADX072.VMI_DATA

                      VMSINSTAL procedure done at 16:15




















                                    Sample C++ Debugger Installation B-5

 









                                                                       C
        ________________________________________________________________

                                          Files Installed on Your System



              The Compaq C++ installation procedure installs and
              modifies a number of files on your system, as listed in
              Table C-1.

              Table_C-1_Files_Installed_or_Modified_____________________

              File_____________________________________New_or_Modified__

              SYS$HELP:CXX065.RELEASE_NOTES            new

              SYS$HELP:CXX065_RELEASE_NOTES.PS         new

              SYS$TEST:CXX$IVP.COM                     new

              SYS$SYSTEM:CXX$DELETE_VERSION.COM        new

              SYS$SYSTEM:CXX$SET_VERSION.COM           new

              SYS$SYSTEM:CXX$SHOW_VERSIONS.COM         new

              SYS$SYSTEM:CXX$COMPILER.EXE              new

              SYS$MESSAGE:CXX$COMPILER_MSG.EXE         new

              SYS$LIBRARY:DCLTABLES.EXE                modified

              SYS$COMMON:[CXX$LIB]CXX$CLD.CLD          new

              SYS$SYSTEM:CXX$COMPILER_V06_05-002.EXE   new

              SYS$MESSAGE:CXX$COMPILER_MSG_V06_05-     new
              002.EXE

              SYS$COMMON:[CXX$LIB]CXX$CLD_V06_05-      new
              002.CLD

              SYS$HELP:HELPLIB.HLB                     modified

              SYS$SYSTEM:CXX$LINK.EXE                  new

              SYS$MESSAGE:CXX$LINK_MSG.EXE             new

                                                (continued on next page)

                                      Files Installed on Your System C-1

 






           Table_C-1_(Cont.)_Files_Installed_or_Modified_____________

           File_____________________________________New_or_Modified__

           SYS$COMMON:[CXX$LIB]CXXLINK.CLD          new

           SYS$SYSTEM:CXX$LINK_V06_05-002.EXE       new

           SYS$MESSAGE:CXX$LINK_MSG_V06_05-002.EXE  new

           SYS$COMMON:[CXX$LIB]CXXLINK_V06_05-      new
           002.CLD

           SYS$SYSTEM:CXX$DEMANGLE.EXE              new

           SYS$COMMON:[CXX$LIB]CXXDEMANGLE.CLD      new

           SYS$SYSTEM:CXX$DEMANGLE_V06_05-002.EXE   new

           SYS$COMMON:[CXX$LIB]CXXDEMANGLE_V06_     new
           05-002.CLD

           SYS$HELP:[CXX$HELP]INTZLN.PDF            new

           SYS$HELP:[CXX$HELP]IOSTREAM.PDF          new

           SYS$HELP:[CXX$HELP]INTZLN.PS             new

           SYS$HELP:[CXX$HELP]IOSTREAM.PS           new

           SYS$HELP:[CXX$HELP]CXX_CLASSLIB.PS       new

           SYS$HELP:[CXX$HELP]CXX_USERSGUIDE.PS     new

           SYS$HELP:[CXX$HELP]CXX_CLASSLIB.TXT      new

           SYS$HELP:[CXX$HELP]CXX_USERSGUIDE.TXT    new

           SYS$STARTUP:CCXX$STARTUP.COM             new

           SYS$LIBRARY:LIBCXXSTD.OLB                new

           SYS$LIBRARY:LIBCXXSTD_MA.OLB             new

           SYS$LIBRARY:LIBCXXSTD_NOINST.OLB         new

           SYS$LIBRARY:LIBCXXSTD_MA_NOINST.OLB      new

           SYS$LIBRARY:LIBCXXSTD_V06_05-002.OLB     new

           SYS$LIBRARY:LIBCXXSTD_MA_V06_05-002.OLB  new

           SYS$LIBRARY:LIBCXXSTD_NOINST_V06_05-     new
           002.OLB

           SYS$LIBRARY:LIBCXXSTD_MA_NOINST_V06_     new
           05-002.OLB

                                             (continued on next page)

     C-2 Files Installed on Your System

 






              Table_C-1_(Cont.)_Files_Installed_or_Modified_____________

              File_____________________________________New_or_Modified__

              SYS$LIBRARY:CXXL$ANSI_DEF.TLB            new

              SYS$LIBRARY:CXXL$ANSI_DEF_V06_05-        new
              002.TLB___________________________________________________





































                                      Files Installed on Your System C-3

 









                                                                       D
        ________________________________________________________________

                                                  Recovering from Errors



              This appendix provides information to help you with
              failures or errors that might occur during product
              installation or product use.

        D.1 Failures During Compaq C++ Installation

              If VMSINSTAL detects any problems during the installation,
              it notifies you and asks if you want to continue the
              installation. In some instances, you can enter yes to
              continue. To stop the installation process and correct
              the situation, enter no or press Return, then correct the
              problem and restart the installation.

              If errors occur during the installation itself or when
              the Installation Verification Procedure (IVP) is running,
              VMSINSTAL displays failure messages. If the installation
              fails, you see the following message:

              %VMSINSTAL-E-INSFAIL, The installation of Compaq C++ Version 6.5 has failed.

              If the IVP fails, you see these messages:

              The Compaq C++ Version 6.5 Installation Verification Procedure failed.

              %VMSINSTAL-E-IVPFAIL, The IVP for Compaq C++ Version 6.5 has failed.

              Errors can occur during the installation if any of the
              following conditions exist:

              o  The operating system version is incorrect.

              o  A prerequisite software version is incorrect.

              o  Quotas necessary for successful installation are
                 insufficient.

              o  System parameter values for successful installation are
                 insufficient.

              o  The OpenVMS Help library is currently in use.

                                              Recovering from Errors D-1

 






           o  The product license has not been registered and loaded.

           For descriptions of the error messages generated by these
           conditions, see the OpenVMS documentation on system
           messages, recovery procedures, and OpenVMS software
           installation. If you are notified that any of these
           conditions exist, you should take the appropriate action
           as described in the message.

           For information on installation requirements, see
           Chapter 1.

     D.2 Problems During Compaq C++ Use

           If you encounter a problem while using Compaq C++, see the
           Release Notes. If the problem is unresolved, report it to
           Compaq. Depending on the type of support you have and the
           nature of the problem, take one of the following actions:

           o  If you have a Software Product Services Support
              Agreement, contact your Compaq Customer Support Center
              (CSC), either by telephone or using the electronic
              means provided with your support agreement (such
              as DSNlink). The CSC provides telephone support for
              high-level advisory and remedial assistance. When
              you initially contact the CSC, please indicate the
              following:

              -  The name (OpenVMS Alpha) and the version number of
                 the operating system you are using

              -  The product name (Compaq C++) and the version number
                 of Compaq C++ you are using

              -  The hardware system you are using, such as a model
                 number

              -  A very brief description of the problem (one
                 sentence if possible)

              -  How critical the problem is

              When you submit information electronically or are
              speaking on the phone to the appropriate Compaq C++
              support specialist, you can provide more detailed
              information. The information should include the
              specific commands used to compile and link the
              program, the error messages displayed, and relevant

     D-2 Recovering from Errors

 






                 detailed information (possibly including source program
                 listings). Please attempt to narrow the cause of the
                 problem to a specific module or lines of code.

                 CSC personnel might ask for additional information,
                 such as listings of any command files, INCLUDE and
                 COPY files, relevant data files, and so forth. If
                 the program is longer than 50 lines, submit a copy
                 of it electronically or provide machine-readable media
                 (floppy diskette or magnetic tape).

              o  If the problem is related to Compaq C++ documentation,
                 you can report the problem to the CSC (if you have a
                 Software Product Services Support Agreement and the
                 problem is severe); otherwise, send your comments about
                 Compaq C++ documentation to the following Internet
                 address:

                 compaq_cxx@compaq.com


























                                              Recovering from Errors D-3
