HP OpenVMS Systems

HP C

This guide describes how to install HP C on an Intel Itanium processor running the OpenVMS Industry Standard 64 operating system.

This guide applies to HP C Version 7.3 for I64, and all subsequent point releases for Version 7.0.

Revision/Update Information: This is a new manual.

Operating System: OpenVMS Industry Standard 64 Version 8.2 or higher

Software Version: HP C Version 7.3

Hewlett-Packard Company
Palo Alto, California

© Copyright 2007 Hewlett-Packard Development Company, L.P.

Confidential computer software. Valid license from HP 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.

The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Printed in the US

This document is available on CD-ROM.

This document was prepared using DECdocument, Version V3.3-1e.

This guide explains how to install HP C on an OpenVMS Industry Standard 64 (I64) system.

Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall HP C for any other reason.

This manual applies to 7.3 of HP C and all subsequent releases until a revised installation guide is issued.

Intended Audience

This guide is intended for system managers who install HP C.

Structure of This Document

This guide contains the following chapters and appendixes:

• Chapter 1 describes procedures that you must complete before installing HP C.
• Chapter 2 describes how to install HP C.
• Chapter 3 describes post-installation considerations.
• Appendix A lists the files installed.
• Appendix B lists the installation messages.

Associated Documentation

In addition to this guide, the HP C documentation set includes the following:

• The HP C Language Reference Manual
• The HP C User's Guide for OpenVMS Systems
• A cover letter titled Read Before Installing or Using HP C Version 7.n for OpenVMS Industry Standard 64 Systems
• HP C online release notes

For the location of the cover letter and HP C release notes, see Section 1.2.

The following manuals in the OpenVMS documentation set contain information relevant to installing software:

• POLYCENTER Software Installation Utility User's Guide
• OpenVMS License Management Utility Manual
• OpenVMS System Manager's Manual, which includes:
  • OpenVMS System Manager's Manual: Essentials
  • OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems
• Guide to OpenVMS Performance Management

Once installed, you can use HP C online HELP, which describes the command qualifiers, explains compiler messages, and provides a quick-reference summary of language topics. To use online HELP for HP C, enter the following:

$ HELP CC

For help understanding OpenVMS error messages, see the OpenVMS System Messages and Recovery Procedures Reference Manual or the online HELP/MESSAGE facility.

Reader's Comments

HP welcomes your comments on this manual. You can send comments by email to:

c_docs@hp.com 

HP C Web Page

For additional product information, you can view the HP C for OpenVMS home page at the following URL:

http://h71000.www7.hp.com/commercial/c/c_index.html 

Conventions

The following product names may appear in this manual:

• HP OpenVMS Industry Standard 64 for Integrity Servers
• OpenVMS I64
• I64

All three names (the longer form and the two abbreviated forms) refer to the version of the OpenVMS operating system that runs on the Intel® Itanium® architecture.

Table 1 lists the typographic conventions used in this document.

In this manual, some version numbers are given as Vn.n. When you install HP C, the actual version number appears on your screen.

This chapter describes:

• Section 1.1, What You Need to Know First
• Section 1.2, Reading the Release Notes and Cover Letter
• Section 1.3, Hardware Requirements
• Section 1.4, Required Operating System Components
• Section 1.5, Optional Software
• Section 1.6, License Registration
• Section 1.7, Installation Procedure Requirements
• Section 1.8, Backing Up Your System Disk

This guide applies to Version 7.3 of HP C for OpenVMS I64 Systems and all subsequent maintenance releases up to the next release of the product that includes an updated installation guide.

1.1 What You Need to Know First

The OpenVMS Software Product Library CD-ROM (media CD-ROM) set provides the following files:

• HP C installation kit files
• HP C documentation files, including a cover letter, this installation guide, and other files
• Online CD-ROM documentation files in the [README] directory on the first media CD-ROM, including a CD-ROM user guide and master list of CD-ROM products
• A CDMENU utility

To determine whether the appropriate media CD-ROM is already mounted on your system, contact the appropriate system manager.

1.2 Reading the Release Notes and Cover Letter

HP C provides release notes and a cover letter called Read Before Installing or Using HP C Version 7.n for OpenVMS Industry Standard 64 Systems.

