For this release of DIGITAL Fortran, DIGITAL is providing two separate compilers (DIGITAL Fortran 77 and DIGITAL Fortran 90) under one license and one name (DIGITAL Fortran). You can choose to install and/or use either compiler or both compilers.
Before starting the installation procedure in Chapter 2, you should complete the preparations explained in this chapter. This chapter includes the following sections:
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.
DIGITAL 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 DIGITAL Fortran cover letter, see the first few steps in Chapter 2.
Once the appropriate media CD-ROM has been mounted and the appropriate DIGITAL 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 Chapter 2 (step 7).
DIGITAL strongly recommends that you read the release notes and the cover letter before installing DIGITAL Fortran. They contain information about changes to the installation and use of DIGITAL Fortran, such as the minimum version of the OpenVMS Alpha operating system required for this release of DIGITAL Fortran.
After installation, the release notes are installed in:
SYS$HELP:FORTRAN.RELEASE_NOTES
Other forms of the release notes (PostScript and Bookreader) are also provided after installation in the following files:
SYS$HELP:FORTRAN_RELEASE_NOTES.PS SYS$HELP:FORTRAN_RELEASE_NOTES.DECW$BOOK
DIGITAL Fortran Version 7.0 requires the OpenVMS Alpha (formerly OpenVMS AXP) operating system Version 6.1 or higher.
Future DIGITAL Fortran releases may require higher versions of the operating system, as described in the online release notes or the Read Before Installing or Using DIGITAL 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 DIGITAL 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 DIGITAL Fortran Software Product Description (SPD) on the media CD-ROM.
Before you install and run DIGITAL Fortran Version 7.0 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 names used by DIGITAL Fortran are listed in Table 1-1:
| LMF Product Name | Use |
|---|---|
| FORTRAN FORTRAN90 | Unlimited or Personal-Use License |
| FORTRAN-USER FORTRAN90-USER | Concurrent-Use License |
The DIGITAL Fortran 77 and DIGITAL Fortran 90 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 DIGITAL 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 DIGITAL Fortran, review the PAK status and install the PAKs for any prerequisite or optional software before you install DIGITAL Fortran.
You must register and load your license for DIGITAL 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 DIGITAL 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.
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.
To install DIGITAL Fortran, you must be logged in to an account that has at least the following privileges enabled:
Table 1-2 lists DIGITAL Fortran's requirements for free disk storage space.
| Kit Component | During Installation | After Installation |
|---|---|---|
| DIGITAL Fortran 77 Compiler | 9,800 blocks | 9,800 blocks |
| DIGITAL Fortran 90 Compiler | 16,000 blocks | 16,000 blocks |
| Common components | 5,500 blocks | 5,500 blocks |
| DIGITAL Fortran Run-Time Library | 4,600 blocks | 4,600 blocks |
| DIGITAL Fortran Complete kit | 35,900 blocks | 35,900 blocks |
To determine the number of free disk blocks on the current system disk, enter the following DCL command:
$ SHOW DEVICE SYS$SYSDEVICE
Installing DIGITAL Fortran (both compilers) requires certain system parameter settings.
The minimum number of free global pagelets (512-byte subpage unit) and global sections needed is six (6) global sections and approximately 16,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).
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.
To install and run DIGITAL 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.
If you do not have enough free global pagelets or free global sections to install DIGITAL 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.
DIGITAL 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.
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 DIGITAL 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 DIGITAL, see Section 3.10.