Compaq Fortran

Compaq Fortran

Installation Guide for
OpenVMS Alpha Systems

Order Number: AA-PU3AF-TE


January 2000

This guide describes how to install Compaq® Fortran (formerly DIGITAL® Fortran) and the Compaq Extended Math Library (CXML) on an Alpha processor system running the OpenVMStm operating system. It also describes how to read the online release notes.

Revision/Update Information: This manual supersedes the Compaq Fortran Installation Guide for OpenVMS Alpha Systems, AA-PU3AE-TE.

Operating System: OpenVMS Alpha Version 7.1 (or higher; see Section 1.1)

Software Version: Compaq Fortran Version 7.3 (or higher)

Compaq Computer Corporation
Houston, Texas


© 1992, 2000 Compaq Computer Corporation

COMPAQ, the Compaq logo, DEC, DIGITAL, POLYCENTER, VAX, VMS, and the Digital logo Registered in U.S. Patent and Trademark Office.

AXP, Bookreader, DEC Fortran, and OpenVMS are trademarks of Compaq Computer Corporation.

PostScript is a registered trademark of Adobe Systems, Incorporated.

All other product names mentioned herein may be trademarks or registered trademarks of their respective companies.

Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is subject to change without notice.

Cover graphic, photographs: Copyright © 1997 PhotoDisc, Inc.

Cover graphic, image: CERN, European Laboratory for Particle Physics: ALICE detector on CERN's future accelerator, the LHC, Large Hadron Collider.

This document is available on CD-ROM.

This document was prepared using VAX DOCUMENT, Version V3.2-1n.

Contents


Preface

This guide explains how to install Compaq Fortran on an Alpha processor system running the OpenVMS operating system. It also describes how to install the Compaq Extended Math Library (CXML, formerly the DIGITAL Extended Math Library, DXML). In addition, it describes how to read the online release notes.

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

This manual applies to Version 7.3 of Compaq Fortran and all subsequent releases until a revised installation guide is issued.

Intended Audience

This guide is intended for system managers who install Compaq Fortran.

Structure of This Document

This guide contains the following chapters:

Associated Documentation

In addition to this guide, the Compaq Fortran documentation set includes the following:

For the location of the Compaq Fortran "read first" cover letter and the release notes, see Section 1.1.

Once installed, you can use Compaq Fortran online HELP, which describes the command qualifiers, explains run-time messages, and provides a quick-reference summary of language topics. To use online HELP, type HELP followed by the command name as in the following example:


$ HELP FORTRAN

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

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

Sending Compaq Your Comments on This Manual

We welcome your comments on this or any other Compaq Fortran manual. You can send comments in the following ways:

If you have suggestions for improving a particular section or find any errors, please indicate the title, order number, and section (if available). Compaq also welcomes general comments.

Getting Help from Compaq

If you have a customer support contract and have comments or questions about Compaq Fortran software, you can contact the Compaq Customer Support Center (CSC), preferably using electronic means such as DSNlink. In the United States, customers can call the CSC at 1-800-354-9000 (see Section 3.10).

You can also send comments, questions, and suggestions for product improvements by Internet electronic mail to:

Please note, however, that these addresses are for informational inquiries only. They are not formal support channels.

World Wide Web Pages

If you have Internet access and a World Wide Web (WWW) browser, you are invited to view the Compaq Fortran home page, located at the following URL:


http://www.compaq.com/fortran/ 

This Web site contains information about software patch kits, example programs, and additional product information.

There is also a Web site for CXML:


http://www.compaq.com/math/ 

Conventions

Table 1 lists the conventions used in this document.

Table 1 Conventions Used in This Document
Convention Meaning
UPPERCASE_TEXT Uppercase letters indicate the name of a command, a file, a parameter, a procedure, or a utility.
$ SHOW DEFAULT In interactive examples, prompts or displayed text appears in a monospaced font. User input appears in bold.
$ The dollar sign indicates the DCL prompt. This prompt may be different on your system.
Ctrl/x In interactive examples, 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; for example, Ctrl/C or Ctrl/Z.
[Return] In code examples, a key name is shown enclosed to indicate that you press a key on a keyboard.
[YES] Square brackets indicate that the enclosed item is a default value in an installation prompt. Also, square brackets serve as delimiters for a directory name in a file specification.
OpenVMS,
OpenVMS Alpha,
(VMS)
References to OpenVMS (formerly VMS®), and OpenVMS Alpha refer to the OpenVMS Alpha operating system.
Compaq Fortran
(DIGITAL Fortran 90)
References to Compaq Fortran (formerly DIGITAL Fortran 90) refer to the Compaq Fortran compiler, which fully supports the Fortran 90 and Fortran 95 standards (as well as Compaq Fortran extensions).
Compaq Fortran 77
(DIGITAL Fortran 77)
(DEC Fortran)
The term Compaq Fortran 77 (formerly DEC Fortran and DIGITAL Fortran 77) refers to the Compaq Fortran 77 compiler, which supports the FORTRAN-77 standard (as well as Compaq Fortran 77 extensions).

In this manual, some version numbers are given as "Vn.n". When you install Compaq Fortran, the actual version numbers appear on your screen.


Chapter 1
Preparing for Compaq Fortran Installation

For this release of Compaq Fortran, Compaq provides two separate compilers (Compaq Fortran and Compaq Fortran 77) under one license and one name (Compaq Fortran). You can choose to install and/or use either compiler or both compilers.

By default, the FORTRAN command invokes the Compaq Fortran compiler, which supports the Fortran 90 and 95 standards as well as older versions of the Fortran language. If you choose to also install the older Compaq Fortran 77 compiler, programmers can request the Compaq Fortran 77 compiler by using the /OLD_F77 qualifier on the FORTRAN command line.