You can extract the HP C release notes to a file and type or print them before starting HP C installation. The HP C release notes are also installed on your system after installation.

You can read the online cover letter provided on the media CD-ROM set or read the printed hardcopy cover letter.

For information about using the CDMENU utility and locating the appropriate media CD-ROM and directory that contains the HP C cover letter, see the first few steps in Section 2.2.

Once the appropriate media CD-ROM has been mounted and the appropriate HP C documentation directory located, do one of the following:

• Use a TYPE command to display the ASCII version of the HP C cover letter (on your screen).
• Use a PRINT command to print the ASCII or PostScript version of the HP C cover letter to a printer.

For information about reading the online release notes before installation, use the PRODUCT EXTRACT RELEASE_NOTES command described in Section 2.2 (step 6).

HP strongly recommends that you read the release notes and the cover letter before installing HP C. They contain information about changes to the installation and use of HP C, such as the minimum version of the OpenVMS I64 operating system required for this release of HP C.

After installation, the release notes are installed as text and PostScript form in:

SYS$HELP:CC.RELEASE_NOTES 
SYS$HELP:CC_RELEASE_NOTES.PS 

1.3 Hardware Requirements

You can install HP C on any Itanium processor capable of running OpenVMS I64 Version 8.2 or higher. See the OpenVMS Operating System's Software Product Description (SPD 25.01.nn) for details.

1.4 Required Operating System Components

HP C 7.3 requires the OpenVMS I64 operating system Version 8.2 or higher.

Future HP C releases may require higher versions of the OpenVMS operating system, as described in the release notes or the cover letter.

The OpenVMS I64 operating system comes with a variety of support options (or components). Components include such features as networking and RMS journaling. To use HP C, your system should be running a version of the OpenVMS I64 operating system that includes the base component and the following other components:

• Programming support
• Utilities

For a complete list of the required components, see the HP C Software Product Description (SPD) on the media CD-ROM.

1.5 Optional Software

You can use the following optional OpenVMS software with HP C:

• HP Language-Sensitive Editor/Source Code Analyzer (LSE/SCA). Support for C requires that LSE be installed before the compiler is installed.
• HP Test Manager (DTM)
• HP Performance and Coverage Analyzer (PCA)
• HP Code Management System (CMS)
• HP Module Management System (MMS)

1.6 License Registration

Before you install and run HP C 7.3 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 specific LMF product name used by HP C is:

• C-USER: Concurrent-Use License

The HP C compiler accepts a C-USER PAK. 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 HP 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 HP C, review the PAK status and install the PAKs for any prerequisite or optional software before you install HP C.

You must register and load your license for HP 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, log in to a privileged account, such as the system manager's account, SYSTEM. You have a choice of two ways to register a license:

• 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 License PAK information.

If you plan to use HP C on more than one node in a cluster, 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 or the online HELP LICENSE utility.

1.7 Installation Procedure Requirements

After you have registered and loaded the license PAK and read the appropriate parts of this installation guide, the installation takes approximately 5 to 15 minutes, depending on your type of media, your system configuration, and the kit components chosen.

1.7.1 Installation Account Privileges and Disk Space

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

• BYPASS
• CMKRNL
• SYSLCK
• SYSPRV

Table 1-1 lists the HP C requirements for free disk storage space to install the compiler and the documentation (in .ps, .txt, and .html formats).

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

1.7.2 System Parameters

Installing HP 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:

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

1.7.2.1 Calculating Values for GBLPAGES and GBLSECTIONS

To install and run HP 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 for the file.

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.7.2), you must increase the system parameter setting.

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

1.7.2.2 Changing System Parameter Values with AUTOGEN

If you do not have enough free global pages or free global sections to install HP 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 specifies the name of the parameter and its value. For example:

WSMAX = 8096

To modify incremental parameters such as GBLPAGES and GBLSECTIONS, use the ADD_ prefix. 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 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 information about using AUTOGEN and its command-line parameters, see the OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems.

1.8 Backing Up Your System Disk

HP recommends that you do a system disk backup before installing any software. Use the backup procedures that are established at your site. For details on performing a system disk backup, see the Using VMS BACKUP manual.