 











            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.

      <Ctrl/x>               In procedures, a sequence such as
                             <Ctrl/x> indicates that you must
                             hold down the key labeled Ctrl while
                             you press another key or a pointing
                             device button.

      <Return>               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]: <Return>

      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 
                                                                       <Return>

                                          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 <Return>

      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 <Return>

                                         Sample Installations A-1

 


   * Are you satisfied with the backup of your system disk [YES]? <Return>

   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 
                                                                      <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_065].
       These documents consume approximately 60000 blocks.

   * Should these manuals be provided [NO]: <Return>

 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]? <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_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 <Return>

      * Are you satisfied with the backup of your system disk [YES]? <Return>

      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]: <Return>

           Product:      C
           Producer:     DEC
           Version:      6.5
           Release Date: 25-FEB-2002

   * 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_065].
       These documents consume approximately 60000 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 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]? <Return>

 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]? <Return>

      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 <Return>

    %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 <Return>

    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 <Return>

          Product:      C
          Producer:     DEC
          Version:      6.5
          Release Date: 25-FEB-2002

  * 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$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]? <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_065].
       These documents consume approximately 60000 blocks.

   * Should these manuals be provided? [NO]? yes <Return>

       %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]? <Return>

 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
