Compaq_C ____________________________________________ Installation Guide for OpenVMS Alpha Systems Order Number: AA-PUP1H-TE February 2002 This guide contains instructions for installing Compaq C on an Alpha processor system running the OpenVMS operating system. This guide applies to Compaq C Version 6.5 for OpenVMS Alpha, and all subsequent point releases for Version 6.0. Revision/Update Information: This revised manual supersedes the Compaq C Installation Guide for OpenVMS Alpha Systems, (Order No. AA-PUP1G-TF) Software Version: Compaq C Version 6.5 or higher for OpenVMS Alpha. Compaq Computer Corporation Houston, Texas ________________________________________________________________ First Printing, November 1993 Revised, February 2002 Copyright 2002 Compaq Information Technologies Group, L.P. COMPAQ, the Compaq logo, VAX, Alpha, VMS, and OpenVMS are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. All other product names mentioned herein may be trademarks of their respective companies. Confidential computer software. Valid license from Compaq required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty. This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. ___________________________________________________________ Contents Preface ............................................ v Preparing for Compaq C for OpenVMS Alpha Installation 1.1 Hardware Requirements......................... 1-1 1.2 Required Operating System Components.......... 1-2 1.3 Optional Software............................. 1-2 1.4 License Registration.......................... 1-2 1.5 Installation Procedure Requirements........... 1-3 1.5.1 Installation Account Privileges and Disk Space..................................... 1-4 1.5.2 System Parameters......................... 1-5 1.5.2.1 Calculating Values for GBLPAGES and GBLSECTIONS............................. 1-5 1.5.2.2 Changing System Parameter Values with AUTOGEN................................. 1-6 1.5.3 VMSINSTAL and Installation Requirements... 1-7 1.5.3.1 VMSINSTAL Installation Process Requirements............................ 1-8 1.5.3.2 Modifying Process Quotas................ 1-8 1.5.4 Backing Up Your System Disk............... 1-8 1.6 Installing and Using Multiple Compiler Versions...................................... 1-9 1.6.1 Displaying and Selecting the Compiler Version................................... 1-9 1.6.2 Side Effects and Restrictions on Multiple Versions.................................. 1-11 1.6.3 Installation Procedure Changes............ 1-12 iii Installing Compaq C 2.1 Installation Procedure........................ 2-1 2.2 Error Recovery................................ 2-12 After Installing Compaq C 3.1 Running the Installation Verification Procedure Separately.......................... 3-1 3.2 Editing the System Files...................... 3-2 3.3 OpenVMS Cluster Considerations................ 3-2 3.4 User Account Requirements..................... 3-3 3.4.1 User Privileges........................... 3-3 3.4.2 User Account Quotas....................... 3-4 3.5 Enhancing Compaq C Performance................ 3-4 3.5.1 Tuning Your System........................ 3-4 3.5.2 Installing Compaq C as a Shared Image..... 3-4 3.6 Getting Help and Reporting Problems........... 3-5 Sample Installations A.1 Initial Installation.......................... A-1 A.2 Upgrade Installation.......................... A-5 A.3 Installation with Alternate Compiler.......... A-8 Files Installed........................................ B-1 Recovering from Errors C.1 Failures During Compaq C Installation......... C-1 C.2 Problems During Compaq C Use.................. C-2 1 Conventions Used in this Guide............ vi 1-1 Related Optional Software................. 1-2 1-2 Disk Space Requirements................... 1-4 _________________________________________________________________ Preface Purpose of this Guide This guide describes how to install Compaq C on Alpha processors running the OpenVMS operating system. Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall Compaq C for any other reason. You can send comments or suggestions regarding this guide or any Compaq C document by sending electronic mail to the following Internet address: c_docs@compaq.com Intended Audience The audience for this guide is the system manager who installs Compaq C software. Structure of this Document This guide contains the following chapters and appendixes: o Chapter 1 describes how to prepare for Compaq C installation. o Chapter 2 describes the procedure to install Compaq C. o Chapter 3 describes what to do after installing Compaq C. o Appendix A shows sample installations. o Appendix B lists files installed. o Appendix C describes how to recover from errors. v in the Compaq C Documentation Set In addition to this guide, the Compaq C for OpenVMS Alpha documentation set includes the following books: o Compaq C Language Reference Manual o Compaq C User's Guide for OpenVMS Systems o Compaq C Run-Time Library Reference Manual for OpenVMS Systems The Read Before Installing Compaq C Version 6.n for OpenVMS Alpha Systems letter is provided along with this installation guide on the CD media. Manuals For information on OpenVMS system management, see the following documents in the OpenVMS documentation set: o OpenVMS System Manager's Manual o Guide to Maintaining a VMS System o OpenVMS License Management Utility Manual o Guide to OpenVMS Performance Management For help understanding OpenVMS system error messages, see the OpenVMS System Messages and Recovery Procedures Reference Manual or the online HELP/MESSAGE facility. Table 1 lists the conventions used in this guide. Table 1 Conventions Used in this Guide _____________________________________________________________ Convention Meaning UPPERCASE TEXT Uppercase text indicates a command, the name of a routine, the name of a file, the name of a file protection code, or the abbreviations for a system privilege. (continued on next page) Table 1 (Cont.) Conventions Used in this Guide Convention Meaning $ Monospaced type identifies displayed @SYS$UPDATE:VMSINSTAL or typed text, language keywords, fprintf function and the names of OpenVMS and auto storage class Compaq C Run-Time Library routines. boldface monospace Boldface monospace text represents text user input in interactive examples. $ The dollar sign is used to indicate the DCL prompt. This prompt may be different on your system. In procedures, a sequence such as indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button. In procedures, a key name is shown enclosed to indicate that you press a key on a keyboard. . A vertical ellipsis in an example . indicates that information not . directly related to the example has been omitted. file-spec, . . . A horizontal ellipsis indicates that you can enter additional parameters, values, or information. [logical-name] Square brackets indicates that the enclosed item is optional. (Square brackets are not, however, optional in the syntax of a directory name in a file specification or in the syntax of a substring specification in an assignment statement.) _____________________________________________________________ vii 1 _________________________________________________________________ Preparing for Compaq C for OpenVMS Alpha Installation This chapter discusses the preparations and requirements necessary for installing Compaq C for OpenVMS Alpha Systems. This guide applies to Version 6.5 of Compaq C for OpenVMS Alpha Systems and all subsequent maintenance releases up to the next release of the product that includes an updated installation guide. Your bill of materials (BOM) and indented bills report (BIL) specify the number and contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged or if you find that parts of it are missing, contact your Compaq representative. Compaq C provides online release notes. Reading the release notes before proceeding with the installation is strongly recommended. For information on accessing the online release notes, see Section 2.1, step 6. The release notes contain installation-related notes and a summary of technical changes, known problems, restrictions, and incompatibilities. 1.1 Hardware Requirements You can install Compaq C on any Alpha system capable of running the OpenVMS Alpha Operating System Version 6.2 to 7.3 or on any VAX system capable of running the OpenVMS Operating System V5.5-2 to 7.3. See the OpenVMS Operating System's Software Product Description (SPD 25.01.xx) for details. Note that Compaq C Version 6.5 is supported only on Alpha systems. Preparing for Compaq C for OpenVMS Alpha Installation 1-1 Required Operating System Components Compaq C Version 6.5 for OpenVMS Alpha Systems requires OpenVMS Alpha Version 6.2 or higher. Future Compaq C releases may require higher versions of the OpenVMS operating system, as described in the online release notes or the Read Before Installing or Using Compaq C Version 6.n for OpenVMS Systems letter. The OpenVMS operating system comes with a variety of support options, or classes. Classes include such features as networking and RMS journaling. To use Compaq C, your system should be running a version of OpenVMS Alpha that includes the following classes: o Programming support o Utilities For a complete list of the required classes, see the Compaq C Software Product Description (SPD). Optional Software Table 1-1 provides information on optional software that can be used together with Compaq C. Table 1-1 Related Optional Software ___________________________________________________________ Product Name Description DECset A comprehensive Computer Aided Software Engineering (CASE) environment consisting of the following integrated components: Language- Sensitive Editor (LSE), Source Code Analyzer (SCA), Performance Coverage Analyzer (PCA), Code Management System (CMS), Module Management System (MMS), and DEC Test Manager. ___________________________________________________________ License Registration Before you install and run Compaq C Version 6.5 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 Preparing for Compaq C for OpenVMS Alpha Installation 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 Compaq C as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements. If you are installing prerequisite or optional software along with Compaq C, review the License PAK status and install the License PAKs for any prerequisite or optional software before you install Compaq C. You must register and load your license for Compaq C before you start the installation in order to run the Installation Verification Procedure (IVP) and use the software. To register a license under OpenVMS, first log in to the system manager's account, SYSTEM. You then have a choice of two ways to perform the registration: 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 the License PAK information. For complete information on using the LMF, see the VMS License Management Utility Manual or the online HELP LICENSE utility. 1.5 Installation Procedure Requirements This section and those that follow discuss various requirements for installing Compaq C. The installation takes approximately 5 to 15 minutes, depending on your type of media, your system configuration, and the kit components chosen. Preparing for Compaq C for OpenVMS Alpha Installation 1-3 Installation Account Privileges and Disk Space To install Compaq C, you must be logged in to an account that has the SETPRV privilege or at least the following privileges: o CMKRNL o WORLD o SYSPRV VMSINSTAL turns off BYPASS privilege at the start of the installation. The Compaq C compiler's requirements for free disk storage space are different during installation and after installation. Table 1-2 lists the storage requirements. You can now install the C documentation in .ps, .txt, and .html formats. The installation default is to not install the documentation, but if you do, note the additional disk space required. Table 1-2 Disk Space_Requirements _______________________________________________ Blocks During Blocks After Kit Installation Installation _______________________________________________ Compiler only 150,000 100,000 Compiler and 250,000 160,000 documentation ______________________________________________ These counts refer to the disk space required on the system disk. The sizes are approximate; actual sizes may vary depending on the user's system environment, configuration, and software options. To determine the number of free disk blocks on the current system disk, enter the following DCL command: $ SHOW DEVICE SYS$SYSDEVICE Preparing for Compaq C for OpenVMS Alpha Installation 1.5.2 System Parameters Installing Compaq C requires certain system parameter settings. The minimum number of free global pagelets (512-byte subpage unit) and global sections needed for the installation depends on whether SYS$SYSTEM:DECC$COMPILER.EXE was previously installed as a shared known image: o If not previously installed as shared, 1 global section and a sufficient number of contiguous free global pagelets to contain the file SYS$LIBRARY:DCLTABLES.EXE o If previously installed as shared, 2 global sections and approximately 10,000 contiguous free global pagelets plus a sufficient number of contiguous free global pagelets to contain the file SYS$LIBRARY:DCLTABLES.EXE 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. ________________________ Note ________________________ You must ensure that your system has the necessary global pagelets and global section SYSGEN quotas for the installation. Failure to do so could cause the DCL tables to become corrupted in some situations. ______________________________________________________ 1.5.2.1 Calculating Values for GBLPAGES and GBLSECTIONS To install and run Compaq C, you must have sufficient free global pagelets and global sections. 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 needed for the file. Preparing for Compaq C for OpenVMS Alpha Installation 1-5 You can use the WRITE command with the F$GETSYI lexical function to find the number of free contiguous global pagelets and free 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 value of free global pagelets or global sections is less than the required value (see Section 1.5.2), you must increase the system parameter setting. Section 1.5.2.2 describes the procedures for increasing these values using AUTOGEN. Changing System Parameter Values with AUTOGEN If you do not have enough free global pages or free global sections to install Compaq C, you can do either of the following: o Delete an existing known image using the OpenVMS INSTALL utility. o Use the AUTOGEN command procedure to increase the GBLPAGES or GBLSECTIONS 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 Preparing for Compaq C for OpenVMS Alpha Installation To modify incremental parameters such as GBLPAGES and GBLSECTIONS, use ADD_. The following example increases the global page setting by 2000: ADD_GBLPAGES = 2000 After you make all your changes, exit from the editor, then execute the AUTOGEN procedure to recalculate your system parameters. Enter the following command to recalculate your system parameters and reboot the system: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT When you specify REBOOT, AUTOGEN does 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. The AUTOGEN Utility 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 OpenVMS System Management Subkit. 1.5.3 VMSINSTAL and Installation Requirements When you invoke VMSINSTAL, it checks the following: o Whether you have set your default device and directory to SYS$UPDATE o Whether you are logged in to a privileged account o Whether you have adequate quotas for installation (see Section 1.5.3.1) o Whether DECnet is running o Whether any users are logged in to the system 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, type NO or press Return. Then correct the problem and restart the installation. Preparing for Compaq C for OpenVMS Alpha Installation 1-7 VMSINSTAL Installation Process Requirements VMSINSTAL requires that the installation account have the following minimum quotas: ASTLM = 100 BIOLM = 100 DIOLM = 100 ENQLM = 300 FILLM = 300 Modifying Process Quotas Use the OpenVMS Authorize Utility to change the 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 example, to change the BIOLM quota for the account-name installation account, you might enter the following command sequence: $ RUN SYS$SYSTEM:AUTHORIZE UAF> MODIFY account-name /BIOLM = 100 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. For more information on modifying account quotas, see the description of the AUTHORIZE utility in the OpenVMS System Management Subkit. Backing Up Your System Disk At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. You should do a system disk backup before installing any software. Use the backup procedures 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. Preparing for Compaq C for OpenVMS Alpha Installation 1.6 Installing and Using Multiple Compiler Versions Compaq C Version 6.4 and higher provides support for installing and using multiple versions of the compiler on the same node. During installation of Version 6.5, if a Version 6.4, Version 6.2, or Version 6.0 of the compiler is already installed, you have the opportunity to preserve that compiler rather than overwrite it. If you choose to preserve the currently installed compiler, you are then given a choice to keep the currently installed compiler as the system default and install the new compiler as an alternate. By default, the currently installed system compiler is preserved by making it an alternate compiler and installing the new compiler as the system default. Users can make the choice to use an alternate compiler instead of the installed system compiler by running a command procedure that changes the behavior of the cc command for the process that invokes it. 1.6.1 Displaying and Selecting the Compiler Version This kit provides two command procedures to display and control which Compaq C compiler is used by a process: o SYS$SYSTEM:DECC$SHOW_VERSIONS.COM This procedure displays the Compaq C compilers available on the system, along with their version numbers. It also displays which compiler is the default for the current process. The procedure takes an optional version-number argument. Examples: $ @sys$system:decc$show_versions.com The following Compaq C compiler(s) are available in SYS$SYSTEM: Preparing for Compaq C for OpenVMS Alpha Installation 1-9 Filename Version --------------------------------------- DECC$COMPILER.EXE V6.4-005 DECC$COMPILER_T06_04-002.EXE T6.4-002 DECC$COMPILER_T06_04-001.EXE T6.4-001 DECC$COMPILER_V06_00-001.EXE V6.0-001 Process Default DECC$COMPILER_V06_02-008.EXE V6.2-008 $ @sys$system:decc$show_versions.com V6.0 The following Compaq C compiler(s) are available in SYS$SYSTEM: Filename Version --------------------------------------- DECC$COMPILER_V06_00-001.EXE V6.0-001 Process Default o SYS$SYSTEM:DECC$SET_VERSION.COM This procedure sets up process logicals that point to an alternate Compaq C compiler in SYS$SYSTEM, or it removes the process logicals to revert to using the default system compiler. The procedure takes one argument, a version number or the keyword SYSTEM. If no arguments are specified you are prompted for them. The SYSTEM argument selects the installed system compiler, which is the one displayed with the filename DECC$COMPILER.EXE in the output of decc$show_ versions.com. Alternate compilers are shown in that output with their version number appended to the simple filename; for example, the version 6.2-008 compiler is shown as DECC$COMPILER_V06_02-008.EXE. To select a compiler, pass a full ident string or enough of the ident string to be unique. For example: to select the V6.2-008 compiler from the previous list, pass V6.2-008 or V6.2 to the decc$set_version.com routine. However, to select a 6.4 compiler, a full ident string is required to distinguish between the V6.4-005, T6.4- 001, and the T6.4-002 compiler: V6.2-008 logical DECC$* Preparing for Compaq C for OpenVMS Alpha Installation "DECC$COMPILER" = "SYS$SYSTEM:DECC$COMPILER_V06_02-008.EXE" "DECC$MSG_SHR" = "SYS$MESSAGE:DECC$MSG_SHR_V06_02-008.EXE" $ @decc$set_version.com 6.4 The following 6.4 Compaq C compiler(s) are available in SYS$SYSTEM: Filename Version --------------------------------------- DECC$COMPILER.EXE V6.4-005 DECC$COMPILER_T06_04-001.EXE T6.4-001 DECC$COMPILER_T06_04-002.EXE T6.4-002 Ambiguous version number, please be specify a full version number, ex: V6.4-005 Version number : V6.4-005 $ sho logical DECC$COMPILER "DECC$COMPILER" = "SYS$SYSTEM:DECC$COMPILER_V06_04-005.EXE" (LNM$PROCESS_TABLE) $ sho logical DECC$msg_shr "DECC$MSG_SHR" = "SYS$MESSAGE:DECC$MSG_SHR_V06_04-005.EXE" (LNM$PROCESS_TABLE) When this procedure is run in a process, subsequent cc commands invoke the selected compiler version (until the procedure is run again). The process-level logicals used do not affect other processes or users on the system. 1.6.2 Side Effects and Restrictions on Multiple Versions Installing this kit provides the latest DECC$RTLDEF.TLB file and the latest documentation, even if you select the option of having the new compiler as the alternate compiler. Because it is upwardly compatible, the new DECC$RTLDEF.TLB does not adversely impact a preexisting Version 6-based compiler. If you run an older installation procedure, you should rerun the V6.5 installation procedure to make sure you have all the files to support V6.5 as a coexistent compiler. Note that there are two logical names involved in establishing the compiler version: one for the compiler image and one for its message file. Beginning Compaq C V6.4, the compiler issues a diagnostic if it is invoked with the wrong version of the message file; previous versions of the compiler do not detect this situation. If Preparing for Compaq C for OpenVMS Alpha Installation 1-11 you find that an older version of the compiler is issuing diagnostics that do not make sense for the code construct they are attached to, or if the message text is missing and only a message number is issued, use the $ SHOW LOGICAL DECC$COMPILER* command to check that you have matched versions of the files designated by the two logicals. The response should show matching version-numbered files as in the example that selects the Version 6.2 compiler. Or if you are using the system compiler, the response should be the message "%SHOW-S-NOTRAN, no translation for logical name DECC$COMPILER*". Installation Procedure Changes When you install Compaq C Version 6.4 or higher on a system that already has a Version 6.0 or higher compiler installed, you are given the chance to preserve the currently installed system compiler. To do this, answer YES to the following question (the xxx will be replaced by the full version number of the existing system compiler): "Should the existing xxx system compiler be preserved [NO]:" If you answer NO, the installation proceeds in the traditional manner, overwriting the currently installed system compiler. If you answer YES, you are then asked an additional question. To get the traditional behavior of installing the kit compiler as the system default, answer NO to the question: "Should this xxx system compiler remain the default when cc is typed [NO]:" Because you have previously asked to preserve the existing system compiler, that compiler is made an alternate compiler before the new system compiler is installed from the kit. If you answer YES to the question, the kit compiler is installed as an alternate compiler with a name that is based on its ident, and the existing system default compiler remains the default. Preparing for Compaq C for OpenVMS Alpha Installation 2 _________________________________________________________________ Installing Compaq C This chapter explains how to install Compaq C: o Section 2.1 contains a step-by-step description of the installation procedure. o Section 2.2 covers error recovery considerations. 2.1 Installation Procedure The Compaq C installation procedure consists of a series of questions and informational messages. See Appendix A for sample installations. 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. Defaults appear in brackets ([]) throughout the installation procedure. 1. Log in to a privileged account and set your default device and directory to SYS$UPDATE, where VMSINSTAL resides. Username: SYSTEM Password: $ SET DEFAULT SYS$UPDATE 2. Invoke VMSINSTAL. @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N Installing Compaq C 2-1 saveset-name The installation name for the component. For Compaq C, use the following installation name: CC06n Where n represents the minor (point) release number of Compaq C, such as CC065 for Version 6.5. Refer to the label on the Compaq C distribution kit or the Compaq C BOM or BIL for the maintenance update number of your kit. device-name The name of the device on which you plan to mount the media, or the name of the device:[directory] that contains the save sets. For example, DKA400: is the device name used in examples in this guide. The directory is [CC06n.KIT], where n is the minor release number. To specify the device name on the @VMSINSTAL command line, type: DKA400:[CC06n.KIT] OPTIONS N An optional parameter that indicates you want to see the question on release notes. If you do not include the OPTIONS N parameter, 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 OPTIONS N. There are several other options you can select when you invoke VMSINSTAL: o Auto_answer (A): Initially creates a file that contains your answers to VMSINSTAL questions and prompts. This option, and the answer file it produces, can save time during a reinstallation (typically after upgrading your system). Installing Compaq C o Get save set (G): Stores product save sets temporarily on a magnetic tape or in a disk directory. o File log (L): Logs all activity to the terminal during installation. o Alternate root (R): Installs the product to a system root other than that of the running system. See the OpenVMS documentation on software installation in the OpenVMS System Management Subkit for detailed information on these options. If you specify more than one option, separate the options with commas (for example: OPTIONS A,N). The following example invokes VMSINSTAL to install Compaq C and shows the system response. This example uses the OPTIONS N release note parameter. $ @SYS$UPDATE:VMSINSTAL CC06n DKA400:[CC06n.KIT] OPTIONS N OpenVMS Alpha Software Product Installation Procedure V7.3 It is dd-mmm-yyyy at hh:mm. Enter a question mark (?) at any time for help. If you do not supply either the product name or the device name, VMSINSTAL prompts you for this information later in the installation procedure. VMSINSTAL does not prompt you for any options, so be sure to include OPTIONS N on the VMSINSTAL command line to access the release notes during the installation. When you invoke VMSINSTAL, it checks for the following requirements: o Whether you logged in to a privileged account. We recommend 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 Section 1.5.3.1. Installing Compaq C 2-3 o Whether any users are logged in to the system. If users are logged in, you are asked whether you want to continue the installation. If you want to continue, enter YES. If you want to stop the installation, press Return. 3. Confirm system backup. * Are you satisfied with the backup of your system disk [YES]? VMSINSTAL asks if you are satisfied with your system backup. You should always back up your system disk before performing an installation. 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. 4. Mount the media. If you omitted the device name in the VMSINSTAL command line, the following prompt appears: Where will the distribution volumes be mounted: DKA400:[CC06n.KIT] If this prompt appears, enter the name of the distribution (media) device and directory the contains the Compaq C kit (save set). For example, if the media is contained on a CD located on unit DKA400:, enter DKA400:[CC06n.KIT] in reply to this question (where n is the minor release number.) Depending on the type of device and whether the device is already mounted, the following prompt may or may not appear: Please mount the first volume of the set on DKA400:. * Are you ready? YES %MOUNT-I-MOUNTED, Compaq C mounted on DKA400: If you have not already done so, you should now insert the distribution volume on the device you specified when you invoked VMSINSTAL. The device name appears in the line preceding the question. VMSINSTAL then asks you if you are ready to continue with the installation. Installing Compaq C If you enter YES to indicate that you are ready, VMSINSTAL displays a message that the media containing Compaq C has been mounted on the specified device and that the installation has started. If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter NO in response to the "Are you ready?" question. To abort the installation for other reasons, press Ctrl/Y. 5. Verify the product being installed The following products will be processed: CC V6.n Beginning installation of CC V6.n at hh:mm %VMSINSTAL-I-RESTORE, Restoring product saveset A... The product name and version are displayed. The save set (A) is restored to a subdirectory of SYS$UPDATE. 6. Select a release notes option. 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]: If you specified OPTIONS N when you invoked VMSINSTAL, you are asked to choose one of the four options for reviewing the release notes. o Select option 1 to immediately display the release notes online. You can terminate the display at any time by pressing Ctrl/C. o Select option 2 to print the release notes. You are prompted for the name of the print queue that you want to use: * Queue name [SYS$PRINT]: Installing Compaq C 2-5 Either press Return to send the file to the default output print device (SYS$PRINT) or enter another queue name. o Select option 3 to immediately display the release notes online and then be prompted for a queue name for the printed version. o Select option 4 if you have already reviewed the release notes and are restarting the installation. Next, VMSINSTAL displays the following question: * Do you want to continue the installation [N]?: YES %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. To continue the installation, enter YES. Otherwise, press Return. In either case, the release notes are copied to the following file in the SYS$HELP directory (where n is the minor version number): SYS$HELP:CC06n.RELEASE_NOTES ________________________ Note ________________________ The name of the release notes file installed by VMSINSTAL consists of the current product name and version number. Do not delete release notes for previous versions of Compaq C (if any). ______________________________________________________ 7. Read license information. Compaq C Version 6.n for OpenVMS Alpha Systems Copyright 2002 Compaq Information Technologies Group, L.P. Compaq and the Compaq logo are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. 8. Respond to Compaq C multiple-version queries. Installing Compaq C The installation procedure will detect previous versions of the Compaq C compiler installed on your system (back to Compaq C Version 6.0), and asks if you want to keep it or supersede it with the new version you are installing. Enter YES to keep the previous version, or enter NO to supersede it with the new version: A C V6.0-001 compiler was found on your system. Type YES to keep this compiler on your system either as the default system compiler or as an alternate compiler. Type NO to supersede C V6.0-001. * Should the existing V6.0-001 system compiler be preserved [NO]: YES If you answer YES to the previous question, the installation procedure then asks if you want the currently installed ("old") compiler to remain the default compiler on your system. Enter YES to keep the "old" version as the system default compiler. Enter NO to make the "new" version the default system compiler: Type NO to have the compiler on this kit become the default system compiler and to have the currently installed compiler saved as an alternate compiler. Type YES to keep the current system compiler as the default compiler and to have the compiler on this kit available as an alternate compiler. Alternate compilers can be invoked with the cc command after invoking sys$system:decc$set_version.com passing a version_number. Should this V6.0-001 system compiler remain the default when cc is typed [NO]: 9. Respond to license registration query for the new compiler. Compaq C supports the OpenVMS License Management Facility (LMF). The installation procedure displays license information about your product and asks if you have registered and loaded your Product Authorization Key (PAK) for Compaq C. The following is an example of such information: Product: C Producer: DEC Version: 6.5 Release Date: dd-mmm-yyyy * Does this product have an authorization key registered and loaded?: yes Installing Compaq C 2-7 If you have not registered and loaded your PAK, you must answer No to this question. You have to register and load your PAK to run the Installation Verification Procedure (IVP). If you have not done so, you should stop the installation, register and load your PAK, and then restart the installation. 10.Choose the IVP option. The installation procedure asks if you want to run the IVP. The IVP for Compaq C checks to be sure that the installation is successful. It is recommended that you run the IVP; answer YES to the following prompt: This kit contains an Installation Verification Procedure (IVP) to verify the correct installation of Compaq C. The IVP will be left in: SYS$COMMON:[SYSTEST]DECC$IVP.COM After the installation is complete, you can invoke the command file at any time to verify that Compaq C is installed and working correctly. * Do you want to run the IVP after the installation [YES]? After Compaq C is installed, you can run the IVP independently to verify that the software is available on your system. You might need to run the IVP after a system failure to make sure that users can access Compaq C. 11.Decide whether to install the documentation. HTML, postscript and text versions of the Compaq C Users Guide, Language Reference Manual and RTL Reference Manual may be optionally installed into SYS$COMMON:[SYSHLP.CC$ALPHA_HELP_065]. These documents consume approximately 60000 blocks. * Should these manuals be provided [NO]? yes If you have adequate disk space and wish to install the C documentation, enter YES. Once the documentation is installed, you can browse the HTML version by opening the following file from your browser: SYS$COMMON:[SYSHLP.CC$ALPHA_HELP_065]INDEX.HTM Installing Compaq C 12.Read release-notes informational message. This kit contains a file summarizing the new features, changes, restrictions, and compatibility issues in this release of Compaq C. This file is named CC06n.RELEASE_NOTES and has been placed in SYS$HELP:. This file contains information valuable to Compaq C programmers. Please inform your user community of this file's existence. 13.Purge files. * Do you want to purge files replaced by this installation [YES]? The directories SYS$HELP, SYS$MESSAGE, SYS$SYSTEM, DECC$LIBRARY, and SYS$TEST may contain previous versions of Compaq 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 or enter NO to keep them. 14.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. If you chose to have files purged, that work is done now. The following messages are displayed: You have answered all of the questions for this installation. The installation will now execute in 5 to 15 minutes without further intervention, depending on your configuration, installation media, and so forth. The C Runtime Library headers and Starlet headers are installed as a Text Library (.TLB). The traditional text form of the headers (.H files) are also provided for reference purposes only) in the directories: SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C]. Installing Compaq C 2-9 Please note that the compiler does not search the reference areas SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C] during compilation. Instead headers are taken from the text library. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.DECC]. Your OpenVMS system will now be modified to include the following new and modified files: [SYSEXE]DECC$COMPILER_V06_00-001.EXE [renamed] [SYSMSG]DECC$COMPILER_MSG_V06_01-001.EXE [renamed] [SYSEXE]DECC$COMPILER.EXE [new] [SYSMSG]DECC$COMPILER_MSG.EXE [new] [SYSHLP]HELPLIB.HLB [modified] [SYSHLP]CC$HELP*.HTML [new] [SYSHLP.CC$ALPHA_HELP_065] [new] [SYSHLP]CC065.RELEASE_NOTES [new] [SYSHLP]CC065_RELEASE_NOTES.PS [new] [SYSLIB]DCLTABLES.EXE [modified] [SYSLIB]DECC$COMPILED_PRINTF.OLB [new] [SYSLIB]DECC$RTLDEF.TLB [new] [DECC$LIB.REFERENCE.SYS$STARLET_C]*.H [new] [DECC$LIB.REFERENCE.DECC$RTLDEF]*.H [new] [SYSLIB]DECC$CRTL.OLB [new] [SYSLIB]DECC$CRTL.README [new] [SYS$STARTUP]DECC$STARTUP.COM [modified] [SYSTEST]DECC$IVP.COM [new] [SYSEXE]DECC$SET_VERSIONS.COM [new] [SYSEXE]DECC$SHOW_VERSIONS.COM [new] [SYSTEST.DECC]DECC$IVP*.* [new] The file SYS$STARTUP:DECC$STARTUP.COM contains commands to be executed at system startup to allow for the best compilation performance. You may want to invoke this command file from your system's site-specific startup file. This command file does not have to be invoked for correct operation of Compaq C. The end of the installation is indicated by the following message: %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... Installing Compaq C 15.Observe the IVP. If you chose to run the IVP, VMSINSTAL now invokes the IVP to verify that Compaq C was installed successfully: Copyright 2002 Compaq Information Technologies Group, L.P. Compaq and the Compaq logo are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Beginning COMPAQ C V6.5 Installation Verification Procedure Image Check Complete License Check Complete Version Check Complete Help Check Complete Message Check Complete Header Check Complete Run Time Library Check Complete COMPAQ C V6.5 Installation Verification Procedure Successful 16.The installation procedure ends. Installation of CC V6.n completed at hh:mm Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]CC06n.VMI_DATA VMSINSTAL procedure done at hh:mm $ LOGOUT SYSTEM logged out at dd-mmm-yyyy hh:mm:ss.ss When the installation is complete, you can choose to install more products or to log out (as shown here). If you removed any media from the console drive before beginning the installation, you should replace it now. Installing Compaq C 2-11 Be aware that VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, if you are going to continue using the system manager's account and you want to restore these symbols, you should log out and log in again. Error Recovery If errors occur during the installation itself or when the Installation Verification Procedure (IVP) is running, VMSINSTAL displays failure messages. If the installation fails, you see the following message: %VMSINSTAL-E-INSFAIL, The installation of Compaq C V6.n has failed. If the IVP fails, you see these messages: The Compaq C V6.n Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for Compaq C V6.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. 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 Section 1.5. Installing Compaq C If the installation fails, you must restart the installation procedure from step 2 in Section 2.1. For an explanation of any system messages, see the OpenVMS System Messages and Recovery Procedures Reference Manual or the online HELP/MESSAGE facility. If the installation fails due to an IVP failure, contact a Compaq field service representative. Installing Compaq C 2-13 3 _________________________________________________________________ After Installing Compaq C Compaq C is now installed and can be invoked by all users with the CC command. The installation procedure modifies the DCL command table so that the CC 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 CC command must log out and log in again, or use the following DCL command: $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES You can perform the following system management tasks after Compaq C is installed: o Running the Installation Verification Procedure (IVP) separately o Editing the system startup files o Making the product usable on an OpenVMS cluster o Setting user account privileges and quotas o Enhancing performance o Reporting problems The following sections describe these tasks in detail. 3.1 Running the Installation Verification Procedure Separately You usually run the IVP during installation. If you want to run the IVP separately to ensure the integrity of installed files if system problems should occur, execute the following command procedure: $ @SYS$TEST:DECC$IVP.COM After Installing Compaq C 3-1 If the IVP fails for any reason, the following message is displayed: Compaq C VERSION 6.n TEST FAILED Editing the System Files You must edit the system startup file to provide for automatic startup of Compaq C when your system is rebooted. Add the command line that starts Compaq C to the system startup file, SYS$MANAGER:SYSTARTUP_VMS.COM. Compaq C cannot start until after the network has started. You must position this new command line after the line that invokes the network startup command procedure. The following example shows the network startup command line followed by the Compaq C startup command line: $ @SYS$MANAGER:STARTNET.COM . . . $ @SYS$STARTUP:DECC$STARTUP.COM OpenVMS Cluster Considerations If you want to run Compaq C on multiple nodes of an OpenVMS cluster, first check to see that you have the appropriate software license (see Section 1.4). Then perform the following steps after you install Compaq C: 1. Enter the LICENSE LOAD command, as described in the OpenVMS License Management Utility Manual, to activate the license on each node in the cluster on which Compaq C is to be executed. 2. Log in to the installation node and use the OpenVMS INSTALL Utility to determine whether DECC$COMPILER.EXE is a known image: $ INSTALL INSTALL> LIST SYS$SYSTEM:DECC$COMPILER.EXE If the output of the preceding LIST command shows DECC$COMPILER.EXE to be a known image, perform all of the following steps. Otherwise, perform all of the following steps except step 4b. After Installing Compaq C 3. Log in to a node on the cluster. 4. Run the OpenVMS INSTALL utility as described in Section 3.5.2, with the following exceptions: a. After invoking the OpenVMS INSTALL utility, enter the following command: INSTALL> REPLACE SYS$LIBRARY:DCLTABLES.EXE This command updates the DCL tables. It should be entered on each node in the cluster, regardless of whether you activated the Compaq C license (step 1) on all of the nodes. b. If DECC$COMPILER.EXE was established as a known image using the INSTALL utility, enter the following command: INSTALL> REPLACE SYS$SYSTEM:DECC$COMPILER.EXE This command replaces the INSTALL entry for DECC$COMPILER.EXE. It should be entered only on those nodes on which you activated the Compaq C license in step 1. (In most cases, all of the nodes will be licensed.) 5. Repeat steps 3 and 4 for each node of the cluster. 3.4 User Account Requirements Some products cannot be used unless certain privilege and quota requirements are met by user accounts. The following sections describe the privilege and quota requirements needed to work with Compaq C. 3.4.1 User Privileges To use Compaq C, each account must have TMPMBX and NETMBX privileges. Use the OpenVMS AUTHORIZE utility to determine whether users have the privileges they require. After Installing Compaq C 3-3 User Account Quotas To use Compaq C, a user account does not need to meet any special quota requirements. However, for users who will be compiling very large programs (many program units compiled together), consider adjusting working set (WSDEF, WSQUOTA, WSEXTENT) and pagefile (PGFLQUOTA) account quotas to improve performance. See Section 1.5.3.2 for a description of how to verify and change account quotas. Enhancing Compaq C Performance The following sections include information on system tuning and explains how to install Compaq C as a shared image. Tuning Your System After you install Compaq C, you might want to adjust your system to enhance performance or lower the use of some system resources. General information about tuning an OpenVMS system is included in the Guide to OpenVMS Performance Management. Installing Compaq C as a Shared Image If you expect Compaq C to be used extensively on your system, you can reduce the system overhead and memory requirements by installing it as a shared image. To install Compaq C as a shared image on a system that is currently running, use the OpenVMS INSTALL utility. It is recommended that you install Compaq C as shared on a system that has been rebooted recently, because the available space in the global page table is less likely to be fragmented. To install Compaq C as a shared image: 1. Determine the number of available global pagelets and global sections on your system. You will need to increase them. Section 1.5.2 contains guidelines for showing and setting these parameters. 2. After you have reset the system parameter values, run the following .com file: $ $ @SYS$STARTUP:DECC$STARTUP After Installing Compaq C 3.6 Getting Help and Reporting Problems If you encounter a problem while using Compaq C, see the release notes. If the problem is unresolved, report it to Compaq. Depending on the type of support you have and the nature of the problem, take one of the following actions: o If you have a Software Product Services Support Agreement, contact your 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: - The name and version number of the operating system you are using - The product name (Compaq C) and the version number of Compaq C you are using - The hardware system you are using (such as a model number) - A brief description of the problem (one sentence if possible) - How critical the problem is When you submit information electronically or are speaking on the phone to the appropriate Compaq C support specialist, you can provide more detailed information. The information should include the specific commands used to compile and link the program, the error messages displayed, and relevant detailed information (possibly including source program listings). Please attempt to narrow the cause of the problem to a specific module or lines of code. CSC personnel might ask for additional information, such as listings of any command files, INCLUDE and COPY files, relevant data files, and so forth. If the program is longer than 50 lines, submit a copy of it electronically or provide machine-readable media (floppy diskette or magnetic tape). After Installing Compaq C 3-5 o If the problem is related to Compaq C documentation, you can report the problem to the CSC (if you have a Software Product Services Support Agreement and the problem is severe); otherwise, send your comments about Compaq C documentation to the following Internet address: c_docs@compaq.com To obtain information about purchasing a Compaq Software Product Services Support Agreement or other support services, please contact your local Compaq sales representative. After Installing Compaq C A _________________________________________________________________ Sample Installations This appendix contains sample installations of the Compaq C kit. These are only samples. Sometimes the installation procedure is modified in maintenance updates of this product. Because this installation guide is not always revised for maintenance updates, be sure to read the Read Before Installing Compaq C for OpenVMS Alpha Systems Version 6.n letter before you install this product. This letter notes any significant changes to the installation samples shown here. Depending on which layered products you have on your system, you might see additional messages and questions when you perform your installation. The sample installations assume that DECnet has been shut down, and that no users are logged on to your system. The Installation Verification Procedure (IVP) runs at the end of the installations. A.1 Initial Installation This sample was run on a system that had no previous version of Compaq C installed. $ @sys$update:vmsinstal CC065 DKA400:[CC065.KIT] OpenVMS AXP Software Product Installation Procedure V7.2-1 It is 11-JAN-2002 at 12:58. Enter a question mark (?) at any time for help. %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account. %VMSINSTAL-W-ACTIVE, The following processes are still active: TCPIP$NTP TCPIP$PORTM * Do you want to continue anyway [NO]? yes Sample Installations A-1 * Are you satisfied with the backup of your system disk [YES]? The following products will be processed: CC V6.5 Beginning installation of CC V6.5 at 12:58 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. Compaq C Version 6.5 for OpenVMS Alpha Systems Copyright 2002 Compaq Information Technologies Group, L.P. Compaq and the Compaq logo are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Product: C Producer: DEC Version: 6.5 Release Date: 25-FEB-2002 * Does this product have an authorization key registered and loaded? yes This kit contains an Installation Verification Procedure (IVP) to verify the correct installation of Compaq C. The IVP will be left in: SYS$TEST:DECC$IVP.COM After the installation is complete, you can invoke the command file at any time to verify that Compaq C is installed and working correctly. * Do you want to run the IVP after the installation [YES]? HTML, postscript and text versions of the Compaq C Users Guide, Language Reference Manual and RTL Reference Manual may be optionally installed into SYS$COMMON:[SYSHLP.CC$ALPHA_HELP_065]. These documents consume approximately 60000 blocks. * Should these manuals be provided [NO]: Sample Installations This kit contains a file summarizing the new features, changes, restrictions, and compatibility issues in this release of Compaq C. This file is named CC065.RELEASE_NOTES and has been placed in SYS$HELP:. This file contains information valuable to Compaq C programmers. Please inform your user community of this file's existence. * Do you want to purge files replaced by this installation [YES]? You have answered all of the questions for this installation. The installation will now execute in 5 to 15 minutes without further intervention, depending on your configuration, installation media, and so forth. The C Runtime Library headers and Starlet headers are installed as a Text Library (.TLB). The traditional text form of the headers (.H files) is also provided (for reference purposes only) in the directories: SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C]. Please note that the compiler does not search the reference areas SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C] during compilation. Instead headers are taken from the text library. The CXXDEMANGLE utility appears on this system. Installation of the kit version will not be performed. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSHLP.CC$ALPHA_HELP_065]. Your OpenVMS system will now be modified to include the following new and modified files: Sample Installations A-3 [SYSEXE]DECC$COMPILER.EXE [new] [SYSMSG]DECC$COMPILER_MSG.EXE [new] [SYSHLP]HELPLIB.HLB [modified] [SYSHLP]CC$HELP*.HTML [new] [SYSHLP.CC$ALPHA_HELP_065] [new] [SYSHLP]CC065.RELEASE_NOTES [new] [SYSHLP]CC065_RELEASE_NOTES.PS [new] [SYSLIB]DCLTABLES.EXE [modified] [SYSLIB]DECC$RTLDEF.TLB [new] [DECC$LIB.REFERENCE.SYS$STARLET_C]*.H [new] [DECC$LIB.REFERENCE.DECC$RTLDEF]*.H [new] [SYSLIB]DECC$CRTL.OLB [new] [SYSLIB]DECC$CRTL.EXE [new] [SYSLIB]DECC$CRTL.README [new] [SYS$STARTUP]DECC$STARTUP.COM [modified] [SYSEXE]DECC$SET_VERSIONS.COM [new] [SYSEXE]DECC$SHOW_VERSIONS.COM [new] [SYSTEST]DECC$IVP.COM [new] The file SYS$STARTUP:DECC$STARTUP.COM contains commands to be executed at system startup to allow for the best compilation performance. You may want to invoke this command file from your system's site-specific start up file. This command file does not have to be invoked for correct operation of Compaq C. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Copyright 2002 Compaq Information Technologies Group, L.P. Compaq and the Compaq logo are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Beginning COMPAQ C V6.5 Installation Verification Procedure Image Check Complete License Check Complete Version Check Complete Message Check Complete Header Check Complete Run Time Library Check Complete Sample Installations COMPAQ C V6.5 Installation Verification Procedure Successful Installation of CC V6.5 completed at 13:10 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]CC065.VMI_DATA VMSINSTAL procedure done at 13:11 A.2 Upgrade Installation This sample was run on a system that had a previous version of Compaq C installed. The system is upgraded to the new version of the compiler, which replaces the old one. $ @sys$update:vmsinstal CC065 DKA400:[CC065.KIT] OpenVMS AXP Software Product Installation Procedure V7.2-1 It is 11-JAN-2002 at 14:24. Enter a question mark (?) at any time for help. %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account. %VMSINSTAL-W-ACTIVE, The following processes are still active: TCPIP$NTP TCPIP$PORTM * Do you want to continue anyway [NO]? yes * Are you satisfied with the backup of your system disk [YES]? The following products will be processed: CC V6.5 Beginning installation of CC V6.5 at 14:24 (Waiting for demon to record initial state... ...done) %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. Compaq C Version 6.5 for OpenVMS Alpha Systems Copyright 2002 Compaq Information Technologies Group, L.P. Compaq and the Compaq logo are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Sample Installations A-5 Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. A C V6.2-008 compiler was found on your system. Type YES to keep this compiler on your system either as the default system compiler or as an alternate compiler. Type NO to supersede C V6.2-008. * Should the existing V6.2-008 system compiler be preserved [NO]: Product: C Producer: DEC Version: 6.5 Release Date: 25-FEB-2002 * Does this product have an authorization key registered and loaded? yes This kit contains an Installation Verification Procedure (IVP) to verify the correct installation of Compaq C. The IVP will be left in: SYS$TEST:DECC$IVP.COM After the installation is complete, you can invoke the command file at any time to verify that Compaq C is installed and working correctly. * Do you want to run the IVP after the installation [YES]? HTML, postscript and text versions of the Compaq C Users Guide, Language Reference Manual and RTL Reference Manual may be optionally installed into SYS$COMMON:[SYSHLP.CC$ALPHA_HELP_065]. These documents consume approximately 60000 blocks. * Should these manuals be provided [NO]: yes This kit contains a file summarizing the new features, changes, restrictions, and compatibility issues in this release of Compaq C. This file is named CC065.RELEASE_NOTES and has been placed in SYS$HELP:. This file contains information valuable to Compaq C programmers. Please inform your user community of this file's existence. * Do you want to purge files replaced by this installation [YES]? Sample Installations You have answered all of the questions for this installation. The installation will now execute in 5 to 15 minutes without further intervention, depending on your configuration, installation media, and so forth. The C Runtime Library headers and Starlet headers are installed as a Text Library (.TLB). The traditional text form of the headers (.H files) is also provided (for reference purposes only) in the directories: SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C]. Please note that the compiler does not search the reference areas SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C] during compilation. Instead headers are taken from the text library. The CXXDEMANGLE utility appears on this system. Installation of the kit version will not be performed. Your OpenVMS system will now be modified to include the following new and modified files: [SYSEXE]DECC$COMPILER.EXE [new] [SYSMSG]DECC$COMPILER_MSG.EXE [new] [SYSHLP]HELPLIB.HLB [modified] [SYSHLP]CC$HELP*.HTML [new] [SYSHLP.CC$ALPHA_HELP_065] [new] [SYSHLP]CC065.RELEASE_NOTES [new] [SYSHLP]CC065_RELEASE_NOTES.PS [new] [SYSLIB]DCLTABLES.EXE [modified] [SYSLIB]DECC$RTLDEF.TLB [new] [DECC$LIB.REFERENCE.SYS$STARLET_C]*.H [new] [DECC$LIB.REFERENCE.DECC$RTLDEF]*.H [new] [SYSLIB]DECC$CRTL.OLB [new] [SYSLIB]DECC$CRTL.EXE [new] [SYSLIB]DECC$CRTL.README [new] [SYS$STARTUP]DECC$STARTUP.COM [modified] [SYSEXE]DECC$SET_VERSIONS.COM [new] [SYSTEST]DECC$IVP.COM [new] The file SYS$STARTUP:DECC$STARTUP.COM contains commands to be executed at system startup to allow for the best compilation performance. You may want to invoke this command file from your system's site-specific start up file. This command file does not have to be invoked for correct operation of Compaq C. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Sample Installations A-7 Copyright 2002 Compaq Information Technologies Group, L.P. Compaq and the Compaq logo are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Beginning COMPAQ C V6.5 Installation Verification Procedure Image Check Complete License Check Complete Version Check Complete Message Check Complete Header Check Complete Run Time Library Check Complete COMPAQ C V6.5 Installation Verification Procedure Successful Installation of CC V6.5 completed at 14:36 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]CC065.VMI_DATA VMSINSTAL procedure done at 14:40 Installation with Alternate Compiler This sample was run on a system that had a previous version of Compaq C installed. In this sample, the new version of the compiler is installed, but a previous version of the compiler is kept as an alternate compiler. The installation procedure prompts you to designate one of the compiler versions as the system default compiler. See Section 1.6 for more information on installing and using multiple compiler versions. Note that in this example, OPTIONS N is specified on the vmsinstal command to print the release notes. Sample Installations $ @sys$update:vmsinstal CC065 DKA400:[CC065.KIT] options n OpenVMS Alpha Software Product Installation Procedure X5F7-SSB It is 3-January-2002 at 14:07. Enter a question mark (?) at any time for help. %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account. * Do you want to continue anyway [NO]? yes * Are you satisfied with the backup of your system disk [YES]? The following products will be processed: CC V6.5 Beginning installation of CC V6.5 at 14:07 %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]: * Do you want to continue the installation [NO]? yes %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. Compaq C Version 6.5 for OpenVMS Alpha Systems Copyright 2002 Compaq Information Technologies Group, L.P. Compaq and the Compaq logo are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. A C V6.0-001 compiler was found on your system. Type YES to keep this compiler on your system either as the default system compiler or as an alternate compiler. Type NO to supersede C V6.0-001. Sample Installations A-9 * Should the existing V6.0-001 system compiler be preserved [NO]: yes Type NO to have the compiler on this kit become the default system compiler and to have the currently installed compiler saved as an alternate compiler. Type YES to keep the current system compiler as the default compiler and to have the compiler on this kit available as an alternate compiler. Alternate compilers can be invoked with the cc command after invoking sys$system:decc$set_version.com passing a version_number. * Should this V6.0-001 system compiler remain the default when cc is typed [NO]: yes Product: C Producer: DEC Version: 6.5 Release Date: 25-FEB-2002 * Does this product have an authorization key registered and loaded? yes This kit contains an Installation Verification Procedure (IVP) to verify the correct installation of Compaq C. The IVP will be left in: SYS$COMMON:[SYSTEST]DECC$IVP.COM After the installation is complete, you can invoke the command file at any time to verify that Compaq C is installed and working correctly. * Do you want to run the IVP after the installation [YES]? HTML, postscript and text versions of the Compaq C Users Guide, Language Reference Manual and RTL Reference Manual may be optionally installed into SYS$COMMON:[SYSHLP.CC$ALPHA_HELP_065]. These documents consume approximately 60000 blocks. * Should these manuals be provided? [NO]? yes %VMSINSTAL-I-RESTORE, Restoring product saveset B... This kit contains a file summarizing the new features, changes, restrictions, and compatibility issues in this release of Compaq C. This file is named CC065.RELEASE_NOTES and has been placed in SYS$HELP:. This file contains information valuable to Compaq C programmers. Please inform your user community of this file's existence. * Do you want to purge files replaced by this installation [YES]? Sample Installations You have answered all of the questions for this installation. The installation will now execute in 5 to 15 minutes without further intervention, depending on your configuration, installation media, and so forth. The C Runtime Library headers and Starlet headers are installed as a Text Library (.TLB). The traditional text form of the headers (.H files) are also provided for reference purposes only) in the directories: SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C]. Please note that the compiler does not search the reference areas SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C] during compilation. Instead headers are taken from the text library. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.DECC]. Your OpenVMS system will now be modified to include the following new and modified files: [SYSEXE]DECC$COMPILER_V06_00-001.EXE [renamed] [SYSMSG]DECC$COMPILER_MSG_V06_01-001.EXE [renamed] [SYSEXE]DECC$COMPILER.EXE [new] [SYSMSG]DECC$COMPILER_MSG.EXE [new] [SYSHLP]HELPLIB.HLB [modified] [SYSHLP]CC$HELP*.HTML [new] [SYSHLP.CC$ALPHA_HELP_065] [new] [SYSHLP]CC065.RELEASE_NOTES [new] [SYSHLP]CC065_RELEASE_NOTES.PS [new] [SYSLIB]DCLTABLES.EXE [modified] [SYSLIB]DECC$COMPILED_PRINTF.OLB [new] [SYSLIB]DECC$RTLDEF.TLB [new] [DECC$LIB.REFERENCE.SYS$STARLET_C]*.H [new] [DECC$LIB.REFERENCE.DECC$RTLDEF]*.H [new] [SYSLIB]DECC$CRTL.OLB [new] [SYSLIB]DECC$CRTL.README [new] [SYS$STARTUP]DECC$STARTUP.COM [modified] [SYSTEST]DECC$IVP.COM [new] [SYSEXE]DECC$SET_VERSIONS.COM [new] [SYSEXE]DECC$SHOW_VERSIONS.COM [new] [SYSTEST.DECC]DECC$IVP*.* [new] Sample Installations A-11 The file SYS$STARTUP:DECC$STARTUP.COM contains commands to be executed at system startup to allow for the best compilation performance. You may want to invoke this command file from your system's site-specific startup file. This command file does not have to be invoked for correct operation of Compaq C. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Copyright 2002 Compaq Information Technologies Group, L.P. Compaq and the Compaq logo are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Beginning COMPAQ C V6.5 Installation Verification Procedure Image Check Complete License Check Complete Version Check Complete Help Check Complete Message Check Complete Header Check Complete Run Time Library Check Complete COMPAQ C V6.5 Installation Verification Procedure Successful Installation of CC V6.5 completed at 14:15 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]CC065.VMI_DATA VMSINSTAL procedure done at 14:16 Sample Installations B _________________________________________________________________ Files Installed The Compaq C installation procedure installs and modifies a number of files on your system, as follows: [SYSEXE]DECC$COMPILER_V06_00-001.EXE [renamed] [SYSMSG]DECC$COMPILER_MSG_V06_01-001.EXE [renamed] [SYSEXE]DECC$COMPILER.EXE [new] [SYSMSG]DECC$COMPILER_MSG.EXE [new] [SYSHLP]HELPLIB.HLB [modified] [SYSHLP]CC$HELP*.HTML [new] [SYSHLP.CC$ALPHA_HELP_065] [new] [SYSHLP]CC065.RELEASE_NOTES [new] [SYSHLP]CC065_RELEASE_NOTES.PS [new] [SYSLIB]DCLTABLES.EXE [modified] [SYSLIB]DECC$COMPILED_PRINTF.OLB [new] ! OpenVMS V7.2 or lower [SYSLIB]DECC$RTLDEF.TLB [new] [DECC$LIB.REFERENCE.SYS$STARLET_C]*.H [new] [DECC$LIB.REFERENCE.DECC$RTLDEF]*.H [new] [SYSLIB]DECC$CRTL.OLB [new] [SYSLIB]DECC$CRTL.README [new] [SYS$STARTUP]DECC$STARTUP.COM [modified] [SYSTEST]DECC$IVP.COM [new] [SYSEXE]DECC$SET_VERSION.COM [new] [SYSEXE]DECC$SHOW_VERSIONS.COM [new] Note that the files [SYSEXE]DECC$COMPILER_V06_00-001.EXE and [SYSMSG]DECC$COMPILER_MSG_V06_01-001.EXE are examples of files installed only when installing an alternate compiler. In this case, the new version of the compiler is installed, but a previous version of the compiler is kept as an alternate compiler. The installation procedure prompts you to designate one of the compiler versions as the system default compiler. See Section 1.6 for more information on installing and using multiple compiler versions. Files Installed B-1 C _________________________________________________________________ Recovering from Errors This appendix provides information to help you with failures or errors that might occur during product installation or product use. C.1 Failures During Compaq C Installation If VMSINSTAL detects any problems during the installation, it notifies you and asks if you want to continue the installation. In some instances, you can enter yes to continue. To stop the installation process and correct the situation, enter no or press Return, then correct the problem and restart the installation. If errors occur during the installation itself or when the Installation Verification Procedure (IVP) is running, VMSINSTAL displays failure messages. If the installation fails, you see the following message: %VMSINSTAL-E-INSFAIL, The installation of Compaq C V6.n has failed. If the IVP fails, you see these messages: The Compaq C V6.n Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for Compaq C V6.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. Recovering from Errors C-1 o The product license has not been registered and loaded. For descriptions of the error messages generated by these conditions, see the OpenVMS documentation on system messages, recovery procedures, and OpenVMS software installation. If you are notified that any of these conditions exist, you should take the appropriate action as described in the message. For information on installation requirements, see Section 1.5. If the installation fails, you must restart the installation procedure from step 2 in Section 2.1. For an explanation of any system messages, see the OpenVMS System Messages and Recovery Procedures Reference Manual or the online HELP/MESSAGE facility. If the installation fails due to an IVP failure, contact a Compaq field service representative. Problems During Compaq C Use If you encounter a problem while using Compaq C, see the release notes. If the problem is unresolved, report it to Compaq. Depending on the type of support you have and the nature of the problem, take one of the following actions: o If you have a Software Product Services Support Agreement, contact your 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: - The name and version number of the operating system you are using - The product name (Compaq C) and the version number of Compaq C you are using - The hardware system you are using (such as a model number) - A brief description of the problem (one sentence if possible) - How critical the problem is Recovering from Errors When you submit information electronically or are speaking on the phone to the appropriate Compaq C support specialist, you can provide more detailed information. The information should include the specific commands used to compile and link the program, the error messages displayed, and relevant detailed information (possibly including source program listings). Please attempt to narrow the cause of the problem to a specific module or lines of code. CSC personnel might ask for additional information, such as listings of any command files, INCLUDE and COPY files, relevant data files, and so forth. If the program is longer than 50 lines, submit a copy of it electronically or provide machine-readable media (floppy diskette or magnetic tape). o If the problem is related to Compaq C documentation, you can report the problem to the CSC (if you have a Software Product Services Support Agreement and the problem is severe); otherwise, send your comments about Compaq C documentation to the following Internet address: c_docs@compaq.com To obtain information about purchasing a Compaq Software Product Services Support Agreement or other support services, please contact your local Compaq sales representative. Recovering from Errors C-3