------------------------------------------------------------------------ Compaq Fortran ------------------------------------------------------------------------ Installation Guide for Tru64 UNIX Systems ------------------------------------------------------------------------ Order Number: AA-PW82G-TE January 2001 This guide describes how to install Compaq® Fortran 95/90 and Compaq Fortran 77 on an Alpha processor running the Compaq Tru64 UNIX (formerly DIGITAL® UNIX) operating system. Revision/Update Information: This revised manual supersedes the Version 5.3 Compaq Fortran Installation Guide for Tru64 UNIX Systems, AA-PW82F-TE. Operating System: Compaq Tru64 UNIX Version 4.0 or higher Software Version: Compaq Fortran Version 5.4 ------------------------------------------------------------------------ First Printing, February 1993 Revision, December 1999 Revision, January 2001 © 2001, Compaq Computer Corporation. COMPAQ and the Compaq logo are registered in the U.S. Patent and Trademark Office. AXP, DEC, DIGITAL, and Tru64 are trademarks of Compaq Information Technologies Group, L.P. Cray is a registered trademark of Cray Research, Inc. OpenMP and the OpenMP logo are trademarks of OpenMP Architecture Review Board. UNIX is a trademark of The Open Group in the United States and other countries. All other product names mentioned herein may be 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 provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty. 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. ------------------------------------------------------------------------ About This Guide This guide explains how to install Compaq Fortran on an Alpha processor running the Compaq Tru64 UNIX operating system. It also explains how to install Compaq Extended Math Library (CXML). Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall Compaq Fortran for any reason. ----------------------------------------------------------------- Intended Audience This guide is intended for system administrators who install Compaq Fortran. ----------------------------------------------------------------- Associated Documentation See the Release Notes for information about the documentation available with Compaq Fortran. Also see Section 1.3, "Compaq Fortran Documentation" in this guide. For comprehensive information about the Compaq Tru64 UNIX operating system, see the following Web site: http://www.compaq.com/unix Also see Section 1.4, "Compaq Tru64 UNIX Documentation". ----------------------------------------------------------------- Compaq Fortran Web Site You can view the Compaq Fortran home page at: http://www.compaq.com/fortran This Web site contains information about software update patch kits, example programs, and additional product information. To view information about a certain topic area, click the appropriate keyword in the left margin. There is also a Web site for CXML: http://www.compaq.com/math ----------------------------------------------------------------- Sending Compaq Your Comments Compaq welcomes your comments on this or any other Compaq Fortran manual. You can send comments by e-mail to: fortran@compaq.com If you have suggestions for improving particular sections or if you find any errors, please indicate the title, order number, and section numbers. 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 Compaq's Customer Support Center (CSC). For more information, see Section 4.4, "Reporting Problems to Compaq". ------------------------------------------------------------------------ Contents ----------------------------------------------------------------- About This Guide Chapter 1 Summary of Compaq Fortran Software Components and Packaging 1.1 Files on the Software Product Library CD-ROM 1.2 Reading the Release Notes and Cover Letter 1.3 Compaq Fortran Documentation 1.4 Compaq Tru64 UNIX Documentation Chapter 2 Prerequisites for Installing Compaq Fortran 2.1 Registering Your Software License 2.2 Checking the Software Distribution Kit 2.3 Time Requirements and Login Privileges 2.4 Hardware Requirements 2.5 Software Requirements 2.6 Determining Which Compaq Fortran Subsets to Load 2.6.1 DFABASEnnn Subset 2.6.2 DFACOMnnn Subset 2.6.3 DFADOCnnn Subset 2.6.4 DFARTLnnn Subset 2.6.5 OTABASEnnn Subset 2.6.6 HPFLIBSnnn Subset 2.6.7 XMDCOMnnn Subset 2.6.8 XMDLIB4nnn, XMDLIB5nnn, XMDLIB6nnn Subsets 2.6.9 XMDSCInnn Subset 2.6.10 XMDMANnnn Subset 2.6.11 XMDHTMnnn Subset 2.6.12 Reference Pages and nfs Mounting 2.7 Determining Disk Space Requirements 2.7.1 Checking Current Disk Space 2.7.2 Increasing Disk Space by Using Alternative Disks 2.8 Installing from Media or Using Remote Installation Service (RIS) 2.9 Backing Up Your System Disk 2.10 Stopping the Installation 2.11 Recovering from Installation Errors Chapter 3 How to Install Compaq Fortran 3.1 How to Install Your Kit Locally Using CD-ROM Software Products Library Media 3.2 How to Install Your Kit Remotely Using a Remote Installation Service (RIS) Distribution Area 3.3 Selecting Compaq Fortran Subsets 3.4 Installing the Compaq Extended Math Library (CXML) 3.4.1 Selecting XMDLIB Subsets 3.4.2 CXML Library Names Chapter 4 Postinstallation Tasks 4-1 4.1 How to Run the Installation Verification Procedure (IVP) 4.2 How to Delete Compaq Fortran from Your System 4.3 How to Run Compaq Fortran Applications 4.3.1 Subsets and Shared Libraries 4.3.2 Message Catalog 4.4 Reporting Problems to Compaq A Example of a Compaq Fortran Installation from CD-ROM B Example of a Compaq Fortran Installation Verification Procedure (IVP) Index ------------------------------------------------------------------------ Chapter 1 Summary of Compaq Fortran Software Components and Packaging ----------------------------------------------------------------- This chapter contains the following sections: * 1.1, "Files on the Software Product Library CD-ROM" * 1.2, "Reading the Release Notes and Cover Letter" * 1.3, "Compaq Fortran Documentation" * 1.4, "Compaq Tru64 UNIX Documentation" 1.1 Files on the Software Product Library CD-ROM The Compaq Tru64 UNIX Alpha Software Product Library CD-ROM (media CD-ROM) provides the following files: * Compaq Fortran installation kit files (including files for installing CXML). * Compaq Fortran documentation files. These files include: o The Release Notes o A cover letter titled Read Before Installing or Using Compaq Fortran Version n.n for Tru64 UNIX Alpha Systems o The online version of this installation guide o The Software Product Description (SPD) * Online CD-ROM documentation files. These files are contained in the /readme directory on the first media CD-ROM. The files include: + A CD-ROM user guide called Software Product Library CD-ROM User's Guide + A CD-ROM master index file (a master list of CD-ROM products) * A cdmenu utility To determine whether the appropriate media CD-ROM is already mounted on your system, contact the system administrator. To obtain the location of the Compaq Fortran main product directory on the appropriate media CD-ROM, do one of the following: * Use the cdmenu utility provided on the media CD-ROM. * View the CD-ROM master index file on the media CD-ROM. * Contact the system administrator. * Check the cover letter, Read Before Installing or Using Compaq Fortran Version n.n for Tru64 UNIX Alpha Systems. For information about using the cdmenu utility and the files on the media CD-ROM set, see the Software Product Library CD-ROM User's Guide. 1.2 Reading the Release Notes and Cover Letter 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 Compaq Tru64 UNIX Alpha operating system required for this release of Compaq Fortran. The Release Notes list the subset numbers for this Compaq Fortran version. Once the appropriate media CD-ROM has been mounted (see Section 3.1, "How to Install Your Kit Locally Using CD-ROM Software Products Library Media") and the appropriate Compaq Fortran documentation subdirectory is located, use an ls command to determine the file name of the Compaq Fortran Release Notes and cover letter. 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 Compaq Fortran online documentation files, do one of the following: * Use a more or view command to display the ASCII version on your screen. * Use an lpr command to print the ASCII or PostScript version. After installation, you can find the Release Notes in this location: /usr/lib/cmplrs/fort90/relnotes90 For Fortran 77 users, the Release Notes are in: /usr/lib/cmplrs/fort/relnotes 1.3 Compaq Fortran Documentation In addition to this guide, the Compaq Fortran documentation set includes the following printed manuals: * Reference manual: Compaq Fortran Language Reference Manual * User manual: Compaq Fortran User Manual for Tru64 UNIX and Linux Alpha Systems The Compaq Fortran online reference pages describe the Compaq 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. For complete information about Compaq Fortran documentation, including Compaq Fortran online documentation and other sources of information about Fortran 95/90, see the Release Notes. For information about CXML, see the Compaq Extended Math Library Reference Guide. 1.4 Compaq Tru64 UNIX Documentation The Compaq Tru64 UNIX documentation set includes online reference pages and hardcopy documentation on installing software and on aspects of the programming environment. Refer to the Tru64 UNIX Documentation Overview, Glossary, and Master Index, which includes a list of books in the programmer's subkit. The following manuals in the Compaq Tru64 UNIX documentation set contain information relevant to installing software: * Compaq Tru64 UNIX Installation Guide * Compaq Tru64 UNIX System Administration * Compaq Tru64 UNIX Software License Management * Compaq Tru64 UNIX System Tuning and Performance Management * Compaq Tru64 UNIX Network Configuration * Compaq Tru64 UNIX Network Administration and Problem Solving * Compaq Tru64 UNIX User's Guide ------------------------------------------------------------------------ ------------------------------------------------------------------------ Chapter 2 Prerequisites for Installing Compaq Fortran ----------------------------------------------------------------- This chapter contains the following sections: * 2.1, "Registering Your Software License" * 2.2, "Checking the Software Distribution Kit" * 2.3, "Time Requirements and Login Privileges" * 2.4, "Hardware Requirements" * 2.5, "Software Requirements" * 2.6, "Determining Which Compaq Fortran Subsets to Load" * 2.7, "Determining Disk Space Requirements" * 2.8, "Installing from Media or Using Remote Installation Service (RIS)" * 2.9, "Backing Up Your System Disk" * 2.10, "Stopping the Installation" * 2.11, "Recovering from Installation Errors" 2.1 Registering Your Software License Compaq 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 Compaq 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. If you are installing Compaq 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 Compaq Tru64 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 Compaq Tru64 UNIX Software License Management and the lmf(8) reference page. Note that CXML does not require a separate license. 2.2 Checking the Software Distribution Kit Use the Parts List to check the contents of your Tru64 UNIX Software Product Library CD-ROM software distribution kit. The software distribution kit is ordered separately from Compaq Fortran and includes the following: * One or more CD-ROM optical disks containing Tru64 UNIX layered products (media CD-ROM set) * A CD-ROM read first letter If your software distribution kit is damaged or incomplete, contact your Compaq representative. 2.3 Time Requirements and Login Privileges Installing Compaq Fortran, including running the Installation Verification Procedure (IVP), takes approximately 10 to 15 minutes, depending on your system configuration. You must have superuser privileges to install the Compaq Fortran software and to register the license PAK. 2.4 Hardware Requirements To install Compaq Fortran, you need the following hardware: * 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. * 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 Compaq Fortran Software Product Description (SPD). 2.5 Software Requirements Compaq Fortran Version 5.4 requires Version 4.0 (or later) of the Compaq Tru64 UNIX operating system. Use of parallel features requires Version 4.0D (or later) of the Compaq Tru64 UNIX system. Use of NUMA (Non-Uniform Memory Access) features requires Version 5.1 (or later) of the Compaq Tru64 UNIX system. Future releases of Compaq Fortran might require higher Compaq Tru64 UNIX versions. For information about the minimum version of the operating system required, see the Release Notes or the cover letter. (See Section 1.2, "Reading the Release Notes and Cover Letter".) Compaq Fortran also requires that the following Compaq Tru64 UNIX subsets be loaded on the system where you install Compaq Fortran: * OSFBASE - the "Base System" subset * OSFCMPLRS - the "Compiler Back End" subset, which 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 Tru64 UNIX Installation Guide for your version of the Compaq Tru64 UNIX operating system. * OSFPGMR - the "Software Development Environment" subset To install the Compaq Fortran reference pages (manual pages), the following Compaq Tru64 UNIX software subsets must already be installed on your system: * OSFMANOS - the "Admin/User" online manual pages * OSFMANOP - the "Programming" online manual pages * 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 Compaq Fortran. 2. Enter the following command: # setld -i | egrep 'OSFBASE|OSFCMPLRS|OSFPGMR|OSFMANOS|OSFMANOP|OSFDCMT' 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 (that is, the second column in a row is blank), the subset or patch is not loaded. In this case, you must load the missing Compaq Tru64 UNIX software before installing Compaq Fortran. (For information on how to load Compaq Tru64 UNIX operating system software, see the Compaq Tru64 UNIX Installation Guide.) 2.6 Determining Which Compaq Fortran Subsets to Load You must choose the Compaq Fortran subsets you want to load. Table 2-1 indicates which subsets are required or recommended for each compiler. (Both compilers are installed.) The subsets starting with XMD are part of the Compaq Extended Math Library (CXML). Table 2-1 Required and Recommended Subsets for Compaq Fortran Compilers Subset Name Compaq Fortran 95/90 Compaq Fortran 77 DFABASE Required Required DFACOM Required Required DFADOC Recommended Recommended DFARTL Required Required OTABASE Required Not used HPFLIBS Required Not used XMDCOM Recommended Recommended XMDLIB4, XMDLIB5, XMDLIB6 1 Recommended Recommended XMDSCI Recommended Recommended XMDMAN Recommended Recommended XMDHTM Recommended Recommended 1____ Typically, a user installs only one of the XMDLIB subsets. (See Section 2.6.8, "XMDLIB4nnn, XMDLIB5nnn, XMDLIB6nnn Subsets".) In the subset identifiers starting with DFA, the nnn represents the version number of Compaq Fortran. In the subset identifier DFARTLnnn and HPFLIBSnnn, the nnn represents the current version of those subsets. For a list of the current subset numbers, read the Release Notes. (See Section 1.2, "Reading the Release Notes and Cover Letter".) Some of these subsets are also included on the Compaq Tru64 UNIX operating system CD-ROM distribution media (see the Compaq Tru64 UNIX Installation Guide). For information about loading specific subsets, see the setld(8) reference page. The subsets are described in the following sections. 2.6.1 DFABASEnnn Subset Subset title: Compaq Fortran 95/90 and 77 Vn.n for Compaq Tru64 UNIX Alpha Systems. This the primary subset for Compaq Fortran and requires DFARTLnnn and HPFLIBSnnn. You must install this subset to compile, link, and run Fortran programs using either Compaq Fortran 95/90 or Compaq 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 following directory: /usr/lib/cmplrs/fort90_nnn The directory /usr/lib/cmplrs/fort is a symbolic link to the following directory: /usr/lib/cmplrs/fort_nnn 2.6.2 DFACOMnnn Subset Subset title: Compaq 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 Compaq 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 both Compaq Fortran 95/90 (f90 command) and Compaq Fortran 77 (f77 command). This subset installs its files in the following directories: /usr/bin /usr/include /usr/lib /usr/shlib /usr/man/man1 /usr/man/man3 2.6.3 DFADOCnnn Subset Subset title: Compaq Fortran Vn.n Release Notes and Man Page. This subset contains: * The online Release Notes for Compaq Fortran * The f90(1) reference page * The f77(1) reference page * A list of files in the Compaq Fortran kit (file /usr/lib/cmplrs/fort90/filelist) Because the Release Notes and the f90(1) and f77(1) reference pages must be available to programmers using Compaq Fortran, you should load this subset. To view these files before proceeding with the Compaq Fortran installation, you can choose to install this subset first. This subset installs its files in the following directories: /usr/lib/cmplrs/fort90 /usr/lib/cmplrs/fort The directory /usr/lib/cmplrs/fort90 is a symbolic link (for Compaq Fortran 95/90 files) to the following directory: /usr/lib/cmplrs/fort90_nnn The directory /usr/lib/cmplrs/fort is a symbolic link (for Compaq Fortran 77 files) to the following directory: /usr/lib/cmplrs/fort_nnn Because the DFACOMnnn and DFADOCnnn subsets contain reference pages, you can load them only if the appropriate Compaq Tru64 UNIX reference pages subsets are already loaded on your system. (See Section 2.5, "Software Requirements".) 2.6.4 DFARTLnnn Subset Subset title: Compaq Fortran RTL #nnn for Compaq Tru64 UNIX Alpha Systems (f90 and f77). This subset supports both Compaq Fortran 95/90 and Compaq Fortran 77 and contains: * Static and shared versions of the Compaq Fortran run-time libraries * Compaq 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 Compaq Fortran installation procedure, if you choose DFARTLnnn, it will not be installed if your system already has a more recent version. 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 following directory: /usr/lib/cmplrs/fortrtl_nnn 2.6.5 OTABASEnnn Subset Subset title: Compaq 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 If a newer version of these libraries already exists on your system, the installation procedure will not override them. 2.6.6 HPFLIBSnnn Subset Subset title: High Performance Fortran Run-Time Libraries. This subset contains: * Both the serial and parallel versions 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 HPFLIBSnnn subset to compile, link, and run Fortran programs using Compaq Fortran that reference any HPF* routines. If you previously installed the PSESHPF subset and need to delete it, delete it before you install Compaq Fortran. If you delete the PSESHPF subset after you install the Compaq Fortran HPFLIBS subset, you need to reinstall the HPFLIBS subset. For information on using setld to check for and delete subsets, see Section 4.2, "How to Delete Compaq Fortran from Your System". This subset installs its files in the following directories: /usr/examples/hpf /usr/lib/cmplrs/hpfrtl_nnn /usr/lib/cmplrs/hpfrtl /usr/lib /usr/shlib /usr/man/man3 The directory /usr/lib/cmplrs/hpfrtl is a symbolic link to the following directory: /usr/lib/cmplrs/hpfrtl_nnn 2.6.7 XMDCOMnnn Subset Subset title: CXML Common Files for the Extended Math Library. The Compaq Extended Math Library (CXML) is a collection of high performance subprograms that perform different types of mathematical operations, including: * Matrix computations * Signal processing code * Code to solve sparse linear systems using direct and iterative methods To use CXML, users typically include calls to CXML entry points in their application programs, then link the application program with the serial or parallel CXML library, and execute. The CXML routines are primarily called from Fortran or C, but can be called from any language. This subset contains common material needed by the CXML XMDLIB subsets described in Section 2.6.8, "XMDLIB4nnn, XMDLIB5nnn, XMDLIB6nnn Subsets". This subset provides release notes, example programs, header files that user programs must include, Installation Verification Procedure (IVP) tests, and other supporting CXML utilities. This subset installs its files in the following directories: /usr/examples/cxml /usr/opt/XMDCOMnnn/docs /usr/opt/XMDCOMnnn/cxml /usr/opt/XMDCOMnnn/ivp 2.6.8 XMDLIB4nnn, XMDLIB5nnn, XMDLIB6nnn Subsets Subset titles: CXML Extended Math Libraries (Serial and Parallel) for EV4, EV5, EV6. These three subsets contain the CXML libraries, specially tuned for one family of Alpha processors (21064, 21164, 21264). Typically, you choose to install only one of these subsets, but you can install any number of them. Each subset contains both the serial and the parallel CXML libraries: * Serial library in archive and shared library form (libcxml.a, libcxml.so) * Parallel library in archive and shared library form (libcxmlp.a, libcxmlp.so) The parallel version of the CXML library supports symmetric multiprocessing (SMP) for improved performance. The parallel CXML library achieves its parallelization using OpenMP. Key BLAS, LAPACK, FFT routines, and sparse and iterative solver routines in the CXML library have been modified to execute in parallel if run on SMP hardware. Each subset installs its libraries in the following directory: /usr/opt/XMDLIBxnnn 2.6.9 XMDSCInnn Subset Subset title: CXML SCIPORT library. This subset contains the SCIPORT Cray compatibility library (libsciport.a) and the SCIPORT man pages. After linking with the SCIPORT library, your Fortran program must link in the CXML library (either serial or parallel). For example: f90 -i8 -r8 -double_size 128 myprog.f -lsciport -lcxmlp The common subset XMDCOM and at least one of the CXML library subsets (XMDLIB4, XMDLIB5, or XMDLIB6) must be installed in addition to XMDSCI. This subset installs its files in the following directories: /usr/opt/XMDSCInnn/cxml /usr/opt/XMDSCInnn/ivp /usr/opt/XMDSCInnn/man /usr/opt/XMDSCInnn 2.6.10 XMDMANnnn Subset Subset title: CXML Reference (man) Pages. This subset contains the reference pages (man pages) for CXML. This subset installs its files in the following directory: /usr/opt/XMDMANnnn/man 2.6.11 XMDHTMnnn Subset Subset title: CXML Reference (man) Pages in HTML format. This subset contains the reference pages (man pages) for CXML in HTML format. This subset installs its files in: /usr/opt/XMDHTMnnn/cxml_webpages These pages are accessible at the following Web location: /usr/opt/XMDHTMnnn/cxml_webpages/cxml_home_page.html 2.6.12 Reference Pages and nfs Mounting Users on the system where Compaq 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 Compaq Fortran). When reference pages are nfs mounted on another system, do not request the DFACOMnnn and DFADOCnnn subsets during the Compaq Fortran installation. After the installation is complete, you can log in to the system where the reference pages are installed and load only the Compaq Fortran DFACOMnnn and DFADOCnnn subsets on that system. 2.7 Determining Disk Space Requirements Table 2-2 lists the disk space requirements for loading Compaq Fortran software subsets. These disk space requirements are approximate; the values apply to the disks where you load the Compaq 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. Table 2-2 Compaq Fortran Subset Sizes (Disk Space Requirements) Subset Name Directory Kbytes Required /usr 1 /usr/bin 1 DFABASEnnn /usr/lib/cmplrs 1 /usr/lib/cmplrs/fort90_nnn 15000 /usr/lib/cmplrs/fort_nnn 7500 Total: 22510 /usr/bin 150 /usr/include 170 DFACOMnnn /usr/man/man1 6 /usr/man/man3 200 /usr/lib 360 /usr/shlib 30 Total: 920 DFADOCnnn /usr/lib/cmplrs/fort_nnn 340 /usr/lib/cmplrs/fort90_nnn 450 Total: 790 /usr/lib 1 /usr/lib/cmplrs 1 DFARTLnnn /usr/lib/cmplrs/fortrtl_nnn 2700 /usr/lib/nls/msg/en_US.ISO8859-1 1 /usr/shlib 1 Total: 2710 /usr/lib/cmplrs 1 OTABASEnnn /usr/lib/cmplrs/o3abase_nnn 650 /usr/shlib 1 Total: 660 /usr/lib /usr/lib/cmplrs/hpfrtl 1 1 HPFLIBSnnn /usr/lib/cmplrs/hpfrtl_nnn 9600 /usr/man/man3 /usr/opt/HPFnnn/hpf/usr/examples/hpf 1 /usr/shlib 100 1 Total: 9710 /usr/opt/XMDCOMnnn 24 XMDCOMnnn /usr/opt/XMDCOMnnn/docs 9 /usr/opt/XMDCOMnnn/cxml 251 /usr/opt/XMDCOMnnn/ivp 67 Total: 360 XMDLIB4nnn /usr/opt/XMDLIB4nnn 63410 XMDLIB5nnn /usr/opt/XMDLIB5nnn 62910 XMDLIB6nnn /usr/opt/XMDLIB6nnn 68590 XMDMANnnn /usr/opt/XMDMANnnn/man 4750 XMDHTMnnn /usr/opt/XMDHTMnnn/man 6820 /usr/opt/XMDSCInnn/cxml 1121 XMDSCInnn /usr/opt/XMDSCInnn/ivp 8 /usr/opt/XMDSCInnn/man 20 Total: 1150 Grand Total: 245290 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 Compaq Fortran files will reside. If you need precise information on the sizes of individual Compaq Fortran files in the various directories, view one of the following files: * Fortran 95/90: /usr/lib/cmplrs/fort90/filelist * Fortran 77: /usr/lib/cmplrs/fort/filelist 2.7.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 Compaq 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 shows the following: * /usr (mounted to /dev/rd0g) is the only mount point that affects where Compaq Fortran files will reside. * The system has only one local disk drive. * The /usr/lib and /usr/lib/cmplrs file systems reside in the g partition of the disk on that drive. To check total space and free space for the directories where Compaq 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. You can do so as follows: # df /usr Filesystem Total kbytes kbytes % node kbytes used free used Mounted on /dev/rd0g 122598 54447 55892 49% /usr The device names shown in this section are for Tru64 UNIX Version 4 systems. For Tru64 UNIX Version 5 systems, the device names might be different. This display indicates there are 55892 Kbytes free. This free space must accommodate the subset requirements listed in Table 2-2. On systems where /usr/lib and /usr/man are mounted to devices different from /usr, enter the following command: # df /usr/lib /usr/man In this case, you would: * Compare space required for Compaq Fortran files in /usr/lib with the free space displayed in the first line of the df output list. * Compare the space required for Compaq Fortran files in /usr/man with the free space displayed in the second line of that list. 2.7.2 Increasing Disk Space by Using Alternative Disks The Compaq 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 Compaq 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 Compaq 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 Compaq Fortran: 1. Log in as superuser (login name root) to the system where you will install Compaq Fortran. 2. Create one or both of the appropriate directories: o /usr/lib/cmplrs/fort90_nnn This is a symbolic link to the following directory: /usr/lib/cmplrs/fort90_nnn o /usr/lib/cmplrs/fort_nnn This is a symbolic link to the following directory: /usr/lib/cmplrs/fort_nnn In these directory names, nnn is the Compaq 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. 2.8 Installing from Media or Using Remote Installation Service (RIS) Someone from your site must perform at least one Compaq Fortran installation from the distribution medium. Your site system administrator can then decide whether or not to make a Compaq Fortran distribution kit available online, so that subsequent installations of Compaq Fortran can use the Remote Installation Service (RIS). For information on extracting Compaq Fortran subsets to a RIS distribution area, see your Compaq Tru64 UNIX system management documentation. If you expect to use Compaq 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: * A Compaq Fortran network kit is available for use. * Your system is registered as a RIS client. For information on installing Compaq Fortran from a RIS distribution area, see Section 3.2, "How to Install Your Kit Remotely Using a Remote Installation Service (RIS) Distribution Area". 2.9 Backing Up Your System Disk Compaq recommends that you back up your system disk before installing Compaq Fortran or any software. Use the backup procedures established at your site. For information about backing up your system disk, see the Compaq Tru64 UNIX system documentation. 2.10 Stopping the Installation To stop the installation procedure at any time, enter Ctrl/C. You must then delete files created interactively up to that point. The directories and files created during the Compaq Fortran installation are listed in the following files: /usr/lib/cmplrs/fort90/filelist /usr/lib/cmplrs/fort/filelist 2.11 Recovering from Installation Errors If errors occur during the installation, the system displays 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 Compaq Fortran (DFABASEnnn) will not be loaded. Errors can occur during the installation if any of the following conditions exist: * The operating system version is incorrect. * The prerequisite software version is incorrect. * The system parameter values for successful installation are insufficient. For descriptions of error messages generated by these conditions, see the Compaq Tru64 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 requirements for installing Compaq Fortran, see Section 2.5, "Software Requirements". ------------------------------------------------------------------------ ------------------------------------------------------------------------ Chapter 3 How to Install Compaq Fortran ----------------------------------------------------------------- This chapter contains the following sections: * 3.1, "How to Install Your Kit Locally Using CD-ROM Software Products Library Media" * 3.2, "How to Install Your Kit Remotely Using a Remote Installation Service (RIS) Distribution Area" * 3.3, "Selecting Compaq Fortran Subsets" * 3.4, "Installing the Compaq Extended Math Library (CXML)" Note: For a complete example of an installation process, see Appendix A. For a list of files from the DFABASE, DFACOM, and DFADOC subsets installed on your system by the installation process, see the following file: /usr/lib/cmplrs/fort90/filelist 3.1 How to Install Your Kit Locally Using CD-ROM Software Products Library Media The installation procedure loads Compaq Fortran files to a disk belonging to the system where you perform the installation. When Compaq Fortran is run, its executable images are mapped into memory on your system. Follow these steps to install Compaq Fortran from the Software Products Library CD-ROM set: 1. To obtain the kit directory location of the Compaq 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-ROM master index file on the media CD-ROM o Contact the system administrator o Check the cover letter, Read Before Installing or Using Compaq Fortran Version n.n for Tru64 UNIX Alpha Systems. 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. For more information, see Section 1.1, "Files on the Software Product Library CD-ROM". 2. If the media CD-ROM containing the Compaq Fortran installation files is not mounted, either contact the 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 Compaq Fortran. 4. Make sure you are at the root directory (/) by entering the following command: # cd / 5. Find out whether a previous version of Compaq Fortran is installed by entering the following command: # setld -i | egrep 'PSESH|DFA|HPFLIBS|XMD|OTABASE' If the directory /usr/sbin is not in your path, specify the path before the setld command (/usr/sbin/setld). If a version of Compaq 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 HPFLIBS 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 HPFLIBSnnn For more information on deleting subsets for previous versions before continuing the installation (including Compaq Fortran subsets also used by other products), see Section 4.2, "How to Delete Compaq Fortran from Your System". 6. Specify the /mnt directory to be the mount point for the distribution file system on the drive. For example, 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 cover letter, as described in Section 1.2, "Reading the Release Notes and Cover Letter". 7. To verify the location of the Compaq Fortran main product directory on the appropriate media CD-ROM (see step 1), enter an ls command 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 Compaq Fortran Version 5.n subsets are located: # setld -l /mnt/product-directory/kit In this example, product-directory is the main Compaq Fortran directory (such as dfa500) listed in the Software Product Library CD-ROM User's Guide and CD master index file. The installation procedure now displays the names of Compaq Fortran subsets and asks you to specify the subsets you want to load. See Section 3.3, "Selecting Compaq Fortran Subsets", to continue the installation. 3.2 How to Install Your Kit Remotely Using a Remote Installation Service (RIS) Distribution Area If you are installing Compaq 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 Compaq Fortran. 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 Compaq Fortran subsets are located. For example, if you are loading Compaq Fortran subsets from a RIS distribution area on node orion, enter the following: # setld -l orion: RIS 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 3.3, "Selecting Compaq Fortran Subsets", to continue the installation. 3.3 Selecting Compaq Fortran Subsets Note: 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. The actual subset numbers are listed in the Release Notes (see Section 1.2, "Reading the Release Notes and Cover Letter"). Note: If you are installing from a RIS distribution area, the numbers of the Compaq Fortran subsets can vary depending on what products are available in the RIS area and how many subsets they have. The installation proceeds as follows: 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) CXML Common Files for the Extended Math Lib, Vn.n 2) CXML Extended Math Libraries (Serial and Parallel) for Ev4, Vn.n 3) CXML Extended Math Libraries (Serial and Parallel) for Ev5, Vn.n 4) CXML Extended Math Libraries (Serial and Parallel) for Ev6, Vn.n 5) CXML Reference (man)Pages 6) CXML Reference (man)Pages in HTML format 7) CXML Vn.n SCIPORT library 8) Compaq Compiled Code Support Library #nnn 9) Compaq Fortran 95/90 and 77 Vn.n for Compaq Tru64 UNIX Alpha Systems 10) Compaq Fortran RTL #nnn for Compaq Tru64 UNIX Alpha Systems (f90 and f77) 11) Compaq Fortran Vn.n High Performance Fortran Runtime Libraries V1.8-5 12) Compaq Fortran Vn.n Release Notes and Man Page 13) Compaq Fortran Vn.n Tools & their Man Pages Or you may choose one of the following options: 14) ALL of the above 15) CANCEL selections and redisplay menus 16) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 1,3,5-13 The actual display shown on your system might not include certain lines if you have a recent version of Compaq Fortran installed. For example, if the same version of the "Compaq Fortran RTL #nnn for Tru64 UNIX Alpha" (subset DFARTL) on the Compaq Fortran kit has already been installed, that line will not be displayed. The following text in this section assumes this is a new installation. To compile and run Fortran programs using the Compaq Fortran tools, you must choose subset numbers 8, 9, and 10. To use HPF parallel directives with Compaq Fortran 95/90, you must also choose subset number 11. To use the Compaq Extended Math Library, you must also choose subset numbers 1 and 7, and one of the following: 2, 3, or 4 (the other numbers are optional). For more information, see Section 3.4, "Installing the Compaq Extended Math Library (CXML)". To install only the Release Notes without installing Compaq Fortran, choose subset number 12. If you specify more than one number at the prompt, use spaces (not commas) to separate the numbers. Enter 14 to install all of the listed subsets. Next, the procedure lets you verify your choice. For example, if you enter 14 in response to the previous prompt, the following display appears: You are installing the following optional subsets: CXML Common Files for the Extended Math Lib, Vn.n CXML Extended Math Libraries (Serial and Parallel) for Ev4, Vn.n CXML Extended Math Libraries (Serial and Parallel) for Ev5, Vn.n CXML Extended Math Libraries (Serial and Parallel) for Ev6, Vn.n CXML Reference (man)Pages CXML Reference (man)Pages in HTML format CXML Vn.n SCIPORT library Compaq Compiled Code Support Library #nnn Compaq Fortran 95/90 and 77 Vn.n for Compaq Tru64 UNIX Alpha Systems Compaq Fortran RTL #nnn for Compaq Tru64 UNIX Alpha Systems (f90 and f77) Compaq Fortran Vn.n (ECO1) High Performance Fortran Runtime Libraries V1 Compaq Fortran Vn.n Release Notes and Man Page Compaq Fortran Vn.n Tools & their Man Pages 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. The installation procedure loads and verifies the selected Compaq Fortran subsets. 3.4 Installing the Compaq Extended Math Library (CXML) If you install CXML, the installation procedure asks several questions pertaining to choices of subsets, libraries, and names of libraries. When installing CXML, you must install a minimum of the following subsets: * CXML Common Files for the Extended Math Library (XMDCOMnnn) * One or more of the following: o CXML Extended Math Libraries (Serial and Parallel) for EV4 (XMDLIB4nnn) o CXML Extended Math Libraries (Serial and Parallel) for EV5 (XMDLIB5nnn) o CXML Extended Math Libraries (Serial and Parallel) for EV6 (XMDLIB6nnn) For more information, see Section 3.4.1, "Selecting XMDLIB Subsets" and Section 3.4.2, "CXML Library Names". Optionally, you can also install one or more of the following: * CXML SCIPORT Library (XMDSCInnn) * CXML Reference (man) Pages (XMDMANnnn) * CXML Reference (man) Pages in HTML format (XMDHTMnnn) 3.4.1 Selecting XMDLIB Subsets For information about these subsets, see Section 2.6.8, "XMDLIB4nnn, XMDLIB5nnn, XMDLIB6nnn Subsets". Typically, you choose to install only one of these subsets, but you can install any number of them. For best performance, Compaq recommends that you install the subset that matches the platform's processor type. For example, install the EV5 library for EV56 systems and the EV6 library for EV67 systems. If you select a subset that does not match your platform's hardware, the installation procedure will verify that you want to continue to install that subset. By default, both the serial and the parallel CXML libraries will be installed. You can choose to install only the serial CXML or only the parallel CXML library. By default, both shared and archive CXML libraries will be installed. You can choose to install only shared libraries (for example, libcxml.so) or only archive libraries (for example, libcxml.a). 3.4.2 CXML Library Names If you install an XMDLIB subset that matches the platform, the installation procedure will construct the CXML libraries you selected with names that show the platform explicitly (for example, libcxml_ev5.so). It will also construct symbolic links from /usr/lib or /usr/shlib to the selected libraries. By default, this installation will also construct symbolic links from the standard CXML library names (for example, /usr/shlib/libcxml.so) to your selected libraries, unless you select not to use standard names. If you install an XMDLIB subset that does not match the platform, the installation procedure will ask you if you want the CXML libraries you are currently installing to have the standard CXML library names (for example, /usr/shlib/libcxml.so) as well as the platform-specific names. ----------------------------------------------------------------------- Chapter 4 Postinstallation Tasks ----------------------------------------------------------------- This chapter contains the following sections: * 4.1, "How to Run the Installation Verification Procedure (IVP)" * 4.2, "How to Delete Compaq Fortran from Your System" * 4.3, "How to Run Compaq Fortran Applications" * 4.4, "Reporting Problems to Compaq" 4.1 How to Run the Installation Verification Procedure (IVP) After installing Compaq 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 Compaq Fortran. The IVP verifies the installation by using the fverify command with the -y option (see the fverify(8) reference page). Depending on which Compaq Fortran subsets you specify on the setld -v command line, the following checks might occur: * For the DFABASEnnn subset, the IVP first compiles, links, and runs a Fortran program with Compaq Fortran 77 tools, and then compiles, links, and runs a Fortran program with Compaq Fortran 95/90 tools. * For Compaq Extended Math Library subsets (identifiers starting with XMD), the IVP links and executes test programs that exercise the CXML and SCIPORT libraries. * For other subsets, the IVP verifies that certain files are present. For instance, the DFARTLnnn and HPFLIBSnnn subsets verify that the run-time libraries exist. To run the IVP after an installation, enter the following command: # setld -v subset-name In this command, subset-name can be any Compaq Fortran subset, such as DFABASEnnn and DFADOCnnn. (For nnn, substitute the appropriate version number.) For a sample listing of the Compaq Fortran IVP, see Appendix B. If the verification process fails, look in the /var/adm/smlogs/fverify.log file for information to help diagnose the problem. 4.2 How to Delete Compaq Fortran from Your System If you must remove a version of Compaq 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|HPFLIBS|XMD|OTABASE' 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. Enter a setld command like the following to delete subsets: # setld -d HPFLIBSnnn DFABASEnnn DFADOCnnn DFACOMnnn In this command, nnn is the version number (such as 540 for Version 5.4). The CXML subsets have a prefix of XMD. You can use the following setld command to check for CXML subsets: # setld -i | egrep 'XMD' Note: If you plan to run Compaq Fortran applications, do not delete the DFARTL subset (see Section 4.3.1, "Subsets and Shared Libraries"). Before you delete the DFACOM or DFARTL subsets, be aware that the Compaq Fortran 95/90 and Compaq Fortran 77 products (DFABASE subset) use 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. After installation, anytime you delete an older subset, you must use the SELECT option to reestablish the symbolic links for each subset. For example, to reestablish the symbolic links for the DFABASEnnn subset: # setld -c DFABASEnnn SELECT 4.3 How to Run Compaq Fortran Applications You need Compaq Fortran shared libraries and the message catalog to run Compaq Fortran applications on your system. 4.3.1 Subsets and Shared Libraries To run Compaq Fortran applications compiled with the default -call_shared flag, you must have the following Compaq Fortran subsets (and included shared libraries) installed: Table 4-1 Subset Names for Shared Libraries Subset Name Shared Libraries DFACOMnnn libshcom.so DFARTLnnn libfor.so, libUfor.so, libFutil.so HPFLIBSnnn libphpf.so, libphpfp.so, libshpf.so (Fortran 95/90 only) OTABASEnnn libots3.so (Fortran 95/90 only) XMDLIBxnnn (where x is 4, 5, or 6) libcxml.so and libcxmlp.so The shared library files included in the DFARTLnnn subset can be installed on any system licensed to run the Compaq Tru64 UNIX operating system. This allows executable programs created with Compaq Fortran to be executed regardless of whether Compaq Fortran is installed on that system. Some of these subsets are also included on the Compaq Tru64 UNIX operating system CD-ROM distribution media (see the Compaq Tru64 UNIX Installation Guide). You should always use the most recent versions of these subsets. The Release Notes list the versions of the subsets included in the Compaq Fortran kit (see Section 1.2, "Reading the Release Notes and Cover Letter"). 4.3.2 Message Catalog The message catalog contains the text for all messages issued by the Compaq Fortran run-time library. The message catalog should be installed on any system used to run Compaq Fortran applications. If the message catalog is not present and a Compaq 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 Compaq Fortran run-time library errors. The message catalog file included in the DFARTLnnn subset can be installed on any system licensed to run the Compaq Tru64 UNIX operating system. The DFARTLnnn subset is included with Compaq Fortran and is also in the /mnt/ALPHA/DEC_Fortran_RTL directory on the Compaq Tru64 UNIX operating system CD-ROM distribution media. (See the Tru64 UNIX Installation Guide.) You should always use the most recent version of this subset. The Release Notes list the version of the DFARTL subset included in the Compaq Fortran kit (see Section 1.2, "Reading the Release Notes and Cover Letter"). The message catalog is installed in the /usr/lib/cmplrs/fortrtl directory and is pointed to by a symbolic link in the following directory: /usr/lib/nls/msg/en_US.ISO8859-1 Compaq Fortran uses the NLSPATH environment variable to find its run-time message catalog. If NLSPATH is not set, the following default location is used: /usr/lib/nls/msg/en_US.ISO8859-1/for_msg.cat If the Compaq 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/msgen_US.ISO8859-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 Compaq Fortran. For more information on NLSPATH, see the Compaq Tru64 UNIX documentation or the catopen(3) reference page. 4.4 Reporting Problems 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, you can do either of the following: * If you have a Software Product Services Support Agreement, contact 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. * If you don't have a support agreement, you can arrange or per-call CSC support. When you initially contact the CSC, indicate the following: 1. The name and version number of the operating system you are using 2. The name and version number of Compaq 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 brief description of the problem (one sentence if possible) When you submit information electronically or are speaking on the phone to a 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 might 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. 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. If the problem is related to Compaq Fortran documentation, see the information in "Sending Compaq Your Comments" in the front of this guide. ------------------------------------------------------------------------ ------------------------------------------------------------------------ Appendix A Example of a Compaq Fortran Installation from CD-ROM ----------------------------------------------------------------- The example installation in this appendix shows: * Compaq Fortran Version 5.4 subset numbers. * Use of a locally mounted media CD-ROM and subset directory of /mnt/dfa540/kit (where the Compaq Fortran subsets are located on the locally mounted media CD-ROM). * Installation on a system running Tru64 UNIX Version 4.0. * A new installation (all lines are displayed). The actual menu display shown on your system might not include certain lines if you have a recent version of Compaq Fortran installed. The actual subset numbers for your installation are listed in the Release Notes. (See Section 1.2, "Reading the Release Notes and Cover Letter".) For a detailed explanation of the Compaq Fortran installation, see Chapter 3, "How to Install Compaq Fortran". Note: This installation guide is not necessarily revised for each release of Compaq Fortran. When installing a version of Compaq Fortran later than Version 5.4, the displayed numbers for the subsets, version, and subset directory will be specific for that release. The example installation follows: # setld -l /mnt/dfa540/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) CXML Common Files for the Extended Math Lib, V4.1 2) CXML Extended Math Libraries (Serial and Parallel) for Ev4, V4.1 3) CXML Extended Math Libraries (Serial and Parallel) for Ev5, V4.1 4) CXML Extended Math Libraries (Serial and Parallel) for Ev6, V4.1 5) CXML Reference (man)Pages in HTML format 6) CXML Reference (man)Pages 7) CXML V4.1 SCIPORT library 8) Compaq Compiled Code Support Library #211 9) Compaq Fortran 90 and 77 V5.4 for Compaq Tru64 UNIX Alpha Systems 10) Compaq Fortran RTL #393 for Compaq Tru64 UNIX Alpha Systems (f90 and f77) 11) Compaq Fortran V5.4 High Performance Fortran Runtime Libraries V1.8-5 12) Compaq Fortran V5.4 Release Notes and Man Page 13) Compaq Fortran V5.4 Tools & their Man Pages Or you may choose one of the following options: 14) ALL of the above 15) CANCEL selections and redisplay menus 16) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6):1,3,5-13 You are installing the following optional subsets: CXML Common Files for the Extended Math Lib, V4.1 CXML Extended Math Libraries (Serial and Parallel) for Ev5, V4.1 CXML Reference (man)Pages in HTML format CXML Reference (man)Pages CXML V4.1 SCIPORT library Compaq Compiled Code Support Library #211 Compaq Fortran 90 and 77 V5.4 for Compaq Tru64 UNIX Alpha Systems Compaq Fortran RTL #393 for Compaq Tru64 UNIX Alpha Systems (f90 and f77) Compaq Fortran V5.4 High Performance Fortran Runtime Libraries V1.8-5 Compaq Fortran V5.4 Release Notes and Man Page Compaq Fortran V5.4 Tools & their Man Pages Is this correct? (y/n):y Checking file system space required to install selected subsets: File system space checked OK. 11 subset(s) will be installed. Loading 1 of 11 subset(s).... ************************************************************************* * * * Copyright Compaq Computer Corporation 2000. All rights reserved. * * * ************************************************************************* Compaq Extended Math Library V4.1 for Tru64 UNIX Common Files Subset XMDCOM410 The common CXML files will be installed. CXML Common Files for the Extended Math Lib, V4.1 Copying from . (disk) Verifying Loading 2 of 11 subset(s).... ************************************************************************* * * * Copyright Compaq Computer Corporation 2000. All rights reserved. * * * ************************************************************************* Obsolete versions of CXML HTML manpages will be deleted. Completed deleting obsolete versions of CXML HTML manpages CXML Reference (man)Pages in HTML format Copying from . (disk) Verifying Loading 3 of 11 subset(s).... ************************************************************************* * * * Copyright Compaq Computer Corporation 2000. All rights reserved. * * * ************************************************************************* Compaq Extended Math Library V4.1 for Tru64 UNIX CXML Serial and Parallel libraries, tuned for EV5 CXML Extended Math Libraries (Serial and Parallel) for Ev5, V4.1 Copying from . (disk) Verifying Loading 4 of 11 subset(s).... ************************************************************************* * * * Copyright Compaq Computer Corporation 2000. All rights reserved. * * * ************************************************************************* Obsolete versions of CXML manpages will be deleted. Completed deleting obsolete versions of CXML manpages CXML Reference (man)Pages Copying from . (disk) Verifying Loading 5 of 11 subset(s).... ************************************************************************* * * * Copyright Compaq Computer Corporation 2000. All rights reserved. * * * ************************************************************************* CXML V4.1 SCIPORT library for Tru64 UNIX CXML V4.1 SCIPORT library Copying from . (disk) Verifying Loading 6 of 11 subset(s).... Installation of this subset proceeds automatically, and should complete in approximately 1 minute. Compaq Compiled Code Support Library #211 Copying from . (disk) Verifying Loading 7 of 11 subset(s).... Copyright 2000 Compaq Computer Corporation Compaq Fortran V5.4 High Performance Fortran Runtime Libraries V1.8-5 for Compaq Tru64 UNIX Alpha Systems Subset: Compaq Fortran V5.4 High Performance Fortran Runtime Libraries V1.8-5 (HPFLIBS185) Starting installation at Fri Nov 3 15:54:05 EST 2000. Installation of this subset proceeds automatically, and should complete in approximately 1 minute. There are no installation questions for this subset. Compaq Fortran V5.4 High Performance Fortran Runtime Libraries V1.8-5 Copying from . (disk) Verifying Loading 8 of 11 subset(s).... Installation of this subset proceeds automatically, and should complete in approximately 1 minute. Compaq Fortran RTL #393 for Compaq Tru64 UNIX Alpha Systems (f90 and f77) Copying from . (disk) Verifying Loading 9 of 11 subset(s).... Installation of this subset proceeds automatically, and should complete in approximately 1 minute. 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. Compaq Fortran 95/90 and 77 V5.4 for Compaq Tru64 UNIX Alpha Systems Copying from . (disk) Verifying Loading 10 of 11 subset(s).... Installation of this subset proceeds automatically, and should complete in approximately 1 minute. Compaq Fortran V5.4 Tools & their Man Pages Copying from . (disk) Verifying Loading 11 of 11 subset(s).... 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. Compaq Fortran V5.4 Release Notes and Man Page Copying from . (disk) Verifying 11 of 11 subset(s) installed successfully. Configuring "CXML Common Files for the Extended Math Lib, V4.1" (XMDCOM410) The CXML Manpages in HTML are now installed. To view them, point your browser to /usr/opt/XMDHTM410/cxml_webpages/cxml_home_page.html Configuring "CXML Reference (man)Pages in HTML format" (XMDHTM410) You are installing the CXML subset XMDLIB5410 . This subset contains serial and parallel libraries which are tuned for the 21164 family of the Alpha AXP processor types. By default, both the serial and the parallel CXML libraries will be installed. You can choose to install only the serial CXML [s] only the parallel CXML [p] Please choose now: install only the serial CXML [s] install only the parallel CXML [p] (hit RETURN to get the default -> install both) ? By default, both shared and archive CXML libraries will be installed. You can choose to install only shared libs, e.g. libcxml.so [s] only archive libs, e.g. libcxml.a [a] Please choose now: install only shared CXML libs [s] install only archive CXML libs [a] (hit RETURN to get the default -> install both) ? This installation will construct the CXML libraries you selected with names that show the platform explicitly, e.g. libcxml_ev5.so. This installation will construct symbolic links from /usr/lib or /usr/shlib to the selected libraries. By default, this installation will also construct symbolic links from the standard CXML library names to your selected libraries e.g. /usr/shlib/libcxml.so unless you choose NO standard names [n]. Please choose now: no standard names [n] (hit RETURN to get the default -> standard names) ? The requested CXML libraries will be constructed and installed. The installation will take just a few minutes. ... unpacking the serial libraries ... ... building the shared serial libraries ... ... unpacking the parallel libraries ... ... building the shared parallel libraries ... Configuring "CXML Extended Math Libraries (Serial and Parallel) for Ev5, V4.1" (XMDLIB5410) Creating Links to new manpages for CXML Configuring "CXML Reference (man)Pages" (XMDMAN410) Creating Links to new manpages for CXML V4.1 SCIPORT Configuring "CXML V4.1 SCIPORT library" (XMDSCI410) To run the IVP after the installation, please use setld -v XMDSCI410 Configuring "Compaq Compiled Code Support Library #211" (OTABASE211) OTABASE211, information: Shared library installed. Creating softlinks for HPFLIBS185 ...done. Compaq Fortran V5.4 High Performance Fortran Runtime Libraries V1.8-5 for Compaq Tru64 UNIX Alpha Systems Subset: Compaq Fortran V5.4 High Performance Fortran Runtime Libraries V1.8-5 (HPFLIBS185) Installation completed at Fri Nov 3 16:00:01 EST 2000. Configuring "Compaq Fortran V5.4 High Performance Fortran Runtime Libraries V1.8-5" (HPFLIBS185) Copyright 2000 Compaq Computer Corporation Compaq Fortran V5.4 High Performance Fortran Runtime Libraries V1.8-5 for Compaq Tru64 UNIX Alpha Systems Subset: Compaq Fortran V5.4 High Performance Fortran Runtime Libraries V1.8-5 (HPFLIBS185) Starting configuration (INSTALL) at Fri Nov 3 16:00:02 EST 2000. Completing configuration (INSTALL) at Fri Nov 3 16:00:02 EST 2000. Configuring "Compaq Fortran RTL #393 for Compaq Tru64 UNIX Alpha Systems (f90 and f77)" (DFARTL393) DFARTL393, information: Shared libraries installed. DFABASE540, information: You can run the Installation Verification Procedure using the following command from root: setld -v DFABASE540 Configuring "Compaq Fortran 90 and 77 V5.4 for Compaq Tru64 UNIX Alpha Systems" (DFABASE540) Configuring "Compaq Fortran V5.4 Tools & their Man Pages" (DFACOM540) DFADOC540, 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 "Compaq Fortran V5.4 Release Notes and Man Page" (DFADOC540) ------------------------------------------------------------------------ ------------------------------------------------------------------------ Appendix B Example of a Compaq Fortran Installation Verification Procedure (IVP) ----------------------------------------------------------------- Note: This installation guide is not necessarily revised for each release of Compaq Fortran. When installing a later version of Compaq Fortran, the displayed numbers for the subsets, version, and subset directory will be specific for that release. The following example of an IVP shows Compaq Fortran subset numbers and displayed information for a Version 5.4 IVP: csh> setld -v DFABASE540 Compaq Fortran 90 and 77 V5.4 for Compaq Tru64 UNIX Alpha Systems (DFABASE540) DFABASE540: Starting Installation Verification Procedure (IVP). Copyright 2000 Compaq Computer Corporation If this IVP fails, please include the following when submitting a report: 1) This subset name, which is DFABASE540 2) Output from: ls -l /tmp/DFABASE540.ivptmp 3) This setld session IVP, information: Created scratch directory. IVP, information: Testing the original Compaq Fortran 77 compiler IVP, information: Compiling and linking. IVP, information: Running. IVP, information: Execution of original Compaq Fortran 77 successful. IVP, information: Testing the redirected Compaq Fortran 77 compiler IVP, information: Compiling and linking. IVP, information: Running. IVP, information: Execution of redirected Compaq Fortran 77 successful. IVP, information: Testing the Compaq Fortran 90 compiler IVP, information: Compiling and linking. IVP, information: Running. IVP, information: Execution of Compaq Fortran 90 successful. IVP, information: Cleaning up. IVP, information: DFABASE540 is properly installed. csh> setld -v HPFLIBS185 Compaq Fortran V5.4 High Performance Fortran Runtime Libraries V1.8-5(HPFLIBS185) Copyright 2000 Compaq Computer Corporation Starting the verification of Compaq Fortran V5.4 High Performance Fortran Runtime Libraries V1.8-5 for Compaq Tru64 UNIX Alpha Systems Subset: Compaq Fortran V5.4 High Performance Fortran Runtime Libraries V1.8-5 (HPFLIBS185) Checking the presence of the HPF scalar libraries ... Done. Checking for the presence of the f90 compiler ... Done. Creating a sample F90 program ... Done. Compiling the sample F90 program ... Done. Linking the sample F90 program with the static HPF scalar library ... Done. Running the sample F90 program ... Done. Linking the sample F90 program with the shared HPF scalar library ... Done. Running the sample F90 program ... Done. Verification of HPFLIBS185 is successful. csh> setld -v XMDLIB5410 CXML Extended Math Libraries (Serial and Parallel) for Ev5, V4.1 (XMDLIB5410) Running CXML V4.1 IVP on usr/shlib/libcxml.so Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/shlib/libdxml.so Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/shlib/libcxml_ev5.so Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/shlib/libdxml_ev5.so Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/lib/libcxml_ev5.a Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/lib/libdxml_ev5.a Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/lib/libcxml.a Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/lib/libdxml.a Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/shlib/libcxmlp.so Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/shlib/libdxmlp.so Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/shlib/libcxmlp_ev5.so Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/shlib/libdxmlp_ev5.so Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/lib/libcxmlp_ev5.a Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/lib/libdxmlp_ev5.a Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/lib/libcxmlp.a Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK Running CXML V4.1 IVP on usr/lib/libdxmlp.a Copyright (c) Compaq Computer Corporation, 2000. All rights reserved. IVP_TEST> IVP Testing in progress IVP_TEST> CXML IVP completed OK ------------------------------------------------------------------------