Digital_Fortran_____________________________________ Installation Guide for OpenVMS Alpha Systems Order Number: AA-PU3AD-TE April 1996 (Online version revised January 1997) This guide describes how to install Digital Fortran on an Alpha processor system running the OpenVMS operating system. It also describes how to read the online release notes. Note: This online installation guide was revised for Version 7.1 to provide the correct disk space requirements in Section 1.4 and the correct PRODUCT INSTALL commands in Chapter 2. These corrections will made to the printed version the next time it is revised. Revision/Update Information: This manual supersedes all previous DEC Fortran and DEC Fortran 90 installation guides for OpenVMS Alpha systems. Operating System: OpenVMS Alpha Version 6.1 (or higher; see Section 1.1) Software Version: Digital Fortran Version 7.0 (or higher) Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ First Printing, October 1992 Revised, May 1993 Revised, April 1995 Revised, April 1996 Revised (online version only), January 1997 Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. © Digital Equipment Corporation 1996. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: AlphaGeneration, AXP, Bookreader, DEC, DEC Fortran, DECnet, DECsupport, DECwindows, Digital, OpenVMS, POLYCENTER, VAX, VAX DOCUMENT, VMS, and the DIGITAL logo. The following is a third-party trademark: PostScript is a registered trademark of Adobe Systems, Inc. ZK6444 This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. _______________________________________________________________ Contents ................................................... v Preparing for Digital Fortran Installation 1.1 The Software Product Library CD-ROM and Installation-Related Documentation Files...... 1-1 1.2 Required Operating System Components.......... 1-3 1.3 License Registration.......................... 1-3 1.4 Installation Procedure Requirements........... 1-5 1.4.1 Installation Account Privileges and Disk Space..................................... 1-5 1.4.2 System Parameters......................... 1-6 1.4.2.1 Calculating Values for GBLPAGES and GBLSECTIONS............................. 1-6 1.4.2.2 Changing System Parameter Values with AUTOGEN................................. 1-7 1.5 Backing Up Your System Disk................... 1-8 1.6 Recovering from Installation Errors........... 1-8 Installing Digital Fortran After Installing Digital Fortran 3.1 Running the Installation Verification Procedure Separately.......................... 3-1 3.2 Modifying the System-Wide Startup Command Procedure..................................... 3-2 3.3 VMScluster Considerations..................... 3-2 3.4 Making the FORTRAN and F90 Commands Available After Installation............................ 3-3 3.5 User Account Requirements..................... 3-4 3.6 Enhancing Digital Fortran Performance......... 3-4 iii 3.7 OpenVMS Upgrade Issues........................ 3-5 3.8 Removing Digital Fortran...................... 3-6 3.9 Troubleshooting Tips.......................... 3-6 3.10 Getting Help and Reporting Problems........... 3-7 Tables 1 Conventions Used in This Document......... viii 1-1 LMF Product Names Used by Digital Fortran................................... 1-4 1-2 Disk Space Requirements................... 1-5 iv _________________________________________________________________ Preface This guide explains how to install Digital Fortran on an Alpha processor system running the OpenVMS operating system. It also 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 Digital Fortran for any other reason. This manual applies to Version 7.0 of Digital Fortran and all subsequent releases until a revised installation guide is issued. Intended Audience This guide is intended for system managers who install Digital Fortran. Structure of This Document This guide contains the following chapters: o Chapter 1 describes the hardware and software requirements for Digital Fortran installation. It also lists related procedures that you must complete before installing Digital Fortran. o Chapter 2 describes how to install Digital Fortran, including an example installation. o Chapter 3 describes post-installation considerations. v Associated Documentation In addition to this guide, the Digital Fortran documentation set includes the following: o A language reference manual, either the DEC Fortran 90 Language Reference Manual (for the Digital Fortran 90 language) or the DEC Fortran Language Reference Manual (for the Digital Fortran 77 language). o A user manual, either the DEC Fortran 90 User Manual for OpenVMS Alpha Systems or the DEC Fortran User Manual for OpenVMS AXP Systems o A letter titled Read Before Installing or Using Digital Fortran Version n.n for OpenVMS Alpha Systems ("read first" cover letter) o Digital Fortran online release notes For the location of the Digital Fortran "read first" cover letter and the release notes, see Section 1.1. Once installed, you can use Digital 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 examples: $ HELP FORTRAN $ HELP F90 The following manuals in the OpenVMS Alpha documentation set contain information relevant to installing software: o POLYCENTER Software Installation Utility User's Guide o OpenVMS License Management Utility Manual o OpenVMS System Manager's Manual, which includes: - OpenVMS System Manager's Manual: Essentials - OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems o 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. vi Sending Digital Your Comments on This Manual We welcome your comments on this or any other DEC Fortran 90 manual. You can send comments in the following ways: o Internet electronic mail: fortran_docs@zko.mts.dec.com o FAX: 603-881-0120 Attn: Languages Documentation, ZKO2-3 /K35 o A letter addressed to: Digital Equipment Corporation Languages Documentation, ZK02-3/K35 110 Spit Brook Road Nashua, NH 03062-2698 USA If you have suggestions for improving a particular section or find any errors, please indicate the title, order number, and section (if available). Digital also welcomes general comments. Getting Help from Digital If you have a customer support contract and have comments or questions about Digital Fortran software, you can contact Digital's 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 fortran@digital.com. Conventions Table 1 lists the conventions used in this document. vii 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. 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, References to OpenVMS, OpenVMS AXP, OpenVMS Alpha, or OpenVMS Alpha refer to the OpenVMS OpenVMS AXP Alpha operating system. (continued on next page) viii Table_1_(Cont.)_Conventions_Used_in_This_Document__________ Convention__________Meaning________________________________ DEC Fortran References to DEC Fortran and Digital DEC Fortran 90 Fortran 77 refer to the Digital Fortran Digital Fortran 77 77 compiler. References to DEC Fortran Digital Fortran 90 90 and Digital Fortran 90 refer to Digital Fortran the Digital Fortran 90 compiler. References to Digital Fortran refer to the merged Digital Fortran product. For more information, see the Read Before Installing or Using Digital Fortran ____________________Version_n.n_for_OpenVMS_Alpha_Systems._ In this manual, some version numbers are given as "Vn.n". When you install Digital Fortran, the actual version numbers appear on your screen. ix 1 _________________________________________________________________ Preparing for Digital Fortran Installation 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: o Reading the online release notes and "read first" letter (Section 1.1) o Required operating system components (Section 1.2) o License registration (Section 1.3) o Installation procedure requirements, including disk space requirements (Section 1.4) o Backing up your system disk (Section 1.5) o Recovering from installation errors (Section 1.6) 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: o Digital Fortran installation kit files o Digital Fortran documentation files, including a "read first" cover letter, this installation guide, and other files o 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 Preparing for Digital Fortran Installation 1-1 o A CDMENU utility 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: o You can read the online "read first" cover letter provided on the media CD-ROM set or read the printed hardcopy letter. o You can extract the Digital Fortran release notes to a file and type or print them before starting Digital Fortran installation. The Digital Fortran release notes are also installed on your system after installation. 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: o Use a TYPE command to display the ASCII version of the Digital Fortran cover letter (on your screen). o Use a PRINT command to print the ASCII or PostScript version of the Digital Fortran cover letter to a printer. 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 1-2 Preparing for Digital Fortran Installation 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 1.2 Required Operating System Components 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: o Programming support o Utilities For a complete list of the required components, see Digital Fortran Software Product Description (SPD) on the media CD-ROM. 1.3 License Registration 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: Preparing for Digital Fortran Installation 1-3 Table_1-1_LMF_Product_Names_Used_by_Digital_Fortran________ LMF_Product_Name____Use____________________________________ FORTRAN Unlimited or Personal-Use License FORTRAN90 FORTRAN-USER Concurrent-Use License FORTRAN90-USER_____________________________________________ 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: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your License PAK. o At the DCL prompt, enter the LICENSE REGISTER command with the appropriate qualifiers that correspond to License PAK information. 1-4 Preparing for Digital Fortran Installation 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. 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 Digital Fortran, you must be logged in to an account that has at least the following privileges enabled: o CMKRNL o SYSLCK o SYSPRV Table 1-2 lists Digital Fortran's requirements for free disk storage space. Table_1-2_Disk_Space_Requirements__________________________ During After Kit_Component_____________Installation____Installation_____ Digital Fortran 77 9,800 blocks 9,800 blocks Compiler Digital Fortran 90 16,000 blocks 16,000 blocks Compiler Common components 5,500 blocks 5,500 blocks Digital Fortran Run-Time _4,600_blocks _4,600_blocks Library Digital Fortran Complete 35,900 blocks 35,900 blocks kit________________________________________________________ To determine the number of free disk blocks on the current system disk, enter the following DCL command: Preparing for Digital Fortran Installation 1-5 $ SHOW DEVICE SYS$SYSDEVICE 1.4.2 System Parameters 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. ________________________ 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 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): 1-6 Preparing for Digital Fortran Installation $ 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 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. Preparing for Digital Fortran Installation 1-7 1.5 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. 1.6 Recovering from Installation Errors Errors can occur during the installation if any of the following conditions exist: o The operating system version is incorrect. o The privileges or disk space for successful installation are insufficient. 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. 1-8 Preparing for Digital Fortran Installation 2 _________________________________________________________________ Installing Digital Fortran This chapter describes: o How to read the online release notes before installation. o How to install Digital Fortran using POLYCENTER Software Installation (PCSI) software. PCSI software is bundled with the OpenVMS operating system. Before you start the installation, read Chapter 1, which describes the general options and requirements for installing Digital Fortran. The installation procedure loads Digital Fortran product distribution files on to the system disk on the system where you perform the installation. ________________________ Note ________________________ You must first install the Digital Fortran Run-Time Library (RTL) before you install the Digital Fortran compiler. ______________________________________________________ Follow these steps to install Digital Fortran from the OpenVMS Alpha Software Products Library CD-ROM set: 1. Log in to a privileged account on the system (or cluster) where you will install Digital Fortran. This account must have the following privileges enabled: o CMKRNL o SYSLCK o SYSPRV Installing Digital Fortran 2-1 Do not proceed with the installation unless your account has the CMKRNL, SYSLCK, and SYSPRV privileges enabled. If your process has the SETPRV privilege, you can enable the CMKRNL, SYSLCK, and SYSPRV privileges by typing the following command: $ SET PROCESS/PRIVILEGE=(CMKRNL,SYSLCK,SYSPRV) To check whether your process has these privileges enabled, type the following command: $ SHOW PROCESS/PRIVILEGES 2. To obtain the kit directory location of the Digital Fortran product distribution files on the appropriate OpenVMS Alpha Software Product Library CD-ROM (media CD-ROM), do one of the following: o Use the CDMENU utility provided on the media CD-ROM. o View the CD-ROM master index file on the media CD-ROM. o Contact the appropriate system manager. For information about using the CDMENU utility and the CD-ROM files on the media CD-ROM set, see the Software Product Library CD-ROM User's Guide (media CD-ROM user guide), which accompanies the media CD-ROM distribution kit. 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. 3. To determine whether the appropriate media CD-ROM is already mounted on your system, type the following command: $ SHOW DEVICE DKA400 ________________________ Note ________________________ DKA400 is the device name used in examples in this document to show where the appropriate media CD-ROM has been mounted. ______________________________________________________ 2-2 Installing Digital Fortran 4. If the media CD-ROM containing the Digital Fortran installation files is not mounted, either contact the appropriate system manager or insert the appropriate media CD-ROM (write down the volume label) into an available CD-ROM drive. Type the appropriate MOUNT command to mount the media CD-ROM (omit the /FOREIGN qualifier), such as the following: $ MOUNT DKA400 label Where label is the volume label of that media CD-ROM. 5. To check that you have located the correct CD-ROM device and directory, use the following DIRECTORY command: $ DIRECTORY Directory DKA400:[dir.subdir] DEC-AXPVMS-FORRTL-Vnnnn-x-1.PCSI DEC-AXPVMS-FORTRAN-Vnnnn-x-1.PCSI Total of 2 files. 6. To extract the Digital Fortran online release notes before you install Digital Fortran, type the following command: $ PRODUCT EXTRACT RELEASE_NOTES FORTRAN /SOURCE=disk:[dir] - $_/FILE=FORTRAN.RELNOTES In this command, disk:[dir] is the specification of the disk and directory containing the product installation files. You can view or print the file FORTRAN.RELNOTES before you continue with the installation (next command). For example: $ TYPE/PAGE FORTRAN.RELNOTES 7. In addition to the Digital Fortran compiler (development) kit, Digital Fortran also provides a separate Run-Time Library kit. If you are running a version of OpenVMS Alpha earlier than Version 7.0, you must install the Digital Fortran Run-Time Library kit before you install the Digital Fortran compiler kit. If you are running OpenVMS Alpha Version 7.0 or later, installing the Run-Time Library kit is optional, but recommended, as it contains Installing Digital Fortran 2-3 corrections and enhancements not included in OpenVMS Alpha Version 7.0. The Digital Fortran Run-Time Library kit contains a shared Digital Fortran 77 and Digital Fortran 90 Run- Time Library (Fortran RTL) needed to execute (RUN) Fortran programs.. The Fortran RTL kit provided with Digital Fortran compiler media contains changes needed to run Fortran 90 programs that are not included in the Fortran RTL version supplied with the OpenVMS Alpha operating system Version 6.1 or Version 6.2. The Fortran RTL kit includes the shareable image DEC$FORRTL.EXE, which is compatible with DEC Fortran for OpenVMS Alpha Version 6.1 (or earlier releases). This compatibility allows you to copy Fortran executable images from other OpenVMS systems and run them on systems where the DEC$FORRTL.EXE from the Digital Fortran kit is installed. To run Fortran 90 images on other OpenVMS Alpha systems earlier than Version 7.0 or Fortran 77 images on other OpenVMS Alpha systems earlier than Version 6.2, you must install the Fortran RTL kit on those OpenVMS Alpha systems. This Fortran RTL kit can be installed on other licensed OpenVMS systems-see the Digital Fortran Software Product Description (SPD) for details. OpenVMS Alpha Version 7.0 and later includes RTL components which are sufficient to run both Fortran 77 and Fortran 90 applications. The RTL kit provided with Digital Fortran will not replace components provided by OpenVMS Alpha if the existing components are newer. To install the Digital Fortran Run-Time Library, type the following PRODUCT INSTALL command: $ PRODUCT INSTALL FORRTL /SOURCE=disk:[dir] /HELP Where disk:[dir] is the specification of the disk and directory containing the product installation files. The following text appears for a Run-Time Library installation: 2-4 Installing Digital Fortran If the installation fails, repeat the PRODUCT INSTALL command(s) adding the qualifiers /LOG/TRACE to the command line. The additional output will help Digital support analyze the problem. The following product has been selected: DEC AXPVMS FORRTL V7.0-n Do you want to continue? [YES] *** DEC AXPVMS FORRTL V7.0-n Copyright © Digital Equipment Corporation 1995,1996 - All rights reserved. This software is produced by Digital Equipment Corporation This software is licensed under the OpenVMS product license Do you want all the default values for this product? [YES] Do you want to view the values? [NO] %PCSIUI-I-DONEASK, execution phase starting The following product will be installed: DEC AXPVMS FORRTL V7.0-n %PCSI-I-VOLINFO, estimated space information for volume DISK$vvvvvvvv -PCSI-I-VOLSPC, nnnn required; nnnnnn available; nnnnnn net Portion Done: 0%...20%...70%...90%...100% The following product has been installed: DEC AXPVMS FORRTL V7.0-n *** DEC AXPVMS FORRTL V7.0-n Release notes are in SYS$HELP:FORRTL.RELEASE_NOTES Do INSTALL REPLACE SYS$LIBRARY:DEC$FORRTL.EXE on all other cluster nodes $ 8. Installation of the Run-Time Library kit takes about one minute (depending on your system). When installation has been completed, the DCL $ prompt reappears. 9. If DEC Fortran 90 was previously installed on this system, it must be removed before Digital Fortran is installed. To determine if DEC Fortran 90 is present, type the following command: $ PRODUCT SHOW PRODUCT FORTRAN90 Installing Digital Fortran 2-5 If DEC Fortran 90 is present, the following text appears: PRODUCT ------- DEC AXPVMS FORTRAN90 V2.0-1 1 item found If DEC Fortran 90 is not present, the following text appears: PRODUCT ------- 0 items found If DEC Fortran 90 is present, remove it by typing the following PRODUCT REMOVE command: $ PRODUCT REMOVE FORTRAN90 The following text appears: The following product has been selected: DEC AXPVMS FORTRAN90 Vn.n-n %PCSI-E-CONREMUNR, optionally remove product DEC AXPVMS FORRTL Vn.n-n that is no longer required by another product Do you want to take this action? [NO] Do you want to continue? [YES] The following product will be removed: DEC AXPVMS FORTRAN90 Vn.n-n %PCSI-I-VOLINFO, estimated space information for volume DISK$vvvvvvvv -PCSI-I-VOLSPC, -nnnnn required; nnnnnnn available; nnnnnnn net Portion done: 0%...50%...60%...70%...80%...100% The following product has been removed: DEC AXPVMS FORTRAN90 Vn.n-n 10.To install the Digital Fortran compilers, type the following PRODUCT INSTALL command: $ PRODUCT INSTALL FORTRAN /SOURCE=disk:[dir] /HELP Where disk:[dir] is the specification of the disk and directory containing the product installation files. 2-6 Installing Digital Fortran The following text appears: If the installation fails, repeat the PRODUCT INSTALL command(s) adding the qualifiers /LOG/TRACE to the command line. The additional output will help Digital support analyze the problem. The following product has been selected: DEC AXPVMS FORTRAN Vn.n-n Do you want to continue? [YES] *** DEC AXPVMS FORTRAN Vn.n-n: Digital Fortran for OpenVMS Alpha Systems Copyright © Digital Equipment Corporation 1992,1996 - All rights reserved. This software product is sold by Digital Equipment Corporation PAKs used: FORTRAN, FORTRAN90, FORTRAN-USER or FORTRAN90-USER Do you want all the default values for this product? [YES] If you want both the Fortran 77 and Fortran 90 compilers installed, or wish to use the same selection as a previous installation, type YES at this prompt and skip to the Do you want to view the values? prompt. If you wish to select which of the compilers to install, type NO. The following text will be displayed: *** DEC AXPVMS VMS Vn.n [Available] %PCSIUI-I-ALRDYINST, product already installed; use RECONFIGURE to modify Digital Fortran 77 compiler [YES] If you wish to install the Digital Fortran 77 compiler, type YES, otherwise type NO. Installation continues with the following text displayed: Digital Fortran 90 compiler [YES] If you wish to install the Digital Fortran 90 compiler, type YES, otherwise type NO. Installation continues with the following text displayed: Installing Digital Fortran 2-7 Do you want to view the values? [NO] Execution phase starting ... The following product will be installed: DEC AXPVMS FORTRAN Vn.n-n %PCSI-I-VOLINFO, estimated space information for volume DISK$vvvvvv -PCSI-I-VOLSPC, nnnnn required; nnnnnnn available; nnnnnnn net Portion done: 0%...20%...60%...70%...80%...90%...100% The following product has been installed: DEC AXPVMS FORTRAN Vn.n-n %PCSI-I-EXETSTSTART, start of test procedure %PCSI-I-EXETSTOK, end of test procedure; completed with no errors *** DEC AXPVMS FORTRAN Vn.n-n: Digital Fortran for OpenVMS Alpha Systems Execute SYS$STARTUP:FORT$STARTUP.COM on all other VMScluster nodes Type HELP FORTRAN Release_notes for release notes location Insert the following lines in SYS$MANAGER:SYSTARTUP_VMS.COM: @SYS$STARTUP:FORT$STARTUP $ 11.Installation takes about 2-5 minutes (depending on your system). When installation has been completed, the DCL $ prompt reappears. 12.To obtain a list of files installed, type the following command: $ PRODUCT SHOW OBJECT /PRODUCT=(FORTRAN, FORRTL) To use other features of the PCSI utility, see the POLYCENTER Software Installation Utility User's Guide. 2-8 Installing Digital Fortran 3 _________________________________________________________________ After Installing Digital Fortran The following tasks can be performed after Digital Fortran is installed: o Running the Installation Verification Procedure (IVP) separately o Making the recently installed F90 and FORTRAN commands available to users after installation o Modifying the system-wide startup command procedure o Making the product usable on a VMScluster o Setting user account quotas o Enhancing performance o Getting help and reporting problems 3.1 Running the Installation Verification Procedure Separately The Digital Fortran Installation Verification Procedure (IVP) runs automatically during Digital Fortran installation. If system problems occur, you should run the IVP separately to ensure the integrity of the installed files. To run the IVP, type the following command: $ @SYS$TEST:FORT$IVP.COM If any problems are encountered, a message such as the following appears: Digital Fortran Version 7.n TEST FAILED After Installing Digital Fortran 3-1 3.2 Modifying the System-Wide Startup Command Procedure Add the following line to the system-wide startup file, such as the file SYS$MANAGER:SYSTARTUP_VMS.COM or a command procedure that it invokes: $ @SYS$STARTUP:FORT$STARTUP This command procedure installs Digital Fortran images in memory and performs related actions. 3.3 VMScluster Considerations If you want to run Digital Fortran on multiple nodes of a VMScluster, first check to see that you have the appropriate software license (see Section 1.3). Then perform the following steps after you install Digital Fortran: 1. Issue the LICENSE LOAD command, as described in the OpenVMS License Management Utility Manual, to activate the license on each node in the VMScluster on which Digital Fortran is to be executed. 2. The commands in this step should be executed on all cluster nodes, whether or not they are licensed to use Digital Fortran; failure to do so may cause unexpected errors for users. ________________________ Note ________________________ If you are using a dual-architecture (VAX and Alpha systems) heterogeneous cluster, before executing these commands, make sure the appropriate logical names have been set to define the scope of the SYSMAN DO commands. For more information, see the OpenVMS System Manager's Manual. ______________________________________________________ While logged in as SYSTEM, or as another username that has the CMKRNL and SYSPRV privileges enabled, use the OpenVMS SYSMAN utility to make the new versions of DCLTABLES.EXE and DEC$FORRTL.EXE available, as follows: 3-2 After Installing Digital Fortran $ RUN SYS$SYSTEM:SYSMAN SYSMAN> SET ENVIRONMENT/CLUSTER %SYSMAN-I-ENV, current command environment: Clusterwide on local cluster Username SYSTEM will be used on nonlocal nodes SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DEC$FORRTL.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 The SYSMAN utility will cause each DO command to be executed on all nodes of the local cluster. 3. The SYS$STARTUP:FORT$STARTUP.COM file installs the compilers as a known image. This command procedure file should be executed on all cluster nodes using the following DO command: SYSMAN> DO @SYS$STARTUP:FORT$STARTUP %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 4. Finally, exit from SYSMAN. SYSMAN> EXIT $ 3.4 Making the FORTRAN and F90 Commands Available After Installation Digital Fortran is now installed and can be invoked by all users with the FORTRAN and F90 commands. The installation procedure modifies the DCL command table so that the FORTRAN and F90 commands are recognized and processed. However, the previous command table is still in effect for those users who are currently logged in. All logged-in users who want to use the FORTRAN or F90 commands must log out and log in again, or use the following DCL command: $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES After Installing Digital Fortran 3-3 3.5 User Account Requirements No special privileges are needed to use Digital Fortran. There is no benefit from installing the compilers with privileges. To use Digital Fortran, a user account does not need to meet any special quota requirements. However, for users who will be compiling very large programs (many program units compiled together) or running very large performance- critical programs, consider the adjusting working set (WSDEF, WSQUOTA, WSEXTENT) and page file (PGFLQUOTA) account quotas to improve performance. Use the OpenVMS Authorize Utility from a suitably privileged account to change the process quotas in the user authorization file (UAF). Some sites may restrict the use of the Authorize Utility to certain accounts or people. After the quotas for the account have been changed, the user should log out of the account and log in again for the new quotas to take effect. For information on using the Authorize Utility, see the OpenVMS System Manager's Manual: Essentials. 3.6 Enhancing Digital Fortran Performance This section includes information on system tuning and explains how to install Digital Fortran as a shared image. After you install Digital Fortran, you might want to adjust your system to enhance performance or lower the use of some system resources. If users will be compiling very large programs (many program units compiled together) or running very large performance-critical programs, consider the following: o Check that adequate page file space exists. Large programs need more virtual memory during compilation and execution than small programs. Use the INSTALL command to extend an existing page file or create one or more new page files. 3-4 After Installing Digital Fortran o The SYSGEN parameter virtual page count is related to the total amount of page file space. If you create more page file space, review the virtual page count parameter and increase it if necessary. o The SYSGEN parameter maximum working set (WSMAX) might also be checked if a larger process working set is needed. For more information on page file use and SYSGEN parameters, see the OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems. For information about system tuning and performance investigation, see the Guide to OpenVMS Performance Management. 3.7 OpenVMS Upgrade Issues You should always use the most recent version of the Digital Fortran Run-Time Library available. When you preparing for an upgrade of the OpenVMS operating system, be aware that the Digital Fortran Run-Time Library ships with the OpenVMS operating system. This means that an OpenVMS upgrade can install an older version of the Digital Fortran Run-Time Library, which is shared by DEC Fortran and Digital Fortran. The Run-Time Library provided with Digital Fortran Version 7.0 contains changes that are not included in the version provided with OpenVMS Alpha Version 7.0 and earlier; these changes will be included in a future version after OpenVMS Alpha Version 7.0. In the future, if you install a version of OpenVMS that does not include the updated Fortran Run-Time Library support, the OpenVMS installation may overwrite the Run-Time Library supplied with Digital Fortran with an earlier version. Therefore, after each installation of a new OpenVMS version, the system manager must execute the following command: $ @SYS$UPDATE:FOR$INSTALL_FORRTL This command restores the Digital Fortran version of the Fortran Run-Time Library if it is newer than the version supplied by the OpenVMS Alpha operating system. If the OpenVMS version is newer, the procedure will not overwrite it. After Installing Digital Fortran 3-5 3.8 Removing Digital Fortran To remove Digital Fortran from the system, use the following command: $ PRODUCT REMOVE FORTRAN You may be asked if you would like to also remove the FORRTL product. It is safe to answer YES to this prompt: o It will not affect the Fortran Run-Time Library on the system. o It will remove a separate copy that is used by FOR$INSTALL_FORRTL to replace the Run-Time Library after OpenVMS upgrades. 3.9 Troubleshooting Tips If your installation is not successful, check for the following possible problems: o The appropriate PAK must be available to the user performing the installation. The PAK must be registered and loaded before you can install Digital Fortran. For information about registering a PAK, see Section 1.3. Then reinstall Digital Fortran. o The DCLTABLES.EXE file should be in the SYS$COMMON:[SYSLIB] directory. There should not be a copy of DCLTABLES.EXE in SYS$SPECIFIC:[SYSLIB]. If a copy of DCLTABLES.EXE is found in a SYS$SPECIFIC root, rename it to DCLTABLES.OLD, do an INSTALL REPLACE SYS$LIBRARY:DCLTABLES, then reinstall Digital Fortran. o The system logical name SYS$SYSROOT should not be modified from the preset definition provided by the OpenVMS Alpha operating system. 3-6 After Installing Digital Fortran 3.10 Getting Help and Reporting Problems If you encounter a problem while using Digital Fortran, report it to Digital. If an error occurs while Digital Fortran is in use and you believe the error is caused by a problem with Digital Fortran, take one of the following actions: o If you have a Software Product Services Support Agreement, consider contacting your Customer Support Center (CSC) by telephone (in the United States, 1-800- 354-9000) or by using the electronic means provided with your support agreement. You can use DSNlink or other electronic means to report the problem to the CSC. o Customers without a service contract can arrange for per-call CSC support. When you initially contact the CSC, please indicate the following: o The name and version number of the operating system (OpenVMS Alpha) you are using o The name (Digital Fortran) and version number of Digital Fortran you are using o The hardware system you are using (such as a model number) o How critical the problem is o A very brief description of the problem (one sentence if possible) When you submit information electronically or are speaking on the phone to the appropriate support specialist, you can provide more detailed information. This includes the specific commands used to compile and link the program, the error messages displayed, and relevant detailed information (possibly including source program listings). Please try to narrow the cause of the problem to a specific source module or lines of code. CSC personnel may ask for additional information, such as listings of any command files, INCLUDE files, relevant data files, and so forth. If the program is longer than After Installing Digital Fortran 3-7 50 lines, submit a copy of it electronically or provide machine-readable media (floppy diskette or magnetic tape). Experience shows that problem reports sometimes do not contain enough information to duplicate or identify the problem. Concise, complete information helps Digital give accurate and timely service to software problems. To obtain information about purchasing Digital support services, please contact your local Digital sales representative. You may also send comments and questions about the Digital Fortran product to the following Internet mail address: fortran@digital.com. 3-8 After Installing Digital Fortran