Compaq_Fortran______________________________________ Installation Guide for OpenVMS Alpha Systems Order Number: AA-PU3AF-TE January 2000 This guide describes how to install Compaq[R] Fortran (formerly DIGITAL[R] Fortran) and the Compaq Extended Math Library (CXML) on an Alpha processor system running the OpenVMS[TM] 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, and VMS are registered in the 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 2.1. ______________________________________________________________ Contents Preface .......................................... v 1 Preparing for Compaq Fortran Installation 1.1 The Software Product Library CD-ROM and Installation-Related Documentation Files...... 1-2 1.2 Required Operating System Components.......... 1-3 1.3 License Registration.......................... 1-4 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-7 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 2 Installing Compaq Fortran 2.1 Compaq Fortran Installation Instructions...... 2-1 2.2 Installing Compaq Extended Math Library....... 2-11 2.3 Installing 64-Bit Tools Support............... 2-14 iii 3 After Installing Compaq 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-3 3.4 Making the FORTRAN Command Available After Installation.................................. 3-4 3.5 User Account Requirements..................... 3-5 3.6 Enhancing Compaq Fortran Performance.......... 3-5 3.7 Removing Compaq Fortran....................... 3-6 3.8 CXML Post-Installation Startup Options........ 3-7 3.8.1 Setting CXML System-Wide Parameters ...... 3-8 3.8.2 Select a User-Specific Default CXML Link Library................................... 3-10 3.9 Troubleshooting Tips.......................... 3-10 3.10 Getting Help and Reporting Problems........... 3-11 A Compaq Fortran and CXML Files Tables 1 Conventions Used in This Document......... viii 1-1 LMF Product Names Used by Compaq Fortran .......................................... 1-4 1-2 Disk Space Requirements................... 1-6 3-1 Allowable names for the Second and Third CXML Startup Line Parameters.............. 3-8 3-2 Global System Resoures For Installed Images-IEEE Format........................ 3-9 3-3 Global System Resoures For Installed Images-VAX Format......................... 3-10 A-1 Files Installed by the Compaq Fortran Kit....................................... A-1 A-2 Files Installed by the CXML Kit........... A-5 iv _________________________________________________________________ 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: o Chapter 1 describes the hardware and software requirements for Compaq Fortran and CXML installations. It also lists related procedures that you must complete before installing Compaq Fortran. o Chapter 2 describes how to install Compaq Fortran, including an example installation. o Chapter 3 describes post-installation considerations. o Appendix A lists the files installed. v Associated Documentation In addition to this guide, the Compaq Fortran documentation set includes the following: o A language reference manual: - Compaq Fortran Language Reference Manual for the Compaq Fortran language, which fully supports the Fortran 90 and Fortran 95 standards. - DEC Fortran Language Reference Manual for the Compaq Fortran 77 language. o A user manual, either the Compaq Fortran 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 Compaq Fortran Version n.n for OpenVMS Alpha Systems ("read first" cover letter) o Compaq Fortran online release notes o CXML online release notes and the Compaq Extended Math Library Reference Guide o CXML example programs in SYS$COMMON:[SYSHLP.EXAMPLES.CXML] (described in the file READ_ME.INDEX in that directory) 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: 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 vi - OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems o Guide to OpenVMS Performance Management 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: o Internet electronic mail: fortran@compaq.com o FAX: 603-884-0120 Attn: Languages Documentation, ZKO2-3 /K35 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: o fortran@compaq.com o cxml@compaq.com Please note, however, that these addresses are for informational inquiries only. They are not formal support channels. vii 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. In code examples, a key name is shown enclosed to indicate that you press a key on a keyboard. (continued on next page) viii Table_1_(Cont.)_Conventions_Used_in_This_Document__________ Convention__________Meaning________________________________ [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 (formerly OpenVMS Alpha, VMS[R]), and OpenVMS Alpha refer to (VMS) the OpenVMS Alpha operating system. Compaq Fortran References to Compaq Fortran (formerly (DIGITAL Fortran DIGITAL Fortran 90) refer to the Compaq 90) Fortran compiler, which fully supports the Fortran 90 and Fortran 95 standards (as well as Compaq Fortran extensions). Compaq Fortran 77 The term Compaq Fortran 77 (formerly (DIGITAL Fortran DEC Fortran and DIGITAL Fortran 77) 77) refers to the Compaq Fortran 77 (DEC Fortran) 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. ix 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: 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) Preparing for Compaq Fortran Installation 1-1 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 Compaq Fortran installation kit files o Compaq 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 o A CDMENU utility 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: 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 Compaq Fortran release notes to a file and type or print them before starting Compaq Fortran installation. The Compaq 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 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: o Use a TYPE command to display the ASCII version of the Compaq Fortran cover letter (on your screen). 1-2 Preparing for Compaq Fortran Installation o Use a PRINT command to print the ASCII or PostScript[R] version of the Compaq 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 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: o Programming support Preparing for Compaq Fortran Installation 1-3 o Utilities 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 Unlimited or Personal-Use License FORTRAN90 FORTRAN-USER Concurrent-Use License FORTRAN90-USER_____________________________________________ 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. 1-4 Preparing for Compaq Fortran Installation 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. 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: o BYPASS o CMKRNL o SYSLCK o SYSPRV Table 1-2 lists Compaq Fortran's requirements for free disk storage space. Preparing for Compaq Fortran Installation 1-5 Table_1-2__Disk_Space_Requirements_________________________ During After Kit_Component_____________Installation____Installation_____ Compaq Fortran Compiler 25,000 blocks 25,000 blocks Compaq Fortran 77 12,000 blocks 12,000 blocks Compiler Compaq Fortran Run-Time _10,000_blocks ____200_blocks Library Compaq Fortran Complete 47,000 blocks 37,200 blocks kit Compaq Extended Math 150,000 blocks 150,000 blocks Library_(optional)_________________________________________ 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. 1-6 Preparing for Compaq Fortran Installation ________________________ 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. Preparing for Compaq Fortran Installation 1-7 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: o The operating system version is incorrect. o The privileges or disk space for successful installation are insufficient. 1-8 Preparing for Compaq Fortran Installation 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. Preparing for Compaq Fortran Installation 1-9 2 _________________________________________________________________ Installing Compaq Fortran This chapter describes: o How to read the online release notes before installation. o How to install Compaq Fortran and CXML using POLYCENTER[R] Software Installation (PCSI) software. PCSI software is bundled with the OpenVMS operating system. o Information about installing optional tools that support 64-bit addressing of static data. Before you start the installation, read Chapter 1, which describes the general options and requirements for installing Compaq Fortran. After you complete installation, see Chapter 3. 2.1 Compaq Fortran Installation Instructions The installation procedure loads Compaq Fortran product distribution files on to the system disk on the system where you perform the installation. ________________________ Note ________________________ You must first install the Compaq Fortran Run-Time Library (RTL) before you install the Compaq Fortran compiler. ______________________________________________________ Follow these steps to install Compaq Fortran from the OpenVMS Alpha Software Products Library CD-ROM set: Installing Compaq Fortran 2-1 1. Log in to a privileged account on the system (or cluster) where you will install Compaq Fortran. This account must have the following privileges enabled: o BYPASS o CMKRNL o SYSLCK o SYSPRV Do not proceed with the installation unless your account has the BYPASS, CMKRNL, SYSLCK, and SYSPRV privileges enabled. If your process has the SETPRV privilege, you can enable these privileges by typing the following command: $ SET PROCESS/PRIVILEGE=(BYPASS,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 Compaq 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: 2-2 Installing Compaq Fortran $ 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. ______________________________________________________ 4. If the media CD-ROM containing the Compaq 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 *.PCSI 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 Compaq Fortran online release notes before you install Compaq 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. If your process default directory is the directory on the CD-ROM that contains the Compaq Fortran product distribution files, you can specify the /SOURCE directory as /SOURCE=[]. Installing Compaq Fortran 2-3 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 Compaq Fortran compiler (development) kit, Compaq Fortran also provides a separate Run- Time Library kit. The Compaq Fortran Run-Time Library (FORRTL) may be freely redistributed on other OpenVMS Alpha systems provided the terms specified in the Software Product Description (SPD) are honored. A copy of the Compaq Fortran SPD can be found in the [.DOCUMENTATION] subdirectory of the Compaq Fortran product directory on the OpenVMS Alpha Software Product Library CD-ROM. The Compaq Fortran Run-Time Library kit contains a shared Compaq Fortran and Compaq Fortran 77 Run-Time Library (Fortran RTL) needed to execute (RUN) Fortran programs. The Fortran RTL kit provided with Compaq Fortran compiler media contains changes needed to run Compaq Fortran programs that are not included in the Fortran RTL version supplied with the OpenVMS Alpha operating system Version 7.1, 7.2 or 7.2-1. The Fortran RTL kit includes the shareable image DEC$FORRTL.EXE, which is compatible with DEC Fortran for OpenVMS Alpha Version 7.1 or later 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 Compaq Fortran kit is installed. The Fortran RTL kit also includes an updated version of the Math Library shareable image DPML$SHR.EXE which includes support for the COMPLEX*32 datatype. To run Compaq Fortran images on other OpenVMS Alpha systems, 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 Compaq Fortran Software Product Description (SPD) for details. 2-4 Installing Compaq Fortran An OpenVMS Alpha release after Version 7.2 includes RTL components which are sufficient to run both Compaq Fortran and Compaq Fortran 77 applications. The RTL kit provided with Compaq Fortran will not replace components provided by OpenVMS Alpha if the existing components are newer. To install the Compaq 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: If the installation fails, repeat the PRODUCT INSTALL command(s) adding the qualifiers /LOG/TRACE to the command line. The additional output will help Compaq support analyze the problem. The following product has been selected: DEC AXPVMS FORRTL 7.n Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS FORRTL V7.n-n: Compaq Fortran Run-Time Library This kit contains the Compaq Fortran Run-Time Library. It is required for use of Compaq Fortran applications and is upwards compatible from earlier versions. Copyright © 2000 Compaq Computer Corporation COMPAQ Registered in U.S. Patent and Trademark Office. Confidential computer software. Valid license from Compaq or authorized sublicensor 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. Installing Compaq Fortran 2-5 This software is produced by Compaq Computer Corporation This software is licensed under the OpenVMS product license Do you want the default values for all options [YES] Ignore PSCI-I-RETAIN messages During installation of this product, you may see messages of the form: %PCSI-I-RETAIN, 'object' 'object-name' was not replaced because 'object' from kit does not have higher generation number These messages indicate that the Run-Time Library components on this kit are older than those already installed on your OpenVMS system. This is a normal situation and the messages can be ignored. You may also see these messages when installing a new version of OpenVMS. In this case, it indicates that the OpenVMS versions of the Run-Time Library components are older than those already on the system. This will occur with installations of OpenVMS 7.2-1 or earlier. These messages can be ignored also. Do you want to continue? [YES] %PCSIUI-I-DONEASK, execution phase starting The following product will be installed: DEC AXPVMS FORRTL 7.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 7.n Layered Product *** DEC AXPVMS FORRTL 7.n Layered Product Release notes are in SYS$HELP:FORRTL.RELEASE_NOTES Do INSTALL REPLACE of shareable libraries on all other Alpha cluster nodes After installation, execute the following command on all other Alpha nodes of your OpenVMS cluster: 2-6 Installing Compaq Fortran INSTALL REPLACE SYS$LIBRARY:DEC$FORRTL.EXE INSTALL REPLACE SYS$LIBRARY:DPML$SHR.EXE $ 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 Version 2.0 was previously installed on this system, it must be removed before Compaq Fortran is installed. To determine if DEC Fortran 90 is present, type the following command: $ PRODUCT SHOW PRODUCT FORTRAN90 If DEC Fortran 90 is present, something similar to the following text appears: PRODUCT ------- DEC AXPVMS FORTRAN90 Vn.n 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 PRODUCT REMOVE command. Specify the product name FORTRAN90. For example: $ PRODUCT REMOVE FORTRAN90 The following text appears: The following product has been selected: DEC AXPVMS FORTRAN90 V2.0 Installing Compaq Fortran 2-7 %PCSI-E-CONREMUNR, optionally remove product DEC AXPVMS FORRTL V2.0 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 V2.0 %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 V2.0 For more information on removing Compaq Fortran, see Section 3.7. 10.To install the Compaq 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. The following text appears: The following product has been selected: DEC AXPVMS FORTRAN V7.n Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS FORTRAN V7.n: Compaq Fortran for OpenVMS Alpha Systems Compaq Fortran provides two compilers, Compaq Fortran and Compaq Fortran 77. Compaq Fortran for OpenVMS Alpha Systems is an implementation of the Fortran 95 programming language conforming to International Standards Organization standard ISO 1539-1995(E). It includes support for programs conforming to the previous Fortran standards Fortran 90, FORTRAN 77 and FORTRAN IV as well as MIL-STD-1753 and Federal Information Processing Standard Publication (FIPS-69-1). 2-8 Installing Compaq Fortran Compaq Fortran 77 is an implementation of full language FORTRAN-77, conforming to American National Standard FORTRAN, ANSI X3.9-1978. It includes optional support for programs conforming to the previous standard, ANSI X3.9-1966. Compaq Fortran meets the Federal Information Processing Standard Publication (FIPS-69-1) requirements by conforming to the ANSI Standard and by including a flagger. The flagger optionally produces diagnostic messages for compile-time elements that do not conform to the Full-Level ANSI FORTRAN X3.9-1978 Standard. Compaq Fortran 77 also conforms to the International Standard ISO 1539-1980(E) and to MIL-STD 1753. Copyright © 2000 Compaq Computer Corporation COMPAQ Registered in U.S. Patent and Trademark Office. Confidential computer software. Valid license from Compaq or authorized sublicensor 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. This software product is sold by Compaq Computer Corporation PAKs used: FORTRAN, FORTRAN90, FORTRAN-USER or FORTRAN90-USER This product requires that one of the following license PAKs be registered and loaded: Producer Product Version Release Date DEC FORTRAN V7.3 1-DEC-1999 DEC FORTRAN90 V7.3 1-DEC-1999 DEC FORTRAN-USER V7.3 1-DEC-1999 DEC FORTRAN90-USER V7.3 1-DEC-1999 Do you want all the default values for this product? [YES] If you want both the Compaq Fortran and Compaq Fortran 77 compilers installed, or wish to use the same selection as a previous installation, type YES at this prompt (or press the Return key to accept the default of YES). If you wish to only install the Compaq Fortran Installing Compaq Fortran 2-9 compiler (and not Compaq Fortran 77 compiler), type NO and answer the additional prompts. The following text will be displayed: By default, the FORTRAN command invokes Fortran 95 Starting with version V7.2 of this product, the FORTRAN command verb, by default, invokes the Fortran 95 compiler. This is different from previous versions where FORTRAN invoked the Fortran 77 compiler. While we have made the Fortran 95 compiler highly compatible with the Fortran 77 compiler, there are some differences and some users may prefer to use the older compiler. With the default installation, the Fortran 77 compiler may be invoked using FORTRAN/OLD_F77. Command definition files are provided which allow system managers and individual users to select the previous arrangement where FORTRAN invokes Fortran 77 and F90 invokes Fortran 95. (The F90 verb invokes Fortran 95 in either case.) Please read, and ask your Fortran users to read, the release notes for more details on this change and how it may affect applications and build scripts. Do you want to continue? [YES] By default, the Compaq Fortran 95 and Compaq Fortran 77 compilers are both installed. Installation continues with the following text displayed: Do you want to review the options? [NO] If you type YES, you can choose whether you want to install the Compaq Fortran 77 compiler (follow the additional prompts). If you type NO or press the Return key, installation continues with the following text displayed: Execution phase starting ... The following product will be installed: DEC AXPVMS FORTRAN V7.n DISK$VOLUMExxx:[VMS$COMMON] The following product has been removed: DEC AXPVMS FORTRAN V7.n DISK$VOLUMExxx:[VMS$COMMON] %PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS FORTRAN V7.n.. %PCSI-I-IVPSUCCESS, test procedure completed successfully DEC AXPVMS FORTRAN V7.n: Compaq Fortran for OpenVMS Alpha Systems 2-10 Installing Compaq Fortran 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.2 Installing Compaq Extended Math Library The Compaq Extended Math Library (CXML), an optional component, is a set of scientific subroutines optimized for Alpha systems, organized into the following libraries: o BLAS - Basic Linear Algebra Subprograms o LAPACK - An extensive library of Linear System and Eigenproblem Solvers o Sparse Linear System Solvers - A library of direct and iterative sparse solvers o Signal Processing - FFTs, sine/cosine transforms, convolution, correlation and filters o SCIPORT - A library of routines compatible with Cray's SCILIB V7. Further details about CXML can be found at the Compaq Math Library Web site at http://www.compaq.com/math or in the CXML online documentation. Before you install the Compaq Extended Math Library (CXML), be aware that the account and privileges requirements are the same as for Compaq Fortran. Unless you are installing CXML from the same account immediately after installing Compaq Fortran, please review steps 1 through 6 in Section Installing Compaq Fortran 2-11 2.1 to ensure you have the necessary privileges, can locate the CXML installation files (in the same directory as the Fortran files), and can print out the CXML release notes before installation. To install the Compaq Extended Math Library, type the following PRODUCT INSTALL command: $ PRODUCT INSTALL CXML /SOURCE=disk:[dir] /HELP Where disk:[dir] is the specification of the disk and directory containing the product installation files. The following text appears: The following product has been selected: DEC AXPVMS CXML Vm.n Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS CXML Vm.n: Compaq Extended Math Library for OpenVMS Alpha Systems The CXML is a set of computationally intensive mathematical subroutines that are optimized for Alpha platforms. These routines are drawn from both public domain and proprietary libraries. CXML includes five sublibraries or components: o VLIB - fast math routines for vectors o BLAS (Basic Linear Algebra Subroutines) - vector and matrix operations o LAPACK - linear and eigen system solvers o Sparse Linear System Solvers - sparse direct and iterative solvers o Signal Processing - FFTs, cos/sin transforms, convolution, correlation and digital filters Most routines are available in both real and complex versions, as well as in both single and double precision. G-float and IEEE floating point formats are supported on OpenVMS Alpha. Copyright © 2000 Compaq Computer Corporation COMPAQ Registered in U.S. Patent and Trademark Office. 2-12 Installing Compaq Fortran Confidential computer software. Valid license from Compaq or authorized sublicensor 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 CXML requires no license PAKs * This product does not have any configuration options. Execution phase starting ... The following product will be installed to destination: DEC AXPVMS CXML Vm.n DISK$VOLUMExxx:[VMS$COMMON.] Portion done: 0%...30%...40%...50%...70%...80%...90%...100% The following product has been installed: DEC AXPVMS CXML Vm.n Layered Product %PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS CXML Vm.n ... %PCSI-I-IVPSUCCESS, test procedure completed successfully DEC AXPVMS CXML Vm.n: Compaq Extended Math Library for OpenVMS Alpha Systems Release notes at SYS$HELP:CXML-Vmn-RELEASE-NOTES.TXT. Insert the following lines in SYS$MANAGER:SYSTARTUP_VMS.COM: @SYS$STARTUP:cxml$startup $ Installation takes about 2-5 minutes (depending on your system). When installation has been completed, the DCL $ prompt reappears. To obtain a list of files installed, type the following command: $ PRODUCT SHOW OBJECT /PRODUCT=CXML Installing Compaq Fortran 2-13 2.3 Installing 64-Bit Tools Support If you will be using 64-bit address space data in your applications, you should install the enhanced 64-bit OpenVMS tools on your system, which include the OpenVMS Debugger (DEBUG64) and OpenVMS Linker (LINKER64). If your system has OpenVMS Version 7.2 installed, and you want to use the ability to allocate static data (local variables and COMMON) in 64-bit address space, you must install the DEBUG64 (ADX072) kit as it provides a new linker, LINKER64, which supports this new feature. OpenVMS Version 7.2 supports 64-bit allocation of static data, but does not provide LINKER64. OpenVMS versions prior to Version 7.2 do not support 64-bit allocation of static data. If you have a version of OpenVMS later than Version 7.2, please check its release notes to see if DEBUG64 and LINKER64 functionality is already included. If the DEBUG64 kit is installed, LINKER64 is made the system default linker. It can be used as a general replacement for the OpenVMS-supplied linker. DEBUG64 may be installed on OpenVMS Versions 6.2 and later. (Note that Compaq Fortran supports OpenVMS Version 7.1 and later.) The DEBUG64 kit is provided on your media CD-ROM in the same directory where the Fortran compiler kit files are located. For more details on the capabilities of DEBUG64, see the release notes file ADX072.RELEASE_NOTES. You can view the release notes before installation (see below). After installation, the release notes are installed on the system in SYS$HELP:ADX072.RELEASE_NOTES. Follow these steps to install DEBUG64: 1. Log in to a privileged account on the system (or cluster) where you will install Compaq Fortran. This account must have the following privileges enabled: o BYPASS o CMKRNL o SYSLCK 2-14 Installing Compaq Fortran o SYSPRV Do not proceed with the installation unless your account has the BYPASS, CMKRNL, SYSLCK, and SYSPRV privileges enabled. If your process has the SETPRV privilege, you can enable these privileges by typing the following command: $ SET PROCESS/PRIVILEGE=(BYPASS,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 Compaq 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. ______________________________________________________ Installing Compaq Fortran 2-15 4. If the media CD-ROM containing the Compaq 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 ADX*.* Directory DKA400:[dir.subdir] ADX072.A ADX072.B ADX072.C Total of 3 files. 6. To extract the DEBUG64 online release notes before you install the DEBUG64 kit, type the following command: $ @SYS$UPDATE:VMSINSTAL ADX072 disk:[dir] OPTIONS N The release notes are copied to SYS$HELP:ADX072.RELEASE_ NOTES. VMSINSTAL then displays the following text: Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: Select the option number needed and press Return (default is item 2). You are given the opportunity to proceed with the installation or exit immediately. 7. To install DEBUG64, type the following command: $ @sys$update:vmsinstal adx072 disk:[dir] 2-16 Installing Compaq Fortran The following text appears: OpenVMS AXP Software Product Installation Procedure V7.2 It is 19-APR-1999 at 15:43. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? Press Return to proceed: The following products will be processed: ADX V7.2 Beginning installation of ADX V7.2 at 15:43 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. ************************************************************** OpenVMS Alpha Debug V7.2X Copyright © 1998,2000 Compaq Computer Corporation COMPAQ Registered in U.S. Patent and Trademark Office. Confidential computer software. Valid license from Compaq or authorized sublicensor 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. ********************************************************************* This kit installs Debug version V7.2X. It will install on Alpha OpenVMS V6.2 to V7.2 systems. This kit requires an installed DCE for its client/server configurations (see release motes). If DCE is not installed, the "server" portion of the debugger cannot be linked and a warning is printed during the installation, for example, "%ADX-W-LINKABORT, NO DEBUGSRVSHR linked, SYS$LIBRARY:DCE$LIB_SHR missing (install DCE)". You can safely ignore this message. The normal operation of the debugger is not affected, however, the client/server mode will NOT be operational. A new Heap Analyzer will be also installed on V7.1 or later systems. Installing Compaq Fortran 2-17 If your system is later upgraded from V6 to V7 or if DCE or MOTIF are later installed, then this kit MUST be rerun, i.e. the V7.2X debugger MUST be reinstalled. System Code Debugger features will NOT be installed as part of this kit, use the system supplied debugger for that. This installation will NOT replace your current OpenVMS system supplied debugger. However, it will replace any previous versions of the V7.2X debugger that may be installed AND it will remove any earlier network kit debuggers, e.g. V71C. This installation takes ~5 minutes. * Do you want to run the IVP after the installation [YES]? Do you want to run the interactive DECwindows Motif IVP? [NO]? Do you want to purge files replaced by this installation [YES]? %ADX-I-DONEASK, No further questions will be asked during this installation. %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-RESTORE, Restoring product save set C ... %ADX-I-ENDRESTORE, All Debugger savesets have been restored. %ADX-I-LINKING, Linking V7 images. %ADX-I-LINKDONE, DEBUGSHR has been linked. %ADX-I-LINKDONE, DEBUG has been linked. %ADX-I-LINKDONE, DEBUGUISHR has been linked. %ADX-I-LINKDONE, DEBUGSRVSHR has been linked. %ADX-I-LINKDONE, HA_MAIN has been linked. %ADX-I-LINKDONE, HA_KERNEL has been linked. %ADX-I-LINKDONE, TRACE has been linked. %ADX-I-CLEANUP, Cleanup has been performed. %ADX-I-PROHELP, Providing Debugger Help files... %ADX-I-PROMSG, Providing Debugger message image... %ADX-I-PROMSG, Providing Debugger .CLD file... %ADX-I-PROEXE, Providing Debugger files... %ADX-I-PROEXE, Providing Heap Analyzer files... %ADX-I-PROMSG, Providing startup files ... If you want the debugger installed by this kit to be the default system debugger: - Add the following line to the system startup procedure: $ @SYS$STARTUP:DEBUG$STARTUP_V72X.COM V72X You should remove any other *DEBUG$STARTUP*.COM reference. 2-18 Installing Compaq Fortran - Enter the following command from a privileged account: @SYS$STARTUP:DEBUG$STARTUP_V72X.COM V72X To install the images and define the default system debugger on other Alpha nodes of a VMScluster, enter this command on each such node. Note, however, that this is a /SYSTEM setup (also see SYS$STARTUP:DEBUGSETUP.COM) and also modifies and install/replaces your SYS$SHARE:DCLTABLES.EXE. If you want the regular system debugger installed to be the default system debugger, then do the same as above but use "VMS" as the input parameter, for example: @SYS$STARTUP:DEBUG$STARTUP_V72X.COM VMS Users can also dynamically switch debuggers by using SYS$STARTUP:DEBUGSETUP.COM. It's input options are VMS, V72X, V72, V71C, or UNSET. It also needs the logical table switch /JOB or /SYSTEM. For example: @SYS$STARTUP:DEBUGSETUP.COM V72X /JOB %ADX-I-PROIVP, Providing test files for IVP... The Debugger IVP has been moved to the SYS$TEST directory. To run the IVP after installation, first setup to use the V72X debugger by executing the command "@SYS$STARTUP:DEBUGSETUP V72X /JOB" Then, run the character cell IVP by executing the command "@SYS$TEST:DBG$IVP.COM" or, if DECWindows Motif has been installed on your system, run the interactive DECWindows Motif IVP by executing the command "@SYS$TEST:DBG$DW$IVP.COM" %ADX-I-INSTALLDONE, OpenVMS Alpha Debug V7.2X installation done %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Beginning the Debug V7.2X Verification Procedure Copyright © 1998,2000 Compaq Computer Corporation Debug verification procedure successful. Installation of ADX V7.2 completed at 15:49 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]ADX072.VMI_DATA VMSINSTAL procedure done at 15:49 Installing Compaq Fortran 2-19 8. Edit your system startup procedure as described in the above displayed text. 2-20 Installing Compaq Fortran 3 _________________________________________________________________ After Installing Compaq Fortran The following tasks can be performed after Compaq Fortran is installed: o Running the Installation Verification Procedure (IVP) separately (Section 3.1) o Modifying the system-wide startup command procedure (Section 3.2) o Making the product usable on a VMScluster (Section 3.3) o Making the recently installed FORTRAN command available to users after installation (Section 3.4) o Setting user account quotas (Section 3.5) o Enhancing performance (Section 3.6) o Removing Compaq Fortran (Section 3.7) o CXML Post-Installation Startup Options (Section 3.8) o Troubleshooting tips (Section 3.9) o Getting help and reporting problems (Section 3.10) 3.1 Running the Installation Verification Procedure Separately The Compaq Fortran Installation Verification Procedure (IVP) runs automatically during Compaq Fortran installation. Similarly, the Compaq Extended Math Library (CXML) IVP runs during CXML installation. If system problems occur, you should run the Compaq Fortran IVP separately to ensure the integrity of the installed files. To run the IVP, type the following command: $ @SYS$TEST:FORT$IVP.COM After Installing Compaq Fortran 3-1 If any problems are encountered, a message such as the following appears: Compaq Fortran Version 7.n TEST FAILED Similarly, you can run the CXML IVP after installation, or at other times, to ensure the integrity of installed files if system problems have occurred. You need system privileges to run the CXML IVP. To run the CXML IVP, execute the following command procedure: $ @SYS$TEST:CXML_IVP.COM If the IVP runs successfully, you will see the following display: CXML-I-IVP> Completed CXML Vnnnn Installation Verification Procedure 3.2 Modifying the System-Wide Startup Command Procedure Add the following lines to the system-wide startup file (if you have not done so previously), such as the file SYS$MANAGER:SYSTARTUP_VMS.COM or a command procedure that it invokes: $ @SYS$STARTUP:FORT$STARTUP $ @SYS$STARTUP:CXML$STARTUP These command procedures install Compaq Fortran and CXML images in memory and perform related actions. The Fortran startup procedure line does not take any parameters (arguments). The CXML startup procedure line lets you specify certain parameters to: o Control the default CXML link library o Specify names of CXML shareable images to be installed as shared images o Specify names of CXML shareable images to be installed as resident images Among other things, inserting this line in the startup procedure makes the correct CXML library available automatically, eliminating the need for the user to explicitly specify the CXML link library on the LINK command line. 3-2 After Installing Compaq Fortran In addition, individual users can select a user- specific default CXML link library, by executing the SYS$LIBRARY:CXML$SET_LIB command procedure. For more information on the CXML startup procedure arguments and specifying a user-specific default CXML link library, see Section 3.8. 3.3 VMScluster Considerations If you want to run Compaq 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 Compaq 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 Compaq 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 Compaq Fortran; failure to do so may cause unexpected errors for users. ________________________ Note ________________________ If you are using a dual-architecture (VAX[R] 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 shareable images available, as follows: After Installing Compaq Fortran 3-3 $ 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 SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DPML$SHR.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 If any of the INSTALL commands fail, reboot the affected node. 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 Command Available After Installation Compaq Fortran is now installed and can be invoked by all users with the FORTRAN command. The installation procedure modifies the DCL command table so that the FORTRAN commands are recognized and processed. However, the previous command table is still in effect for those users who are currently logged in. 3-4 After Installing Compaq Fortran All logged-in users who want to use the FORTRAN command must log out and log in again, or use the following DCL command: $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES 3.5 User Account Requirements No special privileges are needed to use Compaq Fortran. There is no benefit from installing the compilers with privileges. To use Compaq 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 Compaq Fortran Performance This section includes information on system tuning and explains how to install Compaq Fortran as a shared image. After you install Compaq 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 After Installing Compaq Fortran 3-5 to extend an existing page file or create one or more new page files. 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 Removing Compaq Fortran To remove Compaq 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. Compaq recommends that you answer NO to this prompt. After removing Compaq Fortran from the system, remove the call to SYS$STARTUP:FORT$STARTUP.COM from your system startup procedure. To remove Compaq Extended Math Library from the system, use the following command: $ PRODUCT REMOVE CXML After removing Compaq Extended Math Library from the system, remove the call to SYS$STARTUP:CXML$STARTUP.COM from your system startup procedure. 3-6 After Installing Compaq Fortran 3.8 CXML Post-Installation Startup Options As part of the post-installation process described in Section 3.2, you need to add the following line to your system's startup procedure: @SYS$STARTUP:CXML$STARTUP Among other things, inserting this line in the startup procedure will make the correct CXML library available automatically, eliminating the need for the user to explicitly specify the CXML link library on the LINK command line. In addition, individual users can select a user- specific default CXML link library, by executing the SYS$LIBRARY:CXML$SET_LIB command procedure, as described in Section 3.8.2. This command procedure has three system-wide default parameters, which you can optionally change (as described below). The default parameters control the following things: o The first parameter sets the default CXML link library. Its default value is "IEEE". o The second parameter is a list of the names of CXML shareable images to be installed as shared images. Its default value is " " (none). o The third parameter is a list of the names of CXML shareable images to be installed as resident images. Its default value is " " (none). If the default parameter values described above are acceptable, you can skip the rest of this step. If you want to change any of these parameters, use the following instructions. After Installing Compaq Fortran 3-7 3.8.1 Setting CXML System-Wide Parameters First parameter-controls the default CXML link library. If it has the value "IEEE", the library of routines using IEEE floating-point format will be designated as the default CXML link library. If its value is "VAX", the library of VAX floating-point format routines will be designated as the default CXML link library. The default value of this first parameter is "IEEE". If it does not have the value "VAX" or "IEEE", an error message will be given. Second parameter-a list of the names of CXML shareable images to be installed as shared images. Its default value is "". Allowable names in this list are described in the following table. Third parameter-a list of the names of CXML shareable images to be installed as resident images. Its default value is "". Allowable names in this list are described Table 3-1. Table 3-1 Allowable names for the Second and Third CXML ___________Startup_Line_Parameters_________________________ IEEE_BLAS1 VAX_BLAS1 IEEE_BLAS1E VAX_BLAS1E IEEE_BLAS2 VAX_BLAS2 IEEE_BLAS3 VAX_BLAS3 IEEE_COMMON VAX_COMMON IEEE_LAPACK VAX_LAPACK IEEE_SIG_PROC VAX_SIG_PROC IEEE_SPARSE VAX_SPARSE IEEE_VLIB_____________VAX_VLIB_____________________________ The list entries are not case sensitive. If more than one name appears in a list, the names are separated by commas. The list may contain only the above names and comma(s). If a CXML shareable image name appears in both lists, it will be installed as a shared image. For example, the following command will set the default CXML link library to be the one using IEEE floating-point format and will install the IEEE-format COMMON shareable image along with all the IEEE-format BLAS shareable images 3-8 After Installing Compaq Fortran as resident images. No other CXML shareable images will be installed. $ @SYS$STARTUP:CXML$STARTUP IEEE "" - $_ IEEE_BLAS1,IEEE_BLAS1E,IEEE_BLAS2,IEEE_BLAS3,IEEE_COMMON To install CXML images, your system must have sufficient resources available. Refer to the following tables to obtain the total number of global resources required. If you are installing images as a /SHARED resource, add all relevant entries under the columns "GBLPAGES" and "GBLSECTIONS". Then check that your system is configured with a sufficient number of free global pages and free global sections to accomodate the images to be installed. If you are installing images as /RESIDENT resources, add all relevant entries under the column "GH_RSRVPGCNT". Check that your system has sufficient free pages in the resident image code area of the granularity hint region (see Table 3-2 and Table 3-3). Table 3-2 Global System Resoures For Installed Images-IEEE __________Format___________________________________________ Image_Name_______GBLPAGESGBLSECTIONSGH_RSRVPGCNT___________ CXML$STS_BLAS1 160 1 8 CXML$STS_BLAS1E 192 1 10 CXML$STS_BLAS2 2224 1 127 CXML$STS_BLAS3 3488 2 213 CXML$STS_COMMON 96 2 1 CXML$STS_LAPACK 7584 2 469 CXML$STS_SIG_ 7904 2 489 PROC CXML$STS_SPARSE 1856 1 114 CXML$STS_VLIB____112_____2__________2______________________ After Installing Compaq Fortran 3-9 Table 3-3 Global System Resoures For Installed Images-VAX ___________Format__________________________________________ Image_Name_______GBLPAGESGBLSECTIONSGH_RSRVPGCNT___________ CXML$FGS_BLAS1 160 1 8 CXML$FGS_BLAS1E 192 1 10 CXML$FGS_BLAS2 2224 1 127 CXML$FGS_BLAS3 3488 2 213 CXML$FGS_COMMON 96 2 1 CXML$FGS_LAPACK 7568 2 468 CXML$FGS_SIG_ 7904 2 489 PROC CXML$FGS_SPARSE 1856 1 114 CXML$FGS_VLIB____112_____2__________2______________________ 3.8.2 Select a User-Specific Default CXML Link Library Individual users can change the CXML link library by changed by invoking SYS$LIBRARY:CXML$SET_LIB from their process. The system-wide default CXML link library is set using the system startup file SYS$STARTUP:CXML$STARTUP, as described in Section 3.8.1. In addition, individual users may change their own specific default library by invoking SYS$LIBRARY:CXML$SET_LIB themselves. For example, the following command alters the default CXML link library for the current user to the VAX format library: $ @SYS$LIBRARY:CXML$SET_LIB VAX For information on using CXML, refer to the Compaq Extended Math Library Reference Guide. Refer also to the Web site http://www.compaq.com/math/. 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 Compaq Fortran. For information about registering a PAK, see Section 1.3. Then reinstall Compaq Fortran. 3-10 After Installing Compaq 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 Compaq Fortran. o The system logical name SYS$SYSROOT should not be modified from the preset definition provided by the OpenVMS Alpha operating system. 3.10 Getting Help and Reporting Problems If you encounter a problem while using Compaq Fortran, report it to Compaq. If an error occurs while Compaq Fortran is in use and you believe the error is caused by a problem with Compaq 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 (Compaq Fortran) and version number of Compaq 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) After Installing Compaq Fortran 3-11 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 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 Compaq give accurate and timely service to software problems. To obtain information about purchasing Compaq support services, please contact your local sales representative. You may also send comments and questions about the Compaq Fortran product to the following Internet mail address: fortran@compaq.com. 3-12 After Installing Compaq Fortran A _________________________________________________________________ Compaq Fortran and CXML Files Appendix A lists the Compaq Fortran and CXML files that the installation procedure writes on your system in Table A-1 and Table A-2. Note that not all files may be installed because of options selected or OpenVMS version. Table_A-1_Files_Installed_by_the_Compaq_Fortran_Kit________ FORTRAN____________________________________________________ SYS$SYSTEM: F90$MAIN.EXE Fortran 90/95 compiler FORT$MAIN.EXE Fortran 77 compiler FORT$FSPLIT.EXE FSPLIT utility SYS$LIBRARY: FORSYSDEF.TLB FORT$FORTRAN-F77.CLD Defines FORTRAN as Fortran 77 FORT$FORTRAN-F95.CLD Defines FORTRAN as Fortran 95 SYS$MESSAGE: F90$MSG.EXE FORT$MSG.EXE FORT$MSG2.EXE SYS$TEST: FORT$IVP.COM (continued on next page) Compaq Fortran and CXML Files A-1 Table_A-1_(Cont.)__Files_Installed_by_the_Compaq_Fortran_Kit FORTRAN____________________________________________________ SYS$HELP: FORTRAN.RELEASE_NOTES FORTRAN_RELEASE_NOTES.PS SYS$STARTUP: FORT$STARTUP.COM ___________________________________________________________ FORRTL_____________________________________________________ SYS$LIBRARY: STARLET.OLB (updated) DEC$FORRTL.EXE DPML$SHR.EXE FORDEF.FOR FORIOSDEF.FOR SYS$HELP: FORRTL.RELEASE_NOTES ___________________________________________________________ ADX072_____________________________________________________ SYS$HELP: DBG$HELP_V72X.HLB DBG$UIHELP_V72X.HLB SYS$MESSAGE: DBGTBKMSG_V72X.EXE SYS$LIBRARY: CS_IN_DEBUG.CLD (continued on next page) A-2 Compaq Fortran and CXML Files Table_A-1_(Cont.)_Files_Installed_by_the_Compaq_Fortran_Kit ADX072_____________________________________________________ CS_OUT_DEBUG.CLD DEBUG_V72X.EXE DEBUGSHR_V72X.EXE TRACE.EXE DEBUGSRVSHR_V72X.EXE DEBUGUISHR_V72X.EXE VMSDEBUGUIL_V72X.UID DBG$HA_V72X.UID DBG$HA_KERNEL_V72X.EXE DBG$HA_MAIN_V72X.EXE LIBRTL_INSTRUMENTED.EXE SYS$SYSTEM: LINKER64.EXE SYS$UPDATE: DBGKITUNINSTAL.COM SYS$STARTUP: DEBUGSETUP.COM DEBUG$STARTUP_V72X.COM SYS$TEST: DBG$IVP.COM DBG$DW$IVP.COM DBG_IVP IVP_IMAGE.PAS DBG_IVP IVP_IMAGE.EXE DBG_IVP IVP_SCRIPT.TST (continued on next page) Compaq Fortran and CXML Files A-3 Table_A-1_(Cont.)__Files_Installed_by_the_Compaq_Fortran_Kit ADX072_____________________________________________________ DBG_IVP IVP_SCRIPT.OUT_ OLD DECW$SYSTEM_DEFAULTS: VMSDEBUG_V72X.DAT ___________________________________________________________ A-4 Compaq Fortran and CXML Files Table_A-2_Files_Installed_by_the_CXML_Kit__________________ CXML_______________________________________________________ SYS$STARTUP.COM CXML$STARTUP.COM Startup command procedure SYS$HELP CXML_V359_RELEASE_ Online release notes NOTES.TXT CXML_LAPACK_C.TXT CXML_LAPACK_D.TXT CXML_LAPACK_S.TXT CXML_LAPACK_Z.TXT CXMLREF_VMS.PDF CXML Reference Manual - online CXMLREF_VMS.PS CXML Reference Manual - hardcopy SYS$TEST CXML$IVP.COM IVP command procedure SYS$LIBRARY CXML$FGS.OLB CXML routines - VAX Floating- point CXML$FGS_BLAS1.EXE CXML$FGS_BLAS1E.EXE CXML$FGS_BLAS2.EXE CXML$FGS_BLAS3.EXE CXML$FGS_COMMON.EXE CXML$FGS_LAPACK.EXE CXML$FGS_SIG_PROC.EXE CXML$FGS_SPARSE.EXE CXML$FGS_VLIB.EXE (continued on next page) Compaq Fortran and CXML Files A-5 Table_A-2_(Cont.)__Files_Installed_by_the_CXML_Kit_________ CXML_______________________________________________________ CXML$STS.OLB CXML routines - IEEE Floating- point CXML$STS_BLAS1.EXE CXML$STS_BLAS1E.EXE CXML$STS_BLAS2.EXE CXML$STS_BLAS3.EXE CXML$STS_COMMON.EXE CXML$STS_LAPACK.EXE CXML$STS_SIG_PROC.EXE CXML$STS_SPARSE.EXE CXML$STS_VLIB.EXE CXMLDEF.FOR and Definition file for signal DXMLDEF.FOR processing CXMLDEF.H and DXMLDEF.H Definition file for signal processing CXML_EQUIVALENCE_LAPACK.C LINPACK/LAPACK names conversion program CXML$EMACS.ML Editor support CXML$EVE.TPU CXML$IMAGELIB_GS.OLB VAX Floating-point library CXML$IMAGELIB_TS.OLB IEEE Floating-point library CXML$SET_LIB.COM Library selection procedure SYS$COMMON:[SYSTEST.CXML] BLAS_BUILD_TEST.OBJ IVP_LAPACK_VAX.OBJ IVP_LAPACK_IEEE.OBJ IVP_SIG_VAX.OBJ IVP_SIG_IEEE.OBJ IVP_SPARSE_B1_VAX.OBJ (continued on next page) A-6 Compaq Fortran and CXML Files Table_A-2_(Cont.)_Files_Installed_by_the_CXML_Kit__________ CXML_______________________________________________________ IVP_SPARSE_B1_IEEE.OBJ IVP_SPARSE_IS_VAX.OBJ IVP_SPARSE_IS_IEEE.OBJ IVP_SPARSE_SKY_VAX.OBJ IVP_SPARSE_SKY_IEEE.OBJ IVP_VLIB_VAX.OBJ IVP_VLIB_IEEE.OBJ LAPACK_BUILD_TEST.OBJ SIG_PROC_BUILD_TEST.OBJ SPARSE_BUILD_TEST.OBJ VLIB_BUILD_TEST.OBJ SYS$COMMON:[SYSHLP.EXAMPLES.CXML] EXAMPLE_ITSOL_1.C EXAMPLE_ITSOL_1.CXX EXAMPLE_ITSOL_1.FOR EXAMPLE_ITSOL_2.FOR EXAMPLE_ITSOL_3.FOR EXAMPLE_ITSOL_4.FOR EXAMPLE_ITSOL_5.FOR EXAMPLE_LAPACK_1.C EXAMPLE_LAPACK_1.FOR EXAMPLE_LAPACK_2.FOR EXAMPLE_SFFT_1D_2.C EXAMPLE_SFFT_2D_2.C EXAMPLE_SKYSOL_1.C EXAMPLE_SKYSOL_1.CXX EXAMPLE_SKYSOL_1.FOR EXAMPLE_SKYSOL_2.FOR (continued on next page) Compaq Fortran and CXML Files A-7 Table_A-2_(Cont.)__Files_Installed_by_the_CXML_Kit_________ CXML_______________________________________________________ EXAMPLE_SKYSOL_3.FOR EXAMPLE_SKYSOL_4.FOR EXAMPLES_SIG_PROC.FOR READ_ME.INDEX______________Road_map_for_the_examples_______ A-8 Compaq Fortran and CXML Files