You can install the Compaq Extended Math Library (CXML) separately from Compaq Fortran, which allows you to call the CXML routines from either Compaq Fortran or Compaq Fortran 77.

You can install CXML either before or after you install Compaq Fortran. When installing Compaq Fortran, you must install the Compaq Fortran Run-Time Library (RTL) before Compaq Fortran (see Chapter 2).

Before starting the installation procedure in Chapter 2, you should complete the preparations explained in this chapter. This chapter includes the following sections:

1.1 The Software Product Library CD-ROM and Installation-Related Documentation Files

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

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

Compaq Fortran provides online release notes and an online "read first" cover letter:

For information about using the CDMENU utility and locating the appropriate media CD-ROM and directory that contains the Compaq Fortran cover letter, see the first few steps in Chapter 2.

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

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

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

After Compaq Fortran installation, the release notes are installed in:


  SYS$HELP:FORTRAN.RELEASE_NOTES 

The release notes are also provided in PostScript form after installation in the following file:


  SYS$HELP:FORTRAN_RELEASE_NOTES.PS 

Release notes for CXML are provided separately. After installing CXML, the CXML release notes are installed in:


   SYS$HELP:CXML-*NOTES.TXT 

The CXML release notes and the CXML Reference Guide are also provided in PostScript form in the SYS$HELP directory.

1.2 Required Operating System Components

Compaq Fortran Version 7.3 requires the OpenVMS Alpha operating system Version 7.1 or higher.

Future Compaq Fortran releases may require higher versions of the operating system, as described in the online release notes or the Read Before Installing or Using Compaq Fortran Version n.n for OpenVMS Alpha Systems (cover) letter.

The OpenVMS Alpha operating system comes with a variety of support options (or components). To use Compaq Fortran, your system should be running a version of the OpenVMS Alpha operating system that includes the base component and the following other components:

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

1.3 License Registration

Before you install and run Compaq Fortran Version 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). CXML does not require a License PAK. The specific LMF product names used by Compaq Fortran are listed in Table 1-1:

Table 1-1 LMF Product Names Used by Compaq Fortran
LMF Product Name Use
FORTRAN
FORTRAN90
Unlimited or Personal-Use License
FORTRAN-USER
FORTRAN90-USER
Concurrent-Use License

The Compaq Fortran and Compaq Fortran 77 compilers will each accept either a FORTRAN(-USER) or FORTRAN90(-USER) PAK. It is not required that PAKs for both product names of a given license type be loaded.

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 Fortran 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 Fortran, review the PAK status and install the PAKs for any prerequisite or optional software before you install Compaq Fortran.

You must register and load your license for Compaq Fortran before you start the installation in order to run the Installation Verification Procedure (IVP) and use the software.

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:

If you plan to use Compaq Fortran 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 OpenVMS License Management Utility Manual.

1.4 Installation Procedure Requirements

After you have registered and loaded the license PAK and have previously read the appropriate parts of this installation guide, the installation takes approximately 2 to 5 minutes, depending on your system configuration.

1.4.1 Installation Account Privileges and Disk Space

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

Table 1-2 lists Compaq Fortran's requirements for free disk storage space.

Table 1-2 Disk Space Requirements
Kit Component During Installation After Installation
Compaq Fortran Compiler 25,000 blocks 25,000 blocks
Compaq Fortran 77 Compiler 12,000 blocks 12,000 blocks
Compaq Fortran Run-Time Library 10,000 blocks 200 blocks
Compaq Fortran Complete kit 47,000 blocks 37,200 blocks
     
Compaq Extended Math Library (optional) 150,000 blocks 150,000 blocks

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


$ SHOW DEVICE SYS$SYSDEVICE

For information on installing 64-bit tools support, see Section 2.3.

1.4.2 System Parameters

Installing Compaq Fortran (both compilers) requires certain system parameter settings.

The minimum number of free global pagelets (512-byte subpage unit) and global sections needed is eleven (11) global sections and approximately 20,000 contiguous free global pagelets, plus a sufficient number of contiguous free global pagelets to contain the file SYS$LIBRARY:DCLTABLES.EXE (see Section 1.4.2.1).

If the optional Compaq Extended Math Library is installed, an additional 18 global sections and 50,000 contiguous free global pagelets are required.

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

If you do not ensure that your system has the necessary global pagelets and global section SYSGEN parameters for the installation, the DCL tables can become corrupted in some situations.

1.4.2.1 Calculating Values for GBLPAGES and GBLSECTIONS

To install and run Compaq Fortran, 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:


$ DIRECTORY/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.4.2), you must increase the system parameter setting.

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

1.4.2.2 Changing System Parameter Values with AUTOGEN

If you do not have enough free global pagelets or free global sections to install Compaq Fortran, you can 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

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. To modify incremental parameters such as GBLPAGES and GBLSECTIONS, use the ADD_ prefix.

After you make all your changes, exit from the editor.

When you execute the AUTOGEN procedure to recalculate your system parameters, AUTOGEN uses the information in your MODPARAMS.DAT file and also can automatically adjust some of the SYSGEN parameters based on the consumption of resources since the last reboot.

For information about using AUTOGEN and its command-line parameters, see the OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems.

1.5 Backing Up Your System Disk

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

1.6 Recovering from Installation Errors

Errors can occur during the installation if any of the following conditions exist:

For descriptions of error messages generated by these and related conditions, see the OpenVMS Alpha documentation on system messages and software installation or the online HELP/MESSAGE command. Take the appropriate action described in the message.

For information on system requirements for installing Compaq Fortran, see Section 1.2.

For a list of problems that can cause an unsuccessful installation, see Section 3.9.

To report a problem to Compaq, see Section 3.10.


Next Contents