             C                      HP_C++________________________________________ 9                      Installation Guide for OpenVMS Alpha   .                      Order Number: AA-PY27K-TE    "                      November 2005  G                      This guide contains instructions for installing HP G                      C++ on OpenVMS Alpha systems. It also explains how E                      to read the online release notes before or after ,                      installing the product.  A                      This guide applies to HP C++ Version 7.1 for E                      OpenVMS Alpha, and all subsequent point releases %                      for Version 7.0.           C                      Revision/Update Information: This is a revised C                                                   manual, replacing =                                                   AA-PY27J-TE   G                      Operating System & Version:  OpenVMS Alpha Version B                                                   7.3-2 or higher.D                                                   Future maintenance@                                                   releases might@                                                   require higher;                                                   versions.   D                      Software Version:            HP C++ Version 7.1C                                                   for OpenVMS Alpha               ,                      Hewlett-Packard Company*                      Palo Alto, California                 E            __________________________________________________________   E             Copyright 2005 Hewlett-Packard Development Company, L.P.   @            Confidential computer software. Valid license from HPC            required for possession, use or copying. Consistent with ?            FAR 12.211 and 12.212, Commercial Computer Software, B            Computer Software Documentation, and Technical Data forE            Commercial Items are licensed to the U.S. Government under 0            vendor's standard commercial license.  @            The information contained herein is subject to change>            without notice. The only warranties for HP products=            and services are set forth in the express warranty >            statements accompanying such products and services.@            Nothing herein should be construed as constituting anD            additional warranty. HP shall not be liable for technical=            or editorial errors or omissions contained herein.   0            This document is available on CD-ROM.              Printed in the U.S.  E                                                                ZK6036   @            This document was prepared using DECdocument, Version            3.3-1n.                               C    ________________________________________________________________   C                                                            Contents     C    Preface..................................................      v     '    1  Preparing for HP C++ Installation   C          1.1   Hardware Requirements........................    1-1 C          1.2   Required Operating System Components.........    1-1 C          1.3   Optional Software............................    1-2 C          1.4   License Registration.........................    1-2 C          1.5   Installation Procedure Requirements..........    1-3 C          1.5.1     Process Privileges.......................    1-3 C          1.5.2     Process Account Quotas...................    1-3 C          1.5.3     System Parameters........................    1-4 C          1.5.4     Disk Space...............................    1-5 C          1.5.5     Backing Up Your System Disk..............    1-5 0          1.5.6     Additional System MaintenanceC                    Procedures...............................    1-5 C          1.5.6.1     Checking System Parameter Values.......    1-6 6          1.5.6.2     Calculating the Values for GlobalC                      Pagelets and Global Sections...........    1-6 :          1.5.6.3     Changing System Parameter Values withC                      AUTOGEN................................    1-7 5          1.5.6.4     Setting Dynamic System Parameter C                      Values.................................    1-8   $    2  Installing the HP C++ Compiler  5          2.1   Installing and Using Multiple Compiler C                Versions.....................................    2-1 8          2.1.1     Displaying and Selecting the CompilerC                    Version..................................    2-2 C          2.1.2     Installation Procedure Changes...........    2-4 C          2.2   Installation Procedure.......................    2-5   C                                                                 iii                  E            2.3   Error Recovery...............................   2-13           3  After C++ Installation  6            3.1   Running the Installation VerificationE                  Procedure Separately.........................    3-2 E            3.2   Editing and Organizing the System Files......    3-2 E            3.3   VMScluster Considerations....................    3-2 E            3.4   User Account Requirements....................    3-2 E            3.4.1     User Privileges..........................    3-3 E            3.4.2     User Account Quotas......................    3-3 ;            3.5   Installing the HP C++ Compiler and the C++ E                  Class Library as a Shared Image..............    3-3 E            3.6   Removing the Compiler from Your System.......    3-5 E            3.7   Getting Help and Reporting Problems..........    3-5   (      A  Sample C++ Compiler Installation  &      B  Files Installed on Your System          C  Recovering from Errors  E            C.1   Failures During HP C++ Installation..........    C-1 E            C.2   Problems During HP C++ Use...................    C-2   
      Examples   :            A-1       Sample HP C++ Installation on OpenVMSE                      Alpha Version 8.2........................    A-2         Tables   E            1         Conventions..............................    vii   6            1-1       Process Quotas for the InstallingE                      Account..................................    1-3   6            1-2       Minimum Required System ParameterE                      Values...................................    1-4   E            1-3       Disk Space Requirements..................    1-5   E            B-1       Files Installed or Modified..............    B-1         iv                            H         ________________________________________________________________  H                                                                  Preface      G               This guide describes how to install HP C++ on the OpenVMS ?               Alpha operating system. It is intended for system C               managers. Keep this guide with your distribution kit, E               in case you need it to reinstall HP C++ for any reason.   B               You may send comments or suggestions concerning thisF               guide, or any HP C++ document, by electronic mail to the)               following Internet address:                     c_docs@hp.com           Document Structure  F               This guide contains three chapters and three appendixes:  >               o  Chapter 1 describes how to prepare for HP C++                  installation.  H               o  Chapter 2 describes how to install the HP C++ compiler.  A               o  Chapter 3 describes postinstallation procedures.   A               o  Appendix A shows a sample compiler installation.   D               o  Appendix B explains how to find a list of the files*                  installed on your system.  A               o  Appendix C provides information to help you with                   failures.          H                                                                        v                       Associated Documentation   B            In addition to this guide, the HP C++ 7.1 documentation,            set includes the following books:  C            o  Stroustrup, Bjarne. The C++ Programming Language, 3rd D               Edition. Reading, Massachusetts: Addison-Wesley, 1997.D               This book is available only as hardcopy documentation.  ,            o  Using HP C++ for OpenVMS Alpha  >            o  C++ Class Library Reference Manual (online only)  E            o  C Run-Time Library Reference Manual for OpenVMS Systems   B            For information on the HP C++ online release notes, see            Chapter 1.   D            For general information on OpenVMS system management, see:            the OpenVMS operating system documentation set.  @            For help understanding OpenVMS system error messages,B            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.   H               Table_1_Conventions_______________________________________  H               Convention________________Meaning_________________________  D               UPPERCASE TEXT            Uppercase text indicates theB                                         name of a command, a file,D                                         a parameter, a procedure, or0                                         utility.  H               $ @SYS$UPDATE:VMSINSTAL   In interactive examples, promptsD                                         or displayed text appears inD                                         a monospace font. User inputG                                         appears in bold monospace font.   G               italic type               Italic type indicates important G                                         information, complete titles of H                                         manuals, or variables. VariablesG                                         include information that varies B                                         in system output (InternalG                                         error number), in command lines H                                         (/PRODUCER=name), and in commandD                                         parameters in text (where ddF                                         represents the predefined code=                                         for the device type).   B               <Return>                  In interactive examples, aE                                         key name is shown enclosed to H                                         indicate that you press a key on5                                         the keyboard.   @               Ctrl/X                    In interactive examples,A                                         a sequence such as Ctrl/X D                                         indicates that you must holdG                                         down the key labeled Ctrl while B                                         you press another key or aC                                         pointing device button; for B                                         example, Ctrl/C or Ctrl/Z.  H                                                 (continued on next page)    H                                                                      vii                 E            Table_1_(Cont.)_Conventions_______________________________   E            Convention________________Meaning_________________________   B            [YES]                     Square brackets indicate thatC                                      the enclosed item is a default A                                      value in a VMSINSTAL prompt. C                                      Also, square brackets serve as D                                      delimiters for a directory nameE            __________________________in_a_file_specification.________   B            In this manual, some version numbers are given as Vn.n.C            When you install HP C, the actual version numbers appear             on your screen.                                                              	      viii                        H                                                                        1H         ________________________________________________________________  H                                        Preparing for HP C++ Installation      F               This chapter discusses the preparations and requirementsH               necessary for installing HP C++ for OpenVMS Alpha Systems.  E               This guide applies to Version 7.1 of HP C++ for OpenVMS C               Alpha Systems and all subsequent maintenance releases D               up to the next release of the product that includes an)               updated installation guide.   D               Your bill of materials (BOM) and indented bills reportB               (BIL) specify the number and contents of your media.B               Be sure to verify the contents of your kit with thisE               information. If your kit is damaged or if you find that F               parts of it are missing, contact your HP representative.  D               HP C++ provides online release notes, which are copiedE               to SYS$HELP during installation. HP strongly recommends H               that you read the release notes before proceeding with theC               installation. For information on accessing the online B               release notes for the HP C++ compiler, see step 2 in               Section 2.2.  !         1.1 Hardware Requirements   B               You can install HP C++ on any Alpha processor systemG               capable of running OpenVMS Alpha Version 7.3-2 or higher. A               See the OpenVMS Operating System's Software Product 5               Description (SPD 25.01.nn) for details.   0         1.2 Required Operating System Components  C               HP C++ Version 7.1 for OpenVMS Alpha Systems requires B               OpenVMS Alpha Version 7.3-2 or higher. Future HP C++A               releases may require higher versions of the OpenVMS H               operating system, as described in the online release notesG               or the Read Before Installing or Using HP C++ Version 7.n )               for OpenVMS Systems letter.   H                                    Preparing for HP C++ Installation 1-1                 ?            The OpenVMS operating system comes with a variety of E            support options, or classes. Classes include such features @            as networking and RMS journaling. To use HP C++, yourC            system should be running a version of OpenVMS Alpha that *            includes the following classes:  !            o  Programming support               o  Utilities   B            For a complete list of the required classes, see the HP2            C++ Software Product Description (SPD).        1.3 Optional Software  C            You can use the following optional software with HP C++:   ?            o  HP Language-Sensitive Editor/Source Code Analyzer B               (LSE/SCA) for OpenVMS Alpha Systems. Support for C++C               requires that LSE be installed before the compiler is                installed.  =            o  HP Test Manager (DTM) for OpenVMS Alpha Systems   D            o  HP Performance and Coverage Analyzer (PCA) for OpenVMS               Alpha Systems   ?            o  HP Code Management System (CMS) for OpenVMS Alpha                Systems   A            o  HP Module Management System (MMS) for OpenVMS Alpha                Systems   >            For more information on HP DECset Release 12.4A for?            OpenVMS Alpha Systems, refer to the Software Product &            Description (SPD 42.29.nn).        1.4 License Registration   C            Before you start the installation, you must register and C            load the License Product Authorization Key (License PAK) D            using the OpenVMS License Management Facility (LMF). (ForA            complete information on using the LMF, see the OpenVMS .            License Management Utility Manual.)  *      1-2 Preparing for HP C++ Installation                 /         1.5 Installation Procedure Requirements   F               This section discusses settings that you should check toG               be sure that your system is ready for the installation of                 HP C++ to proceed.            1.5.1 Process Privileges  D               To install HP C++, you must be logged in to an accountC               that has SETPRV or at least the following privileges:                  o  CMKRNL                  o  WORLD                 o  SYSPRV   G               VMSINSTAL turns off BYPASS privileges at the start of the                installation.   $         1.5.2 Process Account Quotas  C               VMSINSTAL requires that the installation account have 3               minimum quotas as shown in Table 1-1.   H               Table_1-1_Process_Quotas_for_the_Installing_Account_______  H               Name________Quota_________________________________________                 ASTLM       190                  BIOLM       160                   BYTLM       99,000                 DIOLM       160                  ENQLM       4000  H               FILLM_______300___________________________________________  D               Use the OpenVMS Authorize Utility to verify and changeE               process quotas for the installation account in the user D               authorization file (UAF). (Some sites may restrict theF               use of the OpenVMS Authorize Utility to certain accountsE               or people.) For instance, to change the BYTLM quota for H               the account-name installation account, you might enter the)               following command sequence:   H                                    Preparing for HP C++ Installation 1-3                 %            $ RUN SYS$SYSTEM:AUTHORIZE 2            UAF> MODIFY account-name /BYTLM = 99000!            UAF> SHOW account-name             UAF> EXIT            $ LOGOUT   B            After the quotas for the installation account have beenB            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.   A            User account quotas are stored in the file SYSUAF.DAT. D            For more information on modifying account quotas, see theE            description of the Authorize Utility in the OpenVMS System (            Management documentation set.        1.5.3 System Parameters  @            Table 1-2 lists the minimum required system parameterA            values for the installation. Depending on the kinds of D            programs and applications running at your site, you might0            need higher values for some settings.  E            Table_1-2_Minimum_Required_System_Parameter_Values________   +                                     Minimum E            System_Parameter_________Value________Default_Value_______   4            CLISYMTBL[1]             500          500  5            GBLPAGES[2]              8400         8400   5            GBLPAGFIL                1024         1024   2            GBLSECTIONS[2]           2            2E            [1]The_CLISYMTBL_dynamic_system_parameter_must_be_set_to__   D            a minimum value of 500 during the installation procedure.D            You can change the setting to its original value once the$            installation is finished.>            [2]These values represent the number of free global8            pagelets and global sections required for theB            installation, not the total number you need to run your%            system and other software. E            __________________________________________________________   *      1-4 Preparing for HP C++ Installation                          1.5.4 Disk Space  D               Requirements for free disk storage space are differentC               during installation and after installation. Table 1-3 2               summarizes the storage requirements.  H               Table_1-3_Disk_Space_Requirements_________________________  >                                 Blocks After       Peak DuringH               Component_________Installation_______Installation_________  :               Compiler          150,000            160,000  9               Text Header       13,000             13,000                Files   6               CXXLINK           500                500  H               __________________________________________________________  H               All_Components____163,500____________173,500______________  H               To determine the number of free disk blocks on the currentA               system disk, enter the following command at the DCL                prompt:   )               $ SHOW DEVICE SYS$SYSDEVICE   )         1.5.5 Backing Up Your System Disk   B               At the beginning of the installation, VMSINSTAL asksC               if you have backed up your system disk. HP recommends E               that you back up your system disk before installing any                software.   D               Use the backup procedures that are established at yourG               site. For details on performing a system disk backup, see E               the section on the Backup Utility in the OpenVMS System +               Management documentation set.   6         1.5.6 Additional System Maintenance Procedures  D               This section explains how to use the System GenerationA               Utility (SYSGEN) and the AUTOGEN Utility to prepare E               your system for an installation of HP C++. AUTOGEN uses C               system configuration data to automatically set system                parameters.   H                                    Preparing for HP C++ Installation 1-5                 -      1.5.6.1 Checking System Parameter Values   C            To check the values of your system parameters, enter the             following command:   "            $ RUN SYS$SYSTEM:SYSGEN            SYSGEN>  C            At the SYSGEN> prompt, enter the SHOW command to display A            the value of a system parameter. The following example =            displays the value for the WSMAX system parameter:               SYSGEN> SHOW WSMAX   E            Parameter Name   Current   Default    Min.  Max.      Unit E            --------------   -------   -------    ----  -------   ---- I            WSMAX              81920      4096    1024  1048576   Pagelets F             internal value     5120       256      64    65536   Pages  E            After checking the parameters with the SHOW command, enter B            the EXIT command at the SYSGEN> prompt to return to DCLE            level. For information on setting dynamic system parameter '            values, see Section 1.5.6.4.   B      1.5.6.2 Calculating the Values for Global Pagelets and Global              Sections   C            To install and run HP C++, you must have sufficient free C            global pagelets and global sections. You must first find E            out how many free global pagelets and sections you have on D            your system. Then use AUTOGEN if you need to increase theA            global pagelets and global sections system parameters.   E            Enter the following DCL command to determine the number of A            global pagelets required by SYS$LIBRARY:DCLTABLES.EXE:   5            $ DIRECTORY/SIZE SYS$LIBRARY:DCLTABLES.EXE   R            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.  B            You can use the WRITE command with the F$GETSYI lexicalB            function to find the number of free global pagelets and>            global sections. The following example shows how toA            get this information at your terminal (the default for             SYS$OUTPUT):   *      1-6 Preparing for HP C++ Installation                 <               $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES")               15848 :               $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")               24  D               If the values displayed by the system are greater thanF               the values in Table 1-2, you do not need to increase theF               values for these parameters. If the value of free globalC               pagelets or global sections is less than the value in H               Table 1-2, you must increase the system parameter setting.  E               Section 1.5.6.3 describes the procedures for increasing )               these values using AUTOGEN.   =         1.5.6.3 Changing System Parameter Values with AUTOGEN   @               Use the AUTOGEN command procedure to change systemB               parameters. AUTOGEN automatically adjusts values forF               parameters that are associated with the values you resetF               manually. To change system parameters with AUTOGEN, edit!               the following file:   &               SYS$SYSTEM:MODPARAMS.DAT  E               Use an editor to access the file. To change a parameter A               value listed in this file, delete the current value E               associated with that parameter and enter the new value.   A               To add a new parameter, add a line to the file that D               includes both the name of the parameter and its value.               For example:                 WSMAX = 8096  B               To modify incremental parameters such as free globalD               pagelets and global sections, use ADD_GBLPAGES or ADD_G               GBLSECTS. The following example increases the global page                setting by 2000:  !               ADD_GBLPAGES = 2000   G               When you set the page file quota, do not use a value that D               exceeds the amount of page file space available on the               system.   H                                    Preparing for HP C++ Installation 1-7                 D            After you make all your changes, exit from the editor andC            execute the AUTOGEN procedure to recalculate your system E            parameters. The following command recalculates your system -            parameters and reboots the system:   /            $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT   A            When you specify REBOOT, AUTOGEN performs an automatic A            system shutdown and then reboots the system. Any users ?            logged on to the system are immediately disconnected A            during the shutdown. The automatic reboot puts the new (            parameter values into effect.  ;            AUTOGEN automatically adjusts some of the SYSGEN E            parameters based on the consumption of resources since the D            last reboot. If you do not want to take advantage of thisE            automatic adjustment, include the /NOFEEDBACK qualifier on $            the AUTOGEN command line.  C            For more information about using AUTOGEN, see the system >            management documentation for your operating system.  4      1.5.6.4 Setting Dynamic System Parameter Values  C            Use SYSGEN to set dynamic parameters. Dynamic parameters >            changed with the SYSGEN command WRITE ACTIVE becomeE            active immediately without any need to reboot your system. E            Rebooting returns dynamic system parameter values to their             previous settings.   D            After you change the dynamic parameter values, you shouldA            complete the installation before rebooting the system. ?            After you finish the installation, you can reset the E            dynamic parameters to their previous values or let them be C            reset automatically when you reboot your system the next             time.  B            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 example0            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 HP C++ Installation                       H                                                                        2H         ________________________________________________________________  H                                           Installing the HP C++ Compiler      K               After you register and load the License Product Authorization H               Key (License PAK), the installation takes approximately 10G               to 15 minutes, depending on your system configuration and (               the kit components chosen.  ;         2.1 Installing and Using Multiple Compiler Versions   G               C++ Version 7.1 provides support for installing and using A               multiple versions of the compiler on the same node.   B               During installation of Version 7.n, if a Version 6.n@               of the compiler is already installed, you have the?               opportunity to preserve that compiler rather than C               overwrite it. If you choose to preserve the currently E               installed compiler, you are then given a choice to keep H               the currently installed compiler as the system default and7               install the new compiler as an alternate.   A               By default, the currently installed system compiler A               is preserved by making it an alternate compiler and F               installing the new compiler as the system default. UsersF               can make the choice to use an alternate compiler insteadC               of the installed system compiler by running a command H               procedure that changes the behavior of the cxx command for*               the process that invokes it.  G               Some details of the following description may change, but 6               the mechanism is essentially as follows.              H                                       Installing the HP C++ Compiler 2-1                 8      2.1.1 Displaying and Selecting the Compiler Version  B            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  D               This procedure displays the C++ compilers available onC               the system, along with their version numbers. It also D               displays which compiler is the default for the currentE               process. The procedure takes an optional version-number !               argument. Examples:   1               $ @sys$system:cxx$show_versions.com   <               The following C++ compiler(s) are available in               SYS$SYSTEM:   3               Filename                      Version 5               --------------------------------------- 3               CXX$COMPILER.EXE             V6.5-020 3               CXX$COMPILER_V06_04-002.EXE  V6.5-002 3               CXX$COMPILER_V06_04-001.EXE  V6.5-001 F               CXX$COMPILER_V06_00-001.EXE  V6.0-001    Process Default3               CXX$COMPILER_V06_02-008.EXE  V6.2-008   6               $ @sys$system:cxx$show_versions.com V6.0  <               The following C++ compiler(s) are available in               SYS$SYSTEM:   3               Filename                      Version 5               --------------------------------------- F               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 A               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 B               system compiler, which is the one displayed with theB               filename CXX$COMPILER.EXE in the output of CXX$show_A               versions.com. Alternate compilers are shown in that_E               output with their version number appended to the simple   '      2-2 Installing the HP C++ Compilerr m  :            G                  filename; for example, the version 6.2-008 compiler isd6                  shown as CXX$COMPILER_V06_02-008.EXE.  B                  To select a compiler, pass a full ident string orF                  enough of the ident string to be unique. For example:B                  to select the V6.2-008 compiler from the previousG                  list, pass V6.2-008 or V6.2 to the CXX$set_version.comaC                  routine. However, to select a 6.5 compiler, a fullnD                  ident string is required to distinguish between the?                  V6.5-020, V6.5-001, and the V6.5-002 compiler:   2         $ @sys$system:cxx$set_version.com V6.2-008           $ show logical CXX$*           (LNM$PROCESS_TABLE)g             "CXX$COMPILER" =4             "SYS$SYSTEM:CXX$COMPILER_V06_02-008.EXE"           "CXX$MSG_SHR" = 4             "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-020V-         CXX$COMPILER_V06_04-001.EXE  V6.5-001 -         CXX$COMPILER_V06_04-002.EXE  V6.5-002   W         Ambiguous version number, please be specify a full version number, ex: V6.5-020 !         Version number : V6.5-020_  #         $ show logical CXX$COMPILER_W           "CXX$COMPILER" = "SYS$SYSTEM:CXX$COMPILER_V06_04-005.EXE" (LNM$PROCESS_TABLE) "         $ show logical CXX$msg_shrV           "CXX$MSG_SHR" = "SYS$MESSAGE:CXX$MSG_SHR_V06_04-005.EXE" (LNM$PROCESS_TABLE)  H                  When this procedure is run in a process, subsequent cxxE                  commands invoke the selected compiler version (until H                  the procedure is run again). The process-level logicalsC                  used do not affect other processes or users on thea                  system.  2               o  SYS$SYSTEM:CXX$DELETE_VERSION.COM  H                                       Installing the HP C++ Compiler 2-3 s  r            ?               This procedure removes the C++ compilers from the D               system. The procedure takes an optional version-number:               argument, as shown in the following example:  7               $ @sys$system:cxx$delete_version V6.5-001n  S               The following V6.5-001 HP C++ compiler(s) are available in SYS$SYSTEM.  3               Filename                      Version 5               ---------------------------------------a4               CXX$COMPILER_V06_05-001.EXE   V6.5-001  2               Really delete these compiler(s)? yes&               Deleting HP C++ V6.5-001  B               Deleting SYS$COMMON:[CXX$LIB]CXX$CLD_V06_05-001.CLD;G               Deleting SYS$COMMON:[SYSEXE]CXX$COMPILER_V06_05-001.EXE;1.K               Deleting SYS$COMMON:[SYSMSG]CXX$COMPILER_MSG_V06_05-001.EXE;1wC               Deleting SYS$COMMON:[SYSEXE]CXX$LINK_V06_05-001.EXE;1iG               Deleting SYS$COMMON:[SYSMSG]CXX$LINK_MSG_V06_05-001.EXE;1 G               Deleting SYS$COMMON:[SYSEXE]CXX$DEMANGLE_V06_05-001.EXE;1sH               Deleting SYS$COMMON:[SYSLIB]CXXL$ANSI_DEF_V06_05-001.TLB;1D               Deleting SYS$COMMON:[SYSLIB]LIBCXXSTD_V06_05-001.OLB;1F               Deleting SYS$COMMON:[CXX$LIB]CXXDEMANGLE_V06_05-001.CLD;B               Deleting SYS$COMMON:[CXX$LIB]CXXLINK_V06_05-001.CLD;  )      2.1.2 Installation Procedure Changes   A            When you install C++ Version 7.1 or higher on a system <            that already has a Version 6.0 or higher compiler>            installed, you are given the chance to preserve theB            currently installed system compiler. To do this, answerE            YES to the following question (the xxx will be replaced by6D            the full version number of the existing system compiler):  G            "Should the existing xxx system compiler be preserved [NO]:"t  =            If you answer NO, the installation proceeds in the.B            traditional manner, overwriting the currently installed            system compiler.   >            If you answer YES, you are then asked an additionalB            question. To get the traditional behavior of installingC            the kit compiler as the system default, answer NO to the.            question:  W            "Should this xxx system compiler remain the default when cxx is typed [NO]:".  '      2-4 Installing the HP C++ Compiler  1               H               Because you have previously asked to preserve the existingA               system compiler, that compiler is made an alternate B               compiler before the new system compiler is installedF               from the kit. If you answer YES to the question, the kitC               compiler is installed as an alternate compiler with atF               name that is based on its ident, and the existing system3               default compiler remains the default.z  "         2.2 Installation Procedure  C               If it is not already inserted, place the compact disc 3               (CD-ROM) media into the CD-ROM drive..  D               To abort the installation procedure at any time, pressG               Ctrl/Y. When you press Ctrl/Y, the installation procedure.C               deletes all files it has created up to that point and ?               exits. You can then start the installation again..  F                 ________________________Note  ________________________  @                 The kit installation procedure invokes a utilityA                 program to manipulate header file text libraries. C                 Attempts to abort the installation might be ignored @                 while the program is executing. If the procedureA                 does not abort immediately, press Ctrl/Y until it.                 does.e  E                 _____________________________________________________   D               When the system prompts you with a question during theH               installation procedure, the default answer is often listed               in brackets ([]).o  D               1. Log in to a privileged account and set your default4                  device and directory to SYS$UPDATE.  "                   Username: SYSTEM                   Password:.  "               2. Invoke VMSINSTAL.  K                  @SYS$UPDATE:VMSINSTAL saveset-name device-name option-list       H                                       Installing the HP C++ Compiler 2-5                 E               To start the installation, invoke the VMSINSTAL command_E               procedure from a privileged account, such as the SYSTEM D               account. VMSINSTAL is in the SYS$UPDATE directory. TheE               elements that you specify when you invoke the VMSINSTAL /               command procedure are as follows:p                 saveset-nameB               The installation name for the component. For HP C++,2               use the following installation name:                 CXX07n  B               n represents the minor (point) release number for HP1               C++ such as CXX071 for Version 7.1.s  E               To obtain the directory location of the HP C++ save set B               on the CD-ROM, refer to the Software Product LibraryB               CD-ROM User's Guide booklet that accompanies the CD-D               ROM distribution kit, or before starting installation,#               complete these steps:   A               a. To determine whether the CD-ROM drive is already <                  mounted (with the MOUNT command), enter the#                  following command:x  &                  $ SHOW DEVICE DKA400:  B               b. If it is not mounted, enter the appropriate MOUNT?                  command to mount the CD-ROM (omit the /FOREIGNe                  qualifier).  ?               c. To obtain the save-set name, enter a DIRECTORY ?                  command specifying the directory file from then"                  previous command:  8                  $ DIRECTORY DKA400:[CXX07n.KIT]CXX07n.A  :                  n represents the minor release of HP C++.                 device-nameRC               The name of the device on which you plan to mount the @               media and the directory containing the HP C++ saveB               set. For example, DKA400: is the device name used in@               examples in this guide. The directory is [CXX07n],2               where n is the minor release number.  '      2-6 Installing the HP C++ Compilere s               E                  To specify the device name on the @VMSINSTAL commandg                  line, enter:V                     DKA400:[CXX07n]                    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)  G                     Initially creates a file that contains your answers H                     to VMSINSTAL questions and prompts. You can then useH                     the option (and the answer file) to save time duringD                     a reinstallation (typically after upgrading your                     system).  +                  o  Get save-set option (G)i  E                     Lets you store product save sets temporarily on aa9                     magnetic tape or in a disk directory.,  '                  o  File log option (L)   F                     Logs all activity to the terminal during installa-                     tion.   :                  o  Display or print the release notes (N)  C                     Indicates that you want to see the installationpD                     question on release notes. If you do not includeB                     the N option, VMSINSTAL does not ask you aboutD                     the release notes. You should review the releaseD                     notes before proceeding with the installation inF                     case they contain additional information about the!                     installation.   C                     If you are restarting the installation and have G                     already reviewed the release notes, you do not need D                     to specify the N option. (Even if you omit the NH                     option when you invoke VMSINSTAL, the HP C++ releaseB                     notes are copied automatically to the SYS$HELP                     directory.)   -                  o  Alternate root option (R)   G                     Lets you install the product to a system root other 4                     than that of the running system.  H                                       Installing the HP C++ Compiler 2-7                 E               For detailed information on these software installationeB               options, see the OpenVMS operating system documenta-E               tion. If you specify more than one option, separate them7               options with commas, such as OPTIONS A,N.e  C               The following example invokes VMSINSTAL to install HPrB               C++ and shows the system response. This example uses0               the OPTIONS N release note option.  F               $ @SYS$UPDATE:VMSINSTAL CXX07n DKA400:[CXX07n] OPTIONS N  N                     OpenVMS Alpha Software Product Installation Procedure V8.2  )               It is dd-mmm-yyyy at hh:mm. =               Enter a question mark (?) at any time for help._  A               If you do not supply either the product name or the_E               device name, VMSINSTAL prompts you for this information 2               later in the installation procedure.  /            3. Verify user's account and quotas.   A               When you invoke VMSINSTAL, it checks the following:   C               o  Whether you are logged in to a privileged account. A                  HP recommends that you install software from the_B                  system manager's account with your default device1                  and directory set to SYS$UPDATE.   C               o  Whether you have adequate quotas for installation.a?                  VMSINSTAL checks for the quota values shown in                   Table 1-1.   B               VMSINSTAL then checks to determine whether any users>               are logged in to the system. If users are loggedA               in, VMSINSTAL asks whether you want to continue the                installation:e  9               * Do you want to continue anyway [NO]?  YESt  E               If you want to continue, enter YES. If you want to stopo-               the installation, press Return.   $            4. Confirm system backup.  L               * Are you satisfied with the backup of your system disk [YES]?  '      2-8 Installing the HP C++ Compiler     t            D                  If you are satisfied with the backup of your systemG                  disk, press Return. Otherwise, enter NO to discontinuetF                  the installation. After you back up your system disk,2                  you can restart the installation.  &               5. Specify distribution.  H                  If you omitted the device name on the VMSINSTAL command4                  line, the following prompt appears:  R                  * Where will the distribution volumes be mounted: DKA400:[CXX07n]  >                  If this prompt appears, enter the name of theH                  distribution (media) device and directory that containsH                  the HP C++ kit (save set). For example, if the media isE                  contained on a CD-ROM located on unit DKA400:, enter F                  DKA400:[CXX07n] in reply to this question (where n is+                  the minor version number).   "               6. Specify save set.  @                  If you omitted the product save set name on theF                  VMSINSTAL command line, the following prompt appears:  [                  Enter the products to be processed from the first distribution volume set.f#                  * Products: CXX07n   H                  If this prompt appears, enter the C++ for OpenVMS AlphaF                  kit name. The name has the format: CXX07n (where n is+                  the minor version number).r  4               7. Verify the product being installed.  ;                   The following products will be processed:m                       CXX V7.n  B                       Beginning installation of CXX V7.n  at hh:mm  I                     %VMSINSTAL-I-RESTORE, Restoring product save set A...   F                  The product name and version are displayed. This saveF                  set (A) is restored to a subdirectory of SYS$UPDATE:.  G                  Next, VMSINSTAL displays a message like the following:   H                                       Installing the HP C++ Compiler 2-9 t  t            Y               %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.d    6                  HP C++ V7.n for OpenVMS Alpha Systems  D               The release notes are copied to the following files in%               the SYS$HELP directory:S  (               SYS$HELP:CXX.RELEASE_NOTES+               SYS$HELP:CXX_RELEASE_NOTES.PS   A               After the installation, you can enter the following ?               command to view the location of the release noteso(               through the Help facility:  &               $ HELP CXX RELEASE_NOTES  C            8. Choose the Installation Verification Procedure optiona  C               If you have chosen to install the compiler component, D               the installation procedure now asks if you want to runD               the Installation Verification Procedure (IVP). The IVPD               checks to be sure that the installation is successful.1               HP recommends that you run the IVP.   H               * Do you want to run the IVP after the installation [YES]?  <               After HP C++ is installed, you can run the IVPD               independently to verify that the software is availableC               on your system. You might need to run the IVP after aiB               system failure to make sure that users can access HP               C++.  *            9. Select components to install  <               The installation procedure lets you select theA               components of the kit that you want to install. Theo%               choices are as follows:m                 o  C++ compiler   ;                  This component includes help text, commandv;                  definitions, and the IVP for the compiler.   E               o  C Run-Time Library and C++ Class Library text header                   files  (      2-10 Installing the HP C++ Compiler                 B                     For efficiency, the header files are installed@                     on the system in text library format, withinE                     SYS$LIBRARY. However, this creates a problem whenaB                     users need to use the headers as reference. ToD                     remedy this, the installation procedure will nowC                     prompt you to install a "reference copy" of the_E                     text headers. These are in traditional text form,LF                     and are suitable for searching, lookup, and so on.G                     When selected, the procedure will break them up and_C                     install them into the following subdirectories:h  ?                     SYS$COMMON:[CXX$LIB.REFERENCE.CXXL$DEF_HXX]c=                     SYS$COMMON:[CXX$LIB.REFERENCE.CXXL$DEF_H] A                     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.a  F                 ________________________Note  ________________________  =                 The header files (text libraries) are now au-r>                 tomatically installed based on the time stampsB                 found within them. Time stamps on the kit versions@                 are compared to those on the system, and the kitD                 libraries are installed only if they are found to beB                 more recent. All of this occurs without prompting.  E                 _____________________________________________________o  $                  o  CXXLINK facility  G                  Select the components you want to install by answeringUH                  YES or NO to the questions. If you want a more detailedD                  description of any component, enter a question markE                  (?). After the explanation is displayed, you will bea/                  prompted again for a response.m  G                  If you enter YES, the installation procedure validatesn?                  that your request is possible and installs thea                  component.   H                  If you enter NO, the installation procedure then issues:                  prompts for selecting the next component.  6              10. Respond to license registration query  H                                      Installing the HP C++ Compiler 2-11    0            @               The HP C++ compiler component supports the OpenVMS>               License Management Facility (LMF). (For completeC               information on using the LMF, see the OpenVMS LicenseB?               Management Utility Manual.) If you entered YES tom>               install the compiler component, the installationB               procedure displays license information about HP C++.A               It asks whether you have registered and loaded youre?               PAK for each product. The following is an exampleeA               of the information and the queries presented by thee%               installation procedure:t  B                   The HP C++ compiler component requires a ProductI                   Authorization Key (PAK) for HP C++ to be registered and K                   loaded.   Answer the following question with YES if a PAKsH                   with the specified product name and a date equal to orO                   later than the date shown is registered and loaded, otherwise                    answer NO.  '                     Product:      CXX-V %                     Producer:     DECt  %                     Version:      7.nn  -                     Release Date: dd-mmm-yyyy_  J               * Does this product have an authorization key registered and               loaded?: YES  A               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 installationoD               successfully. If you have not done so, you should stopE               the installation, register and load your PAKs, and then '               restart the installation.d  )           11. Read informational messages   B               At this point, the installation procedure displays aA               number of informational messages that report on the @               progress of the installation. There are no further?               questions. If the installation procedure has beensB               successful up to this point, VMSINSTAL moves the newD               or modified files to their target directories, updatesC               help files, and updates DCL tables, if necessary. See E               Appendix B for a list of files installed on the system.   (      2-12 Installing the HP C++ Compiler .               C                  If you answered YES in response to the prompt thatoG                  requests a file purge, previous versions of the HP C++TE                  files are now purged. The end of the installation is 4                  indicated by the following message:  P                  %VMSINSTAL-I-MOVEFILES, files will now be moved to their target7                                          directories...1                 12. Observe the IVP  G                  If you chose to run the IVP, VMSINSTAL now invokes therF                  IVP to verify that HP C++ was installed successfully.  G                  If HP C++ was installed successfully, the IVP displaysN                  the following:t  X                  HP C++ V7.n Installation Verification Procedure completed successfully.  /              13. End the installation procedure   =                   Installation of CXX V7.n completed at hh:mmu  O                      Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY-  V                      Creating installation data file: VMI$ROOT:[SYSUPD]CXX07n.VMI_DATA  E                  Depending on whether you specified parameters on the6F                  VMSINSTAL command line, the * Products: prompt or theE                  DCL prompt ($) may appear. If the * Products: prompttF                  appears, you can return to the DCL prompt by pressing                  Ctrl/Z.  G                  If you removed any media from the console drive beforelG                  beginning the installation, you should replace it now.   D                  VMSINSTAL deletes or changes entries in the processB                  symbol tables during the installation. Therefore,D                  if you are going to continue using the installationG                  account (such as SYSTEM) and you want to restore thesea>                  symbols, you should log out and log in again.           2.3 Error Recovery  H               If VMSINSTAL detects any problems during the installation,B               it notifies you and asks if you want to continue theC               installation. In some instances, you can enter YES toRH               continue. To stop the installation process and correct theF               situation, enter NO or press Return. Correct the problem+               and restart the installation.c  H                                      Installing the HP C++ Compiler 2-13    g            A            If errors occur during the installation itself or whentD            the Installation Verification Procedure (IVP) is running,C            VMSINSTAL displays failure messages. If the installation 5            fails, you will see the following message:   ;            %VMSINSTAL-E-INSFAIL, The installation of HP C++F&                Version 7.n has failed.  9            If the IVP fails, you will see these messages:h  .            The HP C++ Version 7.n Installation-                Verification Procedure failed.f  3            %VMSINSTAL-E-IVPFAIL, The IVP for HP C++ &                Version 7.n has failed.  A            Errors can occur during the installation if any of thee&            following conditions exist:  8            o  The operating system version is incorrect.  ;            o  A prerequisite software version is incorrect.   >            o  Quotas necessary for successful installation are               insufficient.r  E            o  System parameter values for successful installation aret               insufficient.a  ;            o  The OpenVMS Help library is currently in use.   E            o  The product license has not been registered and loaded.   D            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 appropriateA            action as described in the message. For information onh4            installation requirements, see Chapter 1.  B            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 A            and Recovery Procedures Reference Manual or the online E            HELP/MESSAGE facility. If the installation fails due to anuC            IVP failure, contact an HP field service representative.e  (      2-14 Installing the HP C++ Compiler t                     H                                                                        3H         ________________________________________________________________  H                                                   After C++ Installation      E               HP C++ is now installed and can be invoked by all userso#               with the cxx command.   G               The installation procedure modifies the DCL command table B               so that the cxx command is recognized and processed.D               However, the previous command table is still in effectH               for those users who are currently logged in. All logged-inH               users who want to use the cxx command must log out and log9               in again, or use the following DCL command:y  9               $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLESt  B               The following tasks can be performed after HP C++ is               installed:  F               o  Running the Installation Verification Procedure (IVP)                  separatelyT  >               o  Editing the system startup and shutdown files  4               o  Modifying system parameter settings  :               o  Making the product usable on a VMScluster  ,               o  Setting user account quotas  :               o  Installing the compiler as a shared image  2               o  Removing the compiler, if desired  #               o  Reporting problemsn  D               The following sections describe these tasks in detail.    H                                               After C++ Installation 3-1 r  u            C      3.1 Running the Installation Verification Procedure Separatelya  B            You usually run the Installation Verification ProcedureB            (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  4            If the IVP fails, you see these messages:  E            The HP C++ 7.1 Installation Verification Procedure failed.c  C            %VMSINSTAL-E-IVPFAIL, The IVP for HP C++ 7.1 has failed.A  0      3.2 Editing and Organizing the System Files  >            You do not need to edit the compiler system startupE            (CCXX$STARTUP.COM) and shutdown files to provide for auto- C            matic startup and shutdown of HP C++ when your system is H            rebooted. You may optionally add SYS$STARTUP:CCXX$STARTUP.COMA            to the system startup procedure to install the images._  "      3.3 VMScluster Considerations  A            After completing the initial installation, if you wantf@            to install HP C++ on multiple nodes in a cluster, youD            must run INSTALL on each of the other nodes and enter the            following command:p  6            INSTALL>  REPLACE SYS$LIBRARY:DCLTABLES.EXE  >            If you are using a dual-architecture (VAX and AlphaA            systems) heterogeneous cluster, before executing thesepA            commands, make sure the appropriate logical names havetB            been set to define the scope of the SYSMAN DO commands.A            For more information, see the OpenVMS System Manager'sa            Manual.  "      3.4 User Account Requirements  D            Many products cannot be used unless certain privilege andE            quota requirements are met by user accounts. The following A            sections describe the privilege and quota requirementsn&            needed to work with HP C++.        3-2 After C++ Installationo l  a                     3.4.1 User Privilegest  G               To use HP C++, each account must have at least the TMPMBXaF               and NETMBX privileges. Use the OpenVMS Authorize UtilityA               to determine whether users have the privileges theyc               require.  !         3.4.2 User Account Quotasi  E               To use HP C++, a user account does not need to meet anyhH               special quota requirements. However, for users who will beH               compiling very large programs (many program units compiledC               together), consider adjusting the working set (WSDEF,lH               WSQUOTA, WSEXTENT) and pagefile (PGFLQUOTA) account quotas%               to improve performance.   F               See Section 1.5.2 for a description of how to verify and$               change account quotas.  G         3.5 Installing the HP C++ Compiler and the C++ Class Library as              a Shared Image  F               HP highly recommends that you reduce the system overheadG               and memory requirements by installing the HP C++ compilernD               and the C++ Class Library as shared images. To installD               HP C++ as a shared image on a system that is currentlyB               running, use the INSTALL Utility. HP recommends thatD               you install HP C++ as shared on a system that has beenB               rebooted recently because the available space in theC               global pagelet table is less likely to be fragmented.-  H               To install HP C++ and the Class Library as a shared image:  @               1. Determine the number of available (free) globalD                  pagelets and global sections on your system and theE                  number of each needed to install and run HP C++ (see "                  Section 1.5.6.2).  D               2. If necessary, increase the current number of globalO                  pagelets and global sections parameters (see Section 1.5.6.2).   E               After you reset the system parameter values, invoke the-G               INSTALL Utility from a privileged account and install the00               HP C++ compiler as a shared image:  H                                               After C++ Installation 3-3 s  g                        $ INSTALLA            INSTALL> ADD SYS$SYSTEM:CXX$COMPILER.EXE /OPEN /SHAREDo            INSTALL> EXIT  ?            Similarly, install the C++ Class Library as a sharedp            image:               $ INSTALLB            INSTALL> ADD SYS$LIBRARY:CXXL$011_SHR.EXE /OPEN /SHARED            INSTALL> EXIT  D            Add the following lines to the appropriate system startup?            command file so that HP C++ is available as a sharediC            image each time the system is started. (If your site hassB            modularized its startup procedures, be sure you add theB            lines to the correct file.) The default startup command1            file is SYS$MANAGER:SYSTARTUP_VMS.COM.r              $ INSTALL8            ADD SYS$SYSTEM:CXX$COMPILER.EXE /OPEN /SHARED9            ADD SYS$LIBRARY:CXXL$011_SHR.EXE /OPEN /SHARED-            EXIT   C            Using the /PRIVILEGED qualifier is neither necessary nor             recommended.t  D            To install the compiler message file, enter the following            commands:              $ INSTALL8            INSTALL> ADD SYS$MESSAGE:CXX$COMPILER_MSG.EXE            INSTALL> EXIT  ?            To install the Class Library message file, enter thet            following commands:              $ INSTALL4            INSTALL> ADD SYS$MESSAGE:CXXL$MSG_SHR.EXE            INSTALL> EXIT  =            When you install HP C++ as a shared image you need >            to increase the global pagelets and global sections=            parameters. See Section 1.5.6.2 for information onX%            changing these parameters.C        3-4 After C++ Installation     X            2         3.6 Removing the Compiler from Your System  H               A command procedure CXX$PRODUCT_REMOVE is available shouldA               you wish to remove the HP C++ compiler product from D               your system for any reason. The procedure performs the:               equivalent of a PCSI PRODUCT REMOVE command.  G               Before issuing the command procedure, you are required torG               disable the product license to prevent a compilation from 2               interfering with the delete process.  G               If the compiler has been installed as a shared image, the 9               command procedure will uninstall the image.M  F               The command procedure takes no parameters and can be run               as follows:   .               $ @SYS$SYSTEM:CXX$PRODUCT_REMOVE  I               Do you wish to proceed with removing HP C++ <No>? Yes [Ret]e  B               Enter "Yes" to remove the compiler from your system.  /         3.7 Getting Help and Reporting Problems   G               If an error occurs while HP C++ is in use and you believe G               the error is caused by a problem with the product, please3               report it to HP.  H               If you have a Software Product Services Support Agreement,E               contact your Customer Support Center (CSC) by telephonetA               or by using the electronic means provided with your:C               support agreement (such as DSNlink). The CSC providesHD               telephone support for high-level advisory and remedialF               assistance. When you initially contact the CSC, indicate               the following:  H               o  The name and version number of the operating system you                  are using  ;               o  The version number of HP C++ you are usingM  C               o  The hardware system you are using (such as a model:                  number)  D               o  A brief description of the problem (one sentence if                  possible)  ,               o  How critical the problem is  H                                               After C++ Installation 3-5 .  ;            C            Whether you submit information electronically or contact B            the appropriate support specialist by telephone, please$            take the following steps:  B            1. Describe as accurately as possible the circumstances@               and state of the system when the problem occurred.B               Include the description and version number of the HPC               C++ compiler being used. Demonstrate the problem withe                specific examples.  @            2. Reduce the problem to as small a size as possible.  @            3. Remember to include listings of any command files,B               INCLUDE files, or relevant data files, and so forth.  /            4. Provide a listing of the program.   C            5. If the program is longer than 50 lines, submit a copy C               of it on machine-readable media (diskette or magnetic                tape).  ;            6. Report only one problem per report. This willm+               facilitate a faster response.   ,            7. Mail the problem report to HP.  A            If the problem is related to HP C++ documentation, you D            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 HP C++;            documentation to the following Internet address:C              c_docs@hp.com  D            To obtain information about purchasing a Software Product@            Services Support Agreement or other support services,?            please contact your local HP sales representative ors            business partner.                    3-6 After C++ Installationt                       H                                                                        AH         ________________________________________________________________  H                                         Sample C++ Compiler Installation      E               This appendix contains a sample installation for the HPOF               C++ kit. It is only a sample. Sometimes the installationB               procedure is modified in maintenance updates of this               product.  D               Because this installation guide is not usually revisedE               for maintenance updates, be sure to read the applicableaF               Read Before Installing or Using HP C++ letter before youE               install this product. This letter notes any significantiA               changes to the installation sample shown here. SuchiC               information also appears in the online release notes.o  B               Depending on which layered products you have on yourE               system, you might see additional messages and questions 1               when you perform your installation._  H               This sample installation assumes that DECnet has been shutH               down, that no users are logged in to your system, and thatD               OPTIONS N is specified to print the release notes. TheG               Installation Verification Procedure (IVP) runs at the endt"               of the installation.  F               Example A-1 shows a sample installation of HP C++ 7.1 on2               an OpenVMS Alpha Version 8.2 system.                      H                                     Sample C++ Compiler Installation A-1                 B            Example A-1 Sample HP C++ Installation on OpenVMS Alpha"                        Version 8.2  "            $ @sys$update:vmsinstal  M                    OpenVMS Alpha Software Product Installation Procedure V8.2c  '            It is 16-June-2005 at 13:35.t  :            Enter a question mark (?) at any time for help.  K            * Are you satisfied with the backup of your system disk [YES]? Y   L            * Where will the distribution volumes be mounted: DKA400:[CXX071]  U            Enter the products to be processed from the first distribution volume set.             * Products: cxxA            * Enter installation options you wish to use (none): n1  4            The following products will be processed:                CXX V7.1+  >                    Beginning installation of CXX V7.1 at 13:35  A            %VMSINSTAL-I-RESTORE, Restoring product save set A ...iV            %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.  <                HP C++ Version V7.1 for OpenVMS Alpha Systems  G                Copyright 2005 Hewlett-Packard Development Company, L.P.U  Q                Confidential computer software. Valid license from HP required forOQ                possession, use or copying. Consistent with FAR 12.211 and 12.212,UQ                Commercial Computer Software, Computer Software Documentation, and V                Technical Data for Commercial Items are licensed to the U.S. Government:                under vendor's standard commercial license.  \            * Should this V7.1-001 system compiler remain the default when cxx is typed [NO]:T                The newly installed compiler will become the system default compiler.  L            * Do you want to purge files replaced by this installation [YES]?  E                                              (continued on next page)   )      A-2 Sample C++ Compiler Installationa u               G               Example A-1 (Cont.) Sample HP C++ Installation on OpenVMSh3                                   Alpha Version 8.2l  J                   This kit contains an Installation Verification ProcedureE                   (IVP) to  verify  the  correct  installation of the G                   HP C++ compiler component and  class library headers. (                   IVP will be placed in:  2                               SYS$TEST:CXX$IVP.COM  J                   After the  installation  is complete, you can invoke theE                   command file at any time to reverify that HP C++ is J                   installed and working correctly.   If you wish to invokeJ                   it automatically  at the completion of this installationB                   procedure, answer Yes to the following question.  J               * Do you want to run the IVP after the installation [YES]? Y  H                   The C Runtime Library, and C++ Class Library,  headersG                   will be installed as Text Libraries (.TLBs).   If youoH                   also wish to install the traditional text form  of theH                   headers (.H and .HXX  files) for  reference  purposes,H                   please answer yes to the following question.  The textH                   headers will be placed in a subdirectory that will notH                   be searched  by the compiler.   Instead, they  will be/                   placed the subdirectory tree:h  ;                           SYS$COMMON:[CXX$LIB.REFERENCE...]   F                   ( SYS$COMMON:[CXX$LIB.REFERENCE...] for the HP C RTLG                   header library, CXX$RTLDEF, and the system definitionn1                   header library, SYS$STARLET_C.)a  I                   Note that doing this may double the disk space used forl                   the headers.  N               * Do you want to install the text form of the headers?  [YES]? Y  B                   The HP C++ compiler component requires a ProductI                   Authorization Key (PAK) for HP C++ to be registered and K                   loaded.   Answer the following question with YES if a PAK H                   with the specified product name and a date equal to orO                   later than the date shown is registered and loaded, otherwise                    answer NO.  H                                                 (continued on next page)  H                                     Sample C++ Compiler Installation A-3    u            D            Example A-1 (Cont.) Sample HP C++ Installation on OpenVMS0                                Alpha Version 8.2  &                    Product:      CXX-V$                    Producer:     DEC  $                    Version:      7.1,                    Release Date: dd-mmm-2005  Q            * Does this product have an authorization key registered and loaded? YC  Q                All questions and validations regarding the installation of HP C++rV                kit components have now been asked.  Depending upon your configuration,E                time estimates for the installation(s) are as follows:y  4                Compiler/Linker/Library:   2  minutes4                Text form of headers:      4  minutes4                IVP:                       2  minutes4                Moving files:              6  minutes  M                You may optionally add the SYS$STARTUP:CCXX$STARTUP.COM to theWK                system startup procedure. To use HP C++ for OpenVMS Alpha onmS                other Alpha nodes of a VMScluster, from a privileged account on eachiS                such node enter the command "$ @SYS$STARTUP:CCXX$STARTUP.COM".  This #                will install images.o  J                The existing version of VMI$ROOT:[SYSLIB]DECC$RTLDEF.TLB isH                identical or newer than the one on this installation kit.E                Installation of the kit version will not be performed.e  O                Your OpenVMS system will now be updated to include the followingc(                new and modified file(s):  F                SYS$HELP:CXX.RELEASE_NOTES                        [new]F                SYS$HELP:CXX_RELEASE_NOTES.PS                     [new]F                SYS$TEST:CXX$IVP.COM                              [new]F                SYS$SYSTEM:CXX$DELETE_VERSION.COM                 [new]F                SYS$SYSTEM:CXX$SET_VERSION.COM                    [new]F                SYS$SYSTEM:CXX$SHOW_VERSIONS.COM                  [new]F                SYS$SYSTEM:CXX$COMPILER.EXE                       [new]F                SYS$MESSAGE:CXX$COMPILER_MSG.EXE                  [new]K                SYS$LIBRARY:DCLTABLES.EXE                         [modified].F                SYS$COMMON:[CXX$LIB]CXX$CLD.CLD                   [new]  E                                              (continued on next page)p  )      A-4 Sample C++ Compiler Installationi i  i            G               Example A-1 (Cont.) Sample HP C++ Installation on OpenVMSt3                                   Alpha Version 8.2d  I                   SYS$SYSTEM:CXX$COMPILER_V07_01-001.EXE            [new] I                   SYS$MESSAGE:CXX$COMPILER_MSG_V07_01-001.EXE       [new]lI                   SYS$COMMON:[CXX$LIB]CXX$CLD_V07_01-001.CLD        [new]o  N                   SYS$HELP:HELPLIB.HLB                              [modified]I                   SYS$SYSTEM:CXX$LINK.EXE                           [new] I                   SYS$MESSAGE:CXX$LINK_MSG.EXE                      [new]gI                   SYS$COMMON:[CXX$LIB]CXXLINK.CLD                   [new]m  I                   SYS$SYSTEM:CXX$LINK_V07_01-001.EXE                [new] I                   SYS$MESSAGE:CXX$LINK_MSG_V07_01-001.EXE           [new] I                   SYS$COMMON:[CXX$LIB]CXXLINK_V07_01-001.CLD        [new]   I                   SYS$SYSTEM:CXX$DEMANGLE.EXE                       [new] I                   SYS$COMMON:[CXX$LIB]CXXDEMANGLE.CLD               [new]s  I                   SYS$SYSTEM:CXX$DEMANGLE_V07_01-001.EXE            [new]lI                   SYS$COMMON:[CXX$LIB]CXXDEMANGLE_V07_01-001.CLD    [new]e  I                   SYS$HELP:[CXX$HELP]INTZLN.PDF                     [new]oI                   SYS$HELP:[CXX$HELP]IOSTREAM.PDF                   [new]rI                   SYS$HELP:[CXX$HELP]INTZLN.PS                      [new]gI                   SYS$HELP:[CXX$HELP]IOSTREAM.PS                    [new]tI                   SYS$HELP:[CXX$HELP]CXX_CLASSLIB.PS                [new]OI                   SYS$HELP:[CXX$HELP]CXX_USERSGUIDE.PS              [new] I                   SYS$HELP:[CXX$HELP]CXX_CLASSLIB.TXT               [new]eI                   SYS$HELP:[CXX$HELP]CXX_USERSGUIDE.TXT             [new]yI                   SYS$STARTUP:CCXX$STARTUP.COM                      [new]RI                   SYS$LIBRARY:LIBCXXSTD.OLB                         [new] I                   SYS$LIBRARY:LIBCXXSTD_MA.OLB                      [new]oI                   SYS$LIBRARY:LIBCXXSTD_NOINST.OLB                  [new]AI                   SYS$LIBRARY:LIBCXXSTD_MA_NOINST.OLB               [new]t  I                   SYS$LIBRARY:LIBCXXSTD_V07_01-001.OLB              [new] I                   SYS$LIBRARY:LIBCXXSTD_MA_V07_01-001.OLB           [new] I                   SYS$LIBRARY:LIBCXXSTD_NOINST_V07_01-001.OLB       [new] I                   SYS$LIBRARY:LIBCXXSTD_MA_NOINST_V07_01-001.OLB    [new]r  I                   SYS$LIBRARY:CXXL$ANSI_DEF.TLB                     [new]P  I                   SYS$LIBRARY:CXXL$ANSI_DEF_V07_01-001.TLB          [new]u  H                                                 (continued on next page)  H                                     Sample C++ Compiler Installation A-5 i               D            Example A-1 (Cont.) Sample HP C++ Installation on OpenVMS0                                Alpha Version 8.2  Y            %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...h  I             Beginning HP C++ V7.1-001 Installation Verification Procedure   D             Copyright 2005 Hewlett-Packard Development Company, L.P.  N             Confidential computer software. Valid license from HP required forN             possession, use or copying. Consistent with FAR 12.211 and 12.212,N             Commercial Computer Software, Computer Software Documentation, andS             Technical Data for Commercial Items are licensed to the U.S. Government 7             under vendor's standard commercial license.   9             Test compiler operation and error messages...m  +             Test Class Library operation...h  V             HP C++ V7.1-001 Installation Verification Procedure completed successfully  ;                 Installation of CXX V7.1 completed at 13:45c  F             Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY  M             Creating installation data file: VMI$ROOT:[SYSUPD]CXX071.VMI_DATA.  T            Enter the products to be processed from the next distribution volume set.              * Products:  4                    VMSINSTAL procedure done at 13:45            $                        )      A-6 Sample C++ Compiler InstallationI E  E                  H                                                                        BH         ________________________________________________________________  H                                           Files Installed on Your System      G               The HP C++ installation procedure installs and modifies a_E               number of files on your system, as listed in Table B-1.   H               Table_B-1_Files_Installed_or_Modified_____________________  H               File_____________________________________New_or_Modified__  :               SYS$HELP:CXX.RELEASE_NOTES               new  :               SYS$HELP:CXX_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                modifieds  :               SYS$COMMON:[CXX$LIB]CXX$CLD.CLD          new  :               SYS$SYSTEM:CXX$COMPILER_V07_01-001.EXE   new  :               SYS$MESSAGE:CXX$COMPILER_MSG_V07_01-     new               001.EXEh  :               SYS$COMMON:[CXX$LIB]CXX$CLD_V07_01-      new               001.CLDn  ?               SYS$HELP:HELPLIB.HLB                     modifiedn  :               SYS$SYSTEM:CXX$LINK.EXE                  new  :               SYS$MESSAGE:CXX$LINK_MSG.EXE             new  :               SYS$COMMON:[CXX$LIB]CXXLINK.CLD          new  H                                                 (continued on next page)  H                                       Files Installed on Your System B-1 F  e            E            Table_B-1_(Cont.)_Files_Installed_or_Modified_____________S  E            File_____________________________________New_or_Modified__   7            SYS$SYSTEM:CXX$LINK_V07_01-001.EXE       new+  7            SYS$MESSAGE:CXX$LINK_MSG_V07_01-001.EXE  newo  7            SYS$COMMON:[CXX$LIB]CXXLINK_V07_01-      newn            001.CLD  7            SYS$SYSTEM:CXX$DEMANGLE.EXE              new   7            SYS$COMMON:[CXX$LIB]CXXDEMANGLE.CLD      new   7            SYS$SYSTEM:CXX$DEMANGLE_V07_01-001.EXE   new   7            SYS$COMMON:[CXX$LIB]CXXDEMANGLE_V07_     news            01-001.CLD   7            SYS$HELP:[CXX$HELP]INTZLN.PDF            new   7            SYS$HELP:[CXX$HELP]IOSTREAM.PDF          new   7            SYS$HELP:[CXX$HELP]INTZLN.PS             newh  7            SYS$HELP:[CXX$HELP]IOSTREAM.PS           new   7            SYS$HELP:[CXX$HELP]CXX_CLASSLIB.PS       new   7            SYS$HELP:[CXX$HELP]CXX_USERSGUIDE.PS     newe  7            SYS$HELP:[CXX$HELP]CXX_CLASSLIB.TXT      newm  7            SYS$HELP:[CXX$HELP]CXX_USERSGUIDE.TXT    newz  7            SYS$STARTUP:CCXX$STARTUP.COM             new   7            SYS$LIBRARY:LIBCXXSTD.OLB                newo  7            SYS$LIBRARY:LIBCXXSTD_MA.OLB             new   7            SYS$LIBRARY:LIBCXXSTD_NOINST.OLB         newi  7            SYS$LIBRARY:LIBCXXSTD_MA_NOINST.OLB      newo  7            SYS$LIBRARY:LIBCXXSTD_V07_01-001.OLB     newi  7            SYS$LIBRARY:LIBCXXSTD_MA_V07_01-001.OLB  newh  7            SYS$LIBRARY:LIBCXXSTD_NOINST_V07_01-     newe            001.OLB  7            SYS$LIBRARY:LIBCXXSTD_MA_NOINST_V07_     new             01-001.OLBm  7            SYS$LIBRARY:CXXL$ANSI_DEF.TLB            news  E                                              (continued on next page)h  '      B-2 Files Installed on Your System     u            H               Table_B-1_(Cont.)_Files_Installed_or_Modified_____________  H               File_____________________________________New_or_Modified__  :               SYS$LIBRARY:CXXL$ANSI_DEF_V07_01-        newH               001.TLB___________________________________________________                                                                              H                                       Files Installed on Your System B-3 n  f                  H                                                                        CH         ________________________________________________________________  H                                                   Recovering from Errors      A               This appendix provides information to help you withP@               failures or errors that might occur during product*               installation or product use.  /         C.1 Failures During HP C++ Installation   H               If VMSINSTAL detects any problems during the installation,B               it notifies you and asks if you want to continue theC               installation. In some instances, you can enter yes totD               continue. To stop the installation process and correctG               the situation, enter no or press Return, then correct theI3               problem and restart the installation.   D               If errors occur during the installation itself or whenG               the Installation Verification Procedure (IVP) is running, F               VMSINSTAL displays failure messages. If the installation3               fails, you see the following message:o  7               %VMSINSTAL-E-INSFAIL, The installation of $               HP C++ 7.1 has failed.  7               If the IVP fails, you see these messages:   H               The HP C++ 7.1 Installation Verification Procedure failed.  F               %VMSINSTAL-E-IVPFAIL, The IVP for HP C++ 7.1 has failed.  D               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.  A               o  Quotas necessary for successful installation are.                  insufficient.  H               o  System parameter values for successful installation are                  insufficient.  H                                               Recovering from Errors C-1 t  Y            ;            o  The OpenVMS Help library is currently in use.e  E            o  The product license has not been registered and loaded.o  D            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 appropriateA            action as described in the message. For information onl4            installation requirements, see Chapter 1.  #      C.2 Problems During HP C++ Use   A            If you encounter a problem while using HP C++, see theeA            Release Notes. If the problem is unresolved, report itnC            to HP. Depending on the type of support you have and theSD            nature of the problem, take one of the following actions:  =            o  If you have a Software Product Services Supporty@               Agreement, contact your HP Customer Support Center@               (CSC), either by telephone or using the electronic>               means provided with your support agreement (suchA               as DSNlink). The CSC provides telephone support fore?               high-level advisory and remedial assistance. Whena@               you initially contact the CSC, please indicate the               following:  =               -  The name (OpenVMS Alpha) and version of yourr!                  operating system   E               -  The product name (HP C++) and version number you aren                  using  C               -  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 aresE               speaking on the phone to the appropriate HP C++ supportaD               specialist, you can provide more detailed information.B               The information should include the specific commands=               used to compile and link the program, the errortC               messages displayed, and relevant detailed informationl        C-2 Recovering from Errorse o  c            E                  (possibly including source program listings). Please @                  attempt to narrow the cause of the problem to a2                  specific module or lines of code.  D                  CSC personnel might ask for additional information,C                  such as listings of any command files, INCLUDE and B                  COPY files, relevant data files, and so forth. IfC                  the program is longer than 50 lines, submit a copynG                  of it electronically or provide machine-readable media 4                  (floppy diskette or magnetic tape).  C               o  If the problem is related to HP C++ documentation, E                  you can report the problem to the CSC (if you have asD                  Software Product Services Support Agreement and theH                  problem is severe); otherwise, send your comments aboutH                  HP C++ documentation to the following Internet address:                    c_docs@hp.com                                                      H                                               Recovering from Errors C-3                                                                                                                                                                                                                                                        P{#l,[u~7Z
