                           C                      Compaq_C++____________________________________ 7                      Installation Guide for OpenVMS VAX   .                      Order Number: AA-PNAMF-TE    "                      December 1999  D                      This guide contains instructions for installingE                      Compaq C++ for OpenVMS VAX. It also explains how E                      to read the online release notes before or after ,                      installing the product.  >                      This guide also contains instructions forD                      installing a version of the OpenVMS Version 6.0C                      Debugger that supports debugging of Compaq C++ F                      programs. This debugger is packaged as a separateG                      installation kit but is included on the same media 0                      as the Compaq C++ compiler.          C                      Revision/Update Information: This is a revised 8                                                   guide.  E                      Operating System & Version:  OpenVMS VAX Version B                                                   5.5-2 or higher.  @                      Software Version:            Compaq C++ forE                                                   OpenVMS VAX Version @                                                   5.6C or higherB                                                   Compaq C++ ClassE                                                   Library Version 1.2 ;                                                   or higher   0                      Compaq Computer Corporation#                      Houston, Texas                  E            __________________________________________________________ )            First Printing, September 1992 !            Revised, November 1999   @            The information in this document is subject to changeE            without notice and should not be construed as a commitment >            by Digital Equipment Corporation. Digital EquipmentD            Corporation assumes no responsibility for any errors that'            may appear in this document.   E            The software described in this document is furnished under A            a license and may be used or copied only in accordance *            with the terms of such license.  B            No responsibility is assumed for the use or reliabilityC            of software on equipment that is not supplied by Digital =            Equipment Corporation or its affiliated companies.   D            Restricted Rights: Use, duplication, or disclosure by theE            U.S. Government is subject to restrictions as set forth in C            subparagraph (c)(1)(ii)  of the Rights in Technical Data >            and Computer Software clause at DFARS 252.227-7013.  @             Digital Equipment Corporation 1992-1999. All Rights            Reserved.  D            Compaq, the Compaq logo, Alpha, DEC, DECwindows, DIGITAL,B            OpenVMS, VAX, VMS are registered in the U.S. Patent and            Trademark Office.  4            The following are third-party trademarks:  ;            Motif is a registered trademark of Open Software #            Foundation Incorporated.   @            PostScript is a registered trademark of Adobe Systems            Incorporated.  E            Other product names mentioned herein may be the trademarks )            of their respective companies.   0            This document is available on CD-ROM.  E                                                                ZK6036   @            This document was prepared using DECdocument, Version            3.2-1n.                               C    ________________________________________________________________   C                                                            Contents     C    Preface..................................................      v     ;    1  Preparing for Compaq C++ for OpenVMS VAX Installation   C          1.1   License Registration.........................    1-1 7          1.2   Required Operating System Components and C                Software.....................................    1-2 C          1.3   Installation Procedure Requirements..........    1-4 6          1.3.1     Deassigning DECset Debugger LogicalC                    Names....................................    1-4 C          1.3.2     Process Privileges.......................    1-5 C          1.3.3     Process Account Quotas...................    1-5 C          1.3.4     System Parameters........................    1-7 C          1.3.5     Disk Space...............................    1-9 C          1.3.6     Backing Up Your System Disk..............   1-10 0          1.3.7     Additional System MaintenanceC                    Procedures...............................   1-10 C          1.3.7.1     Checking System Parameter Values.......   1-10 <          1.3.7.2     Calculating the Values for Global PagesC                      and Global Sections....................   1-10 :          1.3.7.3     Changing System Parameter Values withC                      AUTOGEN................................   1-12 5          1.3.7.4     Setting Dynamic System Parameter C                      Values.................................   1-13                   C                                                                 iii                  -      2  Installing Compaq C++ for OpenVMS VAX   3            2.1   Installing the OpenVMS Version 6.0 E                  Debugger.....................................    2-1 :            2.2   Installing the Compaq C++ for OpenVMS VAXE                  Compiler.....................................    2-7 E            2.3   Error Recovery...............................   2-15         3  After Installation  6            3.1   Running the Installation VerificationE                  Procedures Separately........................    3-1 E            3.2   Editing and Organizing System Files..........    3-2 E            3.3   VMScluster Considerations....................    3-3 E            3.4   User Account Requirements....................    3-4 E            3.4.1     User Privileges..........................    3-4 E            3.4.2     User Account Quotas......................    3-4 E            3.5   Getting Help and Reporting Problems..........    3-5         A  Sample Installations    8      B  Files and Logical Names Installed on Your System  E            B.1   File Names...................................    B-1 E            B.2   Logical Names................................    B-1         C  Recovering from Errors  E            C.1   Failures During Compaq C++ Installation......    C-1 E            C.2   Problems During Compaq C++ Use...............    C-2   
      Examples   8            A-1       Sample OpenVMS Version 6.0 DebuggerE                      Installation on OpenVMS VAX..............    A-2   6            A-2       Sample Compaq C++ for OpenVMS VAXE                      Installation.............................    A-4                   iv                           Tables  H               1         Conventions Used in the Guide............     vi  H               1-1       Optional Software........................    1-4  A               1-2       Process Account Quotas for the Installing H                         Account..................................    1-6  @               1-3       Minimum Required System Parameter ValuesH                         for the OpenVMS Version 6.0 Debugger.....    1-7  @               1-4       Minimum Required System Parameter Values;                         for the Compaq C++ Version 5.6C for H                         OpenVMS VAX Compiler.....................    1-8  H               1-5       Disk Space Requirements..................    1-9  H               1-6       Contiguous GBLPAGE Count Requirements....   1-11                                                    H                                                                        v                           H         ________________________________________________________________  H                                                                  Preface      C               This guide describes how to install Compaq C++ on VAX D               processors running the OpenVMS operating system. It isE               intended for system managers. Keep this guide with your F               distribution kit in case you need it to reinstall Compaq1               C++ for OpenVMS VAX for any reason.   E               If you have any comments about this document, send them D               to Compaq. your comments will be considered for future2               revisions of the installation guide.  B               You may send comments or suggestions concerning thisC               guide, or any Compaq C++ for OpenVMS VAX document, by @               electronic mail to the following Internet address:  %                  cxx_docs@zko.dec.com            Document Structure  D               This guide contains three chapters and two appendixes:  F               o  Chapter 1 describes how to prepare for Compaq C++ for*                  OpenVMS VAX installation.  G               o  Chapter 2 describes how to install the OpenVMS Version @                  6.0 Debugger and the Compaq C++ for OpenVMS VAX                  compiler.  A               o  Chapter 3 describes postinstallation procedures.   8               o  Appendix A shows a sample installation.  A               o  Appendix B discusses the files and logical names *                  installed on your system.  A               o  Appendix C provides information to help you with                   failures.  H                                                                        v                       Associated Documentation   @            In addition to this guide, the Compaq C++ for OpenVMSD            VAX Version 5.6C documentation set includes the following            books:   C            o  Stroustrup, Bjarne. The C++ Programming Language, 3nd D               Edition. Reading, Massachusetts: Addison-Wesley, 1997.  ?            o  Musser, David R. and Atul Saini. STL Tutorial and ?               Reference Guide. Reading, Massachusetts: Addison-                Wesley, 1996.   .            o  Using Compaq C++ for OpenVMS VAX  7            o  Compaq C++ Class Library Reference Manual   D            o  Compaq C Run-Time Library Reference Manual for OpenVMS               Systems   >            o  Compaq C/C++ Run-Time Components for OpenVMS VAX.               Reference and Installation Guide  C            For information on the Compaq C++ for OpenVMS VAX 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.        Conventions  <            Table 1 lists the conventions used in this guide.  E            Table_1_Conventions_Used_in_the_Guide_____________________   E            Convention_____________Meaning____________________________   C            UPPERCASE TEXT         Uppercase text indicates the name D                                   of a command, a file, a parameter,<                                   a procedure, or a utility.  E                                              (continued on next page)         vi                  H               Table_1_(Cont.)_Conventions_Used_in_the_Guide_____________  H               Convention_____________Meaning____________________________  E               $ @SYS$UPDATE:VMSINSTALIn interactive examples, prompts C                                      or displayed text appears in a G                                      monospace font. User input appears <                                      in bold monospace font.  H               Ctrl/X                 In interactive examples, a sequenceF                                      such as Ctrl/X indicates that youC                                      must hold down the key labeled E                                      Ctrl while you press another key E                                      or a pointing device button; for ?                                      example, Ctrl/C or Ctrl/Z.   B               [YES]                  Square brackets indicate thatC                                      the enclosed item is a default G                                      value in a VMSINSTAL prompt. Also, H                                      square brackets serve as delimitersC                                      for a directory name in a file H               _______________________specification._____________________                                              H                                                                      vii                       H                                                                        1H         ________________________________________________________________  H                    Preparing for Compaq C++ for OpenVMS VAX Installation      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 A               parts of it are missing, contact your local support                representative.   D               Compaq C++ for OpenVMS VAX and the OpenVMS Version 6.0C               Debugger both provide online release notes, which are E               copied to SYS$HELP during installation. Compaq strongly ?               recommends that you read the release notes before B               proceeding with the installation. For information onC               accessing the online release notes for the Compaq C++ E               compiler, see step 5 in Section 2.2. For information on H               accessing the online release notes for the OpenVMS Version6               6.0 Debugger, see step 4 in Section 2.1.            1.1 License Registration  H               Before you install and run Compaq C++ for OpenVMS VAX on aG               newly licensed node (or cluster), you must first register E               a License Product Authorization Key (License PAK) using H               the License Management Facility (LMF). The License PAK mayF               be shipped along with the kit if you ordered the licenseE               and media together; otherwise, it is shipped separately C               to a location based on your license order. If you are C               installing Compaq C++ for OpenVMS VAX as an update on C               a node or cluster already licensed for this software, E               you have already completed the License PAK registration                requirements.           H                Preparing for Compaq C++ for OpenVMS VAX Installation 1-1           :      Preparing for Compaq C++ for OpenVMS VAX Installation      1.1 License Registration   B            If you are installing prerequisite or optional software@            along with Compaq C++ for OpenVMS VAX, review the PAK>            status and install the PAKs for any prerequisite or>            optional software before you install Compaq C++ for            OpenVMS VAX.   <            The OpenVMS Debugger does not support the LMF, soA            there are no PAKs to register to run the debugger with &            Compaq C++ for OpenVMS VAX.  A            You must register and load your license for Compaq C++ C            for OpenVMS VAX before you start the installation to run D            the Installation Verification Procedure (IVP) and use the            software.  E            Log in to the system manager's account, SYSTEM. You have a 4            choice of two ways to register a license:  B            o  Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. WhenD               it prompts you for information, respond with data from               your License PAK.   C            o  At the DCL prompt, enter the LICENSE REGISTER command @               with the appropriate qualifiers that correspond to&               License PAK information.  @            If you plan to use Compaq C++ for OpenVMS VAX on moreD            than one node in a VMScluster, you will need to perform aB            license load on the other nodes after you complete this)            installation. See Section 3.3..  E            For complete information on using the LMF, see the OpenVMSo-            License Management Utility Manual.a  :      1.2 Required Operating System Components and Software  ?            Compaq C++ Version 5.6C for OpenVMS VAX requires thef             following components:  C            o  OpenVMS VAX operating system Version 5.5-2 or higher.   D               Future Compaq C++ for OpenVMS VAX releases may requireC               higher versions of the operating system, as described <               in the online release notes or the Read BeforeE               Installing or Using Compaq C++ Version 5.6C for OpenVMS                VAX letter.   >      1-2 Preparing for Compaq C++ for OpenVMS VAX Installation :  p      H                    Preparing for Compaq C++ for OpenVMS VAX InstallationH                    1.2 Required Operating System Components and Software  A               o  Compaq C/C++ Run-Time Components Version 6.0 foro!                  OpenVMS VAX kit.   A                  Components of this kit include newer versions of F                  existing shareable image OpenVMS run-time components,F                  as well as the Compaq C++ Class Library and shareableG                  image components that are new to the Compaq C Run-Time                   Library.n  C               The OpenVMS VAX operating system comes with a variety_B               of support options or components. Components includeD               such features as networking and RMS journaling. To useG               Compaq C++ for OpenVMS VAX, your system should be runninguG               a version of OpenVMS VAX that includes the base componentp                and the following:  $               o  Programming support                 o  Utilities  H               The Compaq C/C++ Run-Time Components kit is distributed onH               the same media with the Compaq C++ kit, and comes with itsE               own installation instructions. You can redistribute the H               Compaq C/C++ Run-Time Components kit and its documentationB               to remote sites that develop applications written inE               Compaq C++ Version 5.6C for OpenVMS VAX. See the Compaq A               C/C++ Run-Time Components for OpenVMS VAX Reference B               and Installation Guide for detailed installation and*               redistribution instructions.  F                 ________________________Note  ________________________  D                 Although they are both on the same media, you cannotA                 install both the OpenVMS Version 6.0 Debugger kitoD                 and the Compaq C++ Version 5.6C OpenVMS VAX kit with5                 a single invocation of VMSINSTAL. TheO?                 Compaq C++ for OpenVMS VAX kit causes VMSINSTAL ?                 to check to ensure that the OpenVMS Version 6.0 =                 Debugger installation is complete so that therB                 Installation Verification Procedure (IVP) can testA                 C++ debugging capabilities. If you try to install >                 both kits with the same VMSINSTAL command, the>                 Compaq C++ for OpenVMS VAX kit installs before@                 the OpenVMS Version 6.0 Debugger kit because theB                 compiler kit files (CXX05n) alphabetically precedeD                 the debugger kit files (DBG060). Requests to install  H                Preparing for Compaq C++ for OpenVMS VAX Installation 1-3           :      Preparing for Compaq C++ for OpenVMS VAX Installation:      1.2 Required Operating System Components and Software  A               the debugger kit first, by specifying DBG060 beforeo6               CXX05n on the command line, are ignored.  C               _____________________________________________________.  A            Table 1-1 provides information about optional softwared@            that you can use together with Compaq C++ for OpenVMS            VAX.L  E            Table_1-1_Optional_Software_______________________________-  E            Optional_Product____Purpose_______________________________   E            Compaq Language-    Formatted language constructs simplify ?            Sensitive Editor    editing source programs. Support ?            (LSE) Version 4.0   for Compaq C++ requires that LSE-B            or higher           be installed before the compiler isE            ____________________installed.____________________________   ,      1.3 Installation Procedure Requirements  D            This section discusses the settings that you should checkD            to be sure that your system is ready for the installation4            of Compaq C++ for OpenVMS VAX to proceed.  4      1.3.1 Deassigning DECset Debugger Logical Names  E            Although carrying out the procedure in Section 2.1 updates.B            the system version of the OpenVMS Debugger, it does not?            modify any auxiliary version of the OpenVMS Debugger1B            that may also exist on your system, such as the versionA            supplied with DECset Version 11 or supplied with olderaA            versions of Compaq C++ for OpenVMS VAX. If they exist,eA            executable images of these alternative versions of the.@            debugger are activated using system logical names. To@            install this Compaq C++ for OpenVMS VAX kit properly,=            you must remove the following logical names before.>            installing the OpenVMS Version 6.0 Debugger on thisE            Compaq C++ for OpenVMS VAX kit. Use the DEASSIGN/SYSTEM oru7            DEASSIGN/SYSTEM/EXEC command to remove them:   1            DEBUG         DBGTBKMSG     DBG$UIHELP       >      1-4 Preparing for Compaq C++ for OpenVMS VAX Installation           H                    Preparing for Compaq C++ for OpenVMS VAX InstallationH                                  1.3 Installation Procedure Requirements    7               DEBUGSHR      VMSDEBUGUIL   DEBUGAPPCLASS   $               DEBUGUISHR    DBG$HELP            1.3.2 Process Privileges  G               To install Compaq C++ for OpenVMS VAX, you must be logged H               in to an account that has SETPRV or at least the following               privileges:B                 o  CMKRNL.                 o  WORLD                 o  SYSPRVf  G               VMSINSTAL turns off BYPASS privileges at the start of the.               installation.o  $         1.3.3 Process Account Quotas  C               VMSINSTAL requires that the installation account haves3               minimum quotas as shown in Table 1-2.n                                          H                Preparing for Compaq C++ for OpenVMS VAX Installation 1-5 a  t      :      Preparing for Compaq C++ for OpenVMS VAX Installation,      1.3 Installation Procedure Requirements  >            Table 1-2 Process Account Quotas for the InstallingE            __________Account_________________________________________4  E            Account_Quota___Value_____________________________________               ASTLM           190              BIOLM           160  !            BYTLM           99,000               DIOLM           160              ENQLM           4000n              FILLM           300              JTQUOTA         4096u  E            PGFLQUOTA_______20,000____________________________________q  A            Use the OpenVMS Authorize Utility to verify and change.B            process quotas for the installation account in the userA            authorization file (UAF). (Some sites may restrict thegC            use of the OpenVMS Authorize Utility to certain accounts B            or people.) For instance, to change the BYTLM quota forE            the account-name installation account, you might enter the_&            following command sequence:  %            $ RUN SYS$SYSTEM:AUTHORIZE 2            UAF> MODIFY account-name /BYTLM = 99000!            UAF> SHOW account-namee            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  A            User account quotas are stored in the file SYSUAF.DAT.iD            For more information on modifying account quotas, see theE            description of the Authorize Utility in the OpenVMS Systemd            Management Subkit.d  >      1-6 Preparing for Compaq C++ for OpenVMS VAX Installation    p      H                    Preparing for Compaq C++ for OpenVMS VAX InstallationH                                  1.3 Installation Procedure Requirements           1.3.4 System Parameters   C               Table 1-3 lists the minimum required system parameter E               values for installing the OpenVMS Version 6.0 Debugger. A               Depending on the kinds of programs and applicationsbD               running at your site, you might need higher values for               some settings.  D               Table 1-3 Minimum Required System Parameter Values forH               __________the_OpenVMS_Version_6.0_Debugger________________  .                                        MinimumH               System_Parameter_________Value________Default_Value_______  7               CLISYMTBL[1]             500          500t  8               GBLPAGES[2]              6750         6750  8               GBLPAGFIL                6750         6750  6               GBLSECTIONS[2]           8            10H               [1]The_CLISYMTBL_dynamic_system_parameter_must_be_set_to__  G               a minimum value of 500 during the installation procedure.sH               You can change the setting to its original value after the'               installation is finished.uG               [2]These values represent the number of free global pagesaD               and global sections required for the installation, notD               the total number you need to run your system and other               software.VH               __________________________________________________________  C               Table 1-4 lists the minimum required system parameter B               values for installing the Compaq C++ for OpenVMS VAX$               Version 5.6C compiler.                    H                Preparing for Compaq C++ for OpenVMS VAX Installation 1-7           :      Preparing for Compaq C++ for OpenVMS VAX Installation,      1.3 Installation Procedure Requirements  A            Table 1-4 Minimum Required System Parameter Values forr@                      the Compaq C++ Version 5.6C for OpenVMS VAXE            __________Compiler________________________________________n  +                                     Minimum E            System_Parameter_________Value________Default_Value_______t  4            CLISYMTBL[1]             500          500  5            GBLPAGES[2]              2500         2500_  5            GBLPAGFIL                2500         2500   2            GBLSECTIONS[2]           3            3E            [1]The_CLISYMTBL_system_parameter_must_be_set_to_a_minimume  B            value of 500 during the installation procedure. You can>            reset the value after the installation is finished.D            [2]These values represent the number of free global pagesA            and global sections required for the installation, notnA            the total number you need to run your system and other             software.E            __________________________________________________________o                                            >      1-8 Preparing for Compaq C++ for OpenVMS VAX Installation           H                    Preparing for Compaq C++ for OpenVMS VAX InstallationH                                  1.3 Installation Procedure Requirements      F                 ________________________Note  ________________________  D                 Remember to use SYS$SYSTEM:MODPARAMS.DAT and AUTOGEN=                 when changing these settings. For example, to @                 set GBLSECTIONS to 10, use ADD_GBLSECTIONS=10 or>                 MIN_GBLSECTIONS=currentvalue+10. Also remember@                 to account for other usage of system parameters.>                 Slightly overconfiguring OpenVMS operations or?                 memory usage settings by 10% to 20%, or more is C                 unlikely to incurr any performance penalty. For thee@                 specific overhead involved with increasing these5                 settings, see the performance manual.i  E                 _____________________________________________________            1.3.5 Disk Space  D               Requirements for free disk storage space are differentC               during installation and after installation. Table 1-512               summarizes the storage requirements.  H               Table_1-5_Disk_Space_Requirements_________________________  A                                  Blocks During       Blocks AfterOH               Kit________________Installation________Installation_______  ;               Compiler kit       29,000              19,500t  9               OpenVMS Debugger   22,000              1000r               kiti  9               Run-Time           15,000              5000aH               Components_kit____________________________________________  H               To determine the number of free disk blocks on the currentA               system disk, enter the following command at the DCLd               prompt:t  )               $ SHOW DEVICE SYS$SYSDEVICEo        H                Preparing for Compaq C++ for OpenVMS VAX Installation 1-9 t  a      :      Preparing for Compaq C++ for OpenVMS VAX Installation,      1.3 Installation Procedure Requirements  &      1.3.6 Backing Up Your System Disk  B            At the beginning of the installation, VMSINSTAL asks ifA            you have backed up your system disk. Compaq recommends B            that you back up your system disk before installing any            software.  A            Use the backup procedures that are established at yoursD            site. For details on performing a system disk backup, seeB            the section on the Backup Utility in the OpenVMS System            Management Subkit.P  3      1.3.7 Additional System Maintenance Proceduresy  A            This section explains how to use the System GenerationiC            Utility (SYSGEN) and the AUTOGEN Utility to prepare youriA            system for an installation of Compaq C++. AUTOGEN usesp@            system configuration data to automatically set system            parameters.  -      1.3.7.1 Checking System Parameter Valuest  C            To check the values of your system parameters, enter the             following command:a  "            $ RUN SYS$SYSTEM:SYSGEN            SYSGEN>  C            At the SYSGEN> prompt, enter the SHOW command to displayeA            the value of a system parameter. The following exampleo=            displays the value for the WSMAX system parameter:V              SYSGEN> SHOW WSMAXa  E            After checking the parameters with the SHOW command, entertB            the EXIT command at the SYSGEN> prompt to return to DCLE            level. For information on setting dynamic system parameter '            values, see Section 1.3.7.4.   ?      1.3.7.2 Calculating the Values for Global Pages and Global               Sectionsl  B            To install and run Compaq C++ for OpenVMS VAX, you mustB            have sufficient free global pages, global sections, andD            contiguous global pages. You must first find out how manyB            free global pages and sections you have on your system.D            Then use AUTOGEN if you need to increase the global pages1            and global sections system parameters.   ?      1-10 Preparing for Compaq C++ for OpenVMS VAX Installation            H                    Preparing for Compaq C++ for OpenVMS VAX InstallationH                                  1.3 Installation Procedure Requirements  H               Enter the following DCL command to determine the number ofA               global pages required by SYS$LIBRARY:DCLTABLES.EXE:   2               $ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE  U               This command returns the size (in blocks) of SYS$LIBRARY:DCLTABLES.EXE.iC               As an approximation, use this figure as the number of (               global pages for the file.  @               Table 1-6 lists the requirements for the number ofF               contiguous global pages needed during installation. NoteH               that the values represent the number of pages required forF               installation, not the number you need to run your system!               and other software.q  H               Table_1-6_Contiguous_GBLPAGE_Count_Requirements___________  .                                        MinimumH               Product_Installation_____Value________Default_Value_______  6               OpenVMS Version 6.0      900          95               Debugger  H               Compaq_C++_Version_5.6C__900__________95__________________  E               You can use the WRITE command with the F$GETSYI lexicalnD               function to find the number of contiguous global pagesG               and free global sections. The following example shows how G               to get this information at your terminal (the default for                SYS$OUTPUT):  <               $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES")               15848L:               $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")               24  D               If the values displayed by the system are greater thanE               the values in Tables 1-3, 1-4, and 1-6, you do not needoG               to increase the values for these parameters. If the valuenF               of free global pages or global sections is less than theD               value in Table 1-3 or Table 1-4, you must increase the'               system parameter setting.p  E               Section 1.3.7.3 describes the procedures for increasingt)               these values using AUTOGEN.   H               Preparing for Compaq C++ for OpenVMS VAX Installation 1-11 h  a      :      Preparing for Compaq C++ for OpenVMS VAX Installation,      1.3 Installation Procedure Requirements  :      1.3.7.3 Changing System Parameter Values with AUTOGEN  =            Use the AUTOGEN command procedure to change systeml?            parameters. AUTOGEN automatically adjusts values for C            parameters that are associated with the values you reseteC            manually. To change system parameters with AUTOGEN, editf            the following file:  #            SYS$SYSTEM:MODPARAMS.DAT.  B            Use an editor to access the file. To change a parameter>            value listed in this file, delete the current valueB            associated with that parameter and enter the new value.  >            To add a new parameter, add a line to the file thatA            includes both the name of the parameter and its value.             For example:p              WSMAX = 8096c  E            To modify incremental parameters such as free global pagessA            and global sections, use ADD_GBLPAGES or ADD_GBLSECTS. E            The following example increases the global page setting byt            2000:              ADD_GBLPAGES = 2000  D            When you set the page file quota, do not use a value thatA            exceeds the amount of page file space available on thee            system.  D            After you make all your changes, exit from the editor andC            execute the AUTOGEN procedure to recalculate your systemeE            parameters. The following command recalculates your systemi-            parameters and reboots the system:1  /            $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT   A            When you specify REBOOT, AUTOGEN performs an automatictA            system shutdown and then reboots the system. Any usersn?            logged on to the system are disconnected immediatelygA            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.  ?      1-12 Preparing for Compaq C++ for OpenVMS VAX Installationg u         H                    Preparing for Compaq C++ for OpenVMS VAX InstallationH                                  1.3 Installation Procedure Requirements  F               For more information about using AUTOGEN, see the systemA               management documentation for your operating system.t  7         1.3.7.4 Setting Dynamic System Parameter Values   F               Use SYSGEN to set dynamic parameters. Dynamic parametersA               changed with the SYSGEN command WRITE ACTIVE becomeCH               active immediately without any need to reboot your system.H               Rebooting returns dynamic system parameter values to their                previous settings.  G               After you change the dynamic parameter values, you shouldlD               complete the installation before rebooting the system.B               After you finish the installation, you can reset theH               dynamic parameters to their previous values or let them beF               reset automatically when you reboot your system the next               time.n  E               If the dynamic parameter values on your system are less,B               than the values previously listed, use the followingC               series of commands to change the values. This example 1               changes the CLISYMTBL value to 500:/  %               $ RUN SYS$SYSTEM:SYSGENE                SYSGEN> USE ACTIVE'               SYSGEN> SET CLISYMTBL 500H"               SYSGEN> WRITE ACTIVE               SYSGEN> EXIT                                  H               Preparing for Compaq C++ for OpenVMS VAX Installation 1-13                       H                                                                        2H         ________________________________________________________________  G                                   Installing Compaq C++ for OpenVMS VAXn      K               After you register and load the License Product AuthorizationlG               Key (License PAK), the installation takes approximately 5.F               to 30 minutes depending on your system configuration and(               the kit components chosen.  7         2.1 Installing the OpenVMS Version 6.0 Debugger.  S               This section explains how to install the OpenVMS Version 6.0 Debuggerc@               on systems running OpenVMS VAX Version 5.5-2. ThisA               procedure does not apply to systems already runningf0               OpenVMS VAX Version 6.0 or higher.  B               The OpenVMS Version 6.0 Debugger has its own instal-C               lation kit stored on the same media as the Compaq C++2G               installation kit and must be installed as a separate step_H               before installing the compiler if the installing system isF               running a version of OpenVMS VAX lower than Version 6.0.F               If your installation medium is tape, install the OpenVMSE               Debugger before the Compaq C++ compiler to avoid errorsn/               when installing the compiler kit.J  F                 ________________________Note  ________________________  =                 If you try to install the OpenVMS Version 6.0i?                 Debugger kit on a system running Version 6.0 orl3                 higher, the installation will fail.f  E                 _____________________________________________________u  B               This section contains excerpts from the installationB               procedure and explains each step. Defaults appear inC               brackets ([])  throughout the installation procedure.s      H                               Installing Compaq C++ for OpenVMS VAX  2-1 n         *      Installing Compaq C++ for OpenVMS VAX4      2.1 Installing the OpenVMS Version 6.0 Debugger  A            To abort the installation procedure at any time, press D            Ctrl/Y. When you press Ctrl/Y, the installation procedure@            deletes all files it has created up to that point andB            then returns you to DCL level. If you want to retry theD            installation after pressing Ctrl/Y, you must proceed from            step 2.  A            1. Log in to a privileged account and set your defaulte1               device and directory to SYS$UPDATE.                  Username: SYSTEM               Password:i&               $ SET DEFAULT SYS$UPDATE              2. Invoke VMSINSTAL.A  C               This example invokes VMSINSTAL to install the OpenVMSdC               Version 6.0 Debugger using the N option and shows the                system response.  1               $ @VMSINSTAL DBG060 MUA0: OPTIONS Na  L                     OpenVMS VAX Software Product Installation Procedure Vn.n  )               It is dd-mmm-yyyy at hh:mm.u=               Enter a question mark (?) at any time for help.   U               * Are you satisfied with the backup of your system disk [YES]? <Return>r  A               If you are satisfied with the backup of your system_E               disk, press Return. Otherwise, type NO and press Returny.               to discontinue the installation.  1            3. Insert the installation kit volume.0  @               Please mount the first volume of the set on MUA0:."               * Are you ready? YES7               The following products will be processed:N                   DBG V6.0  =                   Beginning installation of DBG V6.0 at hh:mmb  C               %VMSINSTAL-I-RESTORE, Restoring product save-set A...i  E               To indicate that you want to continue the installation,v9               mount volume 1, type YES, and press Return.   ,            4. Select a release notes option.  .      2-2 Installing Compaq C++ for OpenVMS VAX i         G                                   Installing Compaq C++ for OpenVMS VAXrH                          2.1 Installing the OpenVMS Version 6.0 Debugger  E                  This step applies only if you specified OPTIONS N in                   step 2.  '                  Release Notes Options:s  -                      1. Display release notes +                      2. Print release notes $                      3. Both 1 and 26                      4. Copy release notes to SYS$HELPD                      5. Do not display, print, or copy release notes  %                  * Select option [2]:   G                  If you select option 1, VMSINSTAL displays the release G                  notes on line immediately. To terminate the display at_(                  any time, press Ctrl/C.  H                  If you select option 2 (the default), VMSINSTAL promptsE                  you for a queue name. You can then type a queue nameCE                  or press Return, which sends the file to the default %                  output print device.   8                  * Queue name [SYS$PRINT]: CLUSTER_PRINT  G                  If you select option 3, VMSINSTAL displays on line thepD                  release notes immediately. To terminate the displayA                  at any time, press Ctrl/C. VMSINSTAL prompts yourA                  for a queue name for printing the release notes.tE                  Either type a queue name or press Return to send theeE                  file to the default output print device. The OpenVMSuF                  Version 6.0 Debugger release notes are then copied to/                  SYS$HELP:DBG060.RELEASE_NOTES.   E                  If you select option 4, VMSINSTAL copies the release+/                  notes to SYS$HELP immediately.   D                  If you select option 5, VMSINSTAL does not display,D                  print, or copy the release notes, but moves them toE                  SYS$HELP. Typically, you select this option when you_.                  want to end the installation.  ?                  Next, VMSINSTAL displays the following prompt:   E                  * Do you want to continue the installation [N]?: YESDK                  %VMSINSTAL-I-RELMOVED, The product release notes have beene4                      successfully moved to SYS$HELP.  H                               Installing Compaq C++ for OpenVMS VAX  2-3 r         *      Installing Compaq C++ for OpenVMS VAX4      2.1 Installing the OpenVMS Version 6.0 Debugger  @               If you want to continue the installation, type YES?               and press Return. If you type NO or press Return,f@               VMSINSTAL discontinues the installation. In eitherB               case, VMSINSTAL moves the release notes to SYS$HELP.  B            5. Select the Installation Verification Procedure (IVP)               options.  D               You are asked two questions about running the IVP. TheD               first allows you to run the IVP for the character-cellC               debugger. The second allows you to run the DECwindows                Motif IVP.  H               * Do you want to run the IVP after the installation [YES]?M               * Do you want to run the interactive DECwindows Motif IVP [NO]?   D               The purpose of the IVP is to verify that the installa-A               tion was successful. If the IVP determines that youn>               have insufficient quotas to run the IVP, you are?               notified about which quotas need to be increased. A               The procedure then asks if you want to complete the C               installation without running the IVP. Press Return to D               run the IVP after the installation. If you do not want7               to run the IVP, type NO and press Return.o  E               The DECwindows Motif IVP defaults to NO. If you want to 6               run this IVP, type YES and press Return.  *            6. Select installation options.  O               * Do you want to purge files replaced by this installation [YES]?   A               The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE, @               SYS$STARTUP, and SYS$SYSTEM contain older versions@               of OpenVMS Debugger files. Some of these files areB               replaced during the installation with new files, and@               the following files are deleted because they wouldD               prevent the OpenVMS Version 6.0 Debugger from working:  (                  SYS$HELP:DBG$DSHELP.HLB*                  SYS$HELP:DBG$DSUIHELP.HLB  D               The old files are not automatically purged. Purging isB               recommended. To purge the old files, press Return atD               the prompt. If you want to keep the old files, type NO               and press Return.   .            7. Read the informational messages.  .      2-4 Installing Compaq C++ for OpenVMS VAX    $      G                                   Installing Compaq C++ for OpenVMS VAX H                          2.1 Installing the OpenVMS Version 6.0 Debugger  @                  The installation procedure displays a number ofC                  informational messages that report on the progress H                  of the installation. There are no further questions. IfG                  the installation is succeeding, VMSINSTAL moves new orl<                  modified files to their target directories.  H                  A successful installation is indicated by the following                  message:   V         %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories...  @                  If you typed YES in response to the prompt thatF                  requests a file purge at step 6, previous versions ofG                  the OpenVMS Version 6.0 Debugger files are now purged.   !               8. Observe the IVP.o  G                  If you chose to run the IVP in step 5, VMSINSTAL callssH                  the IVP to verify that the OpenVMS Version 6.0 Debugger,                  was installed successfully.  T         ****************************************************************************T         *                                                                          *T         *           Beginning the Debug V6.0 Verification Procedure                *T         *                                                                          *T         ****************************************************************************  T         ****************************************************************************T         *                                                                          *T         *                  Debug verification procedure successful                 *T         *                                                                          *T         ****************************************************************************  >                  If you chose in step 5 to run the interactiveE                  DECwindows Motif IVP by answering YES, the procedureVG                  first checks to see that a suitable DISPLAY is defined H                  and available on which to bring up the windows. It thenA                  displays the following message and instructions:               H                               Installing Compaq C++ for OpenVMS VAX  2-5    c      *      Installing Compaq C++ for OpenVMS VAX4      2.1 Installing the OpenVMS Version 6.0 Debugger  Q      ****************************************************************************$Q      *                                                                          * Q      *           Beginning the Debug V6.0 Verification Procedure                * Q      *            using the Motif Windows User Interface                        * Q      *                                                                          *iQ      ****************************************************************************l/      %DBG-I-IVP, The IVP will display on _WSA1:   4          When the windows come up, do the following:H          -  Go to the command window and click on the STEP button twice.6          -  Pull down the FILE menu and click on EXIT.5          -  Click the OK button to exit the debugger.r  @               When you complete the final step from the previousC               example, the IVP completes and displays the following1               message:  0               %DBG-S-IVP, The IVP has completed.  A                       Installation of DBG V6.0 completed at hh:mmu  B               If a DISPLAY is not available, the following message(               appears and the IVP exits:  R               This machine is not a workstation.  Skipping display-oriented tests.  -            9. End the installation procedure.o  <                  Installation of DBG V6.0 completed at hh:mm  2                  VMSINSTAL procedure done at hh:mm                 $ LOGOUT8               SYSTEM     logged out at dd-mmm-yyyy hh:mm  A               VMSINSTAL deletes or changes entries in the processdB               symbol tables during the installation. Therefore, if@               you are going to continue using the system manager@               account and you want to restore these symbols, you.               should log out and log in again.  B            The file DEBUG$STARTUP.COM contains commands to install3            the OpenVMS Version 6.0 Debugger images.s    .      2-6 Installing Compaq C++ for OpenVMS VAX    0      G                                   Installing Compaq C++ for OpenVMS VAX H                          2.1 Installing the OpenVMS Version 6.0 Debugger  0               OpenVMS Version 6.0 Debugger Files  H               The installation procedure puts the following files in the2               following directories on the system:  H               __________________________________________________________H               Directory_____________File_Name___________________________  -               SYS$LIBRARY           DEBUG.EXEa0                                     DEBUGSHR.EXE2                                     DEBUGUISHR.EXE-                                     TRACE.EXE 0                                     DEBUGUIL.UID  0               SYS$HELP              DBG$HELP.HLB3                                     DBG$DW$HELP.HLB   1               SYS$MESSAGE           DBGTBKMSG.EXEn  /               SYS$TEST              DBG$IVP.COMe1                                     IVP_IMAGE.PAS 1                                     IVP_IMAGE.EXED2                                     IVP_SCRIPT.TSTH               ______________________IVP_SCRIPT.OUT_OLD__________________    >         2.2 Installing the Compaq C++ for OpenVMS VAX Compiler  C               If it is not already inserted, place the compact discr3               (CD-ROM) media into the CD-ROM drive.a  D               To abort the installation procedure at any time, pressG               Ctrl/Y. When you press Ctrl/Y, the installation procedureyC               deletes all files it has created up to that point anda?               exits. You can then start the installation again.   D               When the system prompts you with a question during theH               installation procedure, the default answer is often listed               in brackets ([]).   D               1. Log in to a privileged account and set your default4                  device and directory to SYS$UPDATE.  "                   Username: SYSTEM                   Password:f  H                               Installing Compaq C++ for OpenVMS VAX  2-7 e  s      *      Installing Compaq C++ for OpenVMS VAX;      2.2 Installing the Compaq C++ for OpenVMS VAX Compilert              2. Invoke VMSINSTAL.   <               @SYS$UPDATE:VMSINSTAL saveset-name device-name      option-list  E               To start the installation, invoke the VMSINSTAL commandoE               procedure from a privileged account, such as the SYSTEMLD               account. VMSINSTAL is in the SYS$UPDATE directory. TheE               elements that you specify when you invoke the VMSINSTAL /               command procedure are as follows:                  saveset-nameE               The installation name for the component. For Compaq C++XC               for OpenVMS VAX, use the following installation name:                  CXX05n  ?               n represents the minor (point) release number for_)               Compaq C++ for OpenVMS VAX.   D               To obtain the save-set name, enter a DIRECTORY command=               specifying the directory file from the previoush               command:  5               $ DIRECTORY DKA400:[CXX05n.KIT]CXX05n.A   >               n represents the minor release of Compaq C++ for               OpenVMS VAX.                 device-name C               The name of the device on which you plan to mount the ?               media and the directory containing the Compaq C++g?               for OpenVMS VAX save set. For example, DKA400: is A               the device name used in examples in this guide. ThenA               directory is [CXX05n], where n is the minor release                number.   B               To specify the device name on the @VMSINSTAL command               line, enter:                 DKA400:[CXX05n]k                 option-list =               The word OPTIONS followed by one or more of the 9               following option designators-A, G, L, N, R:f  '               o  Auto_answer option (A)   .      2-8 Installing Compaq C++ for OpenVMS VAX t  O      G                                   Installing Compaq C++ for OpenVMS VAX H                   2.2 Installing the Compaq C++ for OpenVMS VAX Compiler  G                     Initially creates a file that contains your answerstH                     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)l  E                     Lets you store product save sets temporarily on an9                     magnetic tape or in a disk directory.p  '                  o  File log option (L)   F                     Logs all activity to the terminal during installa-                     tion.V  :                  o  Display or print the release notes (N)  C                     Indicates that you want to see the installation D                     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.r  C                     If you are restarting the installation and have G                     already reviewed the release notes, you do not needeD                     to specify the N option. (Even if you omit the NE                     option when you invoke VMSINSTAL, the DEC C++ fornF                     OpenVMS VAX Release Notes are copied automatically/                     to the SYS$HELP directory.)   /                  o  Alternative root option (R)   G                     Lets you install the product to a system root otheru4                     than that of the running system.  H                  For detailed information on these software installationE                  options, see the OpenVMS operating system documenta- H                  tion. If you specify more than one option, separate the:                  options with commas, such as OPTIONS A,N.  C                  The following example invokes VMSINSTAL to installf@                  Compaq C++ for OpenVMS VAX and shows the systemG                  response. This example uses the OPTIONS N release note                   option.  H                               Installing Compaq C++ for OpenVMS VAX  2-9 T  I      *      Installing Compaq C++ for OpenVMS VAX;      2.2 Installing the Compaq C++ for OpenVMS VAX Compileri  F               $ @SYS$UPDATE:VMSINSTAL CXX05n DKA400:[CXX05n] OPTIONS N  L                     OpenVMS VAX Software Product Installation Procedure V6.1  )               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.  A               When you invoke VMSINSTAL, it checks the following:   C               o  Whether you are logged in to a privileged account.dE                  Compaq recommends that you install software from the B                  system manager's account with your default device1                  and directory set to SYS$UPDATE.I  C               o  Whether you have adequate quotas for installation. ?                  VMSINSTAL checks for the quota values shown in                   Table 1-2./  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:   9               * Do you want to continue anyway [NO]?  YESm  E               If you want to continue, enter YES. If you want to stopV-               the installation, press Return.   $            3. Confirm system backup.  L               * Are you satisfied with the backup of your system disk [YES]?  A               If you are satisfied with the backup of your system D               disk, press Return. Otherwise, enter NO to discontinueC               the installation. After you back up your system disk,M/               you can restart the installation.   E               If you omitted the device name on the VMSINSTAL command 1               line, the following prompt appears:T  O               * Where will the distribution volumes be mounted: DKA400:[CXX05n]   /      2-10 Installing Compaq C++ for OpenVMS VAX  p  ,      G                                   Installing Compaq C++ for OpenVMS VAX H                   2.2 Installing the Compaq C++ for OpenVMS VAX Compiler  >                  If this prompt appears, enter the name of theH                  distribution (media) device and directory that containsC                  the Compaq C++ for OpenVMS VAX kit (save set). For-G                  example, if the media is contained on a CD-ROM locatedeH                  on unit DKA400:, enter DKA400:[CXX05n] in reply to this@                  question (where n is the minor version number).  F                  If you entered the wrong device name when you invokedC                  VMSINSTAL and need to restart the installation, or D                  if you want to abort the installation for any other&                  reason, press Ctrl/Y.  4               4. Verify the product being installed.  ;                   The following products will be processed:s                       CXX V5.n  A                       Beginning installation of CXX V5.n at hh:mms  I                     %VMSINSTAL-I-RESTORE, Restoring product save set A...V  F                  The product name and version are displayed. This saveF                  set (A) is restored to a subdirectory of SYS$UPDATE:.  D                  %VMSINSTAL-I-RELMOVED, Product's release notes have(                  been moved to SYS$HELP.  G                  The release notes are copied to the following files intE                  the SYS$HELP directory (where n is the minor versiont                  number):e  .                  SYS$HELP:CXX05n.RELEASE_NOTES1                  SYS$HELP:CXX05n_RELEASE_NOTES.PSc  D                  After the installation, you can enter the followingB                  command to view the location of the release notes+                  through the Help facility:n  )                  $ HELP CXX RELEASE_NOTES   F                 ________________________Note  ________________________  @                 The name of the release notes file (installed byC                 VMSINSTAL) consists of the current product name andp                 version number.w  E                 _____________________________________________________   H                              Installing Compaq C++ for OpenVMS VAX  2-11 ,  d      *      Installing Compaq C++ for OpenVMS VAX;      2.2 Installing the Compaq C++ for OpenVMS VAX Compiler               5. Purge files.  S               * Do you want to purge files replaced by this installation [YES]? YESw  A               The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE,kD               SYS$SYSTEM, and SYS$TEST may contain previous versionsB               of Compaq C++ files. These files are replaced duringD               the installation with new files, but the old files areB               not automatically purged. Purging is recommended. InC               response to the purging prompt, press Return or enter B               YES and press Return to purge the files. To keep the/               files, enter NO and press Return.   6            6. Respond to license registration queries.  ?               The Compaq C++ for OpenVMS VAX compiler component E               supports the OpenVMS License Management Facility (LMF).eC               If you entered YES to install the compiler component,rE               the installation procedure displays license informationoC               about Compaq C++ for OpenVMS VAX. It asks whether youvC               have registered and loaded your PAK for each product.eD               The following is an example of the information and the>               queries presented by the installation procedure:  Y                   Compaq C++ requires a Product Authorization Key (PAK) be registered andeZ                   loaded.  Answer the following question with YES if at least one PAK withW                   the specified product name and a date equal to or later than the date F                   shown is registered and loaded, otherwise answer NO.  <                     Product:      CXX-V, CXX-V-USER, CXX-V-G%                     Producer:     DEC %                     Version:      5.na-                     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 C               must answer NO to this question. You have to register =               and load your PAKs to successfully complete the B               installation (see Section 1.1). If you have not doneE               so, you should stop the installation, register and load*;               your PAKs, and then restart the installation.   B            7. Choose the Installation Verification Procedure (IVP)               option.D  /      2-12 Installing Compaq C++ for OpenVMS VAX  *         G                                   Installing Compaq C++ for OpenVMS VAX H                   2.2 Installing the Compaq C++ for OpenVMS VAX Compiler  F                  If you have chosen to install the compiler component,G                  the installation procedure now asks if you want to rund                  the IVP.t  M                      This kit contains an Installation Verification ProcedureeQ                      (IVP) to  verify the correct  installation of the Compaq C++ :                      compiler.  The IVP will be placed in:  4                                 SYS$TEST:CXX$IVP.COM  K                      After the installation is complete, you can invoke thehL                      command file at any time to reverify that Compaq C++ is5                      installed and working correctly.   K                  * Do you want to run the IVP after the installation [YES]?   A                  After the Compaq C++ for OpenVMS VAX compiler is G                  installed, you can run the IVP independently to verify C                  that the software is available on your system. You D                  might need to run the IVP after a system failure toG                  make sure that the users can access the Compaq C++ forp&                  OpenVMS VAX compiler.  -               8. Read informational messages.   D                  The installation procedure now displays a number ofF                  informational messages that report on the progress ofE                  the installation. There are no further questions. IfpE                  the installation procedure has been successful up toyF                  this point, VMSINSTAL moves the new or modified filesE                  to their target directories, updates help files, andcH                  updates DCL tables, if necessary. The new files include                  the following:e                        H                              Installing Compaq C++ for OpenVMS VAX  2-13    t      *      Installing Compaq C++ for OpenVMS VAX;      2.2 Installing the Compaq C++ for OpenVMS VAX Compilerh  T                   SYS$HELP:CXX056.RELEASE_NOTES                                [new]T                   SYS$HELP:CXX056_RELEASE_NOTES.PS                             [new]T                   SYS$SYSTEM:CXX$COMPILER.EXE                                  [new]T                   SYS$MESSAGE:CXX$MSG_SHR.EXE                                  [new]T                   SYS$SYSTEM:CXX$DEMANGLE.EXE                                  [new]T                   SYS$SYSTEM:CXX$LINK.EXE                                      [new]T                   SYS$SYSTEM:CXX$LINK_MSG.EXE                                  [new]Y                   SYS$HELP:HELPLIB.HLB                                         [modified]gT                   SYS$COMMON:[SYSHLP.CXX$HELP]*.*                              [new]Y                   SYS$LIBRARY:DCLTABLES.EXE                                    [modified]nT                   SYS$LIBRARY:DECC$RTLDEF.TLB                                  [new]T                   DECC$LIBRARY_INCLUDE:*.H                                     [new]T                   SYS$LIBRARY:CXXL$DEF_H.TLB                                   [new]T                   SYS$LIBRARY:CXXL$DEF_HXX.TLB                                 [new]T                   CXX$LIBRARY_INCLUDE:*.H,*.HXX                                [new]T                   SYS$TEST:CXX$IVP.COM                                         [new]T                   SYS$STARTUP:CCXX$STARTUP.COM                                 [new]T                   SYS$LIBRARY:CXXL$ANSI_DEF.TLB                                [new]T                   SYS$LIBRARY:LIBCXXSTD.OLB                                    [new]T                   SYS$LIBRARY:DECC$CRTL.OLB                                    [new]T                   SYS$LIBRARY:DECC$CRTL.EXE                                    [new]T                   SYS$LIBRARY:DECC$CRTL.README                                 [new]  D               The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE>               files are updated to include the new versions of>               the Compaq C++ for OpenVMS VAX help text (module@               CXX$HELP.HLP) and the CXX command-line definition.  =               The end of the installation is indicated by the                 following message:  S      %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...u  B               If Compaq C++ for OpenVMS VAX was installed success-4               fully, the IVP displays the following:  [                  Compaq C++ V6.2 Installation Verification Procedure completed successfullyi  <                  Installation of CXX V5.n completed at hh:mm  2                  VMSINSTAL procedure done at hh:mm        /      2-14 Installing Compaq C++ for OpenVMS VAX            G                                   Installing Compaq C++ for OpenVMS VAXrH                   2.2 Installing the Compaq C++ for OpenVMS VAX Compiler  E                  Depending on whether you specified parameters on the F                  VMSINSTAL command line, the * Products: prompt or theE                  DCL prompt ($) may appear. If the * Products: prompt F                  appears, you can return to the DCL prompt by pressing                  Ctrl/Z.  G                  If you removed any media from the console drive before G                  beginning the installation, you should replace it now.n  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 theses>                  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 to H               continue. To stop the installation process and correct theF               situation, enter NO or press Return. Correct the problem+               and restart the installation.0  D               If errors occur during the installation itself or whenG               the Installation Verification Procedure (IVP) is running, F               VMSINSTAL displays failure messages. If the installationF               fails, the installation procedure the following message:  R               %VMSINSTAL-E-INSFAIL, The installation of Compaq C++ for OpenVMS VAX%               Version 5.n has failed.n  ;               If the IVP fails, it displays these messages:n  R               The Compaq C++ for OpenVMS VAX Version 5.n Installation Verification               Procedure failed.t  J               %VMSINSTAL-E-IVPFAIL, The IVP for Compaq C++ for OpenVMS VAX%               Version 5.n has failed.   D               Errors can occur during the installation if any of the)               following conditions exist:p  ;               o  The operating system version is incorrect.h  >               o  A prerequisite software version is incorrect.  H                              Installing Compaq C++ for OpenVMS VAX  2-15           *      Installing Compaq C++ for OpenVMS VAX      2.3 Error Recoveryu  >            o  Quotas necessary for successful installation are               insufficient.   E            o  System parameter values for successful installation aret               insufficient.i  ;            o  The OpenVMS Help library is currently in use.p  E            o  The product license has not been registered and loaded.y  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 on 4            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 ?            HELP/MESSAGE facility. If the installation fails due <            to an IVP failure, contact a Compaq field service            representative.                                        /      2-16 Installing Compaq C++ for OpenVMS VAX                        H                                                                        3H         ________________________________________________________________  H                                                       After Installation      D               Compaq C++ for OpenVMS VAX is now installed and can be8               invoked by all users with the cxx command.  G               The installation procedure modifies the DCL command tablehB               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:   9               $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLESM  G               The following tasks can be performed after Compaq C++ ford'               OpenVMS VAX is installed:   F               o  Running the Installation Verification Procedure (IVP)                  separatelye  >               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  Reporting problemst  D               The following sections describe these tasks in detail.  G         3.1 Running the Installation Verification Procedures Separately   F               You usually run the Installation Verification ProceduresE               (IVPs) during installation. If you want to run the IVPsLC               separately to ensure the integrity of installed files A               should system problems occur, use the following IVPs!               command procedures:e  H                                                   After Installation 3-1    c            After InstallationtD      3.1 Running the Installation Verification Procedures Separately  "            $ @SYS$TEST:DBG$IVP.COM%            $ @SYS$TEST:DBG$DW$IVP.COM "            $ @SYS$TEST:CXX$IVP.COM  C            If an IVP fails for any reason, the following message isr            displayed:e  >            Compaq C++ for OpenVMS VAX VERSION V5.n TEST FAILED  ,      3.2 Editing and Organizing System Files  C            To provide for automatic startup of Compaq C++ when your ?            system is rebooted, add the command line that starts A            Compaq C++ for OpenVMS VAX to the system startup file,o@            SYS$MANAGER:SYSTARTUP_VMS.COM. Compaq C++ for OpenVMS@            VAX cannot start until after the network has started.A            You must position this new command line after the linenB            that invokes the network startup command procedure. TheC            following example shows the network startup command line E            followed by the Compaq C++ for OpenVMS VAX startup command             line:  &            $ @SYS$MANAGER:STARTNET.COM                 .b                 .e                 . *            $ @SYS$STARTUP:CCXX$STARTUP.COM  ?            You must invoke this command procedure to define theeC            logical names that the compiler needs to find the CompaqA1            C++ Class Library header source files.   C               ________________________Note ________________________   <               SYS$STARTUP:CCXX$STARTUP.COM starts the Compaq<               C++ for OpenVMS VAX compiler only. To activate<               the OpenVMS Version 6.0 Debugger you must exe-;               cute SYS$STARTUP:DEBUG$STARTUP.COM. To invoke ;               the Compaq C/C++ Run-Time Components, execute *               SYS$STARTUP:CRT$STARTUP.COM.  C               _____________________________________________________             3-2 After Installation            H                                                       After InstallationH                                  3.2 Editing and Organizing System Files  F               If you have a system logical name or one or more optionsE               files that point to the old linker and the old run-time O               libraries (RTLs) that resided in dev:[CXX$LIBRARY.SYSTEM]LINK.EXEtE               and dev:[DECC$LIBRARY.CRTL]*.*, you should remove them.nG               That linker is obsolete and the RTLs are made obsolete bySF               the new Compaq C/C++ Run-Time Components Version 6.0 forH               OpenVMS VAX kit (or by your OpenVMS VAX system Version 6.0               or higher).a  A               To let system users use the newly installed OpenVMShG               Version 6.0 Debugger kit, deactivate alternative versions D               of the OpenVMS Debugger that might have been installed?               by layered product kits. Remove the startup file, C               SYS$STARTUP:DEBUG$STARTUP.COM from the system startup A               file, SYS$STARTUP:SYSTARTUP_V5.COM. Also delete the_D               following files to remove the obsolete DECset Debugger'               product from your system:-  %               SYS$HELP:DBG$DSHELP.HLBC'               SYS$HELP:DBG$DSUIHELP.HLBh.               DECW$SYSTEM_DEFAULTS:DSDEBUG.DAT)               SYS$MESSAGE:DSDBGTBKMSG.EXEy%               SYS$LIBRARY:DSDEBUG.EXE (               SYS$LIBRARY:DSDEBUGSHR.EXE*               SYS$LIBRARY:DSDEBUGUISHR.EXE(               SYS$LIBRARY:DSDEBUGUIL.UID+               SYS$STARTUP:DEBUG$STARTUP.COM (               SYS$STARTUP:DEBUGSETUP.COM  I               The OpenVMS Version 6.0 Debugger .DAT file is VMSDEBUG.DAT.fA               If your system has a customized DEBUG.DAT file usedeB               to configure the OpenVMS Debugger, copy DEBUG.DAT toC               SYS$LOGIN:VMSDEBUG.DAT so that the customizations are C               reflected upon starting up the Motif interface to the                debugger.r  %         3.3 VMScluster Considerations   G               After completing the initial installation, if you want toOG               install Compaq C++ for OpenVMS VAX on multiple nodes in aYE               cluster you must run INSTALL on each of the other nodesp/               and enter the following commands:       H                                                   After Installation 3-3 s  e            After Installationp"      3.3 VMScluster Considerations  6            INSTALL>  REPLACE SYS$LIBRARY:DCLTABLES.EXE2            INSTALL>  REPLACE SYS$LIBRARY:DEBUG.EXE5            INSTALL>  REPLACE SYS$LIBRARY:DEBUGSHR.EXEz2            INSTALL>  REPLACE SYS$LIBRARY:TRACE.EXE6            INSTALL>  REPLACE SYS$MESSAGE:DBGTBKMSG.EXE  C            Execute CCXX$STARTUP.COM on all single-architecture (VAXdD            only) clusters, that have a Compaq C++ license. To invokeC            OpenVMS Version 6.0 Debugger, execute DEBUG$STARTUP.COM.:B            To invoke the Compaq C/C++ Run-Time Components, execute'            SYS$STARTUP:CRT$STARTUP.COM..  >            If you are using a dual-architecture (VAX and AlphaA            systems) heterogeneous cluster, before executing these A            commands, make sure the appropriate logical names haveaB            been set to define the scope of the SYSMAN DO commands.A            For more information, see the OpenVMS System Manager'sc            Manual.  "      3.4 User Account Requirements  D            Many products cannot be used unless certain privilege andE            quota requirements are met by user accounts. The followingtA            sections describe the privilege and quota requirementsi:            needed to work with Compaq C++ for OpenVMS VAX.        3.4.1 User Privileges  D            To use Compaq C++ for OpenVMS VAX, each account must haveE            at least the TMPMBX and NETMBX privileges. Use the OpenVMS @            Authorize Utility to determine whether users have the#            privileges they require.         3.4.2 User Account Quotas  E            To use Compaq C++ for OpenVMS VAX, a user account does not D            need to meet any special quota requirements. However, for@            users who will be compiling very large programs (many?            program units compiled together), consider adjustingiB            the working set (WSDEF, WSQUOTA, WSEXTENT) and pagefile=            (PGFLQUOTA) account quotas to improve performance.,  C            See Section 1.3.3 for a description of how to verify andr!            change account quotas.         3-4 After Installationi c  e      H                                                       After InstallationH                                  3.5 Getting Help and Reporting Problems  /         3.5 Getting Help and Reporting Problems   G               If an error occurs while Compaq C++ for OpenVMS VAX is innG               use and you believe the error is caused by a problem withs6               the product, please report it to Compaq.  H               If you have a Software Product Services Support Agreement,E               contact your Customer Support Center (CSC) by telephoneiA               or by using the electronic means provided with yourfC               support agreement (such as DSNlink). The CSC providestD               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  E               o  The version number of Compaq C++ for OpenVMS VAX you                   are using  C               o  The hardware system you are using (such as a modelC                  number)  D               o  A brief description of the problem (one sentence if                  possible)  ,               o  How critical the problem is  F               Whether you submit information electronically or contactE               the appropriate support specialist by telephone, please '               take the following steps:.  E               1. Describe as accurately as possible the circumstances:C                  and state of the system when the problem occurred. B                  Include the description and version number of the@                  Compaq C++ for OpenVMS VAX compiler being used.@                  Demonstrate the problem with specific examples.  C               2. Reduce the problem to as small a size as possible.H  C               3. Remember to include listings of any command files, E                  INCLUDE files, or relevant data files, and so forth.[  2               4. Provide a listing of the program.  F               5. If the program is longer than 50 lines, submit a copyF                  of it on machine-readable media (diskette or magneticG                  tape). If necessary, also submit a copy of the program 7                  library used to build the application.   H                                                   After Installation 3-5                 After Installation ,      3.5 Getting Help and Reporting Problems  ;            6. Report only one problem per report. This willX+               facilitate a faster response.   0            7. Mail the problem report to Compaq.  B            If the problem is related to Compaq C++ for OpenVMS VAXC            documentation, you can report the problem to the CSC (if A            you have a Software Product Services Support Agreement D            and the problem is severe); otherwise, send your comments@            about Compaq C++ for OpenVMS VAX documentation to the&            following Internet address:              cxx_docs@zko.dec.comE  C            To obtain information about purchasing a Compaq Softwareh>            Product Services Support Agreement or other supportD            services, please contact your local sales representative.                                                              3-6 After InstallationX o  n                  H                                                                        AH         ________________________________________________________________  H                                                     Sample Installations      E               This appendix contains sample installations for each of C               the components on the Compaq C++ for OpenVMS VAX kit.i@               These are only samples. Sometimes the installationB               procedure is modified in maintenance updates of this               product.  H               Be sure to read the Read Before Installing or Using CompaqH               C++ Version 5.6C for OpenVMS VAX letter before you installH               this product. This letter notes any significant changes toG               the installation sample shown here. Such information also 2               appears in the online release notes.  D               The following samples were installed on an OpenVMS VAXB               system. Depending on which layered products you haveC               on your system, you might see additional messages and ;               questions when you perform your installation.   D               These sample installations assume that DECnet has beenH               shut down, that no users are logged in to your system, andE               that OPTIONS N is specified to print the release notes. G               The Installation Verification Procedure (IVP) runs at thec&               end of the installation.  D               Example A-1 shows a sample installation of the OpenVMS<               Version 6.0 Debugger on an OpenVMS VAX system.                    H                                                 Sample Installations A-1 a  t            Sample Installationst    G            Example A-1 Sample OpenVMS Version 6.0 Debugger Installationo%                        on OpenVMS VAXe  L            @sys$update:vmsinstal dbg060 $disk1:[install_test.kits] options i  B             VAX/VMS Software Product Installation Procedure V5.5-2  %            It is 2-NOV-1999 at 15:12.   :            Enter a question mark (?) at any time for help.  O            %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account.aI            %VMSINSTAL-W-ACTIVE, The following processes are still active::4            The following products will be processed:                DBG V6.0V  7             Beginning installation of DBG V6.0 at 15:13   A            %VMSINSTAL-I-RESTORE, Restoring product save set A ...hV            %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.  R                  This kit installs Debug version V6.0C-000.  Note that it requiresT                  at least OpenVMS VAX V5.4 and, at most, OpenVMS VAX V5.5-2.  If theT                  debugger's graphical user interface is to be used, it also requires%                  Motif V1.0 or later.s  U                 ********************************************************************* U                 *                                                                   *sU                 *                                                                   *cU                 *  THIS INSTALLATION WILL REPLACE YOUR CURRENT VMS SYSTEM DEBUGGER! *yU                 *                                                                   * U                 *                                                                   *cU                 *********************************************************************r  Q                  You should insure that you have saved the current version of theoC                  system debugger by backing up the following files:a  E                                              (continued on next page)                   A-2 Sample Installationsa o  a      H                                                     Sample Installations    E               Example A-1 (Cont.) Sample OpenVMS Version 6.0 Debuggeri=                                   Installation on OpenVMS VAXd  3                               SYS$LIBRARY:DEBUG.EXEs6                               SYS$LIBRARY:DEBUGSHR.EXE7                               SYS$LIBRARY:DBGSSISHR.EXEn6                               SYS$LIBRARY:DEBUGUIL.UID3                               SYS$HELP:DBG$HELP.HLB 5                               SYS$HELP:DBG$DWHELP.HLB 3                               SYS$LIBRARY:TRACE.EXEg7                               SYS$MESSAGE:DBGTBKMSG.EXE   H               * Do you want to run the IVP after the installation [YES]?O               * Do you want to run the interactive DEC Windows Motif IVP? [NO]: R               * Do you want to purge files replaced by this installation [YES]? noZ               %DBG-I-DONEASK, No further questions will be asked during this installation.  J               %DBG-I-ENDRESTORE, All Debugger savesets have been restored.8               %DBG-I-LINKDONE, DEBUGSHR has been linked.5               %DBG-I-LINKDONE, DEBUG has been linked.e5               %DBG-I-LINKDONE, TRACE has been linked. :               %DBG-I-LINKDONE, DEBUGUISHR has been linked.9               %DBG-I-CLEANUP, Cleanup has been performed.l>               %DBG-I-PROHELP, Providing Debugger Help files...L               %DBG-I-PRORES, Providing Resource file for Debugger visuals...@               %DBG-I-PROMSG, Providing Debugger message image...8               %DBG-I-PROEXE, Providing Debugger files...<               %DBG-I-PROIVP, Providing test files for IVP...  H                                                 (continued on next page)                              H                                                 Sample Installations A-3    d            Sample Installations     B            Example A-1 (Cont.) Sample OpenVMS Version 6.0 Debugger:                                Installation on OpenVMS VAX  Z            *******************************************************************************Z            *                                                                             *Z            *  The Debugger IVP has been moved to the SYS$TEST directory.  To run         *Z            *  the IVP after installation, enter @SYS$TEST:DBG$IVP.COM for the character  *Z            *  cell IVP.  If DECWindows Motif has been installed on your system, enter    *Z            *  @SYS$TEST:DBG$DW$IVP.COM for the interactive DECWindows Motif IVP.         *Z            *                                                                             *Y            ******************************************************************************IY            %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...mZ            *******************************************************************************Z            *                                                                             *Z            *            Beginning the Debug V6.0 Verification Procedure                  *Z            *                                                                             *Z            *******************************************************************************Z            *******************************************************************************  Z            *                                                                             *  Z            *                  Debug verification procedure successful                    *  Z            *                                                                             *  Z            *******************************************************************************  7             Installation of DBG V6.0 completed at 15:21r  -             VMSINSTAL procedure done at 15:21L  D            Example A-2 shows a sample installation of the Compaq C++B            for OpenVMS VAX compiler Version 5.6C on an OpenVMS VAX            system.  E            Example A-2 Sample Compaq C++ for OpenVMS VAX Installation   E                                              (continued on next page)e                    A-4 Sample Installations            H                                                     Sample Installations    C               Example A-2 (Cont.) Sample Compaq C++ for OpenVMS VAX_.                                   Installation  %               $ @sys$update:vmsinstal   N                       OpenVMS VAX Software Product Installation Procedure V7.1  (               It is 2-NOV-1999 at 17:07.  =               Enter a question mark (?) at any time for help.oP               * Are you satisfied with the backup of your system disk [YES]? YESO               * Where will the distribution volumes be mounted: DKA400:[CXX056]   X               Enter the products to be processed from the first distribution volume set.                * Products: CXX056D               * Enter installation options you wish to use (none): N7               The following products will be processed:                  CXX V5.6  A                       Beginning installation of CXX V5.6 at 17:07   D               %VMSINSTAL-I-RESTORE, Restoring product save set A ...Y               %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.e  A                   Compaq C++ Version V5.6 for OpenVMS VAX Systemsu  ]                 Copyright (c) Digital Equipment Corporation 1993, 1999.  All rights reserved.e  N                 Restricted Rights: Use, duplication, or disclosure by the U.S.R                 Government is subject to restrictions as set forth in subparagraphR                 (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR2                 52.227-14 Alt. III, as applicable.  M                 This software is proprietary to and embodies the confidential P                 technology of Digital Equipment Corporation. Possession, use, orS                 copying of this software and media is authorized only pursuant to a P                 valid written license from Digital or an authorized sublicensor.  S               * Do you want to purge files replaced by this installation [YES]? YESU  Y                   Compaq C++ requires a Product Authorization Key (PAK) be registered and Z                   loaded.  Answer the following question with YES if at least one PAK withW                   the specified product name and a date equal to or later than the daterF                   shown is registered and loaded, otherwise answer NO.  H                                                 (continued on next page)  H                                                 Sample Installations A-5 t               Sample Installationsh    @            Example A-2 (Cont.) Sample Compaq C++ for OpenVMS VAX+                                Installation   9                    Product:      CXX-V,CXX-V-USER,CXX-V-Gs$                    Producer:     DEC$                    Version:      5.6+                    Release Date: 2-NOV-1999   S            * Does this product have an authorization key registered and loaded? YEST  G                This kit contains an Installation Verification Procedure K                (IVP) to  verify the correct  installation of the Compaq C++)4                compiler.  The IVP will be placed in:  /                            SYS$TEST:CXX$IVP.COMB  E                After the installation is complete, you can invoke thetF                command file at any time to reverify that Compaq C++ is/                installed and working correctly.   I            * Do you want to run the IVP after the installation [YES]? YESc  O                All questions regarding the installation of Compaq C++ have beennN                asked.  The installation will now continue for 10 to 40 minutesW                depending on your CPU type and the installation options you have chosen.   8                Providing  command support and HELP files  4                Providing compiler and message images  <                Providing .h headers in DECC$LIBRARY_INCLUDE:  R                Providing class library .h and .hxx headers in CXX$LIBRARY_INCLUDE:  C                File selection portion of installation is completed.V  O                Your VMS system will now be updated to include the following news"                and modified files:  E                                              (continued on next page)h                A-6 Sample Installationsu s         H                                                     Sample Installations    C               Example A-2 (Cont.) Sample Compaq C++ for OpenVMS VAXu.                                   Installation  T                   SYS$HELP:CXX056.RELEASE_NOTES                                [new]T                   SYS$HELP:CXX056_RELEASE_NOTES.PS                             [new]T                   SYS$SYSTEM:CXX$COMPILER.EXE                                  [new]T                   SYS$MESSAGE:CXX$MSG_SHR.EXE                                  [new]Y                   SYS$HELP:HELPLIB.HLB                                         [modified] T                   SYS$COMMON:[SYSHLP.CXX$HELP]*.*                              [new]Y                   SYS$LIBRARY:DCLTABLES.EXE                                    [modified]pT                   SYS$LIBRARY:DECC$RTLDEF.TLB                                  [new]T                   DECC$LIBRARY_INCLUDE:*.H                                     [new]T                   SYS$LIBRARY:DECC$RTLDEF_HXX.TLB                              [new]T                   SYS$LIBRARY:CXXL$DEF.TLB                                     [new]T                   SYS$LIBRARY:CXXL$DEF_HXX.TLB                                 [new]T                   CXX$LIBRARY_INCLUDE:*.H,*.HXX                                [new]T                   SYS$TEST:CXX$IVP.COM                                         [new]T                   SYS$STARTUP:CCXX$STARTUP.COM                                 [new]T                   SYS$HELP:CXX056.RELEASE_NOTES                                [new]T                   SYS$HELP:CXX056_RELEASE_NOTES.PS                             [new]T                   SYS$SYSTEM:CXX$COMPILER.EXE                                  [new]T                   SYS$MESSAGE:CXX$MSG_SHR.EXE                                  [new]T                   SYS$SYSTEM:CXX$DEMANGLE.EXE                                  [new]T                   SYS$SYSTEM:CXX$LINK.EXE                                      [new]T                   SYS$SYSTEM:CXX$LINK_MSG.EXE                                  [new]Y                   SYS$HELP:HELPLIB.HLB                                         [modified]uT                   SYS$COMMON:[SYSHLP.CXX$HELP]*.*                              [new]Y                   SYS$LIBRARY:DCLTABLES.EXE                                    [modified]oT                   SYS$LIBRARY:DECC$RTLDEF.TLB                                  [new]T                   DECC$LIBRARY_INCLUDE:*.H                                     [new]T                   SYS$LIBRARY:CXXL$DEF_H.TLB                                   [new]T                   SYS$LIBRARY:CXXL$DEF_HXX.TLB                                 [new]T                   CXX$LIBRARY_INCLUDE:*.H,*.HXX                                [new]T                   SYS$TEST:CXX$IVP.COM                                         [new]T                   SYS$STARTUP:CCXX$STARTUP.COM                                 [new]T                   SYS$LIBRARY:CXXL$ANSI_DEF.TLB                                [new]T                   SYS$LIBRARY:LIBCXXSTD.OLB                                    [new]T                   SYS$LIBRARY:DECC$CRTL.OLB                                    [new]T                   SYS$LIBRARY:DECC$CRTL.EXE                                    [new]T                   SYS$LIBRARY:DECC$CRTL.README                                 [new]  H                                                 (continued on next page)      H                                                 Sample Installations A-7 a  t            Sample Installationse    @            Example A-2 (Cont.) Sample Compaq C++ for OpenVMS VAX+                                Installationi  P                Please add the SYS$STARTUP:CCXX$STARTUP.COM to the system startupM                procedure (SYS$STARTUP:SYSTARTUP_V5.COM or SYSTARTUP_VMS.COM).s  T                To use Compaq C++ for OpenVMS VAX on other VAX nodes of a VMScluster,L                from a privileged account on each such node enter the commandO                "$ @SYS$STARTUP:CCXX$STARTUP.COM".  This will install images and_0                define system-wide logical names.  Y            %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...t  P                Beginning Compaq C++ Combined Installation Verification Procedure  ]                Copyright (c) Digital Equipment Corporation, 1995, 1999.  All rights reserved.   M                Restricted Rights: Use, duplication, or disclosure by the U.S.cQ                Government is subject to restrictions as set forth in subparagraph Q                (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 1                52.227-14 Alt. III, as applicable.n  L                This software is proprietary to and embodies the confidentialO                technology of Digital Equipment Corporation. Possession, use, ornR                copying of this software and media is authorized only pursuant to aO                valid written license from Digital or an authorized sublicensor.l  <                Test compiler operation and error messages...  ,                Test Class library headers...  .                Test Class Library operation...  Y                Compaq C++ V6.2 Installation Verification Procedure completed successfully   7             Installation of CXX V5.6 completed at 17:26n  T            Enter the products to be processed from the next distribution volume set.            * Products: ^Zl4                    VMSINSTAL procedure done at 17:27                A-8 Sample InstallationsV V  s                  H                                                                        BH         ________________________________________________________________  H                         Files and Logical Names Installed on Your System      E               The Compaq C++ installation procedure installs a number_E               of files on your system and defines some logical names.oH               Section B.1 tells where you can find the list of installedG               files. Section B.2 lists the logical names that are added-/               to the system logical name table.a           B.1 File Names  D               The kit for the Compaq C++ compiler includes a list ofG               all the files created on your system when this product is                installed.           B.2 Logical Names   D               Some or all of the following logical names are enteredA               into the system logical name table when you installeC               Compaq C++ for OpenVMS VAX. These names are stored in.H               the product's startup file. They are automatically enteredD               into the system logical name table whenever the system:               reboots or whenever the software is invoked.                 o  CXX$LIBRARY  $               o  CXX$LIBRARY_INCLUDE  #               o  CXX$LIBRARY_SYSTEM*                 o  DECC$LIBRARY   %               o  DECC$LIBRARY_INCLUDE           H                     Files and Logical Names Installed on Your System B-1                       H                                                                        CH         ________________________________________________________________  H                                                   Recovering from Errors      A               This appendix provides information to help you with*@               failures or errors that might occur during product*               installation or product use.  3         C.1 Failures During Compaq C++ Installations  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 to D               continue. To stop the installation process and correctG               the situation, enter no or press Return, then correct the 3               problem and restart the installation.   D               If errors occur during the installation itself or whenG               the Installation Verification Procedure (IVP) is running,IF               VMSINSTAL displays failure messages. If the installation7               fails, it displays the following message:   R               %VMSINSTAL-E-INSFAIL, The installation of Compaq C++ for OpenVMS VAX%               Version 5.6 has failed.   ;               If the IVP fails, it displays these messages:o  R               The Compaq C++ for OpenVMS VAX Version 5.6 Installation Verification               Procedure failed.N  J               %VMSINSTAL-E-IVPFAIL, The IVP for Compaq C++ for OpenVMS VAX%               Version 5.6 has failed.K  D               Errors can occur during the installation if any of the)               following conditions exist:e  ;               o  The operating system version is incorrect.H  >               o  A prerequisite software version is incorrect.  A               o  Quotas necessary for successful installation are                   insufficient.  H                                               Recovering from Errors C-1 d               Recovering from Errorsd0      C.1 Failures During Compaq C++ Installation  E            o  System parameter values for successful installation areG               insufficient.   ;            o  The OpenVMS Help library is currently in use.e  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 theseC            conditions exist, you should take the appropriate actiont'            as described in the message.*  <            For information on installation requirements, see            Chapter 1.   '      C.2 Problems During Compaq C++ Use   E            If you encounter a problem while using Compaq C++, see theoD            Release Notes. If the problem is unresolved, report it toD            Compaq. Depending on the type of support you have and theD            nature of the problem, take one of the following actions:  =            o  If you have a Software Product Services SupportrD               Agreement, contact your Compaq 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 for,?               high-level advisory and remedial assistance. When @               you initially contact the CSC, please indicate the               following:  C               -  The name (OpenVMS Alpha) and the version number of 3                  the operating system you are usingu  E               -  The product name (Compaq C++) and the version number ,                  of Compaq C++ you are 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        C-2 Recovering from Errors            H                                                   Recovering from ErrorsH                                       C.2 Problems During Compaq C++ Use  B                  When you submit information electronically or areD                  speaking on the phone to the appropriate Compaq C++B                  support specialist, you can provide more detailed@                  information. The information should include the?                  specific commands used to compile and link theXD                  program, the error messages displayed, and relevantH                  detailed information (possibly including source programE                  listings). Please attempt to narrow the cause of the ?                  problem to a 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 copyIG                  of it electronically or provide machine-readable media 4                  (floppy diskette or magnetic tape).  G               o  If you want to comment on the Compaq C++ documentationdD                  or if you should find errors in this manual, pleaseG                  send the manual title, order number, and your commentse*                  to the following address:  %                  cxx_docs@zko.dec.com                                             H                                               Recovering from Errors C-3