DEC_C++_____________________________________________ Installation Guide for OpenVMS Alpha Systems Order Number: AA-PY27E-TE July 1997 This guide contains instructions for installing DEC C++ on OpenVMS Alpha systems. It also explains how to read the online release notes before or after installing the product. Revision/Update Information: This is a revised manual. Operating System & Version: OpenVMS Alpha Version 6.1 or higher. Future maintenance releases may require higher versions. Software Version: DEC C++ Version 5.6 or higher for OpenVMS Alpha Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ First Printing, June 1993 Second Printing, May 1995 Third Printing, April 1996 Fourth Printing, January 1997 Fifth Printing, July 1997 Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. © Digital Equipment Corporation 1993, 1995, 1996, 1997. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: DEC, Bookreader, DECnet, DECwindows, DIGITAL, OpenVMS, VAX, VAX DOCUMENT, VMS, VMScluster, the DEC C++ logo, and the DIGITAL logo. 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. ZK6306 This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. ______________________________________________________________ Contents ................................................... v Preparing for DEC C++ for OpenVMS Alpha Installation 1.1 License Registration.......................... 1-1 1.2 Required Operating System Components and Software...................................... 1-2 1.3 Installation Procedure Requirements........... 1-3 1.3.1 Process Privileges........................ 1-3 1.3.2 Process Account Quotas.................... 1-3 1.3.3 System Parameters......................... 1-4 1.3.4 Disk Space................................ 1-5 1.3.5 Backing Up Your System Disk............... 1-6 1.3.6 Additional System Maintenance Procedures................................ 1-7 1.3.6.1 Checking System Parameter Values........ 1-7 1.3.6.2 Calculating the Values for Global Pagelets and Global Sections............ 1-7 1.3.6.3 Changing System Parameter Values with AUTOGEN................................. 1-8 1.3.6.4 Setting Dynamic System Parameter Values.................................. 1-9 Installing the DEC C++ for OpenVMS Alpha Compiler 2.1 Installation Procedure........................ 2-1 2.2 Error Recovery................................ 2-12 iii 3 After DEC C++ Installation 3.1 Running the Installation Verification Procedure Separately.......................... 3-2 3.2 Editing and Organizing the System Files....... 3-2 3.3 VMScluster Considerations..................... 3-2 3.4 User Account Requirements..................... 3-2 3.4.1 User Privileges........................... 3-2 3.4.2 User Account Quotas....................... 3-3 3.4.3 Installing the DEC C++ for OpenVMS Alpha Compiler and the DEC C++ Class Library as a Shared Image............................ 3-3 3.5 Getting Help and Reporting Problems........... 3-5 4 Installing the DEC C++ Debugger 4.1 Installing the Debugger....................... 4-2 4.2 After Debugger Installation................... 4-2 A Sample Installation Examples A-1 Sample DEC C++ for OpenVMS Alpha Installation on OpenVMS Alpha............. A-2 Tables 1 Conventions............................... vii 1-1 Optional Software......................... 1-3 1-2 Process Quotas for the Installing Account................................... 1-3 1-3 Minimum Required System Parameter Values.................................... 1-5 1-4 Disk Space Requirements................... 1-6 iv _________________________________________________________________ Preface This guide describes how to install DEC C++ on the OpenVMS Alpha operating system. It is intended for system managers. Keep this guide with your distribution kit, in case you need it to reinstall DEC C++ for OpenVMS Alpha for any reason. You may send comments or suggestions concerning this guide, or any DEC C++ for OpenVMS Alpha document, by electronic mail to the following Internet address: cxx_docs@casdoc.enet.dec.com If you have access to a FAX machine, you can also send comments or suggestions to: DEC C++ Documentation, ZKO2-3/K35 603-881-0120 Document Structure This guide contains three chapters and one appendix: o Chapter 1 describes how to prepare for DEC C++ for OpenVMS Alpha installation. o Chapter 2 describes how to install the DEC C++ for OpenVMS Alpha compiler. o Chapter 3 describes postinstallation procedures. o Chapter 4 describes how to install the DEC C++ debugger. o Appendix A shows a sample installation. v Associated Documentation In addition to this guide, the DEC C++ for OpenVMS Alpha Version 5.6 documentation set includes the following books: o Stroustrup, Bjarne. The C++ Programming Language, 2nd Edition. Reading, Massachusetts: Addison-Wesley, 1992. o Musser, David R. and Atul Saini. STL Tutorial and Reference Guide. Reading, Massachusetts: Addison-Wesley, 1996. o Using DEC C++ for OpenVMS Systems o DEC C++ Class Library Reference Manual o DEC C Run-Time Library Reference Manual for OpenVMS Systems The books from Addison-Wesley are available only as hardcopy documentation. For information on the DEC C++ for OpenVMS Alpha online release notes, see Chapter 1. For general information on OpenVMS system management, see the OpenVMS operating system documentation set. For help understanding OpenVMS system error messages, see the OpenVMS System Messages and Recovery Procedures Reference Manual or the online HELP/MESSAGE facility. vi Conventions Table 1 lists the conventions used in this guide. Table_1_Conventions________________________________________ Convention_____________Meaning_____________________________ UPPERCASE TEXT Uppercase text indicates the name of a command, a file, a parameter, a procedure, or utility. $ In interactive examples, prompts @SYS$UPDATE:VMSINSTAL or displayed text appears in a monospace font. User input appears in bold monospace font. Ctrl/X In interactive examples, a sequence such as Ctrl/X indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button; for example, Ctrl/C or Ctrl/Z. [YES] Square brackets indicate that the enclosed item is a default value in a VMSINSTAL prompt. Also, square brackets serve as delimiters for a directory name in a file _______________________specification.______________________ vii 1 _________________________________________________________________ Preparing for DEC C++ for OpenVMS Alpha Installation Your bill of materials (BOM) and indented bills report (BIL) specify the number and contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged or if you find that parts of it are missing, contact your DIGITAL representative. DEC C++ for OpenVMS Alpha provides online release notes, which are copied to SYS$HELP during installation. DIGITAL strongly recommends that you read the release notes before proceeding with the installation. For information on accessing the online release notes for the DEC C++ compiler, see step 2 in Section 2.1. Debugging support has been improved as of DEC C++ Version 5.5. These improvements require the installation and use of a new OpenVMS debugger. This special DEC C++ debugger is shipped with DEC C++ but must be separately installed. The installation of this debugger does not replace the debugger that is supplied with the operating system, and you need to take special steps after installation if you want the special DEC C++ debugger to be the default debugger on your system. See Chapter 4. 1.1 License Registration Before you install and run DEC C++ for OpenVMS Alpha on a newly licensed node (or cluster), you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order. If you are installing DEC C++ for OpenVMS Alpha as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements. Preparing for DEC C++ for OpenVMS Alpha Installation 1-1 If you are installing prerequisite or optional software along with DEC C++ for OpenVMS Alpha, review the PAK status and install the PAKs for any prerequisite or optional software before you install DEC C++ for OpenVMS Alpha. You must register and load your license for DEC C++ for OpenVMS Alpha before you start the installation to run the Installation Verification Procedure (IVP) and use the software. Log in to the system manager's account, SYSTEM. You have a choice of two ways to register a license: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your License PAK. 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 DEC C++ for OpenVMS Alpha on more than one node in a VMScluster, you will need to perform a license load on the other nodes after you complete this installation. See Section 3.3. For complete information on using the LMF, see the OpenVMS License Management Utility Manual. 1.2 Required Operating System Components and Software DEC C++ for OpenVMS Alpha Version 5.6 requires the OpenVMS Alpha operating system Version 6.1 or higher. Future DEC C++ for OpenVMS Alpha releases may require higher versions of the operating system, as described in the online release notes or the Read Before Installing or Using DEC C++ Version 5.6 for OpenVMS Alpha Systems letter. The OpenVMS Alpha operating system comes with a variety of support options or components. Components include such features as networking and RMS journaling. To use DEC C++ for OpenVMS Alpha, your system should be running a version of OpenVMS Alpha that includes the base component and the following: o Programming support o Utilities 1-2 Preparing for DEC C++ for OpenVMS Alpha Installation Table 1-1 provides information about optional software that you can use together with DEC C++ for OpenVMS Alpha. Table_1-1_Optional_Software________________________________ Optional_Product____Purpose________________________________ DEC Language- Formatted language constructs simplify Sensitive Editor editing source programs. Support for (LSE) Version 4.0 DEC C++ requires that LSE be installed or_higher___________before_the_compiler_is_installed.______ 1.3 Installation Procedure Requirements This section discusses settings that you should check to be sure that your system is ready for the installation of DEC C++ for OpenVMS Alpha to proceed. 1.3.1 Process Privileges To install DEC C++ for OpenVMS Alpha, you must be logged in to an account that has SETPRV or at least the following privileges: o CMKRNL o WORLD o SYSPRV VMSINSTAL turns off BYPASS privileges at the start of the installation. 1.3.2 Process Account Quotas VMSINSTAL requires that the installation account have minimum quotas as shown in Table 1-2. Table_1-2_Process_Quotas_for_the_Installing_Account________ Name________Quota__________________________________________ ASTLM 190 BIOLM 160 (continued on next page) Preparing for DEC C++ for OpenVMS Alpha Installation 1-3 Table_1-2_(Cont.)_Process_Quotas_for_the_Installing_Account Name________Quota__________________________________________ BYTLM 99,000 DIOLM 160 ENQLM 4000 FILLM_______300____________________________________________ Use the OpenVMS Authorize Utility to verify and change process quotas for the installation account in the user authorization file (UAF). (Some sites may restrict the use of the OpenVMS Authorize Utility to certain accounts or people.) For instance, to change the BYTLM quota for the account-name installation account, you might enter the following command sequence: $ RUN SYS$SYSTEM:AUTHORIZE UAF> MODIFY account-name /BYTLM = 99000 UAF> SHOW account-name UAF> EXIT $ LOGOUT After the quotas for the installation account have been changed, log out of the installation account and log in again for the new quotas to take effect. You can then proceed with the installation. User account quotas are stored in the file SYSUAF.DAT. For more information on modifying account quotas, see the description of the Authorize Utility in the OpenVMS System Management Subkit. 1.3.3 System Parameters Table 1-3 lists the minimum required system parameter values for the installation. Depending on the kinds of programs and applications running at your site, you might need higher values for some settings. 1-4 Preparing for DEC C++ for OpenVMS Alpha Installation Table_1-3_Minimum_Required_System_Parameter_Values_________ Minimum System_Parameter_________Value________Default_Value________ CLISYMTBL[1] 500 500 GBLPAGES[2] 6300 6300 GBLPAGFIL 1024 1024 GBLSECTIONS[2] 2 2 [1]The_CLISYMTBL_dynamic_system_parameter_must_be_set_to___ a minimum value of 500 during the installation procedure. You can change the setting to its original value once the installation is finished. [2]These values represent the number of free global pagelets and global sections required for the installation, not the total number you need to run your system and other software. ___________________________________________________________ 1.3.4 Disk Space Requirements for free disk storage space are different during installation and after installation. Table 1-4 summarizes the storage requirements. Preparing for DEC C++ for OpenVMS Alpha Installation 1-5 Table_1-4_Disk_Space_Requirements__________________________ Blocks During Blocks After Kit_______________Installation_______Installation__________ Compiler 28000 14000 C RTL header 1000 500 files 8300[1] 7700[1] with text header files C++ header files 3800 1900 with text header 5200 2600 files Release notes 300 300 ___________________________________________________________ Total 33100 16700 with text header 46600 27000 files [1]Includes_the_headers_extracted_from_the_header_text_____ library, SYS$STARLET_C.TLB, supplied by the operating system. ___________________________________________________________ To determine the number of free disk blocks on the current system disk, enter the following command at the DCL prompt: $ SHOW DEVICE SYS$SYSDEVICE 1.3.5 Backing Up Your System Disk At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. DIGITAL recommends that you back up your system disk before installing any software. Use the backup procedures that are established at your site. For details on performing a system disk backup, see the section on the Backup Utility in the OpenVMS System Management Subkit. 1-6 Preparing for DEC C++ for OpenVMS Alpha Installation 1.3.6 Additional System Maintenance Procedures This section explains how to use the System Generation Utility (SYSGEN) and the AUTOGEN Utility to prepare your system for an installation of DEC C++. AUTOGEN uses system configuration data to automatically set system parameters. 1.3.6.1 Checking System Parameter Values To check the values of your system parameters, enter the following command: $ RUN SYS$SYSTEM:SYSGEN SYSGEN> At the SYSGEN> prompt, enter the SHOW command to display the value of a system parameter. The following example displays the value for the WSMAX system parameter: SYSGEN> SHOW WSMAX Parameter Name Current Default Min. Max. Unit -------------- ------- ------- ------- ------- ---- WSMAX 81920 4096 1024 1048576 Pagelets internal value 5120 256 64 65536 Pages After checking the parameters with the SHOW command, enter the EXIT command at the SYSGEN> prompt to return to DCL level. For information on setting dynamic system parameter values, see Section 1.3.6.4. 1.3.6.2 Calculating the Values for Global Pagelets and Global Sections To install and run DEC C++ for OpenVMS Alpha, you must have sufficient free global pagelets and global sections. You must first find out how many free global pagelets and sections you have on your system. Then use AUTOGEN if you need to increase the global pagelets and global sections system parameters. Enter the following DCL command to determine the number of global pagelets required by SYS$LIBRARY:DCLTABLES.EXE: $ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE This command returns the size (in blocks) of SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this figure as the number of global pagelets for the file. Preparing for DEC C++ for OpenVMS Alpha Installation 1-7 You can use the WRITE command with the F$GETSYI lexical function to find the number of free global pagelets and global sections. The following example shows how to get this information at your terminal (the default for SYS$OUTPUT): $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") 15848 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") 24 If the values displayed by the system are greater than the values in Table 1-3, you do not need to increase the values for these parameters. If the value of free global pagelets or global sections is less than the value in Table 1-3, you must increase the system parameter setting. Section 1.3.6.3 describes the procedures for increasing these values using AUTOGEN. 1.3.6.3 Changing System Parameter Values with AUTOGEN Use the AUTOGEN command procedure to change system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the values you reset manually. To change system parameters with AUTOGEN, edit the following file: SYS$SYSTEM:MODPARAMS.DAT Use an editor to access the file. To change a parameter value listed in this file, delete the current value associated with that parameter and enter the new value. To add a new parameter, add a line to the file that includes both the name of the parameter and its value. For example: WSMAX = 8096 To modify incremental parameters such as free global pagelets and global sections, use ADD_GBLPAGES or ADD_ GBLSECTS. The following example increases the global page setting by 2000: ADD_GBLPAGES = 2000 1-8 Preparing for DEC C++ for OpenVMS Alpha Installation When you set the page file quota, do not use a value that exceeds the amount of page file space available on the system. After you make all your changes, exit from the editor and execute the AUTOGEN procedure to recalculate your system parameters. The following command recalculates your system parameters and reboots the system: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT When you specify REBOOT, AUTOGEN performs an automatic system shutdown and then reboots the system. Any users logged on to the system are immediately disconnected during the shutdown. The automatic reboot puts the new parameter values into effect. AUTOGEN automatically adjusts some of the SYSGEN parameters based on the consumption of resources since the last reboot. If you do not want to take advantage of this automatic adjustment, include the /NOFEEDBACK qualifier on the AUTOGEN command line. For more information about using AUTOGEN, see the system management documentation for your operating system. 1.3.6.4 Setting Dynamic System Parameter Values Use SYSGEN to set dynamic parameters. Dynamic parameters changed with the SYSGEN command WRITE ACTIVE become active immediately without any need to reboot your system. Rebooting returns dynamic system parameter values to their previous settings. After you change the dynamic parameter values, you should complete the installation before rebooting the system. After you finish the installation, you can reset the dynamic parameters to their previous values or let them be reset automatically when you reboot your system the next time. If the dynamic parameter values on your system are less than the values previously listed, use the following series of commands to change the values. This example changes the GBLPAGES value to 100000: Preparing for DEC C++ for OpenVMS Alpha Installation 1-9 $ RUN SYS$SYSTEM:SYSGEN SYSGEN> USE ACTIVE SYSGEN> SET GBLPAGES 100000 SYSGEN> WRITE ACTIVE SYSGEN> EXIT 1-10 Preparing for DEC C++ for OpenVMS Alpha Installation 2 _________________________________________________________________ Installing the DEC C++ for OpenVMS Alpha Compiler After you register and load the License Product Authorization Key (License PAK), the installation takes approximately 3 to 10 minutes, depending on your system configuration and the kit components chosen. 2.1 Installation Procedure If it is not already inserted, place the compact disc (CD-ROM) media into the CD-ROM drive. To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all files it has created up to that point and exits. You can then start the installation again. When the system prompts you with a question during the installation procedure, the default answer is often listed in brackets ([]). 1. Log in to a privileged account and set your default device and directory to SYS$UPDATE. Username: SYSTEM Password: 2. Invoke VMSINSTAL. @SYS$UPDATE:VMSINSTAL saveset-name device-name option-list To start the installation, invoke the VMSINSTAL command procedure from a privileged account, such as the SYSTEM account. VMSINSTAL is in the SYS$UPDATE directory. The elements that you specify when you invoke the VMSINSTAL command procedure are as follows: Installing the DEC C++ for OpenVMS Alpha Compiler 2-1 saveset-name The installation name for the component. For DEC C++ for OpenVMS Alpha, use the following installation name: CXX05n n represents the minor (point) release number for DEC C++ for OpenVMS Alpha. To obtain the directory location of the DEC C++ for OpenVMS Alpha save set on the CD-ROM, refer to the Software Product Library CD-ROM User's Guide booklet that accompanies the CD-ROM distribution kit, or before starting installation, complete these steps: a. To determine whether the CD-ROM drive is already mounted (with the MOUNT command), enter the following command: $ SHOW DEVICE DKA400: b. If it is not mounted, enter the appropriate MOUNT command to mount the CD-ROM (omit the /FOREIGN qualifier). c. To obtain the save-set name, enter a DIRECTORY command specifying the directory file from the previous command: $ DIRECTORY DKA400:[CXX05n.KIT]CXX05n.A n represents the minor release of DEC C++ for OpenVMS Alpha. device-name The name of the device on which you plan to mount the media and the directory containing the DEC C++ for OpenVMS Alpha save set. For example, DKA400: is the device name used in examples in this guide. The directory is [CXX05n], where n is the minor release number. To specify the device name on the @VMSINSTAL command line, enter: DKA400:[CXX05n] 2-2 Installing the DEC C++ for OpenVMS Alpha Compiler option-list The word OPTIONS followed by one or more of the following option designators-A, G, L, N, R: o Auto_answer option (A) Initially creates a file that contains your answers to VMSINSTAL questions and prompts. You can then use the option (and the answer file) to save time during a reinstallation (typically after upgrading your system). Installing the DEC C++ for OpenVMS Alpha Compiler 2-3 o Get save-set option (G) Lets you store product save sets temporarily on a magnetic tape or in a disk directory. o File log option (L) Logs all activity to the terminal during installation. o Display or print the release notes (N) Indicates that you want to see the installation question on release notes. If you do not include the N option, VMSINSTAL does not ask you about the release notes. You should review the release notes before proceeding with the installation in case they contain additional information about the installation. If you are restarting the installation and have already reviewed the release notes, you do not need to specify the N option. (Even if you omit the N option when you invoke VMSINSTAL, the DEC C++ for OpenVMS Alpha release notes are copied automatically to the SYS$HELP directory.) o Alternate root option (R) Lets you install the product to a system root other than that of the running system. For detailed information on these software installation options, see the OpenVMS operating system documentation. If you specify more than one option, separate the options with commas, such as OPTIONS A,N. The following example invokes VMSINSTAL to install DEC C++ for OpenVMS Alpha and shows the system response. This example uses the OPTIONS N release note option. $ @SYS$UPDATE:VMSINSTAL CXX05n DKA400:[CXX05n] OPTIONS N OpenVMS Alpha Software Product Installation Procedure V6.1 It is dd-mmm-yyyy at hh:mm. Enter a question mark (?) at any time for help. 2-4 Installing the DEC C++ for OpenVMS Alpha Compiler If you do not supply either the product name or the device name, VMSINSTAL prompts you for this information later in the installation procedure. Verify user's account and quotas When you invoke VMSINSTAL, it checks the following: o Whether you are logged in to a privileged account. DIGITAL recommends that you install software from the system manager's account with your default device and directory set to SYS$UPDATE. o Whether you have adequate quotas for installation. VMSINSTAL checks for the quota values shown in Table 1-2. VMSINSTAL then checks to determine whether any users are logged in to the system. If users are logged in, VMSINSTAL asks whether you want to continue the installation: * Do you want to continue anyway [NO]? YES If you want to continue, enter YES. If you want to stop the installation, press Return. Confirm system backup * Are you satisfied with the backup of your system disk [YES]? If you are satisfied with the backup of your system disk, press Return. Otherwise, enter NO to discontinue the installation. After you back up your system disk, you can restart the installation. Specify distribution If you omitted the device name on the VMSINSTAL command line, the following prompt appears: * Where will the distribution volumes be mounted: DKA400:[CXX05n] If this prompt appears, enter the name of the distribution (media) device and directory that contains the DEC C++ for OpenVMS Alpha kit (save set). For example, if the media is contained on a CD-ROM located on unit DKA400:, enter DKA400:[CXX05n] in reply to this question (where n is the minor version number). Installing the DEC C++ for OpenVMS Alpha Compiler 2-5 Specify save set If you omitted the product save set name on the VMSINSTAL command line, the following prompt appears: Enter the products to be processed from the first distribution volume set. * Products: CXX05n If this prompt appears, enter the DEC C++ for OpenVMS Alpha kit name. The name has the format, CXX05n (where n is the minor version number). Specify installation options If you did not specify an option on the VMSINSTAL command line, the following question will appear: * Enter installation options you wish to use (none): N Choose a letter, or combination of letters separated by commas, that represent the options wanted. For a list of available options, enter a question mark (?) at the prompt. In this example, the option N was choosen, which causes VMSINSTAL to prompt with a list of Release note options. Verify the product being installed The following products will be processed: CXX Vn.n Beginning installation of CXX Vn.n at hh:mm %VMSINSTAL-I-RESTORE, Restoring product save set A... The product name and version are displayed. This save set (A) is restored to a subdirectory of SYS$UPDATE:. Select a release notes option Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. Copy release notes to SYS$HELP * Select option [2]: If you specified OPTIONS N, you are now asked to choose one of the options for reviewing the release notes. All options copy the release notes to SYS$HELP. 2-6 Installing the DEC C++ for OpenVMS Alpha Compiler If you select option 1, VMSINSTAL displays the release notes immediately on the console terminal. You can terminate the display at any time by pressing Ctrl/C. If you select option 2, VMSINSTAL prompts you for the name of the print queue that you want to use. Either supply the name of the print queue that you want to use or press Return to send the file to the default output print device. For example: * Queue name [SYS$PRINT]: CLUSTER_PRINT If you select option 3, VMSINSTAL displays the release notes immediately on the console terminal and then prompts you for a queue name for the printed version. If you select option 4, the installation procedure will only copy the release notes to the SYS$HELP directory. Next, VMSINSTAL displays the following message: %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. DEC C++ Vn.n for OpenVMS Alpha Systems The release notes are copied to the following files in the SYS$HELP directory (where n is the minor version number): SYS$HELP:CXX05n.RELEASE_NOTES SYS$HELP:CXX05n_RELEASE_NOTES.PS After the installation, you can enter the following command to view the location of the release notes through the Help facility: $ HELP CXX RELEASE_NOTES ________________________ Note ________________________ The name of the release notes file (installed by VMSINSTAL) consists of the current product name and version number. ______________________________________________________ Installing the DEC C++ for OpenVMS Alpha Compiler 2-7 Select file purging option * Do you want to purge files replaced by this installation [YES]? The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE, SYS$SYSTEM, SYS$TEST, SYS$COMMON:[CXX$LIB...], and SYS$COMMON:[DECC$LIB...] may contain previous versions of DEC C++ files. These files are replaced during the installation with new files, but the old files are not automatically purged. Purging is recommended. In response to the purging prompt, press Return to purge the files. To keep the files, enter NO and press Return. Choose the Installation Verification Procedure option If you have chosen to install the compiler component, the installation procedure now asks if you want to run the Installation Verification Procedure (IVP). The IVP checks to be sure that the installation is successful. DIGITAL recommends that you run the IVP. * Do you want to run the IVP after the installation [YES]? After DEC C++ for OpenVMS Alpha is installed, you can run the IVP independently to verify that the software is available on your system. You might need to run the IVP after a system failure to make sure that users can access DEC C++ for OpenVMS Alpha. Select components to install The installation procedure lets you select the components of the kit that you want to install. The choices are as follows: o DEC C++ compiler This component includes help text, command definitions, and the IVP for the compiler. o Traditional text header files For efficiency, the header files are installed on the system in text library format, within SYS$LIBRARY. However, this creates a problem when users need to use the headers as reference. To remedy this, the installation procedure will now prompt you to install a "reference copy" of the text headers. These are in traditional text form, and are suitable for searching, lookup, and so on. When selected, the 2-8 Installing the DEC C++ for OpenVMS Alpha Compiler procedure will break them up and install them into the following subdirectories: SYS$COMMON:[CXX$LIB.REFERENCE.CXXL$DEF_HXX] SYS$COMMON:[CXX$LIB.REFERENCE.CXXL$DEF_H] SYS$COMMON:[CXX$LIB.REFERENCE.DECC$RTLDEF_HXX] SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] By default, they will not be searched by the compiler. ________________________ Note ________________________ The header files (text libraries) are now automatically installed based on the time stamps found within them. Time stamps on the kit versions are compared to those on the system, and the kit libraries are installed only if they are found to be more recent. All of this occurs without prompting. ______________________________________________________ Select the components you want to install by answering YES or NO to the questions. If you want a more detailed description of any component, enter a question mark (?). After the explanation is displayed, you will be prompted again for a response. If you enter YES, the installation procedure validates that your request is possible and installs the component. If you enter NO, the installation procedure then issues prompts for selecting the next component. Respond to license registration query The DEC C++ for OpenVMS Alpha compiler component supports the OpenVMS License Management Facility (LMF). If you entered YES to install the compiler component, the installation procedure displays license information about DEC C++ for OpenVMS Alpha. It asks whether you have registered and loaded your PAK for each product. The following is an example of the information and the queries presented by the installation procedure: Installing the DEC C++ for OpenVMS Alpha Compiler 2-9 The DEC C++ compiler component requires a Product Authorization Key (PAK) for DEC C++ to be registered and loaded. Answer the following question with YES if a PAK with the specified product name and a date equal to or later than the date shown is registered and loaded, otherwise answer NO. Product: CXX-V Producer: DEC Version: 5.n Release Date: dd-mmm-yyyy * Does this product have an authorization key registered and loaded?: YES If you have not registered and loaded your PAK, you must answer NO to this question. You have to register and load your PAKs to successfully complete the installation (see Section 1.1). If you have not done so, you should stop the installation, register and load your PAKs, and then restart the installation. Read informational messages At this point, the installation procedure displays a number of informational messages that report on the progress of the installation. There are no further questions. If the installation procedure has been successful up to this point, VMSINSTAL moves the new or modified files to their target directories, updates help files, and updates DCL tables, if necessary. The new files include the following: SYS$HELP:CXX05n.RELEASE_NOTES [new] SYS$HELP:CXX05n_RELEASE_NOTES.PS [new] SYS$TEST:CXX$IVP.COM [new] SYS$TEST:CXX$IVP_C.COM [new] Additionally, if you elected to install the compiler component, the new and modified files consist of the following: SYS$SYSTEM:CXX$COMPILER.EXE [new] SYS$MESSAGE:CXX$COMPILER_MSG.EXE [new] SYS$HELP:HELPLIB.HLB [modified] SYS$COMMON:[SYSHLP.CXX$HELP]*.* [new] SYS$LIBRARY:DCLTABLES.EXE [modified] 2-10 Installing the DEC C++ for OpenVMS Alpha Compiler The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE files are updated to include the new versions of the DEC C++ for OpenVMS Alpha help text (module CXX$HELP.HLP) and the cxx command-line definition. If the header file components are installed, the following new files are copied: SYS$LIBRARY:DECC$RTLDEF.TLB [new] SYS$LIBRARY:DECC$RTLDEF_HXX.TLB [new] SYS$LIBRARY:CXXL$DEF_HXX.TLB [new] SPS$LIBRARY:CXXL$DEF_HXX.TLB [new] If you answered YES in response to the prompt that requests a file purge, previous versions of the DEC C++ for OpenVMS Alpha files are now purged. The end of the installation is indicated by the following message: %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... Observe the IVP If you chose to run the IVP, VMSINSTAL now invokes the IVP to verify that DEC C++ for OpenVMS Alpha was installed successfully. If DEC C++ for OpenVMS Alpha was installed successfully, the IVP displays the following: Successful installation of CXX$COMPILER, ident: CXX V5.n-eee End of DEC C++ Combined Installation Verification Procedure End the installation procedure Installation of DEC C++ for OpenVMS Alpha Vn.n completed at hh:mm VMSINSTAL procedure done at hh:mm Depending on whether you specified parameters on the VMSINSTAL command line, the * Products: prompt or the DCL prompt ($) may appear. If the * Products: prompt appears, you can return to the DCL prompt by pressing Ctrl/Z. If you removed any media from the console drive before beginning the installation, you should replace it now. Installing the DEC C++ for OpenVMS Alpha Compiler 2-11 VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, if you are going to continue using the installation account (such as SYSTEM) and you want to restore these symbols, you should log out and log in again. 2.2 Error Recovery If VMSINSTAL detects any problems during the installation, it notifies you and asks if you want to continue the installation. In some instances, you can enter YES to continue. To stop the installation process and correct the situation, enter NO or press Return. Correct the problem and restart the installation. If errors occur during the installation itself or when the Installation Verification Procedure (IVP) is running, VMSINSTAL displays failure messages. If the installation fails, you will see the following message: %VMSINSTAL-E-INSFAIL, The installation of DEC C++ for OpenVMS Alpha Version 5.n has failed. If the IVP fails, you will see these messages: The DEC C++ for OpenVMS Alpha Version 5.n Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for DEC C++ for OpenVMS Alpha Version 5.n has failed. Errors can occur during the installation if any of the following conditions exist: o The operating system version is incorrect. o A prerequisite software version is incorrect. o Quotas necessary for successful installation are insufficient. o System parameter values for successful installation are insufficient. o The OpenVMS Help library is currently in use. o The product license has not been registered and loaded. 2-12 Installing the DEC C++ for OpenVMS Alpha Compiler For descriptions of the error messages generated by these conditions, see the OpenVMS documentation on system messages, recovery procedures, and OpenVMS software installation. If you are notified that any of these conditions exist, you should take the appropriate action as described in the message. For information on installation requirements, see Chapter 1. If the installation fails, you must restart the installation procedure from step 2. For an explanation of any system messages, see the OpenVMS System Messages and Recovery Procedures Reference Manual or the online HELP/MESSAGE facility. If the installation fails due to an IVP failure, contact a DIGITAL field service representative. Installing the DEC C++ for OpenVMS Alpha Compiler 2-13 3 _________________________________________________________________ After DEC C++ Installation DEC C++ for OpenVMS Alpha is now installed and can be invoked by all users with the cxx command. The installation procedure modifies the DCL command table so that the cxx command is recognized and processed. However, the previous command table is still in effect for those users who are currently logged in. All logged-in users who want to use the cxx command must log out and log in again, or use the following DCL command: $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES The following tasks can be performed after DEC C++ for OpenVMS Alpha is installed: o Running the Installation Verification Procedure (IVP) separately o Editing the system startup and shutdown files o Modifying system parameter settings o Making the product usable on a VMScluster o Setting user account quotas o Tailoring your system o Enhancing performance o Reporting problems The following sections describe these tasks in detail. After DEC C++ Installation 3-1 3.1 Running the Installation Verification Procedure Separately You usually run the Installation Verification Procedure (IVP) during installation. To run the IVP separately to ensure the integrity of installed files should system problems occur, type the following: $ @SYS$TEST:CXX$IVP.COM If the IVP fails for any reason, the following message is displayed: DEC C++ for OpenVMS Alpha VERSION Vn.n TEST FAILED 3.2 Editing and Organizing the System Files You do not need to edit the compiler system startup and shutdown files to provide for automatic startup and shutdown of DEC C++ when your system is rebooted. 3.3 VMScluster Considerations After completing the initial installation, if you want to install DEC C++ for OpenVMS Alpha on multiple nodes in a cluster, you must run INSTALL on each of the other nodes and enter the following command: INSTALL> REPLACE SYS$LIBRARY:DCLTABLES.EXE If you are using a dual-architecture (VAX and Alpha systems) heterogeneous cluster, before executing these commands, make sure the appropriate logical names have been set to define the scope of the SYSMAN DO commands. For more information, see the OpenVMS System Manager's Manual. 3.4 User Account Requirements Many products cannot be used unless certain privilege and quota requirements are met by user accounts. The following sections describe the privilege and quota requirements needed to work with DEC C++ for OpenVMS Alpha. 3.4.1 User Privileges To use DEC C++ for OpenVMS Alpha, each account must have at least the TMPMBX and NETMBX privileges. Use the OpenVMS Authorize Utility to determine whether users have the privileges they require. 3-2 After DEC C++ Installation 3.4.2 User Account Quotas To use DEC C++ for OpenVMS Alpha, a user account does not need to meet any special quota requirements. However, for users who will be compiling very large programs (many program units compiled together), consider adjusting the working set (WSDEF, WSQUOTA, WSEXTENT) and pagefile (PGFLQUOTA) account quotas to improve performance. See Section 1.3.2 for a description of how to verify and change account quotas. 3.4.3 Installing the DEC C++ for OpenVMS Alpha Compiler and the DEC C++ Class Library as a Shared Image DIGITAL highly recommends that you reduce the system overhead and memory requirements by installing the DEC C++ for OpenVMS Alpha compiler and the DEC C++ Class Library as shared images. To install DEC C++ for OpenVMS Alpha as a shared image on a system that is currently running, use the INSTALL Utility. DIGITAL recommends that you install DEC C++ for OpenVMS Alpha as shared on a system that has been rebooted recently because the available space in the global pagelet table is less likely to be fragmented. To install DEC C++ for OpenVMS Alpha and the Class Library as a shared image: 1. Determine the number of available (free) global pagelets and global sections on your system and the number of each needed to install and run DEC C++ for OpenVMS Alpha (see Section 1.3.6.2). 2. If necessary, increase the current number of global pagelets and global sections parameters (see Section 1.3.3). After you reset the system parameter values, invoke the INSTALL Utility from a privileged account and install the DEC C++ for OpenVMS Alpha compiler as a shared image: $ INSTALL INSTALL> ADD SYS$SYSTEM:CXX$COMPILER.EXE /OPEN /SHARED INSTALL> EXIT After DEC C++ Installation 3-3 Similarly, install the DEC C++ Class Library as a shared image: $ INSTALL INSTALL> ADD SYS$LIBRARY:CXXL$011_SHR.EXE /OPEN /SHARED INSTALL> EXIT Add the following lines to the appropriate system startup command file so that DEC C++ for OpenVMS Alpha is available as a shared image each time the system is started. (If your site has modularized its startup procedures, be sure you add the lines to the correct file.) The default startup command file is SYS$MANAGER:SYSTARTUP_VMS.COM. $ INSTALL INSTALL> ADD SYS$SYSTEM:CXX$COMPILER.EXE /OPEN /SHARED INSTALL> ADD SYS$LIBRARY:CXXL$011_SHR.EXE /OPEN /SHARED INSTALL> EXIT Using the /PRIVILEGED qualifier is neither necessary nor recommended. To install the compiler message file, enter the following commands: $ INSTALL INSTALL> ADD SYS$MESSAGE:CXX$COMPILER_MSG.EXE INSTALL> EXIT To install the Class Library message file, enter the following commands: $ INSTALL INSTALL> ADD SYS$MESSAGE:CXXL$MSG_SHR.EXE INSTALL> EXIT When you install DEC C++ for OpenVMS Alpha as a shared image you need to increase the global pagelets and global sections parameters. See Section 1.3.3 for information on changing these parameters. 3-4 After DEC C++ Installation 3.5 Getting Help and Reporting Problems If an error occurs while DEC C++ for OpenVMS Alpha is in use and you believe the error is caused by a problem with the product, please report it to DIGITAL. If you have a Software Product Services Support Agreement, contact your Customer Support Center (CSC) by telephone or by using the electronic means provided with your support agreement (such as DSNlink). The CSC provides telephone support for high-level advisory and remedial assistance. When you initially contact the CSC, indicate the following: o The name and version number of the operating system you are using o The version number of DEC C++ for OpenVMS Alpha you are using o The hardware system you are using (such as a model number) o A brief description of the problem (one sentence if possible) o How critical the problem is Whether you submit information electronically or contact the appropriate support specialist by telephone, please take the following steps: 1. Describe as accurately as possible the circumstances and state of the system when the problem occurred. Include the description and version number of the DEC C++ for OpenVMS Alpha compiler being used. Demonstrate the problem with specific examples. 2. Reduce the problem to as small a size as possible. 3. Remember to include listings of any command files, INCLUDE files, or relevant data files, and so forth. 4. Provide a listing of the program. 5. If the program is longer than 50 lines, submit a copy of it on machine-readable media (diskette or magnetic tape). 6. Report only one problem per report. This will facilitate a faster response. After DEC C++ Installation 3-5 7. Mail the problem report to DIGITAL. If the problem is related to DEC C++ for OpenVMS Alpha documentation, you can report the problem to the CSC (if you have a Software Product Services Support Agreement and the problem is severe); otherwise, send your comments about DEC C++ for OpenVMS Alpha documentation to the following Internet address: cxx_docs@casdoc.enet.dec.com If you have access to a FAX machine, you also can send comments or suggestions to: DEC C++ Documentation, ZKO2-3/K35 (603) 881-0120 To obtain information about purchasing a DIGITAL Software Product Services Support Agreement or other support services, please contact your local DIGITAL sales representative. 3-6 After DEC C++ Installation 4 _________________________________________________________________ Installing the DEC C++ Debugger A special C++ debugger is provided with the DEC C++ Version 5.6 kit and must be installed to debug programs compiled with DEC C++ Version 5.6. The special C++ debugger is an early copy of the standard OpenVMS debugger that will ship in a future release after OpenVMS Alpha Version 7.1 and provide full support for languages other than C++. The installation of this debugger kit does not replace the debugger supplied with the operating system. Thus, you can use either debugger after installation. Special steps must be taken if you want the special C++ debugger to be the default debugger on your system. ________________________ Note ________________________ In a future OpenVMS release after Version 7.1, the debugger that is shipped with the operating system will support the new C++ capabilities. If you are using an OpenVMS release after Version 7.1, please consult the OpenVMS New Features manual to determine if it is necessary to install the debugger shipped with DEC C++. ______________________________________________________ If you install the debugger on a version of OpenVMS that does not have DECwindows Motif installed, or on a version of OpenVMS that has a version of DECwindows Motif prior to Version 1.2-4, the C++ debugger's Graphic User Interface (GUI) image will not be installed. If you decide later to install Motif, or to upgrade Motif to Version 1.2-4, and you then want to use the debugger's GUI, you should then reinstall the DEC C++ debugger, to create the debugger's GUI image. Installing the DEC C++ Debugger 4-1 4.1 Installing the Debugger The C++ debugger must be installed in addition to the compiler. The installation procedure is similar to that for the compiler kit; to install the debugger, invoke the VMSINSTAL command procedure, as described in Section 2.1. The saveset-name for the debugger kit is ADB071. The other parameters to VMSINSTALL should be the same as specified when installing the compiler kit. For example: @SYS$UPDATE:VMSINSTAL ADB071 device-name option-list ________________________ Note ________________________ The way in which the ADB071 kit links debugger images at VMSINSTAL time depends on the version of OpenVMS Alpha installed on your system. The ADB071 debugger linked with Version 6.n of OpenVMS Alpha will not function properly on Version 7.n systems. For example, if you install ADB071 on a Version 6.2 system and that system is later upgraded to V7.1, the ADB071 debugger will function improperly until you reinstall ADB071. ______________________________________________________ 4.2 After Debugger Installation The installation of this debugger kit does not replace the debugger supplied with the operating system. After installing the C++ debugger, you need to invoke a command procedure to install the C++ debugger images and define the default system debugger. If you want the special C++ debugger to be the default debugger for the system, you should do the following from a privileged account, after installing the ADB071 kit: 1. Enter the following command: @SYS$STARTUP:DEBUG$STARTUP.COM CXX To install the images and define the default system debugger on other Alpha nodes of a VMScluster, enter this command on each such node. 2. Add the following line to the system startup procedure: $ @SYS$STARTUP:DEBUG$STARTUP.COM CXX 4-2 Installing the DEC C++ Debugger 3. On OpenVMS versions prior to Version 7.0, copy the C++ debugger resource file using the following command: $ COPY DECW$SYSTEM_DEFAULTS:CXXVMSDEBUG.DAT - DECW$SYSTEM_DEFAULTS:VMSDEBUG.DAT If you do not want the special C++ debugger to be the default debugger for the system, you should do the following from a privileged account: 1. Enter the following command: @SYS$STARTUP:DEBUG$STARTUP.COM VMS To install the images and define the default system debugger on other Alpha nodes of a VMScluster, enter this command on each such node. 2. Add the following line to the system startup procedure: $ @SYS$STARTUP:DEBUG$STARTUP.COM VMS Regardless of which debugger you select as the default system debugger, individual users can choose the other debugger. See the DEC C++ release notes for more information. Installing the DEC C++ Debugger 4-3 A _________________________________________________________________ Sample Installation This appendix contains a sample installation for the DEC C++ for OpenVMS Alpha kit. This is only a sample. Sometimes the installation procedure is modified in maintenance updates of this product. Because this installation guide is not usually revised for maintenance updates, be sure to read the applicable Read Before Installing or Using DEC C++ letter before you install this product. This letter notes any significant changes to the installation sample shown here. Such information also appears in the online release notes. The following sample was installed on a system where DEC C++ for OpenVMS Alpha was not previously installed. Depending on which layered products you have on your system, you might see additional messages and questions when you perform your installation. This sample installation assumes that DECnet has been shut down, that no users are logged in to your system, and that OPTIONS N is specified to print the release notes. The Installation Verification Procedure (IVP) runs at the end of the installation. Example A-1 shows a sample installation of DEC C++ Version 5.6 on an OpenVMS Alpha system. Sample Installation A-1 Example A-1 Sample DEC C++ for OpenVMS Alpha Installation on OpenVMS Alpha $ @sys$update:vmsinstal OpenVMS Alpha Software Product Installation Procedure V6.2 It is 10-JUL-1997 at 07:16. Enter a question mark (?) at any time for help. * Do you want to continue anyway [NO]? Y * Are you satisfied with the backup of your system disk [YES]? Y * Where will the distribution volumes be mounted: DKA400:[CXX056] Enter the products to be processed from the first distribution volume set. * Products: CXX056 * Enter installation options you wish to use (none): N The following products will be processed: CXX V5.6 Beginning installation of CXX V5.6 at 07:16 %VMSINSTAL-I-RESTORE, Restoring product save set A ... Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: 2 * Queue name [SYS$PRINT]: NB9$PRINT Job CC056 (queue NB9$LTA3, entry 145) started on NB9$LTA3 * Do you want to continue the installation [NO]? Y %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. DEC C++ Version V5.6-003 for OpenVMS Alpha Systems Copyright Digital Equipment Corporation 1997. All rights reserved. (continued on next page) A-2 Sample Installation Example A-1 (Cont.) Sample DEC C++ for OpenVMS Alpha Installation on OpenVMS Alpha Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. * Do you want to purge files replaced by this installation [YES]? Y This kit contains an Installation Verification Procedure (IVP) to verify the correct installation of the DEC C++ compiler component and class library headers. The IVP will be placed in: SYS$TEST:CXX$IVP.COM After the installation is complete, you can invoke the command file at any time to reverify that DEC C++ is installed and working correctly. If you wish to invoke it automatically at the completion of this installation procedure, answer Yes to the following question. * Do you want to run the IVP after the installation [YES]? Y The DEC C++ kit contains three components: Compiler (includes help text, command definition, IVP) C Runtime Library Header files (includes OpenVMS system symbol definitions) C++ Class Library Header files If you want a more detailed description of any component that you are prompted for, answer with a question mark "?"; after the explanation is displayed, you will be prompted again for a response. * Do you want to install the compiler component [YES]? Y (continued on next page) Sample Installation A-3 Example A-1 (Cont.) Sample DEC C++ for OpenVMS Alpha Installation on OpenVMS Alpha The C Runtime Library, and C++ Class Library, headers will be installed as Text Libraries (.TLBs). If you also wish to install the traditional text form of the headers (.H and .HXX files) for reference purposes, please answer yes to the following question. The text headers will be placed in a subdirectory that will not be searched by the compiler. Instead, they will be placed the subdirectory tree: SYS$COMMON:[CXX$LIB.REFERENCE...] ( SYS$COMMON:[DECC$LIB.REFERENCE...] for the DEC C RTL header library, DECC$RTLDEF, and the system definition header library, SYS$STARLET_C.) Note that doing this may double the disk space used for the headers. * Do you want to install the text form of the headers [YES]? Y The DEC C++ compiler component requires a Product Authorization Key (PAK) for DEC C++ to be registered and loaded. Answer the following question with YES if a PAK with the specified product name and a date equal to or later than the date shown is registered and loaded, otherwise answer NO. Product: CXX-V Producer: DEC Version: 5.6 Release Date: 2-JUL-1997 * Do you want to install the CXXLINK facility [YES]? Y * Does this product have an authorization key registered and loaded? Y All questions and validations regarding the installation of DEC C++ kit components have now been asked. Depending upon your configuration, time estimates for the installation(s) are as follows: Compiler: 1 minute Headers: 3 minutes IVP: 2 minutes (continued on next page) A-4 Sample Installation Example A-1 (Cont.) Sample DEC C++ for OpenVMS Alpha Installation on OpenVMS Alpha Providing compiler components Providing C RTL header files %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[DECC$LIB.REFERENCE]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[DECC$LIB.REFERENCE.DECC$RTLDEF]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[CXX$LIB.REFERENCE]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[CXX$LIB.INCLUDE]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[CXX$LIB.SYSTEM]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[CXX$LIB.REFERENCE.DECC$RTLDEF_HXX]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[CXX$LIB.INCLUDE.DECC$RTLDEF_HXX]. Providing C++ class library header files %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[CXX$LIB.REFERENCE.CXXL$DEF_H]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[CXX$LIB.INCLUDE.CXXL$DEF_H]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[CXX$LIB.REFERENCE.CXXL$DEF_HXX]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[CXX$LIB.INCLUDE.CXXL$DEF_HXX]. Providing SYS$STARLET_C header files %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[DECC$LIB.REFERENCE.SYS$STARLET_C]. Providing Installation Verification Procedure Providing Startup Procedure Please add the SYS$STARTUP:CCXX$STARTUP.COM to the system startup procedure. (continued on next page) Sample Installation A-5 Example A-1 (Cont.) Sample DEC C++ for OpenVMS Alpha Installation on OpenVMS Alpha To use DEC C++ for OpenVMS Alpha on other Alpha nodes of a VMScluster, from a privileged account on each such node enter the command "$ @SYS$STARTUP:CCXX$STARTUP.COM". This will install images and define system-wide logical names. Your OpenVMS system will now be updated to include the following new and modified file(s): SYS$HELP:CXX056.RELEASE_NOTES [new] SYS$HELP:CXX056_RELEASE_NOTES.PS [new] SYS$TEST:CXX$IVP.COM [new] SYS$TEST:CXX$IVP_C.COM [new] SYS$SYSTEM:CXX$COMPILER.EXE [new] SYS$MESSAGE:CXX$COMPILER_MSG.EXE [new] SYS$HELP:HELPLIB.HLB [modified] SYS$COMMON:[SYSHLP.CXX$HELP]*.* [new] SYS$LIBRARY:DCLTABLES.EXE [modified] SYS$STARTUP:CCXX$STARTUP.COM [new] SYS$LIBRARY:DECC$RTLDEF.TLB [new] SYS$LIBRARY:DECC$RTLDEF_HXX.TLB [new] SYS$LIBRARY:CXXL$DEF_H.TLB [new] SYS$LIBRARY:CXXL$DEF_HXX.TLB [new] %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Beginning DEC C++ Combined Installation Verification Procedure Copyright (c) Digital Equipment Corporation, 1997. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. Test compiler operation and error messages... (continued on next page) A-6 Sample Installation Example A-1 (Cont.) Sample DEC C++ for OpenVMS Alpha Installation on OpenVMS Alpha Test Class Library operation... Successful installation of CXX$COMPILER, ident: CXX V5.6-003 End of DEC C++ Combined Installation Verification Procedure Installation of CXX V5.6 completed at 07:23 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]CXX056.VMI_DATA Enter the products to be processed from the next distribution volume set. * Products: ^Z VMSINSTAL procedure done at 07:24 Sample Installation A-7