United States    
COMPAQ STORE | PRODUCTS | SERVICES | SUPPORT | CONTACT US | SEARCH
Compaq C

Compaq C
Installation Guide for
OpenVMS Alpha Systems
Previous Contents

2.2 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:

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.4.

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.

Chapter 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:

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

If the IVP fails for any reason, the following message is displayed: 


Compaq C VERSION 6.n TEST FAILED

3.2 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

3.3 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.3). 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.

  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:
    1. 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.

    2. 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.

3.4.2 User Account Quotas

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

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

3.5 Enhancing Compaq C Performance

The following sections include information on system tuning and explains how to install Compaq C as a shared image.

3.5.1 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.

3.5.2 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.4.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

3.6 Getting Help and Reporting Problems

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

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

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

  1. Describe as accurately as possible the circumstances and state of the system when the problem occurred. Include the description and version number of the Compaq C compiler being used. Demonstrate the problem with specific examples.
  2. Reduce the problem to as small a size as possible.
  3. Remember to include listings of any command files, INCLUDE files, or relevant data files, and so forth.
  4. Provide a listing of the program.
  5. If the program is longer than 50 lines, submit a copy of it on machine-readable media (diskette or magnetic tape).
  6. Report only one problem per report. This will facilitate a faster response.
  7. Mail the problem report to Compaq.

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

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.

Appendix 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 CC064 DKA400:[CC064.KIT] 
 
        OpenVMS AXP Software Product Installation Procedure V7.2-1 
 
It is 11-JAN-2001 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 [Return]
 
* Are you satisfied with the backup of your system disk [YES]? [Return]
 
The following products will be processed: 
 
  CC V6.4 
 
        Beginning installation of CC V6.4 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.4 for OpenVMS Alpha Systems 
 
  Copyright 2001 Compaq Computer Corporation 
 
  Compaq and the Compaq logo Registered in U.S. Patent and Trademark Office. 
 
  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.4 
        Release Date: 05-JAN-2001 
 
* Does this product have an authorization key registered and loaded? yes [Return]
 
    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]? [Return]
 
    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_064]. 
    These documents consume approximately 40000 blocks. 
 
* Should these manuals be provided [NO]: [Return]
 
    This kit contains a file summarizing the new features, changes, 
    restrictions, and compatibility issues in this release of Compaq C. 
    This file is named CC064.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]? [Return]
 
    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_064]. 
 
    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_064]            [new] 
    [SYSHLP]CC064.RELEASE_NOTES           [new] 
    [SYSHLP]CC064_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... 
 
    Beginning COMPAQ C V6.4 Installation Verification Procedure 
 
    Copyright 2001 Compaq Computer Corporation 
 
    Compaq and the Compaq logo Registered in U.S. Patent and Trademark Office. 
 
    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. 
 
    Image Check Complete 
    License Check Complete 
    Version Check Complete 
    Message Check Complete 
    Header Check Complete 
    Run Time Library Check Complete 
 
    COMPAQ C V6.4 Installation Verification Procedure Successful 
 
        Installation of CC V6.4 completed at 13:10 
                                                                
    Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY 
    Creating installation data file: VMI$ROOT:[SYSUPD]CC064.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 CC064 DKA400:[CC064.KIT] 
 
        OpenVMS AXP Software Product Installation Procedure V7.2-1 
 
It is 11-JAN-2001 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 [Return]
 
* Are you satisfied with the backup of your system disk [YES]? [Return]
 
The following products will be processed: 
 
  CC V6.4 
 
        Beginning installation of CC V6.4 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.4 for OpenVMS Alpha Systems 
 
  Copyright 2001 Compaq Computer Corporation 
 
  Compaq and the Compaq logo Registered in U.S. Patent and Trademark Office. 
 
  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]: [Return]
 
        Product:      C 
        Producer:     DEC 
        Version:      6.4 
        Release Date: 05-JAN-2001 
 
* Does this product have an authorization key registered and loaded? yes [Return]
 
    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]? [Return]
 
    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_064]. 
    These documents consume approximately 40000 blocks. 
 
* Should these manuals be provided [NO]: yes [Return]
 
    This kit contains a file summarizing the new features, changes, 
    restrictions, and compatibility issues in this release of Compaq C. 
    This file is named CC064.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]? [Return]
 
    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_064]            [new] 
    [SYSHLP]CC064.RELEASE_NOTES           [new] 
    [SYSHLP]CC064_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... 
 
    Beginning COMPAQ C V6.4 Installation Verification Procedure 
 
    Copyright 2001 Compaq Computer Corporation 
 
    Compaq and the Compaq logo Registered in U.S. Patent and Trademark Office. 
 
    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. 
 
    Image Check Complete 
    License Check Complete 
    Version Check Complete 
    Message Check Complete 
    Header Check Complete 
    Run Time Library Check Complete 
 
    COMPAQ C V6.4 Installation Verification Procedure Successful 
 
        Installation of CC V6.4 completed at 14:36 
 
    Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY 
 
    Creating installation data file: VMI$ROOT:[SYSUPD]CC064.VMI_DATA 
 
        VMSINSTAL procedure done at 14:40

Previous Next Contents
  

1.800.AT.COMPAQ

privacy and legal statement