HP OpenVMS Systems

Order Number: AA--PXWXF--TE

This guide contains instructions for installing Compaq C on a VAX processor system running the OpenVMS operating system.

Revision/Update Information: This revised manual supersedes the DEC C Installation Guide for OpenVMS VAX Systems, (Order No. AA--PXWXE--TE)

Operating System & Version: OpenVMS VAX Version 5.5-2 or higher.
Future maintenance releases may
require higher versions.

Software Version: Compaq C Version 6.4 or higher for OpenVMS VAX Systems

Compaq Computer Corporation
Houston, Texas

© 2001 Compaq Computer Corporation.

COMPAQ, the Compaq logo, VAX, Alpha, VMS, and OpenVMS are registered in the U.S. Patent and Trademark Office. 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 DECdocument, Version V3.3-1e.

Purpose of this Guide

This guide describes how to install Compaq C on VAX processors that are 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 may send comments or suggestions regarding this guide, or any Compaq C document, by electronic mail to the following Internet address:

c_docs-at-hp.com

Intended Audience

The audience for this guide is the system manager who installs Compaq C software.

Structure of this Document

This guide is organized as follows:

• Chapter 1 describes the operating system and hardware requirements for Compaq C installation and related procedures that you complete before installing Compaq C.
• Chapter 2 describes the step-by-step instructions for the installation.
• Chapter 3 describes actions and considerations after the installation, including running the Installation Verification Procedure (IVP).
• Appendix A contains sample listings for Compaq C installation.

Manuals in the Compaq C Documentation Set

In addition to this guide, the Compaq C documentation set for OpenVMS VAX systems includes the following books:

• Compaq C Migration Guide for OpenVMS VAX Systems
• Compaq C Language Reference Manual
• Compaq C User's Guide for OpenVMS Systems
• Compaq C Run-Time Library Reference Manual for OpenVMS Systems

Related Manuals

For information on OpenVMS system management, see the following documents in the OpenVMS documentation set:

• OpenVMS System Manager's Manual
• Guide to Maintaining a VMS System
• OpenVMS License Management Utility Manual
• 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.

Conventions

Table 1 lists the conventions used in this guide.

This chapter discusses the preparations and requirements necessary for installing Compaq C for OpenVMS VAX Systems.

This guide applies to Compaq C for OpenVMS VAX Version 6.4 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 separate online release notes. The release notes contain installation-related notes and a summary of technical changes, known problems, restrictions, and incompatibilities. Reading the release notes before proceeding with the installation is strongly recommended. For information on accessing the online release notes, see Section 2.1.

1.1 Required Operating System Components

Compaq C for OpenVMS VAX Systems, Version 6.4 requires OpenVMS VAX Version 5.5-2 or higher.

The OpenVMS VAX (formerly VAX VMS) operating system comes with a variety of support options, including such features as networking and RMS journaling. To use Compaq C, your system should be running a version of OpenVMS that includes the following:

• Programming support
• Utilities

If you are installing Compaq C on OpenVMS VAX Version 5.5-2 or Version 6.0, you must first install the Compaq C/C++ Run-Time Components kit. See the Compaq C/C++ Run-Time Components for OpenVMS VAX Reference and Installation Guide .

1.3 Optional Software

See the Software Support Addendum (SSA) that comes with the Software Product Description (SPD) for a complete list of prerequisite and optional software products and their required version numbers.

Note that Compaq C and VAX C can coexist on your system. The CC command is used to invoke either the VAX C or Compaq C compiler. If your system has a VAX C compiler already installed on it, you have the option of specifying which compiler will be invoked by default whenever just the CC command verb is used. To invoke the compiler that is not the default, use the CC command with the appropriate qualifier: /DECC for the Compaq C compiler, or /VAXC for the VAX C compiler. See the Compaq C release notes for more information.

1.4 License Registration

Before you install and run Compaq C Version 6.4 on a newly licensed node or cluster, you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order.

If you are installing 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 PAK status and install the 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 to run the Installation Verification Procedure (IVP) and use the software.

To register a license under OpenVMS VAX, first log in to the system manager's account, SYSTEM. You then have a choice of two ways to perform the registration:

• Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your License PAK.
• At the DCL prompt, enter the LICENSE REGISTER command with the appropriate qualifiers that correspond to the License PAK information.

If you plan to use Compaq C on more than one node in a VAXcluster, you will need to perform a license load on the other nodes after you complete this installation. See Section 3.3.

For complete information on using LMF, see the VMS License Management Utility Manual.

1.5 Installation Procedure Requirements

This section discusses various requirements for installing Compaq C.

Each installation takes approximately 10 to 60 minutes, depending on your type of media and your system configuration.

Installing Compaq C and running the Installation Verification Procedure (IVP) on a standalone VAXstation 4000-60 system takes approximately 15 minutes.

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

1.5.1 Privileges and Disk Space

To install Compaq C, you must be logged in to an account that has SETPRV or at least the following privileges:

• CMKRNL
• WORLD
• SYSPRV

VMSINSTAL turns off BYPASS privilege at the start of the installation.

The Compaq C requirements for free disk storage space are different during installation and after installation. Table 1-1 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.

To determine the number of free disk blocks on the current system disk, enter the following DCL command:

$ SHOW DEVICE SYS$SYSDEVICE

The account you use to install Compaq C must have sufficient quotas to enable you to perform the installation. Table 1-2 summarizes the process quotas required for the installation account.

User account quotas are stored in the file SYSUAF.DAT. Use the OpenVMS Authorize Utility (AUTHORIZE) to verify and change process quotas for the installation account. (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 = 160
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.

1.5.3 System Parameters

Installing Compaq C requires certain system parameter settings.

The minimum number of contiguous free global pages and global sections needed for the installation depends on whether
SYS$SYSTEM:DECC$COMPILER.EXE was previously installed as a shared known image. See Table 1-3.

These values represent the number of contiguous free global pages and global sections required for the installation, not the total number you need to run your system and other software.

To install and run Compaq C, you must have sufficient contiguous free global pages and free global sections. You must first find out how many free global pages and sections you have on your system. Use AUTOGEN if you need to increase the CONTIG_GBLPAGES and FREE_GBLSECTS system parameters.

Enter the following DCL command to determine the number of global pages 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 pages needed for the file.

You can use the WRITE command with the F$GETSYI lexical function to find the number of contiguous free global pages 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 contiguous free global pages or free global sections is less than the value required (see Section 1.5.3), you must increase the system parameter setting.

Section 1.5.3.2 describes the procedures for increasing these values using AUTOGEN.

1.5.3.2 Changing System Parameter Values with AUTOGEN

If you do not have enough contiguous free global pages or free global sections to install Compaq C, you can do either of the following:

• Delete an existing known image using the OpenVMS Install Utility.
• 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

To modify incremental parameters such as GBLPAGES and GBLSECTIONS, use ADD_GBLPAGES and ADD_GBLSECTIONS, respectively. The following example increases the global page setting by 2000:

ADD_GBLPAGES = 2000

Be aware that when you set the page file quota, you should not use a value that exceeds the amount of page file space available on the system.

After you make all your changes, exit from the editor and execute the AUTOGEN procedure to recalculate your system parameters. Enter the following command to recalculate your system parameters and reboot the system:

$ @SYS$UPDATE:AUTOGEN SAVPARAMS REBOOT

When you specify REBOOT, AUTOGEN performs an automatic system shutdown and then reboots the system. Any users logged on to the system are immediately disconnected during the shutdown. The automatic reboot puts the new parameter values into effect.

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.4 Backing Up Your System Disk

At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. Doing a system disk backup before installing any software is strongly recommended.

Use the backup procedures that are established at your site. For details on performing a system disk backup, see the section on the Backup Utility in the OpenVMS System Management Subkit.

1.6 Installing and Using Multiple Compiler Versions

Compaq C Version 6.4 provides initial support for installing and using multiple versions of the compiler on the same node.

During installation of Version 6.4, if a Version 6.0 or Version 6.2 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.

Some details of the following description may change, but the mechanism is essentially as follows.

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:

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

• 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 (DECC$COMPILER_V06_02-008.EXE in the previous example).
  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:

  @sys$system:decc$set_version.com V6.2-008 @sho logical DECC$* (LNM$PROCESS_TABLE) "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.