DIGITAL_Fortran_____________________________________ Installation Guide for DIGITAL UNIX Systems Order Number: AA-PW82D-TE September 1997 This guide describes how to install DIGITAL Fortran on an Alpha processor running the DIGITAL UNIX (formerly DEC OSF/1) operating system. It also describes how to read the online release notes. Revision/Update Information: This manual supersedes all previous versions of the DIGITAL Fortran and DIGITAL Fortran 90 installation guides for DIGITAL UNIX systems. Operating System: DIGITAL UNIX Version 4.0 (or higher; see Section 1.1) Software Version: DIGITAL Fortran Version 5.0 for DIGITAL UNIX Systems (or higher) Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ First Printing, February, 1993 Revised, September, 1994 Revised, March 1996 Revised, September, 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 1997. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: DEC, DEC OSF/1, DECwindows, DECsupport, DIGITAL Fortran, DIGITAL UNIX, VAX, VAX DOCUMENT, and the DIGITAL logo. The following are third-party trademarks: OSF and OSF/1 are registered trademarks of the Open Software Foundation, Inc. PostScript is a registered trademark of Adobe Systems, Inc. UNIX is a registered trademark licensed exclusively by X/Open Company Ltd. ZK6326 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-2 1.2 Registering Your Software License............. 1-3 1.3 Checking the Software Distribution Kit........ 1-4 1.4 Checking Installation Procedure Requirements.................................. 1-5 1.4.1 Login Privileges.......................... 1-5 1.4.2 Hardware Requirements..................... 1-5 1.4.3 Software Requirements..................... 1-5 1.4.4 Determining Which DIGITAL Fortran Subsets to Load................................... 1-7 1.4.5 Determining Disk Space Requirements....... 1-12 1.4.5.1 Checking Current Disk Space............. 1-14 1.4.5.2 Increasing Disk Space by Using Alternative Disks....................... 1-15 1.5 Installing from Media or Using RIS............ 1-16 1.6 Backing Up Your System Disk................... 1-17 1.7 Stopping the Installation..................... 1-17 1.8 Recovering from Installation Errors........... 1-17 Installing DIGITAL Fortran 2.1 Starting the Installation Procedure........... 2-1 2.1.1 Using CD-ROM Software Product Library Media for Local Installations............. 2-1 2.1.2 Using a RIS Distribution Area for Remote Installations............................. 2-3 2.2 Responding to Installation Prompts............ 2-4 2.2.1 Selecting DIGITAL Fortran Subsets......... 2-4 iii 2.2.2 Monitoring Displays During the Subset Loading Process........................... 2-6 3 After Installation 3.1 Running the Installation Verification Procedure (IVP)............................... 3-1 3.2 Deleting DIGITAL Fortran from Your System..... 3-2 3.3 Running DIGITAL Fortran Applications ......... 3-3 3.3.1 Shared Libraries ......................... 3-3 3.3.2 The Message Catalog ...................... 3-4 A Sample DIGITAL Fortran Version 5.n Listings A.1 Sample DIGITAL Fortran Installation........... A-1 A.2 Sample DIGITAL Fortran Installation Verification Procedure (IVP).................. A-4 Tables 1 Conventions Used in This Document......... ix 1-1 Required Subsets for DIGITAL Fortran Compilers................................. 1-7 1-2 DIGITAL Fortran Subset Sizes (Disk Space Requirements)............................. 1-13 iv _________________________________________________________________ Preface This guide explains how to install DIGITAL Fortran on an Alpha processor running the DIGITAL UNIX operating system. It also describes how to read the online release notes. This guide does not describe how to install the DIGITAL Parallel Software Environment, which is described in the DIGITAL High Performance Fortran 90 HPF and PSE Manual. You must install DIGITAL Fortran before you install any compilation components of DIGITAL Parallel Software Environment. The DIGITAL Fortran installation procedure creates directories subordinate to the /usr/lib/cmplrs and /usr/man directories and loads DIGITAL Fortran software. Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall DIGITAL Fortran for any other reason. Intended Audience This guide is intended for system administrators who install DIGITAL Fortran. The online release notes are intended for all users of DIGITAL Fortran (see Section 1.1). Structure of This Document This guide contains the following chapters and appendixes: o Chapter 1 describes the hardware and software requirements for DIGITAL Fortran installation and how to read the DIGITAL Fortran release notes. It also lists related procedures that you must complete before installing DIGITAL Fortran. v o Chapter 2 describes how to install DIGITAL Fortran. o Chapter 3 describes the Installation Verification Procedure (IVP) and how to remove DIGITAL Fortran from your system. It also describes the files you need to run DIGITAL Fortran applications. o Appendix A contains sample listings for an interactive DIGITAL Fortran installation and IVP. Associated Documentation In addition to this guide, the DIGITAL Fortran documentation set includes the following: o A language reference manual, either the DIGITAL Fortran Language Reference Manual (for the Fortran 90 language) or the DEC Fortran Language Reference Manual (for the Fortran 77 language). o A user manual, either the Digital Fortran 90 User Manual for Digital UNIX Systems or the DEC Fortran User Manual for DEC OSF/1 AXP Systems o A letter titled Read Before Installing or Using DIGITAL Fortran Version n.n for DIGITAL UNIX Systems (which is provided online on the CD-ROM) Please read this letter; it contains important information about installing DIGITAL Fortran that may not be included in this installation guide or in the release notes. The DIGITAL Fortran online release notes provide more information on this version of DIGITAL Fortran. You can view or print the release notes files located on the media CD-ROM (see Section 1.1) at any time. After installation, the release notes are installed in: /usr/lib/cmplrs/fort90/relnotes (DIGITAL Fortran 90 compiler) /usr/lib/cmplrs/fort/relnotes (DIGITAL Fortran 77 compiler) The DIGITAL Fortran online reference pages describe the DIGITAL Fortran software components. These reference pages include f90(1), f77(1), fpr(1), fsplit(1), intro(3f), intro(3hpf), and numerous section 3f and 3hpf reference pages. vi The DIGITAL UNIX documentation set includes online reference pages and hardcopy documentation on installing software and on aspects of the programming environment. You may want to refer to the DIGITAL UNIX Documentation Overview, Glossary, and Master Index, which includes a list of books in the programmer's subkit. The following manuals in the DIGITAL UNIX documentation set contain information relevant to installing software: o DIGITAL UNIX Installation Guide o DIGITAL UNIX System Administration o DIGITAL UNIX Software License Management o DIGITAL UNIX System Tuning and Performance Management o DIGITAL UNIX Network Configuration o DIGITAL UNIX Network Administration and Problem Solving o DIGITAL UNIX User's Guide Sending DIGITAL Your Comments on This Manual We welcome your comments on this or any other DIGITAL Fortran manual. You can send comments in the following ways: o Internet electronic mail: fortran_docs@zko.mts.dec.com o FAX: 603-884-0120 Attn: Languages Documentation, ZKO2-3 /K35 o A letter addressed to: Digital Equipment Corporation Languages Documentation, ZKO2-3/K35 110 Spit Brook Road Nashua, NH 03062-2698 USA o The online questionnaire form. Send the form located near the end of the online release notes to our Internet address or send it by Internet mail, FAX, or through the postal service. vii 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). For more information, see Section 1.8. Conventions Table 1 lists the conventions used in this document. viii Table_1_Conventions_Used_in_This_Document__________________ Convention_______Meaning___________________________________ # A pound sign (#) is the default superuser prompt. % A percent sign (%) is the default user prompt. In examples, a boxed symbol indicates that you must press the named key on the keyboard. Ctrl/C This symbol indicates that you must press the Ctrl key while you simultaneously press another key (in this case, C). # df /usr In interactive examples, typed user input Filesystem appears in a bold typeface. monospaced In text, this typeface indicates the exact name of a command, routine, partition, pathname, directory, or file. In interactive examples and other screen displays, this typeface indicates what appears on the screen. UPPERCASE The DIGITAL UNIX operating system lowercase differentiates between lowercase and uppercase characters. Literal strings that appear in text, examples, syntax descriptions, and function definitions must be typed exactly as shown. (continued on next page) ix Table_1_(Cont.)_Conventions_Used_in_This_Document__________ Convention_______Meaning___________________________________ setld(8) Cross-references to online reference pages include the appropriate section number in parentheses. For example, setld(8) indicates that you can find the material on the setld command in Section 8 of the reference pages. [y] In a prompt, square brackets indicate that the enclosed item is the default response. For example, [y] means the default response is Yes. DEC OSF/1, References to DEC OSF/1 and DIGITAL UNIX DIGITAL UNIX refer to the same operating system. DEC Fortran References to DEC Fortran and DEC Fortran DEC Fortran 90 90 refer to the merged DIGITAL Fortran DIGITAL Fortran product. For more information, see the Read Before Installing or Using DIGITAL Fortran Version n.n for DIGITAL UNIX _________________Systems.__________________________________ Unless otherwise noted, press the Return key after entering commands or responses to command prompts. In this manual, some version numbers are given as "Vn.n" or (in subset identifiers) "nnn". When you install DIGITAL Fortran, the actual version numbers appear on your screen. x 1 _________________________________________________________________ Preparing for DIGITAL Fortran Installation DIGITAL now provides two separate compilers (DIGITAL Fortran 77 and DIGITAL Fortran 90) under one license and one name (DIGITAL Fortran). You can choose to 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 provides the following information to make your installation run smoothly: o Using the media CD-ROM to read the online Release Notes and "read first" cover letter (Section 1.1) o How to register your Software License (Section 1.2) o How to determine if your distribution kit is complete (Section 1.3) o How long it takes to install DIGITAL Fortran (Section 1.4) o What system privileges you need for installing DIGITAL Fortran (Section 1.4.1) o How to determine if the system where you will install DIGITAL Fortran meets the hardware and software requirements (Sections 1.4.2 and 1.4.3) o Which DIGITAL Fortran subsets you must install and which are optional (Section 1.4.4) o How much disk space you will need for installing DIGITAL Fortran (Section 1.4.5) o How to determine if you must install DIGITAL Fortran from distribution media or if you can use the Remote Installation Service (RIS) (Section 1.5) o Whether you should back up your system disk before the installation (Section 1.6) Preparing for DIGITAL Fortran Installation 1-1 o How to stop the installation procedure (Section 1.7) o How to recover from installation errors (Section 1.8) 1.1 The Software Product Library CD-ROM and Installation-Related Documentation Files The DIGITAL UNIX 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 documentation files in the /readme directory on the first media CD-ROM, including a CD user guide and master list of CD products o A cdmenu utility To determine whether the appropriate media CD-ROM is already mounted on your system, contact the appropriate system administrator. DIGITAL Fortran provides online release notes and a "read first" cover letter. The release notes and cover letter are provided on the media CD-ROM set in the DIGITAL Fortran product documentation subdirectory. To obtain the location of the DIGITAL Fortran main product directory on the appropriate media CD-ROM, do one of the following: o Use the cdmenu utility provided on the media CD-ROM. o View the CD master index file on the media CD-ROM. o Contact the appropriate system administrator. For information about using the cdmenu utility and the CD files on the media CD-ROM set, see the Software Product Library CD-ROM User's Guide (CD user guide), which accompanies the media CD-ROM distribution kit. The CD user guide and CD master index file are provided as online files in the /readme directory on the first media CD-ROM. 1-2 Preparing for DIGITAL Fortran Installation DIGITAL strongly recommends that you read the online release notes and the "read first" 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 DIGITAL UNIX Alpha operating system required for this release of DIGITAL Fortran. The online release notes list the subset numbers for this DIGITAL Fortran version. Once the appropriate media CD-ROM has been mounted (see Section 2.1.1) and the appropriate DIGITAL Fortran documentation subdirectory located, use an ls command to determine the file name of the DIGITAL Fortran cover letter and release notes. You can view or print the release notes, the cover letter, and this installation guide at any time from the media CD-ROM. To read the DIGITAL Fortran documentation files, do one of the following: o Use a more or view command to display the ASCII version of the online documentation files on your screen o Use an lpr command to print the ASCII or PostScript version of the online documentation files to a printer After installation, the release notes for DIGITAL Fortran are in the following files: /usr/lib/cmplrs/fort90/relnotes /usr/lib/cmplrs/fort/relnotes 1.2 Registering Your Software License DIGITAL Fortran includes support for the License Management Facility (LMF). You must register your License Product Authorization Key (License PAK) in the License Database (LDB) in order to use DIGITAL Fortran on a newly-licensed node. 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. Preparing for DIGITAL Fortran Installation 1-3 If you are installing DIGITAL Fortran as an update on a node already licensed for this software, you have already completed the License PAK registration requirements. To register a license for DIGITAL UNIX, follow these steps: 1. Log in as superuser. 2. At the superuser prompt, enter the following command to edit your License PAK: # lmf register An empty PAK template is displayed in a text editor (vi by default). Enter all the information from your License PAK form. 3. After you register your license, use the following command to copy the license details from the LDB to the kernel cache: # lmf reset For complete information on using the License Management Facility, see the DIGITAL UNIX Software License Management and the lmf(8) reference page. 1.3 Checking the Software Distribution Kit Use the Parts List to check the contents of your DIGITAL UNIX Software Product Library CD-ROM software distribution kit. The software distribution kit is ordered separately from DIGITAL Fortran and includes the following: o One or more CD-ROM optical disks containing DIGITAL UNIX layered products (media CD-ROM set) o A CD-ROM read first letter If your software distribution kit is damaged or incomplete, contact your DIGITAL representative. 1-4 Preparing for DIGITAL Fortran Installation 1.4 Checking Installation Procedure Requirements Section 1.4.1 through Section 1.4.5 discuss various requirements for installing DIGITAL Fortran. Installing DIGITAL Fortran, including running the Installation Verification Procedure (IVP), takes approximately 10 to 15 minutes, depending on your type of media and system configuration. 1.4.1 Login Privileges You must have superuser privileges to install the DIGITAL Fortran software and to register the license PAK. 1.4.2 Hardware Requirements To install DIGITAL Fortran, you need the following hardware: o Software distribution device (if installing from media) Locate an available drive for the CD-ROM software distribution media. The documentation for the CD-ROM drive you are using explains how to insert the media CD-ROM. o Terminal You can use either a hardcopy or video terminal to communicate with the operating system and respond to prompts from the installation procedure. For additional hardware requirements, see the DIGITAL Fortran Software Product Description (SPD). 1.4.3 Software Requirements DIGITAL Fortran Version 5.n requires DIGITAL UNIX Version 4.0 (or higher). Future releases of DIGITAL Fortran may require higher DIGITAL UNIX versions. For information about the minimum version of the operating system required, see the online release notes or the Read Before Installing or Using DIGITAL Fortran Version n.n for DIGITAL UNIX Systems letter (see Section 1.1). Preparing for DIGITAL Fortran Installation 1-5 DIGITAL Fortran also requires that the following DIGITAL UNIX subsets be loaded on the system where you install DIGITAL Fortran: o OSFBASE - the "Base System" subset o OSFCMPLRS - the "Compiler Back End" subset o OSFPGMR - the "Software Development Environment" subset ________________________ Note ________________________ Beginning with DIGITAL UNIX Version 4.0, the OSFCMPLRS subset now consists of the following multiple subsets: o OSFCMPLRS (required for program development) o OSFSDE (profiling tools) o OSFLIBA (archive libraries) o OSFINCLUDE (include files) o OSFATOM (atom tools) Some of these subsets may require a separate license. For more information, see the DIGITAL UNIX Installation Guide for your version of the DIGITAL UNIX operating system. ______________________________________________________ To install the DIGITAL Fortran reference pages (manual pages), the following DIGITAL UNIX software subsets must be installed on the system where you install DIGITAL Fortran: o OSFMANOS - the "Admin/User" online manual pages o OSFMANOP - the "Programming" online manual pages o OSFDCMT - the document preparation software To check whether these subsets are loaded, follow these steps: 1. Log in to the system where you will install DIGITAL Fortran. 2. Enter the following command: # setld -i | egrep 'OSFBASE|OSFCMPLRS|OSFPGMR|OSFMANOS|OSFMANOP|OSFDCMT' 1-6 Preparing for DIGITAL Fortran Installation If you do not log in as superuser (login name root), you must enter the full path of the command. For example: % /usr/sbin/setld -i | grep OSFBASE Check the displayed rows for the name of the relevant subset and any related patches. The word "installed" appears in a row after the subset identifier when a subset is loaded. If the word "installed" does not appear (the second column in a row is blank), the subset or patch is not loaded. In this case, you must load the missing DIGITAL UNIX software before installing DIGITAL Fortran. (For information on how to load DIGITAL UNIX operating system software, see the DIGITAL UNIX Installation Guide.) 1.4.4 Determining Which DIGITAL Fortran Subsets to Load You must choose the DIGITAL Fortran subsets you want to load. There are two compilers in the DFABASE subset. Table 1-1 indicates which subsets are required to use each compiler. Table_1-1_Required_Subsets_for_DIGITAL_Fortran_Compilers___ DIGITAL Fortran Subset_Name___90_and_77__________DIGITAL_Fortran_90_only___ DFABASE Required DFACOM Required DFADOC Required DFARTL Required OTABASE Required PSESHPF__________________________Required__________________ You can choose to install both compilers, which allows you to use either compiler at compile-time. In the subset identifiers starting with "DFA", the nnn represents the version number of DIGITAL Fortran 90 and 77. In the subset identifier DFARTLnnn and PSESHPFnnn, the nnn represents the current version of those subsets. Preparing for DIGITAL Fortran Installation 1-7 The subsets have the following identifiers and titles: o DFABASEnnn (title: DIGITAL Fortran 90 and 77 Vn.n for DIGITAL UNIX Systems) This is the primary subset for DIGITAL Fortran and depends on DFARTLnnn and PSESHPFnnn. You must install this subset to compile, link, and run Fortran programs using either DIGITAL Fortran 90 or DIGITAL Fortran 77 programs. This subset installs its files in the following directories: /usr/lib/cmplrs/fort90 /usr/lib/cmplrs/fort /usr/lib/cmplrs /usr/bin /usr The directory /usr/lib/cmplrs/fort90 is a symbolic link to the directory /usr/lib/cmplrs/fort90_nnn. The directory /usr/lib/cmplrs/fort is a symbolic link to the directory /usr/lib/cmplrs/fort_nnn. o DFACOMnnn (title: DIGITAL Fortran Vn.n Tools & their Man Pages) This subset contains: - All unformatted Section 3f reference pages - All include files (such as /usr/include/foriosdef.f) - Certain DIGITAL Fortran utilities and their reference pages (such as fsplit) - Libraries required by certain 3f library routines If disk space is a concern, you can omit installing this subset. This subset and its files are used by DIGITAL Fortran 77 (f77 command). This subset installs its files in the following directories: /usr/bin /usr/include /usr/lib /usr/shlib /usr/man/man1 1-8 Preparing for DIGITAL Fortran Installation /usr/man/man3 Preparing for DIGITAL Fortran Installation 1-9 o DFADOCnnn (title: DIGITAL Fortran Vn.n Release Notes and Man Pages) This subset contains: - The online release notes for DIGITAL Fortran 90 and 77 - The f90(1) reference page - The f77(1) reference page - A list of files in the DIGITAL Fortran kit (file /usr /lib/cmplrs/fort90/filelist) Because the f90(1) and f77(1) reference pages and the DIGITAL Fortran 90 and 77 release notes must be available to programmers using DIGITAL Fortran, you should load this subset. To view these files before proceeding with the DIGITAL Fortran installation, you can choose to install this subset first. This subset installs its DIGITAL Fortran 90 files in the directory /usr/lib/cmplrs/fort90, a symbolic link to the directory /usr/lib/cmplrs/fort90_nnn. Similarly, this subset installs its DIGITAL Fortran 77 files in the /usr/lib/cmplrs/fort directory, a symbolic link to the directory /usr/lib/cmplrs/fort_nnn. o DFARTLnnn (title: DIGITAL Fortran RTL for DIGITAL UNIX Alpha Runtime Support) This subset supports both DIGITAL Fortran 77 and DIGITAL Fortran 90 and contains: - Static and shared versions of the DIGITAL Fortran runtime libraries - The DIGITAL Fortran message catalog This subset (or a higher version) is a prerequisite for the DFABASEnnn subset. Always choose this subset if it appears in your menu and if you are also installing DFABASEnnn. During the DIGITAL Fortran installation procedure, if you choose DFARTLnnn, it will not be installed if there is already a more recent version on your system. 1-10 Preparing for DIGITAL Fortran Installation This subset installs files in the following directories: /usr/lib/nls/msg/en_US.ISO8859-1 /usr/lib/cmplrs/fortrtl /usr/lib/cmplrs /usr/lib /usr/shlib The directory /usr/lib/cmplrs/fortrtl is a symbolic link to the directory /usr/lib/cmplrs/fortrtl_nnn. o OTABASEnnn (title: DIGITAL Compiled Code Support Library) This subset contains libraries required to support parallel directives. The subset installs its files in the following directories: /usr/lib/cmplrs /usr/lib/cmplrs/o3abase_nnn /usr/shlib o PSESHPFnnn (title: High Performance Fortran Scalar Libraries) This subset contains: - The nonparallel (serial) version of the High Performance Fortran (HPF) run-time library - Associated reference pages for HPF_LIBRARY and HPF_ LOCAL_LIBRARY, including intro(3hpf) ________________________ Note ________________________ You must install the PSESHPFnnn subset to compile, link, and run Fortran programs using DIGITAL Fortran 90. ______________________________________________________ The parallel and parallel profiling versions of this library are installed with the DIGITAL Parallel Software Environment kit. This subset installs its files in the following directories: /usr/lib/cmplrs/hpfrtl_nnn /usr/lib/cmplrs/hpfrtl /usr/lib Preparing for DIGITAL Fortran Installation 1-11 /usr/shlib /usr/man/man3 The directory /usr/lib/cmplrs/hpfrtl is a symbolic link to the directory /usr/lib/cmplrs/hpfrtl_nnn. Because the DFACOMnnn and DFADOCnnn subsets contain reference pages, you can load them only if the appropriate DIGITAL UNIX reference pages subsets are already loaded on your system (see Section 1.4.3). Users on the system where DIGITAL Fortran is being installed can use reference pages that are nfs mounted from another system. If so, consider loading the reference pages subsets only on the other system (not the system where you are installing DIGITAL Fortran). When reference pages are nfs mounted on another system, do not request the DFACOMnnn and DFADOCnnn subsets during the DIGITAL Fortran installation. After the installation is complete, you can log in to the system where the reference pages are installed and load only the DIGITAL Fortran DFACOMnnn and DFADOCnnn subsets on that system. In addition to being supplied with DIGITAL Fortran, some or all of these subsets are included on the DIGITAL UNIX operating system CD-ROM distribution media (see Section 3.3). For information about loading specific subsets, see the setld(8) reference page. 1.4.5 Determining Disk Space Requirements Table 1-2 lists the disk space requirements for loading DIGITAL Fortran software subsets. These disk space requirements apply to the disks where you load the DIGITAL Fortran subsets. The disk space requirements are listed by directory, in case you are doing installations on systems where these directories are mount points for different disk partitions. 1-12 Preparing for DIGITAL Fortran Installation Table 1-2 DIGITAL Fortran Subset Sizes (Disk Space __________Requirements)____________________________________ Kbytes Subset_Name__Directory__________________________Required___ DFABASEnnn /usr 1 /usr/bin 1 /usr/lib/cmplrs 1 /usr/lib/cmplrs/fort90_nnn 11915 /usr/lib/cmplrs/fort_nnn _6045 Total: 17963 DFACOMnnn /usr/bin 110 /usr/include 52 /usr/man/man1 5 /usr/man/man3 180 /usr/lib 360 /usr/shlib ___30 Total: 737 DFADOCnnn /usr/lib/cmplrs/fort_nnn 340 /usr/lib/cmplrs/fort90_nnn __400 Total: 780 DFARTLnnn /usr/lib 1 /usr/lib/cmplrs 1 /usr/lib/cmplrs/fortrtl_nnn 2648 /usr/lib/nls/msg/en_US.ISO8859-1 1 /usr/shlib ____1 Total: 2652 OTABASEnnn /usr/lib/cmplrs 1 /usr/lib/cmplrs/o3abase_nnn 140 /usr/shlib ____1 Total: 142 PSESHPFnnn /usr/lib 1 /usr/lib/cmplrs/hpfrtl 1 /usr/lib/cmplrs/hpfrtl_nnn 1250 (continued on next page) Preparing for DIGITAL Fortran Installation 1-13 Table 1-2 (Cont.) DIGITAL Fortran Subset Sizes (Disk Space __________________Requirements)____________________________ Kbytes Subset_Name__Directory__________________________Required___ /usr/man/man3 1 /usr/shlib ____1 Total: 1254 _____ ___________________________Grand_Total:_________23528______ Using these disk space requirements, total the values for the subsets you will load in each directory. Compare the space required for subsets with the free space currently on the disks where DIGITAL Fortran files will reside. If you need precise information on the sizes of individual DIGITAL Fortran files in the various directories, view the file /usr/lib/cmplrs/fort90/filelist or the file /usr/lib /cmplrs/fort/filelist. 1.4.5.1 Checking Current Disk Space To check the current amount of free space for a directory path, log in to the system where you will install DIGITAL Fortran. You can check which directories are mounted and where they are by viewing the /etc/fstab file. For example: # more /etc/fstab /dev/rd0a:/:rw:1:1:ufs:: /dev/rd0g:/usr:rw:1:2:ufs:: /usr/staff/r1/leslie@bigsys:/usr/staff/r1/leslie:rw:0:0:nfs:bg: /usr/man@bigsys:/usr/man:ro:0:0:nfs:bg: This display indicates that /usr (mounted to /dev/rd0g) is the only mount point that affects where DIGITAL Fortran files will reside; the system has only one local disk drive, and the /usr/lib and /usr/lib/cmplrs file systems reside in the g partition of the disk on that drive. 1-14 Preparing for DIGITAL Fortran Installation To check total space and free space for the directories where DIGITAL Fortran files will reside, enter the df command. In the case of the previous display of the /etc /fstab file, which shows that only /usr is a mount point, you need to check free space only in the /usr file system, as follows: # df /usr Filesystem Total kbytes kbytes % node kbytes used free used Mounted on /dev/rd0g 122598 54447 55892 49% /usr This display indicates there are 55892 Kbytes free. This free space must accommodate the subset requirements listed in Table 1-2. On systems where /usr/lib and /usr/man are mounted to different devices from /usr, enter the following command: # df /usr/lib /usr/man In this case, you would compare space required for DIGITAL Fortran files in /usr/lib with the free space displayed in the first line of the df output list. You would compare the space required for DIGITAL Fortran files in /usr/man with the free space displayed in the second line of that list. 1.4.5.2 Increasing Disk Space by Using Alternative Disks The DIGITAL Fortran installation procedure creates some directories and loads files into subordinate directories, as listed in either of the following files: /usr/lib/cmplrs/fort90/filelist /usr/lib/cmplrs/fort/filelist If the /usr/lib/cmplrs directory does not exist, the DIGITAL Fortran installation procedure creates it; if this directory does exist, the installation procedure uses it. If you find that there is insufficient disk space for the DIGITAL Fortran subsets and if you know that there is additional space on other disks or disk partitions for your system, take the following steps before installing DIGITAL Fortran: 1. Log in as superuser (login name root) to the system where you will install DIGITAL Fortran. Preparing for DIGITAL Fortran Installation 1-15 2. Create one or both of the appropriate directories: o /usr/lib/cmplrs/fort90_nnn o /usr/lib/cmplrs/fort_nnn Directory /usr/lib/cmplrs/fort90 is a symbolic link to the directory /usr/lib/cmplrs/fort90_nnn. Directory /usr/lib/cmplrs/fort is a symbolic link to the directory /usr/lib/cmplrs/fort_nnn. (In these directory names, nnn is the DIGITAL Fortran version number.) 3. Specify in the /etc/fstab file that one or more of the newly created directories are mount points to new disk partitions where there is additional space. 4. Enter the mount -a command so that the new mount points take effect. 1.5 Installing from Media or Using RIS Someone from your site must perform at least one DIGITAL Fortran installation from the distribution medium. Your site system administrator can then decide whether or not to make a DIGITAL Fortran distribution kit available online, so that subsequent installations of DIGITAL Fortran can use the Remote Installation Service (RIS). For information on extracting DIGITAL Fortran subsets to a RIS distribution area, see your DIGITAL UNIX system management documentation. If you expect to use DIGITAL Fortran subsets from a RIS area of a remote system for installation on your local system, first check with your site system administrator to ensure the following: o A DIGITAL Fortran network kit is available for use. o Your system is registered as a RIS client. For more information on installing DIGITAL Fortran from a RIS distribution area, see Section 2.1.2. 1-16 Preparing for DIGITAL Fortran Installation 1.6 Backing Up Your System Disk DIGITAL recommends that you back up your system disk before installing DIGITAL Fortran or any software. Use the backup procedures established at your site. For information about backing up your system disk, see the DIGITAL UNIX system documentation. 1.7 Stopping the Installation To stop the installation procedure at any time, enter Ctrl /C. You must then delete files created interactively up to this point. The directories and files created during the DIGITAL Fortran installation are listed in the following files: /usr/lib/cmplrs/fort90/filelist /usr/lib/cmplrs/fort/filelist 1.8 Recovering from Installation Errors If errors occur during the installation, the system displays appropriate error messages. For example, if the installation of the DFABASEnnn subset fails due to insufficient disk space, the installation procedure displays the following message: There is not enough space for subset DFABASEnnn DIGITAL Fortran (DFABASEnnn) will not be loaded. Errors can occur during the installation if any of the following conditions exist: o The operating system version is incorrect. o The prerequisite software version is incorrect. o The system parameter values for successful installation are insufficient. For descriptions of error messages generated by these conditions, see the DIGITAL UNIX documentation on system messages and software installation. If any of these conditions exist, take the appropriate action described in the message. For information on system requirements for installing DIGITAL Fortran, see Section 1.4.3. Preparing for DIGITAL Fortran Installation 1-17 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: 1. The name and version number of the operating system you are using 2. The name and version number of DIGITAL Fortran you are using 3. The hardware system you are using (such as a model number) 4. Whether or not the problem is critical 5. 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 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). For information about submitting media, see the tar(1) reference page. 1-18 Preparing for DIGITAL Fortran Installation 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. If the problem is related to DIGITAL Fortran documentation, you can use the Internet mail address or FAX number listed on the "Send Us Your Comments" section in the front of this guide. Preparing for DIGITAL Fortran Installation 1-19 2 _________________________________________________________________ Installing DIGITAL Fortran This chapter describes how to install DIGITAL Fortran, as follows: o How to install your kit locally using CD-ROM media (Section 2.1.1) o How to install your kit remotely using a RIS distribution area (Section 2.1.2) o How to respond to installation prompts (Section 2.2) Before you start the installation, read Chapter 1, which describes the requirements and general options for installing DIGITAL Fortran using the media CD-ROM. 2.1 Starting the Installation Procedure DIGITAL Fortran can be installed locally (using CD-ROM media) or from a server area. 2.1.1 Using CD-ROM Software Product Library Media for Local Installations The installation procedure loads DIGITAL Fortran files on to a disk belonging to the system where you perform the installation. When DIGITAL Fortran is run, its executable images are mapped into memory on your system. Follow these steps to install DIGITAL Fortran from the Software Products Library CD-ROM set: 1. To obtain the kit directory location of the DIGITAL Fortran subsets on the appropriate 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 master index file on the media CD-ROM o Contact the appropriate system administrator Installing DIGITAL Fortran 2-1 For information about using the cdmenu utility and the CD 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 master index file are provided as online files in the /readme directory on the first media CD-ROM. 2. If the media CD-ROM containing the DIGITAL Fortran installation files is not mounted, either contact the appropriate system administrator or insert the appropriate media CD-ROM into an available CD-ROM drive. 3. Log in as superuser (login name root) to the system where you will install DIGITAL Fortran. 4. Make sure you are at the root directory (/) by entering the following command: # cd / 5. Find out whether a previous version of DIGITAL Fortran is installed by entering the following commands: # setld -i | egrep 'PSESH|DFA' If the directory /usr/sbin is not in your path, specify the path before the setld command (/usr/sbin/setld). If a version of DIGITAL Fortran is not installed, skip to the next step. If multiple versions of the same subset exist, consider deleting the older versions. Before you delete the older subset versions, you might make sure that Fortran programmers using the system no longer need the older versions. For example, if the subset names DFABASE, DFADOC, and PSESHPF are displayed and are no longer needed, enter the following command. (In these subset names, nnn is the version number of the old subsets.) # setld -d DFABASEnnn DFADOCnnn PSESHPFnnn This command deletes the previous versions of the DIGITAL Fortran subsets. For example, you might remove older subset versions from the system when you install a more recent version of DIGITAL Fortran. 2-2 Installing DIGITAL Fortran For more information on deleting subsets for previous versions before continuing the installation (including DIGITAL Fortran subsets also used by other products), see Section 3.2. 6. Specify the /mnt directory to be the mount point for the distribution file system on the drive. If your drive is rz1, enter the following command: # mount -dr /dev/rz1c /mnt Once you mount the media CD-ROM, you can print or view the release notes and the "read first" cover letter, as described in Section 1.1. 7. To verify the location of the DIGITAL Fortran main product directory on the appropriate media CD-ROM, type an ls command (see step 1), such as the following: # ls /mnt/product-directory/kit 8. Enter a setld command that requests the load function (-l option) and identifies the directory in the mounted file system where DIGITAL Fortran Version 5.n subsets are located: # setld -l /mnt/product-directory/kit Where product-directory is the main DIGITAL Fortran directory listed in the CD user guide and CD master index file (such as dfa500). The installation procedure now displays the names of DIGITAL Fortran subsets and asks you to specify the subsets you want to load. See Section 2.2 to continue the installation. 2.1.2 Using a RIS Distribution Area for Remote Installations If you are installing DIGITAL Fortran subsets that reside in an /etc/ris (RIS) distribution area on a remote system, follow these steps: 1. Log in as superuser (login name root) to the system where you will install DIGITAL Fortran. Installing DIGITAL Fortran 2-3 2. Make sure you are at the root directory (/) by entering the following command: # cd / 3. Enter a setld command that requests the load function (-l option) and identifies the system where the DIGITAL Fortran subsets are located. For example, if you are loading DIGITAL Fortran subsets from a RIS distribution area on node orion, enter the following: # setld -l orion: Remote Installation Services now displays a menu that lists all the software subsets available to you and asks you to specify the subsets you want to load. See Section 2.2 to continue the installation. 2.2 Responding to Installation Prompts This section explains the installation procedure prompts and displays. Examples in this section use generic version numbers, such as "Vn.n" or (in subset identifiers) "nnn". During installation, the actual version numbers will appear on your screen. 2.2.1 Selecting DIGITAL Fortran Subsets After you mount the media CD-ROM (for a local installation) and use setld to load and identify where the DIGITAL Fortran subsets are located, specify which DIGITAL Fortran subsets you want to load. ________________________ Note ________________________ If you are installing from a RIS distribution area, the numbers of the DIGITAL Fortran subsets can vary depending on what products are available in the RIS area and how many subsets they have. ______________________________________________________ 2-4 Installing DIGITAL Fortran The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) DIGITAL Compiled Code Support Library #nnn 2) DIGITAL Fortran 90 and 77 V5.n for DIGITAL UNIX Alpha Systems 3) DIGITAL Fortran RTL #nnn for DIGITAL UNIX Alpha Systems (f90 and f77) 4) DIGITAL Fortran V5.n Release Notes and Man Page 5) DIGITAL Fortran V5.n Tools & their Man Pages 6) High Performance Fortran Scalar Libraries Or you may choose one of the following options: 7) ALL of the above 8) CANCEL selections and redisplay menus 9) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): The actual display shown on your system might not include certain lines if you have a recent version of DIGITAL Fortran 77 or DIGITAL Fortran 90 installed. For example, if the same version of the "DIGITAL Fortran RTL #nnn for DIGITAL UNIX Alpha" (subset DFARTL) on the DIGITAL Fortran kit has already been installed, that line will not be displayed. The following text in this section assumes this is a new installation and all lines are displayed as shown above. To compile and run Fortran 77 programs using the DIGITAL Fortran 77 tools, you must choose subset numbers 2, 3, and 5. To compile and run Fortran programs using the DIGITAL Fortran 90 tools, you must choose subset numbers 2, 3, 5, and 6. To use parallel directives for either set of tools, you must also choose subset number 1. To install only the online release notes without installing DIGITAL Fortran, choose subset number 4. Installing DIGITAL Fortran 2-5 If you specify more than one number at the prompt, use spaces (not commas) to separate the numbers. Enter 7 to install all of the listed subsets. ________________________ Note ________________________ The "DIGITAL Compiled Code Support Library" (OTABASE subset) is once again provided on the DIGITAL Fortran kit. This subset contains libraries required to support parallel directives. If a newer version of these libraries already exists on you system, the installation will not override them. ______________________________________________________ Next, the procedure lets you verify your choice. For example, if you enter 8 in response to the previous prompt, the following display appears: You are installing the following optional subsets: DIGITAL Compiled Code Support Library #nnn DIGITAL Fortran 90 and 77 V5.n for DIGITAL UNIX Alpha Systems DIGITAL Fortran RTL #nnn for DIGITAL UNIX Alpha Systems (f90 and f77) DIGITAL Fortran V5.n Release Notes and Man Page DIGITAL Fortran V5.n Tools & their Man Pages High Performance Fortran Scalar Libraries Is this correct? (y/n): If the displayed subsets are not the ones you intended to choose, enter n. In this case, the subset selection menu is again displayed, and you can correct your choice of optional subsets. If the displayed subsets are the ones you want to load, enter y. 2.2.2 Monitoring Displays During the Subset Loading Process The installation procedure loads and verifies the selected DIGITAL Fortran subsets. The following example shows a display where all DIGITAL Fortran Version 5.n subsets are being loaded from the media CD-ROM: 2-6 Installing DIGITAL Fortran Checking file system space required to install selected subsets: File system space checked OK. 7 subset(s) will be installed. Loading 1 of n subset(s).... Copyright (c) Digital Equipment Corporation, 1995, 1996. All Rights Reserved. Parallel Software Environment for Digital UNIX V1.n-n Subset: High Performance Fortran Scalar Libraries (PSESHPFnnn) Starting installation at Tue Jul 8 13:53:37 EDT 1997. There are no installation questions for this subset. High Performance Fortran Scalar Libraries Copying from . (disk) Verifying Loading 2 of n subset(s).... DIGITAL Compiled Code Support Library #nnn Copying from . (disk) Verifying Loading 3 of n subset(s).... DIGITAL Fortran RTL #nnn for DIGITAL UNIX Alpha Systems (f90 and f77) Copying from . (disk) Working....Tue Jul 8 13:54:00 EDT 1997 Verifying Loading 4 of n subset(s).... DIGITAL Fortran 90 and 77 V5.n for DIGITAL UNIX Alpha Systems Copying from . (disk) Working....Tue Jul 8 13:54:23 EDT 1997 Verifying Loading 5 of n subset(s).... DIGITAL Fortran V5.n Tools & their Man Pages Copying from . (disk) Verifying Loading 6 of n subset(s).... Copyright Digital Equipment Corporation 1992,1997. All rights reserved Installing DIGITAL Fortran 2-7 Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. DIGITAL Fortran V5.n Release Notes and Man Page Copying from . (disk) Verifying n of n subset(s) installed successfully. Creating softlinks for PSESHPFnnn ... Parallel Software Environment for Digital UNIX V1.0-7 Subset: High Performance Fortran Scalar Libraries (PSESHPFnnn) Installation completed at Tue Jul 8 13:56:02 EDT 1997. Configuring "High Performance Fortran Scalar Libraries" (PSESHPFnnn) Copyright (c) Digital Equipment Corporation, 1995, 1996. All Rights Reserved. Parallel Software Environment for Digital UNIX V1.0-7 Subset: High Performance Fortran Scalar Libraries (PSESHPFnnn) Starting configuration (INSTALL) at Tue Jul 8 13:56:03 EDT 1997. Completing configuration (INSTALL) at Tue Jul 8 13:56:03 EDT 1997. Configuring "DIGITAL Compiled Code Support Library #nnn" (OTABASEnnn) OTABASEnnn, information: Shared library installed. Configuring "DIGITAL Fortran RTL #nnn for DIGITAL UNIX Alpha Systems (f90 and f77)" (DFARTLnnn) DFARTLnnn, information: Shared libraries installed. DFABASE5nn, information: You can run the Installation Verification Procedure using the following command from root: setld -v DFABASE5nn Configuring "DIGITAL Fortran 90 and 77 V5.n for DIGITAL UNIX Alpha Systems" (DFABASE5nn) Configuring "DIGITAL Fortran V5.n Tools & their Man Pages" (DFACOM5nn) 2-8 Installing DIGITAL Fortran DFADOC5nn, information: The f77 release notes are in ./usr/lib/cmplrs/fort/relnotes and the f90 release notes are in ./usr/lib/cmplrs/fort90/relnotes90 Configuring "DIGITAL Fortran V5.n Release Notes and Man Page" (DFADOC5nn) When you see the "Verifying" message during the subset installation, the installation procedure is checking to see that the files are copied correctly; it is not an IVP message. This sample installation shows Version 5.n subset numbers and the CD-ROM subset directory /mnt/dfa5nn/kit (where the DIGITAL Fortran subsets are located on the locally mounted media CD-ROM). When installing a version after Version 5.n, the displayed numbers for the subsets, version, and subset directory will differ. The subset numbers are listed in the online release notes (see Section 1.1). During the installation, if you get errors from the setld utility, see the Diagnostics section of the setld(8) reference page for an explanation of the errors and the appropriate actions to take. Chapter 3 explains how to run the Installation Verification Procedure (IVP) after installation and how to delete old DIGITAL Fortran subsets before installing a new version of DIGITAL Fortran. Installing DIGITAL Fortran 2-9 3 _________________________________________________________________ After Installation This chapter describes the following tasks performed after installing DIGITAL Fortran: o How to run the Installation Verification Procedure (Section 3.1) o How to delete DIGITAL Fortran from your system (Section 3.2) It also describes the files you need to run DIGITAL Fortran applications (Section 3.3). 3.1 Running the Installation Verification Procedure (IVP) After installing DIGITAL Fortran, you can run the Installation Verification Procedure (IVP) independently to verify that the software is available on your system. You might also want to run the IVP after a system failure to be sure that users can access DIGITAL Fortran. The IVP verifies the installation by using the fverify command with the -y option (see the fverify(8) reference page). Depending on which DIGITAL Fortran subsets you specify on the setld -v command line, the following checks might occur: o For the DFABASEnnn subset, the IVP first compiles, links, and runs a Fortran program with DIGITAL Fortran 77 tools, and then compiles, links, and runs a Fortran program with DIGITAL Fortran 90 tools. o For other subsets, the IVP verifies that certain files are present. For instance, the DFARTLnnn and PSESHPFnnn subsets verify that the runtime libraries exist. After Installation 3-1 To run the IVP after an installation, enter the following command: # setld -v subset-name In this command, subset-name can be any DIGITAL Fortran subset, such as DFABASEnnn and DFADOCnnn. (For nnn, substitute the appropriate version number). For a sample listing of the DIGITAL Fortran IVP, see Appendix A. If the verification process fails, look in the /var/adm/smlogs/fverify.log file for information to help diagnose the problem. 3.2 Deleting DIGITAL Fortran from Your System If you must remove a version of DIGITAL Fortran from your system, delete each subset that you previously installed. To delete subsets: 1. Log in as superuser (login name root). 2. Make sure you are at the root directory (/) by entering the following command: # cd / 3. Enter the following form of the setld command: # setld -i | egrep 'PSESH|DFA' 4. Look for the word "installed" in the listing produced. You can delete any subset names displayed in response to the previous command, especially older versions if multiple versions exist. For example: # setld -d PSESHPFnnn DFABASEnnn DFADOCnnn DFACOMnnn In this command, nnn is the version number (400 for Version 4.0 for example). For example, to delete the DIGITAL Fortran Version 4.0 subsets after installing Version 5.n, type the following command: # setld -d DFABASE400 DFADOC400 DFACOM400 3-2 After Installation DIGITAL Fortran Version 4.n also has subsets, F9ABASE4nn and F9ADOC4nn. ________________________ Note ________________________ If you plan to run DIGITAL Fortran applications, do not delete the DFARTL subset (see Section 3.3). Before you delete the DFACOM and DFARTL subsets, be aware that the DIGITAL Fortran 90 and 77 product (DFABASE subset) uses these subsets. If you have one of these products installed and there is only one version of the subset on your system, do not delete that subset. If multiple versions of the same subset exist, before you delete the older versions, make sure that Fortran programmers using the system no longer need the older versions. ______________________________________________________ When you delete DIGITAL Fortran, the /usr/lib/cmplrs/fort90_nnn and /usr/lib/cmplrs/fort_nnn directories are deleted and symbolic links are removed. If you have another version of DIGITAL Fortran installed, then you must use the SELECT option to reestablish the symbolic links for the remaining version of DIGITAL Fortran for each subset deleted. For example, to reestablish the symbolic links for the DFABASEnnn subset: # setld -c DFABASEnnn SELECT 3.3 Running DIGITAL Fortran Applications You need DIGITAL Fortran shared libraries and the message catalog to run DIGITAL Fortran applications on your system. 3.3.1 Shared Libraries To run DIGITAL Fortran applications compiled with the default -call_shared flag, you must have the following DIGITAL Fortran subsets (and included shared libraries) installed: After Installation 3-3 ___________________________________________________________ Subset_Name_____Shared_Libraries___________________________ DFACOMnnn libshcom.so DFARTLnnn libfor.so libUfor.so libFutil.so PSESHPFnnn libshpf.so OTABASEnnn______libots3.so_(Fortran_90_only)_______________ The shared library files included in the DFARTLnnn subset can be installed on any system licensed to run the DIGITAL UNIX operating system. This allows executable programs created with DIGITAL Fortran to be executed regardless of whether DIGITAL Fortran is installed on that system. In addition to being supplied with DIGITAL Fortran, some or all of these subsets are included on the DIGITAL UNIX operating system CD-ROM distribution media (see the DIGITAL UNIX Installation Guide). You should always use the most recent versions of these subsets. The DIGITAL Fortran release notes list the versions of the subsets included in the DIGITAL Fortran kit. 3.3.2 The Message Catalog The message catalog contains the text for all messages issued by the DIGITAL Fortran run-time library. The message catalog should be installed on any system used to run DIGITAL Fortran applications. If the message catalog is not present and a DIGITAL Fortran application signals an error from the run-time library, you will see the error message number and a message saying that for_msg.cat is missing. The descriptive text for the error will not be displayed. The message catalog is included in the DFARTLnnn subset. This subset must be installed if you want to be able to read the descriptive text associated with DIGITAL Fortran run-time library errors. 3-4 After Installation The message catalog file included in the DFARTLnnn subset can be installed on any system licensed to run the DIGITAL UNIX operating system. DFARTLnnn subset is included with DIGITAL Fortran and also in the /mnt/ALPHA/DEC_Fortran_RTL directory on the DIGITAL UNIX operating system CD-ROM distribution media (see the DIGITAL UNIX Installation Guide). You should always use the most recent version of this subset. The DIGITAL Fortran release notes list the version of the DFARTL subset included in the DIGITAL Fortran kit. The message catalog is installed in the /usr/lib/cmplrs /fortrtl directory and is pointed to by a symbolic link in /usr/lib/nls/msg/en_US.ISO8859-1. DIGITAL Fortran uses the NLSPATH environment variable to find its run-time message catalog. If NLSPATH is not set, the default used is /usr/lib/nls/msg/en_US.ISO8859-1/for_msg.cat. If the DIGITAL Fortran run-time library cannot find its message catalog, it displays a message that includes the following: Check environment variable NLSPATH and protection of /usr/lib/nls/msg/en_US.ISO8859-1/for_msg.cat In this case, check to see if for_msg.cat exists and that users have access to it. The for_msg.cat file is bundled with DIGITAL Fortran. For more information on NLSPATH, see the DIGITAL UNIX documentation or the catopen(3) reference page. After Installation 3-5 A _________________________________________________________________ Sample DIGITAL Fortran Version 5.n Listings This appendix provides listings of the following procedures: o A DIGITAL Fortran installation from CD-ROM (Section A.1) o An Installation Verification Procedure (IVP) run after the installation (Section A.2) This installation guide is not revised for each release of DIGITAL Fortran. When installing later versions of DIGITAL Fortran, the displayed numbers for the subsets, version, and subset directory will differ. A.1 Sample DIGITAL Fortran Installation The sample installation in this appendix shows: o DIGITAL Fortran Version 5.0 subset numbers o Use of a locally mounted media CD-ROM and subset directory of /mnt/dfa500/kit (where the DIGITAL Fortran subsets are located on the locally mounted media CD- ROM). o Installation on a system running DIGITAL UNIX Version 4.0. The actual menu display shown on your system might not include certain lines if you have a recent version of DIGITAL Fortran installed. This appendix shows a new installation (all lines are displayed). The subset numbers are listed in the online release notes (see Section 1.1). For an explanation about DIGITAL Fortran installation (including the mount command), see Chapter 2. Sample DIGITAL Fortran Version 5.n Listings A-1 # setld -l /mnt/dfa500/kit The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) DIGITAL Compiled Code Support Library #200 2) DIGITAL Fortran 90 and 77 V5.0 for DIGITAL UNIX Alpha Systems 3) DIGITAL Fortran RTL #376 for DIGITAL UNIX Alpha Systems (f90 and f77) 4) DIGITAL Fortran V5.0 Release Notes and Man Page 5) DIGITAL Fortran V5.0 Tools & their Man Pages 6) High Performance Fortran Scalar Libraries Or you may choose one of the following options: 7) ALL of the above 8) CANCEL selections and redisplay menus 9) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 7 You are installing the following optional subsets: DIGITAL Compiled Code Support Library #200 DIGITAL Fortran 90 and 77 V5.0 for DIGITAL UNIX Alpha Systems DIGITAL Fortran RTL #376 for DIGITAL UNIX Alpha Systems (f90 and f77) DIGITAL Fortran V5.0 Release Notes and Man Page DIGITAL Fortran V5.0 Tools & their Man Pages High Performance Fortran Scalar Libraries Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. 7 subset(s) will be installed. Loading 1 of 6 subset(s).... Copyright (c) Digital Equipment Corporation, 1995, 1996. All Rights Reserved. Parallel Software Environment for Digital UNIX V1.0-7 Subset: High Performance Fortran Scalar Libraries (PSESHPF107) Starting installation at Tue Jul 8 13:53:37 EDT 1997. There are no installation questions for this subset. A-2 Sample DIGITAL Fortran Version 5.n Listings High Performance Fortran Scalar Libraries Copying from . (disk) Verifying Loading 2 of 6 subset(s).... DIGITAL Compiled Code Support Library #200 Copying from . (disk) Verifying Loading 3 of 6 subset(s).... DIGITAL Fortran RTL #376 for DIGITAL UNIX Alpha Systems (f90 and f77) Copying from . (disk) Working....Tue Jul 8 13:54:00 EDT 1997 Verifying Loading 4 of 6 subset(s).... DIGITAL Fortran 90 and 77 V5.0 for DIGITAL UNIX Alpha Systems Copying from . (disk) Working....Tue Jul 8 13:54:23 EDT 1997 Verifying Loading 5 of 6 subset(s).... DIGITAL Fortran V5.0 Tools & their Man Pages Copying from . (disk) Verifying Loading 6 of 6 subset(s).... Copyright Digital Equipment Corporation 1992,1997. All rights reserved Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. DIGITAL Fortran V5.0 Release Notes and Man Page Copying from . (disk) Verifying 6 of 6 subset(s) installed successfully. Creating softlinks for PSESHPF107 ... Sample DIGITAL Fortran Version 5.n Listings A-3 Parallel Software Environment for Digital UNIX V1.0-7 Subset: High Performance Fortran Scalar Libraries (PSESHPF107) Installation completed at Tue Jul 8 13:56:02 EDT 1997. Configuring "High Performance Fortran Scalar Libraries" (PSESHPF107) Copyright (c) Digital Equipment Corporation, 1995, 1996. All Rights Reserved. Parallel Software Environment for Digital UNIX V1.0-7 Subset: High Performance Fortran Scalar Libraries (PSESHPF107) Starting configuration (INSTALL) at Tue Jul 8 13:56:03 EDT 1997. Completing configuration (INSTALL) at Tue Jul 8 13:56:03 EDT 1997. Configuring "DIGITAL Compiled Code Support Library #200" (OTABASE200) OTABASE200, information: Shared library installed. Configuring "DIGITAL Fortran RTL #376 for DIGITAL UNIX Alpha Systems (f90 and f77)" (DFARTL376) DFARTL376, information: Shared libraries installed. DFABASE500, information: You can run the Installation Verification Procedure using the following command from root: setld -v DFABASE500 Configuring "DIGITAL Fortran 90 and 77 V5.0 for DIGITAL UNIX Alpha Systems" (DFABASE500) Configuring "DIGITAL Fortran V5.0 Tools & their Man Pages" (DFACOM500) DFADOC500, information: The f77 release notes are in ./usr/lib/cmplrs/fort/relnotes and the f90 release notes are in ./usr/lib/cmplrs/fort90/relnotes90 Configuring "DIGITAL Fortran V5.0 Release Notes and Man Page" (DFADOC500) A.2 Sample DIGITAL Fortran Installation Verification Procedure (IVP) This sample installation verification procedure shows DIGITAL Fortran subset numbers and displayed information for a Version 5.0 IVP, which will change for subsequent releases. A-4 Sample DIGITAL Fortran Version 5.n Listings # /usr/sbin/setld -v DFABASE500 DIGITAL Fortran 90 and 77 V5.0 for DIGITAL UNIX Alpha Systems (DFABASE500) DFABASE500: Starting Installation Verification Procedure (IVP). Copyright (c) Digital Equipment Corporation, 1992,1997. All rights reserved. If this IVP fails, please include the following when submitting a report: 1) This subset name, which is DFABASE500 2) Output from: ls -l /tmp/DFABASE500.ivptmp 3) This setld session IVP, information: Created scratch directory. IVP, information: Testing the DIGITAL Fortran 77 compiler IVP, information: Compiling and linking. IVP, information: Running. IVP, information: Execution of DIGITAL Fortran 77 successful. IVP, information: Testing the DIGITAL Fortran 90 compiler IVP, information: Compiling and linking. IVP, information: Running. IVP, information: Execution of DIGITAL Fortran 90 successful. IVP, information: Cleaning up. IVP, information: DFABASE500 is properly installed. Sample DIGITAL Fortran Version 5.n Listings A-5