6<lZSTB1[\`LժvvA#j9:׍3O>hyu#9	H2፺'9lA/(*	wLʞqzQvJ	=B8[i.$}3jJFZj(]Ƿs^>~:z9;Y9cBgá"r6߯y$ǴN}S=uqq؂
^B*>nu?LW=G]cpr(mej]r(V[^FxjtIǒAl%/'\Tg60;7`$FPhKǌIsx1("E׿ϾQb6.i|8%gkDwp5"gb>U8b.0h,2WnCNcԣ;Y37}W0Y}5eYX̮hf&rv8utBO934魁@RWϋՙɚ}HYj]5%t/!Co|p0D$	d
5l6=%P)T]<ŰR`}vϴuW
ɪMU ^nْJg=S`ө/ljBsz=y3M7D}C!Xź|ӫA6Z.eYNM,ũs<}J9"GP w
]u[ߧjRկ/L7^wѾPggVQs$HIEoBɚ $kjg!8$R4T\o~鑷{S{X^DCY2YJչCk
GĀ膬޽'/AF"iR,urZƺdq[1aATc
gO4r[Ŕ64i1-B!^m]Yn~slS(jc_W74bD,Wz|3:|ʄfWC
Үv+W='z5Fw']ܷ2Y֧H;RH>umwP,By^),DjtF~KL
D'Z5m6fӔGhV#}&4
=w<}@Cw~¼Lýъ|\q4(xNՈU!9Yx=ri|ܖy_ Bp%Ű1l20
S+\wa
+"Yz-j+i߯-
F?q zPQ7}z
7f!>'1Sk-9ЁtmƖ]#T_:L%t</jd~+dY,y:BD|Vž١'quϳ|T\gGG[(m~A}B2fA&.)]4xկ "#$1p
r^O4{߿!-3qOuC9xq-N>znP>LrTkyH}M:Agh@6~ƮkfT[3IWY*v̖lx;áAHBǜmz1kehB+5d10=W󑠗Fƥ{ۯ~AZ!{yM:D'ߑ4>8J oPJeqwҾqMo.O4`Z@ƀ9^VmDG o1kD_rLqC
2<0rB^&)L`@ftyt=KJ9U\EP'BK!~ͭEnm]$ eC[y)G:Y}^jq@TDT1*
BeǪi:9o@#vUhΚ;Ƞcv 
fWLW}J*is$qAAJ4Yn͝m{5*ˍRQWg^''mh[FE
&DZi`AM9Vefa䐓|R*Ҡy9#,Q>s2Aj㞎ɬw avz$@x$k]qxLppxHqjq	hb)ЪX!X'a#k$%E~ǥ7	T,Cc]	oziԷRDNboKJO;ck FWIto9Qӎ;y9ҙ:cW^KxJGXKJ:|	u*#\!!R&1_O"C*,/$-4]˫䲘1}0g5y˨ɗ<@NE#=X!&n..0jޭpؓd:ݓDdFroLO͠&	zoG_<BT`us6أk:qi夎G`wp+~*C
b®ٟoFo7ح%.\M^3u6	&[y݄Wg)bc H.an͐߰$KPy _?,|::-A`fvd^	je6vBeBx#F2 rk>wܦ"j=g_P}`cݳJDǋSnG$Z,Lmm	cDz݇:e,~\V5VTMubg|7(dH8k_ܡFHdj"[)o:1AlZX	qW>1ץG8V\3z.yIlڋ0)"@1P)_`=7@ffn|FUQ94S⪎~A5
ϲ8-=yn(?£Asmh/	3oge
<c;΢U,﮴?n
ń^V-Zb&I<{md\^R^Wp1W]Zl=q/vciNP[DQ)f?Zy/u<);ݭ?i)M9.s|A<%e\sq[%#3 tÞE$ٶ$pGLtP5^8ApM9,θ ?C*5oV BE)rrdoORUy~b_co飒oxydޠ1%8ypdKC{޳A*{wCX\e!G0 q/agYw4 82P(>x8;UU!浧3nL'́.2.bw	 7n.v?9։_[5,LFN8\`
8ڒ{$1%N-7㝡=?Sqfz8cBu4`wbg_ES$-T|VyjVƼ*~Y&[=3Y
64q1o]qzY5)m<M(2ɿY0ɔ`bsʿp1}S!o~%!5z"m^/o{8r'z+_䎐ߥ&`0>({D;}~=v[4QZZuZJu"5jsrl*hH(U؝޴֣+"ppn
YC:
L\Ǝd#^i#C&?7ڌJ$yIkm{N .Drϫs(Wһ><R	]tcaG{b*$X43ov1vʌdZmֻ`(Pї0qHͤ2wъ^^=xr/ q:6<B=<D7ǫ
6
|cN/} ڤwGxI:wXSs`e1%wnre؀ mnLS-pOA_%hh`o33ڈ$P#wT
-tq|~Vk`XZLyی39@b1DB~lB|ЋP, 
lB&T!.⤇x	t(k\YB<ኞ2]*!@ml	nˏC<PϿcþ='4Ku<'lD57pw6RHߐ.+,/TcKc}-'?ݔ[mY
yG'!V;Ggɇ75'҇VSNYi Y1@L)5bZ-U]Xnn[
ê;Z~?DBbTOK
7ԎX*YNbrSQ -v>=SVIlz~p|1Y/ϡ@nPMXĶD\[SMNf2?~X߃d
ĵn.UTgBb֓<o&K9vZKC4~F*qt. ˱0jH1j# wȬ xFSSoơ=ӼC
;UٶDo^ؿԑD71F񒏸Es+BNψd 6\:|̜><5ף;1yalu"cq	~Lewa^f
$?Bq*H7pW|Y7
PۡHU_DjtI
1$lɹ:`k%9\FBn	-`$Cg/پvd^5Ϭ8k7])7;{Uzp[X:";9ƞbY3tSX'O;<=n0c{i͂rFO]K8}})O?+&l