1 Preparing for Digital Fortran Installation

This chapter contains information that should be read, and procedures that should be performed before starting the installation (described in Chapter 2). This chapter contains the following topics:

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.

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

The media CD-ROM user guide and CD-ROM master index file are provided as online files in the [README] directory on the first media CD-ROM in the distribution kit. The index file will show the location of the Digital Fortran cover letter.

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, see step 6 in Section 2.1 if you are using POLYCENTER (PCSI), or step 5 in Section 2.2 if you are using VMSINSTAL.

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 VAX operating system required for this release of Digital Fortran.

After installation, the release notes are installed in:

 SYS$HELP:FORT06n.RELEASE_NOTES

Other forms of the release notes (PostScript and Bookreader) are also provided after installation in the following files:

  SYS$HELP:FORT06n_RELEASE_NOTES.PS
  SYS$HELP:FORT06n_RELEASE_NOTES.DECW$BOOK

1.2 The Tape Media and Installation-Related Documentation Files

Digital Fortran tape media includes the following files:

1.3 Required Operating System Components

Digital Fortran Version 6.4 requires OpenVMS VAX Version 5.4 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 VAX Systems (cover) letter.

The OpenVMS VAX (formerly VAX VMS) operating system comes with a variety of support options, or components. Components include features such as networking. To use Digital Fortran, your system should be running a version of OpenVMS that includes the base component and the following components:

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

1.4 Optional Software

Table 1-1 shows information about optional software that you can use with Digital Fortran. The media CD-ROM and tape contain a complete list of prerequisite and optional software and their required version numbers.

Table 1-1 Optional Software

Product Name and Minimum Version Number  Provided FORTRAN Feature 
Common Data Dictionary (CDD) Version 3.4, CDD/Plus Version 4.0, or CDD/Repository Version 5.0   DICTIONARY statement support 
Digital Extended Math Library (DXML) Version 1.0   High-performance mathematical routines 
Language-Sensitive Editor/Source Code Analyzer (LSE/SCA) Version 3.1[1]   Display of data dependence diagnostics, program design and analysis 
Performance Coverage Analyzer (PCA) Version 3.0[1]   Program performance analysis 

[1] LSE, SCA, and PCA are components of DECset

1.5 License Registration

Before you install and run Digital Fortran 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 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 now 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 need to perform a license load on the other nodes after you complete this installation (see Section 3.2).

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

1.6 Installation Procedure Requirements

The installation takes approximately 5 to 40 minutes, depending on your type of media, your system configuration, and the kit components chosen.

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

1.6.1 System Parameters

Digital Fortran installation requires certain system parameter settings. Table 1-2 lists the minimum values for these parameters:

Table 1-2 Required System Parameter Values

System Parameter  Minimum Value 
Contiguous free GBLPAGES  1,800, plus the size in blocks for the file SYS$LIBRARY:DCLTABLES.EXE (see Section 1.6.1.1
Free GBLSECTIONS 

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 your system has the necessary global pagelet and global section parameters for installation, the DCL tables may become corrupted under certain conditions.

1.6.1.1 Calculating Values for GBLPAGES and GBLSECTIONS

To install and run Digital Fortran, you must have sufficient contiguous free global pagelets and free global sections.

To determine the number of global pagelets required by SYS$LIBRARY:DCLTABLES.EXE, enter the following DCL command:

$ 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 (and add it to the number shown in Table 1-2).

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

Section 1.6.1.2 describes how to increase these values.

1.6.1.2 Changing System Parameter Values with AUTOGEN

If you do not have enough free global pagelets or free global sections to install Digital Fortran, you can do either of the following:

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 includes both 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. For example, the following increases the global pagelet setting by 2000:

ADD_GBLPAGES = 2000

After you make all your changes, exit from the editor. Then execute the AUTOGEN procedure at the DCL prompt to recalculate your system parameters, as follows:

$ @SYS$UPDATE:AUTOGEN SAVPARAMS 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 and its command-line parameters, see the OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems.

1.6.2 POLYCENTER (PCSI) Requirements

The POLYCENTER Software Installation (PCSI) Utility can only be used on systems running OpenVMS VAX Version 6.1 or higher. PCSI has the following advantages:

The compiler, command line, and help text are identical between the PCSI and VMSINSTAL versions of the kit. However, the PCSI kit differs in the following areas:

To install Digital Fortran using PCSI, you must be logged in to an account that has either the SETPRV privilege or the following privileges enabled:

Digital Fortran requires 9,000 blocks of free disk storage both during and after installation. Disk space requirements may vary depending on the size of your system's DCLTABLES.EXE, and which OpenVMS VAX version is running on your system.

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 Digital Fortran using PCSI, see Section 2.1.

1.6.3 VMSINSTAL Requirements

To install Digital Fortran using VMSINSTAL, you must be logged in to an account that has either the SETPRV privilege or the following privileges enabled:

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

Digital Fortran requires 16,000 blocks of free disk storage during installation, and 11,000 blocks after installation. Disk space requirements may vary depending on the size of your system's DCLTABLES.EXE, and which OpenVMS VAX version is running on your system.

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

$ SHOW DEVICE SYS$SYSDEVICE

When you invoke VMSINSTAL, it checks the following:

VMSINSTAL requires that the installation account have a minimum of the following quotas:
ASTLM = 24  DIOLM = 18 
BIOLM = 18  ENQLM = 200 
BYTLM = 32,768  FILLM = 100 

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.

For information on installing Digital Fortran using VMSINSTAL, see Section 2.2.

1.6.4 Digital Fortran Requirements

The VAX Vector Instruction Emulation Facility (VVIEF) is a programming development tool that lets you execute vectorized applications on VAX systems that do not have vector hardware.

Vector instructions in a vectorized application are automatically executed either in vector hardware or by the VVIEF, depending on the vector processing capabilities of the VAX system being used.

For information on how to enable VVIEF on your system, see the OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems; for systems running OpenVMS Version 5, consult the New and Changed Features manual for OpenVMS Version 5.4.

1.7 Creating Coexisting Versions of Digital Fortran

If you install Digital Fortran using VMSINSTAL, you will be offered an option of preserving the previously installed version of Digital Fortran. If this option is selected, the earlier version is renamed to FORTRAN$MAIN-Vnn.EXE, where Vnn is the previous version number with the period removed.

If you install Digital Fortran using POLYCENTER (PCSI), you will not be offered an option of preserving the previous version of the compiler. If you wish to preserve a previous version, make a copy of SYS$SYSTEM:FORTRAN$MAIN.EXE using a new name before installing the new version.

In either case, to use the saved version of the compiler, define the logical name FORTRAN$MAIN to point to the saved version. For example, the following command defines FORTRAN$MAIN to point to the Digital Fortran Version 6.4 compiler:

$ DEFINE FORTRAN$MAIN FORTRAN$MAIN-V64

For more information, see the online release notes.

1.8 Backing Up Your System Disk

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.


Click to return to contents

Copyright © 1996, Digital Equipment Corporation -- All rights reserved.