 









                    HP Fortran for Alpha OpenVMS Systems
                    Installation Guide



                    October 2005

                    This guide describes how to install HP Fortran and
                    the Compaq Extended Math Library (CXML) on an Alpha
                    processor running the OpenVMS operating system.







                    Revision/Update Information:  This manual supersedes
                                                  the Version 7.6 HP
                                                  Fortran Installation
                                                  Guide for OpenVMS Alpha
                                                  Systems, AA-PU3AH-TE.

                    Operating System:             OpenVMS Alpha Version
                                                  7.1 or higher

                    Software Version:             HP Fortran Version 8.0












                    Hewlett-Packard Company
                    Palo Alto, California

 






          ________________________________________________________________

          © Copyright 2005 Hewlett-Packard Development Company, L.P.

          Confidential computer software. Valid license from HP
          required for possession, use or copying. Consistent with
          FAR 12.211 and 12.212, Commercial Computer Software,
          Computer Software Documentation, and Technical Data for
          Commercial Items are licensed to the U.S. Government under
          vendor's standard commercial license.

          The information contained herein is subject to change
          without notice. The only warranties for HP products and
          services are set forth in the express warranty statements
          accompanying such products and services. Nothing herein
          should be construed as constituting an additional warranty.
          HP shall not be liable for technical or editorial errors or
          omissions contained herein.

          Intel and Itanium are trademarks or registered trademarks
          of Intel Corporation or its subsidiaries in the United
          States and other countries.

          Printed in the US

          This document was prepared using DECdocument, Version 3.3-
          1b.

 














  _________________________________________________________________

                                                           Contents



  Preface...................................................      v

  1  Preparing for HP Fortran Installation

        1.1   What You Need to Know First...................    1-1
        1.2   Reading the Release Notes.....................    1-2
        1.3   Required Operating System Components..........    1-2
        1.4   License Registration..........................    1-3
        1.5   Installation Procedure Requirements...........    1-4
        1.5.1     Installation Account Privileges and Disk
                  Space.....................................    1-4
        1.5.2     System Parameters.........................    1-5
        1.5.2.1     Calculating Values for GBLPAGES and
                    GBLSECTIONS.............................    1-6
        1.5.2.2     Changing System Parameter Values with
                    AUTOGEN.................................    1-6
        1.6   Backing Up Your System Disk...................    1-7
        1.7   Recovering from Installation Errors...........    1-7

  2  Installing HP Fortran

        2.1   How to Install HP Fortran.....................    2-1
        2.2   Installing Compaq Extended Math Library.......    2-9
        2.3   Installing 64-Bit Tools Support...............   2-11










                                                                iii

 







    3  After Installing HP Fortran

          3.1   Running the Installation Verification
                Procedure Separately..........................    3-1
          3.2   Modifying the System-Wide Startup Command
                Procedure.....................................    3-2
          3.3   Making the Product Usable on a VMScluster.....    3-3
          3.4   Making the FORTRAN Command Available After
                Installation..................................    3-4
          3.5   Setting User Account Quotas...................    3-5
          3.6   Enhancing HP Fortran Performance..............    3-5
          3.7   Removing HP Fortran...........................    3-6
          3.8   Performing CXML Postinstallation Startup
                Tasks.........................................    3-7
          3.8.1     Setting CXML System-Wide Parameters.......    3-8
          3.8.2     Select a User-Specific Default CXML Link
                    Library...................................    3-9
          3.9   Troubleshooting the Installation..............    3-9
          3.10  Getting Help and Reporting Problems...........   3-10

    A  Files Added or Updated During Installation

    B  Installation Messages


    Tables

          1-1       Disk Space Requirements...................    1-5

















    iv

 












        _________________________________________________________________

                                                                  Preface



              This guide explains how to install HP Fortran on an Alpha
              processor system running the OpenVMS operating system.
              It also describes how to install the Compaq Extended Math
              Library (CXML).

              Keep this guide with your distribution kit. You will
              need it to install maintenance updates or to reinstall
              HP Fortran for any other reason. This manual applies to
              Version 8.0 of HP Fortran and all subsequent releases until
              a revised installation guide is issued.

        Intended Audience

              This guide is intended for system managers who install HP
              Fortran.

        Structure of This Document

              This guide contains the following chapters and appendixes:

              o  Chapter 1 describes procedures that you must complete
                 before installing HP Fortran.

              o  Chapter 2 describes how to install HP Fortran.

              o  Chapter 3 describes post-installation considerations.

              o  Appendix A lists the files installed.

              o  Appendix B lists the installation messages.




                                                                        v

 







    Related Documents

          In addition to this guide, the HP Fortran documentation set
          includes the following:

          o  The HP Fortran for OpenVMS Language Reference Manual

          o  The HP Fortran for OpenVMS User Manual

          o  A cover letter titled Read Before Installing or Using HP
             Fortran Version 8.0 for OpenVMS Alpha Systems

          o  HP Fortran online release notes

          o  CXML online release notes and the Compaq Extended Math
             Library Reference Guide.

          o  CXML
             example programs in SYS$COMMON:[SYSHLP.EXAMPLES.CXML]
             (described in the file READ_ME.INDEX in that directory)

          For the location of the cover letter and HP Fortran release
          notes, see Section 1.2.

          Once installed, you can use HP Fortran online HELP,
          which describes the command qualifiers, explains run-
          time messages, and provides a quick-reference summary of
          language topics. To use online HELP, type HELP followed by
          the command name as in the following example:

          $ HELP FORTRAN

    Reader's Comments

          You can send email to:

          fortran@hp.com

          Be sure to tell us the name of the manual and the operating
          system that you are using (that is, OpenVMS on Alpha
          servers) in the subject line or content of your email.

    HP Fortran Web Page

          The HP Fortran web page is located at:

          http://www.hp.com/go/fortran

          This Web site contains information about software patch
          kits, example programs, and additional product information.

    vi

 







        Conventions

              The following typographic conventions might be used in this
              manual:

              Ctrl/x           A sequence such as Ctrl/x indicates that
                               you must hold down the key labeled Ctrl
                               while you press another key or a pointing
                               device button.

              PF1 x            A sequence such as PF1 x indicates that
                               you must first press and release the key
                               labeled PF1 and then press and release
                               another key or a pointing device button.

              <Return>         In examples, a key name enclosed in a
                               box indicates that you press a key on
                               the keyboard. (In text, a key name is not
                               enclosed in a box.)

                               In the HTML version of this document, this
                               convention appears as brackets, rather
                               than a box.

               . . .           A horizontal ellipsis in examples
                               indicates one of the following
                               possibilities:

                               o  Additional optional arguments in a
                                  statement have been omitted.

                               o  The preceding item or items can be
                                  repeated one or more times.

                               o  Additional parameters, values, or other
                                  information can be entered.

              .                A vertical ellipsis indicates the omission
              .                of items from a code example or command
              .                format; the items are omitted because
                               they are not important to the topic being
                               discussed.

              ( )              In command format descriptions,
                               parentheses indicate that you must enclose
                               choices in parentheses if you specify more
                               than one.

                                                                      vii

 








          [ ]              In command format descriptions, brackets
                           indicate optional choices. You can choose
                           one or more items or no items. Do not
                           type the brackets on the command line.
                           However, you must include the brackets
                           in the syntax for OpenVMS directory
                           specifications and for a substring
                           specification in an assignment statement.

          |                In command format descriptions, vertical
                           bars separate choices within brackets
                           or braces. Within brackets, the choices
                           are optional; within braces, at least
                           one choice is required. Do not type the
                           vertical bars on the command line.

          { }              In command format descriptions, braces
                           indicate required choices; you must choose
                           at least one of the items listed. Do not
                           type the braces on the command line.

          bold type        Bold type represents the introduction of a
                           new term. It also represents the name of
                           an argument, an attribute, or a reason.

          italic type      Italic type indicates important
                           information, complete titles of
                           manuals, or variables. Variables include
                           information that varies in system output
                           (Internal error number), in command
                           lines (/PRODUCER=name), and in command
                           parameters in text (where dd represents
                           the predefined code for the device type).

          UPPERCASE TYPE   Uppercase type indicates a command, the
                           name of a routine, the name of a file, or
                           the abbreviation for a system privilege.

          -                A hyphen at the end of a command format
                           description, command line, or code line
                           indicates that the command or statement
                           continues on the following line.


    viii

 








              numbers          All numbers in text are assumed to be
                               decimal unless otherwise noted. Nondecimal
                               radixes-binary, octal, or hexadecimal-are
                               explicitly indicated.

              In this manual, some version numbers are given as Vn.n.
              When you install HP Fortran, the actual version numbers
              appear on your screen.




































                                                                       ix

 










                                                                        1
        _________________________________________________________________

                                    Preparing for HP Fortran Installation


              This chapter describes:

              o  Section 1.1, What You Need to Know First

              o  Section 1.2, Reading the Release Notes

              o  Section 1.3, Required Operating System Components

              o  Section 1.4, License Registration

              o  Section 1.5, Installation Procedure Requirements

              o  Section 1.6, Backing Up Your System Disk

              o  Section 1.7, Recovering from Installation Errors

        1.1 What You Need to Know First

              For this release of HP Fortran, HP provides two separate
              compilers (HP Fortran and HP Fortran 77) under one license
              and one name (HP Fortran). You can choose to install and/or
              use either compiler or both compilers.

              By default, the FORTRAN command invokes the HP Fortran
              compiler, which supports the Fortran 90 and 95 standards
              as well as older versions of the Fortran language. If you
              choose to also install the older HP Fortran 77 compiler,
              programmers can request the HP Fortran 77 compiler by using
              the /OLD_F77 qualifier on the FORTRAN command line.

              You can install the Compaq Extended Math Library (CXML)
              separately from HP Fortran, which allows you to call the
              CXML routines from either HP Fortran or HP Fortran 77.

              You can install CXML either before or after you install HP
              Fortran. When installing HP Fortran, you must install the
              HP Fortran Run-Time Library (RTL) before HP Fortran. (See
              Chapter 2.)

                                Preparing for HP Fortran Installation 1-1

 







    1.2 Reading the Release Notes

          You can extract the HP Fortran release notes to a file and
          type or print them before starting HP Fortran installation.
          The HP Fortran release notes are also installed on your
          system after installation.

          For information about using the CDMENU utility and locating
          the appropriate media CD-ROM, see the first few steps in
          Section 2.1.

          For information about reading the online release notes
          before installation, use the PRODUCT EXTRACT RELEASE_NOTES
          command described in Section 2.1 (step 6).

          HP strongly recommends that you read the release notes
          before installing HP Fortran. They contain information
          about changes to the installation and use of HP Fortran,
          such as the minimum version of the OpenVMS Alpha operating
          system required for this release of HP Fortran.

          After installation, the release notes are installed as text
          and PostScript form in:

          SYS$HELP:FORTRAN.RELEASE_NOTES
          SYS$HELP:FORTRAN_RELEASE_NOTES.PS

          Release notes for CXML are provided separately. After CXML
          installation, the CXML release notes are installed in:

          SYS$HELP:CXML_V5201_RELEASE_NOTES.TXT

          The CXML Reference Guide is also provided in PostScript
          form in the SYS$HELP directory.

    1.3 Required Operating System Components

          HP Fortran Version 8.0 requires the OpenVMS Alpha operating
          system Version 7.1 or higher.

          Future HP Fortran releases may require higher versions of
          the operating system, as described in the release notes or
          the cover letter.

          The OpenVMS operating system comes with a variety of
          support options (or components). To use HP Fortran, your
          system should be running a version of the OpenVMS operating
          system that includes the base component and the following
          other components:

    1-2 Preparing for HP Fortran Installation

 







              o  Programming support

              o  Utilities

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

        1.4 License Registration

              Before you install and run HP Fortran Version 8.0 on a
              newly-licensed node (or cluster), you must first register a
              License Product Authorization Key (License PAK), using the
              License Management Facility (LMF). CXML does not require a
              License PAK.

              Ths specific LMP product names used by HP Fortran are:

              o  FORTRAN or FORTRAN90: Unlimited or Personal-Use License

              o  FORTRAN-USER or FORTRAN90-USER: Concurrent-Use License

              The HP Fortran and HP Fortran 77 compilers will each accept
              either a FORTRAN(-USER) or FORTRAN90(-USER) PAK. It is
              not required that PAKs for both product names of a given
              license type be loaded.

              The License PAK may be shipped along with the kit if you
              ordered the license and media together. Otherwise, it is
              shipped separately to a location based on your license
              order. If you are installing HP Fortran as an update on
              a node or cluster already licensed for this software,
              you have already completed the License PAK registration
              requirements.

              If you are installing prerequisite or optional software
              along with HP Fortran, review the PAK status and install
              the PAKs for any prerequisite or optional software before
              you install HP Fortran.

              You must register and load your license for HP Fortran
              before you start the installation in order to run the
              Installation Verification Procedure (IVP) and use the
              software.

                                Preparing for HP Fortran Installation 1-3

 







          Log in to a privileged account, such as the system
          manager's account, SYSTEM. You have a choice of two ways
          to register a license:

          o  Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it
             prompts you for information, respond with data from your
             License PAK.

          o  At the DCL prompt, enter the LICENSE REGISTER command
             with the appropriate qualifiers that correspond to
             License PAK information.

          If you plan to use HP Fortran on more than one node in a
          cluster, you will need to perform a license load on the
          other nodes after you complete this installation. See
          Section 3.3.

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

    1.5 Installation Procedure Requirements

          After you have registered and loaded the license PAK and
          read the appropriate parts of this installation guide, the
          installation takes approximately 2 to 5 minutes, depending
          on your system configuration.

    1.5.1 Installation Account Privileges and Disk Space

          To install HP Fortran or CXML, you must be logged in to an
          account that has at least the following privileges enabled:

          o  BYPASS

          o  CMKRNL

          o  SYSLCK

          o  SYSPRV

          Table 1-1 lists HP Fortran's requirements for free disk
          storage space.



    1-4 Preparing for HP Fortran Installation

 







              Table_1-1_Disk_Space_Requirements__________________________

              Kit           During
              Component_____Installation__After_Installation_____________

              HP Fortran    28,000        28,000 blocks
              compiler      blocks

              HP Fortran    16,000        16,000 blocks
              77 compiler   blocks

              HP Fortran    10,000        500 blocks
              Run-Time      blocks
              Library

              HP Fortran    54,000        45,500 blocks
              complete kit  blocks

              CXML          150,000       150,000 blocks
              (optional)____blocks_______________________________________

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

              $ SHOW DEVICE SYS$SYSDEVICE

              For information on installing 64-bit tools support, see
              Section 2.3.

        1.5.2 System Parameters

              Installing HP Fortran (both compilers) requires certain
              system parameter settings.

              The minimum number of free global pagelets (512-byte
              subpage unit) and global sections needed is eleven (11)
              global sections and approximately 20,000 contiguous
              free global pagelets, plus a sufficient number of
              contiguous free global pagelets to contain the file
              SYS$LIBRARY:DCLTABLES.EXE. (See Section 1.5.2.1.)

              If the optional Compaq Extended Math Library is installed,
              an additional 18 global sections and 50,000 contiguous free
              global pagelets are required.

              These values represent the number of free global pagelets
              and global sections required for the installation, not
              the total number you need to run your system and other
              software.

                                Preparing for HP Fortran Installation 1-5

 







             ________________________ Note ________________________

             If you do not ensure that your system has the
             necessary global pagelets and global section SYSGEN
             parameters for the installation, the DCL tables can
             become corrupted in some situations.

             ______________________________________________________

    1.5.2.1 Calculating Values for GBLPAGES and GBLSECTIONS

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

          Enter the following DCL command to determine the number of
          global pagelets required by SYS$LIBRARY:DCLTABLES.EXE:

          $ DIRECTORY/SIZE SYS$LIBRARY:DCLTABLES.EXE

          This command returns the size (in blocks) of
          SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this
          figure as the number of global pagelets for the file.

          You can use the WRITE command with the F$GETSYI lexical
          function to find the number of free contiguous global
          pagelets and free global sections. The following example
          shows how to get this information at your terminal (the
          default for SYS$OUTPUT):

          $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES")
          15848
          $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")
          24

          If the value of free global pagelets or global sections is
          less than the required value (see Section 1.5.2), you must
          increase the system parameter setting.

          Section 1.5.2.2 describes the procedures for increasing
          these values using AUTOGEN.

    1.5.2.2 Changing System Parameter Values with AUTOGEN

          If you do not have enough free global pagelets or free
          global sections to install HP Fortran, you can use the
          AUTOGEN command procedure to increase the GBLPAGES or
          GBLSECTIONS system parameters.

    1-6 Preparing for HP Fortran Installation

 







              AUTOGEN automatically adjusts values for parameters that
              are associated with the values you reset manually. To
              change system parameters with AUTOGEN, edit the following
              file:

              SYS$SYSTEM:MODPARAMS.DAT

              To change a parameter value listed in this file, delete the
              current value associated with that parameter and enter the
              new value.

              To add a new parameter, add a line to the file that
              specifies the name of the parameter and its value. To
              modify incremental parameters such as GBLPAGES and
              GBLSECTIONS, use the ADD_ prefix.

              After you make all your changes, exit from the editor.

              When you execute the AUTOGEN procedure to recalculate
              your system parameters, AUTOGEN uses the information in
              your MODPARAMS.DAT file and also can automatically adjust
              some of the SYSGEN parameters based on the consumption of
              resources since the last reboot.

              For information about using AUTOGEN and its command-line
              parameters, see the HP OpenVMS System Manager's Manual,
              Volume 2: Tuning, Monitoring, and Complex Systems.

        1.6 Backing Up Your System Disk

              HP recommends that you do a system disk backup before
              installing any software. Use the backup procedures that
              are established at your site. For details on performing a
              system disk backup, see the Using VMS BACKUP manual.

        1.7 Recovering from Installation Errors

              Errors can occur during the installation if any of the
              following conditions exist:

              o  The operating system version is incorrect.

              o  The privileges or disk space for successful installation
                 are insufficient.

                                Preparing for HP Fortran Installation 1-7

 







          For descriptions of error messages generated by these and
          related conditions, see the OpenVMS Alpha documentation
          on system messages and software installation or the online
          HELP/MESSAGE command. Take the appropriate action described
          in the message.

          For information on system requirements for installing HP
          Fortran, see Section 1.3.

          For a list of problems that can cause an unsuccessful
          installation, see Section 3.9.

          To report a problem to HP, see Section 3.10.
































    1-8 Preparing for HP Fortran Installation

 










                                                                        2
        _________________________________________________________________

                                                    Installing HP Fortran


              This chapter describes:

              o  Section 2.1, How to Install HP Fortran

              o  Section 2.2, Installing Compaq Extended Math Library

              o  Section 2.3, Installing 64-Bit Tools Support

        2.1 How to Install HP Fortran

              The installation procedure loads HP Fortran product
              distribution files on to the system disk on the system
              where you perform the installation.

                ________________________ Note ________________________

                You must first install the HP Fortran Run-Time Library
                (RTL) before you install the HP Fortran compiler.

                ______________________________________________________

              Follow these steps to install HP Fortran from the OpenVMS
              Alpha Software Products Library CD-ROM set:

              1. Log in to a privileged account on the system (or
                 cluster) where you will install HP Fortran. This account
                 must have the following privileges enabled:

                 o  BYPASS

                 o  CMKRNL

                 o  SYSLCK

                 o  SYSPRV

                 If your process has the SETPRV privilege, you can enable
                 these privileges by entering the following command:

                 $ SET PROCESS/PRIVILEGE=(BYPASS,CMKRNL,SYSLCK,SYSPRV)

                                                Installing HP Fortran 2-1

 







             To check whether your process has these privileges
             enabled, enter the following command:

             $ SHOW PROCESS/PRIVILEGES

          2. To obtain the kit directory location of the HP Fortran
             product distribution files on the appropriate OpenVMS
             Alpha Software Product Library CD-ROM (media CD-ROM), do
             one of the following:

             o  Use the CDMENU utility provided on the media CD-ROM.

             o  View the CD-ROM master index file on the media CD-
                ROM.

             o  Contact the appropriate system manager.

          3. To determine whether the appropriate media CD-ROM is
             already mounted on your system, enter the following
             command:

             $ SHOW DEVICE DKA400

             ________________________ Note ________________________

             DKA400 is the device name used in examples in this
             document to show where the appropriate media CD-ROM
             has been mounted.

             ______________________________________________________

          4. If the media CD-ROM containing the HP Fortran
             installation files is not mounted, either contact the
             appropriate system manager or insert the appropriate
             media CD-ROM (write down the volume label) into an
             available CD-ROM drive. Enter the appropriate MOUNT
             command to mount the media CD-ROM (omit the /FOREIGN
             qualifier), such as the following:

             $ MOUNT DKA400 label

             Where label is the volume label of that media CD-ROM.

          5. To check that you have located the correct CD-ROM device
             and directory, use the following DIRECTORY command:

    2-2 Installing HP Fortran

 







                 $ DIRECTORY *.PCSI

                 Directory DKA400:[dir.subdir]
                 DEC-AXPVMS-FORRTL-Vnnnn-x-1.PCSI  DEC-AXPVMS-FORTRAN-Vnnnn-x-1.PCSI
                 Total of 2 files.

              6. Check that the HP Fortran compiler and Run-Time Library
                 (RTL) product distribution files copied from the HP
                 Internet FTP area and decompressed are available on your
                 local node or cluster. If it is not already mounted,
                 mount the disk (MOUNT command) containing the HP
                 Fortran product distribution files. Refer to the field
                 test cover letter for FTP copying and decompressing
                 instructions.

              7. To extract the HP Fortran online release notes before
                 you install HP Fortran, enter the following command:

                 $ PRODUCT EXTRACT RELEASE_NOTES FORTRAN /SOURCE=disk:[dir] -
                 $_/FILE=FORTRAN.RELEASE_NOTES

                 In this command, disk:[dir] is the specification of the
                 disk and directory containing the product installation
                 files. If your process default directory is the
                 directory on the CD-ROM that contains the HP Fortran
                 product distribution files, you can specify the /SOURCE
                 directory as /SOURCE=[].

                 You can view or print the file FORTRAN.RELEASE_NOTES
                 before you continue with the installation (next
                 command). For example:

                 $ TYPE/PAGE FORTRAN.RELEASE_NOTES

              8. In addition to the HP Fortran compiler (development)
                 kit, HP Fortran also provides a separate Run-Time
                 Library kit. The HP Fortran Run-Time Library (FORRTL)
                 may be freely redistributed on other OpenVMS Alpha
                 systems provided the terms specified in the Software
                 Product Description (SPD) are honored. A copy of the
                 HP Fortran SPD can be found in the [.DOCUMENTATION]
                 subdirectory of the HP Fortran product directory on the
                 OpenVMS Alpha Software Product Library CD-ROM.


                                                Installing HP Fortran 2-3

 







             The HP Fortran Run-Time Library kit contains a shared HP
             Fortran and HP Fortran 77 Run-Time Library (Fortran RTL)
             needed to execute (RUN) Fortran programs. The Fortran
             RTL kit provided with HP Fortran compiler media contains
             changes needed to run HP Fortran programs that are not
             included in the Fortran RTL version supplied with the
             OpenVMS Alpha operating system Version 7.3 or earlier.

             The Fortran RTL kit includes the shareable image
             DEC$FORRTL.EXE, which is compatible with DEC Fortran
             for OpenVMS Alpha Version 7.1 or later releases. This
             compatibility allows you to copy Fortran executable
             images from other OpenVMS systems and run them on
             systems where the DEC$FORRTL.EXE from the HP Fortran
             kit is installed.

             The Fortran RTL kit also includes an updated version
             of the Math Library shareable image DPML$SHR.EXE which
             includes support for the COMPLEX*32 datatype.

             To run HP Fortran images on other OpenVMS Alpha systems,
             you must install the Fortran RTL kit on those OpenVMS
             Alpha systems. This Fortran RTL kit can be installed
             on other licensed OpenVMS systems. See the HP Fortran
             Software Product Description (SPD) for details.

             An OpenVMS Alpha release after Version 7.2 includes RTL
             components which are sufficient to run both HP Fortran
             and HP Fortran 77 applications. The RTL kit provided
             with HP Fortran will not replace components provided by
             OpenVMS Alpha if the existing components are newer.

             To install the HP Fortran Run-Time Library, enter the
             following PRODUCT INSTALL command:

             $ PRODUCT INSTALL FORRTL /SOURCE=disk:[dir]

             Where disk:[dir] is the specification of the disk and
             directory containing the product installation files.

             The following text appears for a Run-Time Library
             installation:

             The following product has been selected:
               DEC AXPVMS FORRTL V7.6:         Layered Product

             Do you want to continue? [YES]
             Return

             Configuration phase starting ...

    2-4 Installing HP Fortran

 







                 You will be asked to choose options, if any, for each
                 selected product and for any products that may be
                 installed to satisfy software dependency requirements.

                 DEC AXPVMS FORRTL V7.6: HP Fortran Run-Time Library

                   Copyright 2003 Hewlett-Packard Development Company, L.P.

                   This software is produced by Hewlett-Packard Company

                   This software is licensed under the OpenVMS product license

                 Do you want the default values for all options [YES]
                 Return

                    Copyright 2003 Hewlett-Packard Development Company, L.P.
                    HP, the HP logo, Alpha and OpenVMS are trademarks of
                    Hewlett-Packard Development Company, L.P. in the U.S. and/or
                    other countries.

                    Confidential computer software. Valid license from HP
                    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.

                   Ignore PSCI-I-RETAIN messages

                    During installation of this product, you may see messages
                      of the form:

                   %PCSI-I-RETAIN,  'object' 'object-name' was not replaced
                    because 'object' from kit does not have higher generation
                      number

                    These messages indicate that the Run-Time Library components
                    on this kit are older than those already installed on your
                    OpenVMS system.  This is a normal situation and the messages
                    can be ignored.

                    You may also see these messages when installing a new
                    version of OpenVMS. In this case, it indicates that the
                    OpenVMS versions of the Run-Time Library components are older
                    than those already on the system.  This will occur with
                    installations of OpenVMS 8.1 or earlier. These messages can
                    be ignored also.

                   Do you want to continue? [YES]

                                                Installing HP Fortran 2-5

 







             Do you want to review the options? [NO]

             Execution phase starting . . .

             The following product will be installed to destination:
              DEC AXPVMS FORRTL V7.6       DISK$DISKNAME:[VMS$COMMON.]

             Portion done: 0%...20%...30%...40%...50%...60%...70%...80%...90%...100%

             The following product has been installed:
                 DEC AXPVMS FORRTL V7.6            Layered Product

             %PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS FORRTL V7.6 ...
             %PCSI-I-IVPSUCCESS, test procedure completed successfully

             DEC AXPVMS FORRTL V7.6: HP Fortran Run-Time Library

                Release notes are in SYS$HELP:FORRTL.RELEASE_NOTES
             $

          9. Installation of the Run-Time Library kit takes about one
             minute (depending on your system). When installation has
             been completed, the DCL $ prompt reappears.

         10. If DEC Fortran 90 Version 2.0 was previously installed
             on this system, it must be removed before HP Fortran is
             installed. To determine if DEC Fortran 90 is present,
             enter the following command:

             $ PRODUCT SHOW PRODUCT FORTRAN90

             If DEC Fortran 90 is present, something similar to the
             following text appears:

             PRODUCT
             -------
             DEC AXPVMS FORTRAN90 Vn.n

             1 item found

             If DEC Fortran 90 is not present, the following text
             appears:

             PRODUCT
             -------
             0 items found

    2-6 Installing HP Fortran

 







                 If DEC Fortran 90 is present, remove it by entering
                 the PRODUCT REMOVE command. Specify the product name
                 FORTRAN90. For example:

                 $ PRODUCT REMOVE FORTRAN90

                 The following text appears:

                 The following product has been selected:
                     DEC AXPVMS FORTRAN90 V2.0

                 %PCSI-E-CONREMUNR, optionally remove product DEC AXPVMS FORRTL V2.0
                  that is no longer required by another product
                 Do you want to take this action? [NO] <Return>
                 Do you want to continue? [YES] <Return>
                 The following product will be removed:
                     DEC AXPVMS FORTRAN90 V2.0
                 %PCSI-I-VOLINFO, estimated space information for volume DISK$vvvvvvvv
                 -PCSI-I-VOLSPC, -nnnnn required> nnnnnnn available> nnnnnnn net
                 Portion done: 0%...50%...60%...70%...80%...100%
                 The following product has been removed:
                     DEC AXPVMS FORTRAN90 V2.0

                 For more information on removing HP Fortran, see
                 Section 3.7.

             11. To install the HP Fortran compilers, enter the following
                 PRODUCT INSTALL command:

                 $ PRODUCT INSTALL FORTRAN /SOURCE=disk:[dir]

                 Where disk:[dir] is the specification of the disk and
                 directory containing the product installation files.

                 The following text appears:

                 The following product has been selected:
                   DEC AXPVMS FORTRAN V8.0             Layered Product

                 Do you want to continue? [YES] <Return>

                 Configuration phase starting ...

                 You will be asked to choose options, if any, for each selected product
                 and for any products that may be installed to satisfy software
                 dependency requirements.

                 DEC AXPVMS FORTRAN V8.0: HP Fortran for OpenVMS Alpha Systems

                   Copyright 2005 Hewlett-Packard Development Company, L.P.

                                                Installing HP Fortran 2-7

 







               This software product is sold by Hewlett-Packard Company

               PAKs used: FORTRAN or FORTRAN-USER

             Do you want the defaults for all options? [YES]

                Copyright 2005 Hewlett-Packard Development Company, L.P.

                HP, the HP logo, Alpha and Op0enVMS are trademarks of
                Hewlett-Packard Development Company, L.P. in the U.S. and/or
                other countries.

                Confidential computer software.  Valid License from HP
                required for possession, use or copying.  Consistent with
                FAR 12.211 and 12.212, Commercial Computer Software, Computer
                Software Documentation, and Technical Date for Commercial
                Items are licensed to the U.S. Government under vendor's
                standard commercial license.

             Do you want to review the options? [NO] <Return>

             Execution phase starting . . .

             The following product will be installed to destination:
                DEC AXPVMS FORTRAN V8.0            DISK$DISKNAME:[VMS$COMMON.]

             Portion done: 0%...40%...70%...80%...90%...100%

             The following product has been installed:
                DEC AXPVMS FORTRAN V8.0          Layered Product

             %PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS FORTRAN V8.0 ...
             %PCSI-I-IVPSUCCESS, test procedure completed successfully

             DEC AXPVMS FORTRAN V8.0: HP Fortran for OpenVMS Alpha Systems

                Execute SYS$STARTUP:FORT$STARTUP.COM on all other VMScluster nodes

                Type HELP FORTRAN Release_notes for release notes location

                Install Extended Math Library (CXML) if desired

                If you wish to install the Extended Math Library, which
                contains advanced mathematics routines such as BLAS, FFT and
                vector operations, install the CXML kit from the media CD-ROM.
                See the HP Fortran for OpenVMS Installation Guide for more details.

                Install DEBUG64 (ADB074) to enable 64-bit addressing support

    2-8 Installing HP Fortran

 







                    If your applications will be allocating and accessing data in
                    64-bit address space, be sure to install the DEBUG64 kit (ADB074) from
                    the media CD-ROM. This provides enhanced debug and linker support.
                    See the HP Fortran for OpenVMS Installation Guide for more details.
                    Insert the following lines in SYS$MANAGER:SYSTARTUP_VMS.COM:
                        @SYS$STARTUP:FORT$STARTUP
                 $

             12. Installation takes about 2-5 minutes (depending on your
                 system. When installation has been completed, the DCL $
                 prompt reappears.

             13. To obtain a list of files installed, enter the following
                 command:

                 $ PRODUCT SHOW OBJECT /PRODUCT=(FORTRAN, FORRTL)

              To use other features of the PCSI utility, see the
              POLYCENTER Software Installation Utility User's Guide.

        2.2 Installing Compaq Extended Math Library

              The Compaq Extended Math Library (CXML), an optional
              component, is a set of scientific subroutines optimized
              for Alpha systems, organized into the following libraries:

              o  BLAS-Basic Linear Algebra Subprograms

              o  LAPACK-Extensive library of Linear System and
                 Eigenproblem Solvers

              o  Sparse Linear System Solvers-Library of direct and
                 iterative sparse solvers

              o  Signal Processing-FFTs, sine/cosine transforms,
                 convolution, correlation and filters

              o  SCIPORT-Library of routines compatible with Cray's
                 SCILIB V7

              You can find information about CXML in the CXML online
              documentation or at the CXML Web site at:

              http://www.hp.com/techservers/software/cxml.html

              Before you install CXML, be aware that the account and
              privileges requirements are the same as for HP Fortran.
              Unless you are installing CXML from the same account
              immediately after installing HP Fortran, review steps 1
              through 6 in Section 2.1 to ensure you have the necessary

                                                Installing HP Fortran 2-9

 







          privileges, can locate the CXML installation files (in the
          same directory as the Fortran files), and can print out the
          CXML release notes before installation.

          To install the Compaq Extended Math Library, enter the
          following PRODUCT INSTALL command:

          $ PRODUCT INSTALL CXML /SOURCE=disk:[dir]

          Where disk:[dir] is the specification of the disk and
          directory containing the product installation files.

          The following text appears:

          The following product has been selected:
            DEC AXPVMS CXML V5.2-1         Layered Product

          Do you want to continue? [YES]
          Return

          Configuration phase starting ...

          You will be asked to choose options, if any, for each selected product
          and for any products that may be installed to satisfy software
          dependency requirements.

          DEC AXPVMS CXML V5.2-1: Compaq Extended Math Library for OpenVMS Alpha Systems

             Copyright 2002 Compaq Information Technologies Group, L.P.

             The CXML requires no license PAKs

          * This product does not have any configuration options.

          Execution phase starting ...

          The following product will be installed to destination:
            DEC AXPVMS CXML V5.2-1            DISK$DISKNAME:[VMS$COMMON.]

          Portion done: 0%...40%...90%...100%

          The following product has been installed:
            DEC AXPVMS CXML V5.2-1            Layered Product

          %PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS CXML V5.2-1 ...
          %PCSI-I-IVPSUCCESS, test procedure completed successfully

          DEC AXPVMS CXML V5.2-1: Compaq Extended Math Library for OpenVMS Alpha Systems

            Release notes at SYS$HELP:CXML_V5201_RELEASE_NOTES.TXT.

    2-10 Installing HP Fortran

 







                Insert the following lines in SYS$MANAGER:SYSTARTUP_VMS.COM:
                  @SYS$STARTUP:cxml$startup
              $

              Installation takes about 2 to 5 minutes (depending on your
              system). When installation has been completed, the DCL $
              prompt reappears.

              To obtain a list of files installed, enter the following
              command:

              $ PRODUCT SHOW OBJECT /PRODUCT=CXML

        2.3 Installing 64-Bit Tools Support

              If you will be using 64-bit address space data in your
              applications, you should install the enhanced 64-bit
              OpenVMS tools on your system, which include the OpenVMS
              Debugger (DEBUG64) and OpenVMS Linker (LINKER64).

              If your system has OpenVMS Version 7.2 installed, and you
              want to use the ability to allocate static data (local
              variables and COMMON) in 64-bit address space, you must
              install the DEBUG64 (ADB074) kit as it provides a new
              linker, LINKER64, which supports this new feature.

              OpenVMS Version 7.2 supports 64-bit allocation of static
              data, but does not provide LINKER64. OpenVMS versions prior
              to Version 7.2 do not support 64-bit allocation of static
              data.

              If you have a version of OpenVMS later than Version 7.2,
              check its release notes to see if DEBUG64 and LINKER64
              functionality is already included. If the DEBUG64 kit is
              installed, LINKER64 is made the system default linker.
              It can be used as a general replacement for the OpenVMS-
              supplied linker.

              DEBUG64 can be installed on OpenVMS Versions 6.2 and later.
              (Note that HP Fortran supports OpenVMS Version 7.1 and
              later.) The DEBUG64 kit is provided on your media CD-ROM in
              the same directory where the Fortran compiler kit files are
              located.


                                               Installing HP Fortran 2-11

 







          For more details on the capabilities of DEBUG64, see the
          release notes file ADB074.RELEASE_NOTES. You can view
          the release notes before installation (see below). After
          installation, the release notes are installed on the system
          in SYS$HELP:ADB074.RELEASE_NOTES.

          Follow these steps to install DEBUG64:

          1. Log in to a privileged account on the system (or
             cluster) where you will install HP Fortran. This account
             must have the following privileges enabled:

             o  BYPASS

             o  CMKRNL

             o  SYSLCK

             o  SYSPRV

             If your process has the SETPRV privilege, you can enable
             these privileges by entering the following command:

             $ SET PROCESS/PRIVILEGE=(BYPASS,CMKRNL,SYSLCK,SYSPRV)

             To check whether your process has these privileges
             enabled, enter the following command:

             $ SHOW PROCESS/PRIVILEGES

          2. To obtain the kit directory location of the HP Fortran
             product distribution files on the appropriate OpenVMS
             Alpha Software Product Library CD-ROM (media CD-ROM), do
             one of the following:

             o  Use the CDMENU utility provided on the media CD-ROM.

             o  View the CD-ROM master index file on the media CD-
                ROM.

             o  Contact the appropriate system manager.

          3. To determine whether the appropriate media CD-ROM is
             already mounted on your system, enter the following
             command:

             $ SHOW DEVICE DKA400

             ________________________ Note ________________________

             DKA400 is the device name used in examples in this
             document to show where the appropriate media CD-ROM

    2-12 Installing HP Fortran

 







                has been mounted.

                ______________________________________________________

              4. If the media CD-ROM containing the HP Fortran
                 installation files is not mounted, either contact the
                 appropriate system manager or insert the appropriate
                 media CD-ROM (write down the volume label) into an
                 available CD-ROM drive. Enter the appropriate MOUNT
                 command to mount the media CD-ROM (omit the /FOREIGN
                 qualifier), such as the following:

                 $ MOUNT DKA400 label

                 Where label is the volume label of that media CD-ROM.

              5. To check that you have located the correct CD-ROM device
                 and directory, use the following DIRECTORY command:

                 $ DIRECTORY ADB*.*

                 Directory DKA400:[dir.subdir]

                 ADB074.A         ADB074.B          ADB074.C     ADB074.D

                 Total of 3 files.

              6. To extract the DEBUG64 online release notes before you
                 install the DEBUG64 kit, enter the following command:

                 $ @SYS$UPDATE:VMSINSTAL ADB074 disk:[dir] OPTIONS N

                 The release notes are copied to SYS$HELP:ADB074.RELEASE_
                 NOTES. VMSINSTAL then displays the following text:

                 Additional Release Notes Options:

                  1.  Display release notes
                  2.  Print release notes
                  3.  Both 1 and 2
                  4.  None of the above

                 * Select option [2]:
                 Return

                 Select the option number needed and press Return
                 (default is item 2).

                 You are given the opportunity to proceed with the
                 installation or exit immediately.

                                               Installing HP Fortran 2-13

 







          7. To install DEBUG64, enter the following command:

             $ @sys$update:vmsinstal ADB074 disk:[dir]

             The following text appears:

               OpenVMS AXP Software Product Installation Procedure V7.3.1

             It is 15-MAY-2003 at 14:48.

             Enter a question mark (?) at any time for help.

             * Are you satisfied with the backup of your system disk [YES]?
             Return

             The following products will be processed:

              ADB V7.4

                   Beginning installation of ADB V7.4 at 14:48

             %VMSINSTAL-I-RESTORE, Restoring product save set A ...
             %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.

             **************************************************************

              OpenVMS Alpha Debug V7.4

              Copyright 1978 Compaq Compuer Corporation

              COMPAQ Registered in U.S. Patent and Trademark Office. All other product
              names mentioned herein may be trademarks or registered trademarks of their
              respective companies.
              .
              .
              .

             *********************************************************************
              This kit installs Debug version V7.4.  It will install on Alpha
              OpenVMS V6.2 to V7.3-1 systems.

              This kit requires an installed DCE for its client/server configurations
              (see release motes).  If DCE is not installed, the "server" portion of
              the debugger cannot be linked and a warning is printed during the
              installation, for example, "%ADB-W-LINKABORT, NO DEBUGSRVSHR linked,
              SYS$LIBRARY:DCE$LIB_SHR missing (install DCE)".  You can safely ignore
              this message.  The normal operation of the debugger is not affected,
              however, the client/server mode will NOT be operational.

              If DECWindows Motif V1.2 is installed a new Heap Analyzer will be also
              installed on V7.1 or later systems.

    2-14 Installing HP Fortran

 







                  If your system is later upgraded from V6 to V7 or if DCE or MOTIF are
                  later installed, then this kit MUST be rerun, i.e. the V7.3 debugger
                  MUST be reinstalled.

                  On V7.1-2 and later systems this kit will also optionally install new
                  process dump and process dump analysis tools: new process dump analysis
                  DEBUG kernel, new SDA, and new IMGDMP (image dump). Old style process
                  dumps are NOT compatible with this new style.  New process dumps can be
                  analyzed through the new kept debugger ANALYZE/PROCESS_DUMP/IMAGE_PATH
                  command (enter it at the DBG> prompt).  The DCL ANALYZE/PROCESS_DUMP
                  command can also be used to invoke the debugger process dump analysis.
                  You can also view new process dumps with the new SDA through the DCL
                  ANALYZE/CRASH command.

                  If you chose to install the new process dump and process dump analysis
                  tools, the new System Code and System Dump Debuggers (SCD and SDD) ARE
                  also installed.

                  The debuggers and (optionally) process dump tools installed by this kit
                  coexist with your regular system supplied ones, that is, it does NOT
                  replace them.  Procedures are included that will allow you to set up to
                  these new tools or the regular system ones.  However, the kit will
                  replace any previous V7.4 versions that may be installed AND it will
                  request to remove any earlier network kit debuggers, e.g.V72X.

                  "%INSTALL-I-NONSHRADR, image installed ignoring '/SHARE=ADDRESS'...
                  SYSTEM-F-NOPRIV, insufficient privilege or object protection violation"
                  errors for TRACE and IMGCMP may occur during setup for the IVP.  These
                  errors can be safely ignored for the IVP (which does not actually test
                  TRADE or IMGDMP).  However, to correct TRACE and IMGDMP installation
                  SYS$STARTUP:DEBUG$STARTUP_V74 must be run from a privileged account
                  after vmsinstal completes.

                 * Do you want to install the new process dump tools [YES]?
                 Return

                 This installation should take 15 minutes or less.

                 * Do you want to run the IVP after the installation [YES]?
                 Return

                 *
                 Do you want to run the interactive DECwindows Motif IVP? [NO]?
                 Return

                 * Do you want to purge files replaced by this installation [YES]?
                 Return

                                               Installing HP Fortran 2-15

 







             * Do you want to remove obsolete versions of network debuggers (recommended)
                  [YES]?
             Return

             %ADB-I-DONEASK, No further questions will be asked during this installation.
             %VMSINSTAL-I-RESTORE, Restoring product save set B ...
             %VMSINSTAL-I-RESTORE, Restoring product save set C ...
             %VMSINSTAL-I-RESTORE, Restoring product save set D ...
             %ADB-I-ENDRESTORE, All Debugger savesets have been restored.
             %ADB-I-LINKING, Linking V7 images.
             %ADB-I-LINKDONE, DEBUGSHR has been linked.
             %ADB-I-LINKDONE, DEBUG has been linked.
             %ADB-I-LINKDONE, DEBUGUISHR has been linked.
             %ADB-I-LINKDONE, DEBUGSRVSHR has been linked.
             %ADB-I-LINKDONE, HA_MAIN has been linked.
             %ADB-I-LINKDONE, HA_KERNEL has been linked.
             %ADB-I-LINKDONE, TRACE has been linked.
             %ANALYZE-I-ERRORS, VMI$ROOT:[SYS$LDR]SYS$LDR]SYS$BASE_IMAGE.EXE>1     0 errors
             %ADB-I-LINKDONE, SDA has been linked.
             %ADB-I-LINKDONE, IMGDMP, IMGDMP_RIGHTS, and PRGDEVMSG have been linked.
             %ADB-I-LINKDONE, Process dump DEBUG kernel has been linked.
             %ADB-I-LINKDONE, System dump DEBUG kernel has been linked.
             %ADB-I-LINKDONE, System code DEBUG kernel has been linked.
             %ADB-I-CLEANUP, Cleanup has been performed.
             %ADB-I-PROHELP, Providing Debugger Help files...
             %ADB-I-PROMSG, Providing Debugger message image...
             %ADB-I-PROMSG, Providing Debugger .CLD file...
             %ADB-I-PROEXE, Providing Debugger files...
             %ADB-I-PROEXE, Providing Heap Analyzer files...
             %ADB-I-PROEXE, Providing new process dump tools...
             %ADB-I-UNINSTALL, Uninstalling obsolete network kit debuggers
             OpenVMS Debugger Uninstall Procedure
             Copyright 2002 Compaq Information Technologies Group, L.P.
             %ADB-I-PROMSG, Providing startup files ...











    2-16 Installing HP Fortran

 







                  If you want the debuggers installed by this kit to be the default
                  system debuggers:
                   - Add the following line to the system startup procedure:
                      $ @SYS$STARTUP:DEBUG$STARTUP_V74.COM V74
                     You should remove any other *DEBUG$STARTUP*.COM reference.
                   - Enter the following DCL command from a privileged account on each
                     and every Alpha node of your VMScluster that you wish to upgrade:
                        @SYS$STARTUP:DEBUG$STARTUP_V74.COM V74
                     Note that this is a /SYSTEM table setup (also see
                     SYS$STARTUP:DEBUGSETUP.COM) and modifies your DCL command tables.
                     The DCL DEBUG /CLIENT and /SERVER switches on pre V7.2 systems
                     may not be seen and the /KEPT invocation may not be redirected
                     for active processes (until they are logged-off and restarted).

                   If you want the regular system supplied debuggers (and process dump tools)
                   to be the default, then do the same as above but use "VMS" as the input
                   parameter, for example:

                       @SYS$STARTUP:DEBUG$STARTUP_V74.COM VMS

                   Users can also individually and dynamically switch debuggers (and process
                   dump tools) by using SYS$STARTUP:DEBUGSETUP.COM.  Its input options are
                   VMS, V74, or UNSET. It also needs the logical table switch /JOB or /SYSTEM.
                   switch.  For example:

                       @SYS$STARTUP:DEBUGSETUP.COM V74 /JOB

                 %ADB-I-PROIVP, Providing test files for IVP...

                  The Debugger IVP has been moved to the SYS$TEST  directory.  To run the
                  IVP after installation, first make sure you are setup to use the V74
                  debugger, e.g. executing the command "@SYS$STARTUP:DEBUGSETUP V74 /JOB"
                  Then, run the character cell IVP by executing the command
                  "@SYS$TEST:DBG$IVP.COM" or, if DECWindows Motif has been installed on
                  your system, run the interactive DECWindows Motif IVP by executing the
                  command "@SYS$TEST:DBG$DW$IVP.COM"

                 %ADB-I-INSTALLDONE, OpenVMS Alpha Debug V7.4 installation done
                 %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

                  Beginning the Debug V7.4 Verification Procedure

                  Copyright 1988 Compaq Computer Corporation

                  Debug verification procedure successful.

                   Installation of ADB V7.4 completed at 14:56

                  Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY

                                               Installing HP Fortran 2-17

 







              Creating installation data file: VMI$ROOT:[SYSUPD]ADB074.VMI_DATA
               VMSINSTAL procedure done at 14:56

          8. Edit your system startup procedure as described in the
             above displayed text.








































    2-18 Installing HP Fortran

 










                                                                        3
        _________________________________________________________________

                                              After Installing HP Fortran


              You can perform the following tasks after HP Fortran is
              installed:

              o  Section 3.1, Running the Installation Verification
                 Procedure Separately

              o  Section 3.2, Modifying the System-Wide Startup Command
                 Procedure

              o  Section 3.3, Making the Product Usable on a VMScluster

              o  Section 3.4, Making the FORTRAN Command Available After
                 Installation

              o  Section 3.5, Setting User Account Quotas

              o  Section 3.6, Enhancing HP Fortran Performance

              o  Section 3.7, Removing HP Fortran

              o  Section 3.8, Performing CXML Postinstallation Startup
                 Tasks

              o  Section 3.9, Troubleshooting the Installation

              o  Section 3.10, Getting Help and Reporting Problems

        3.1 Running the Installation Verification Procedure Separately

              The HP Fortran Installation Verification Procedure (IVP)
              runs automatically during HP Fortran installation.
              Similarly, the Compaq Extended Math Library (CXML) IVP
              runs during CXML installation.

              If system problems occur, you should run the HP Fortran IVP
              separately to ensure the integrity of the installed files.
              To run the IVP, enter the following command:

              $ @SYS$TEST:FORT$IVP.COM

                                          After Installing HP Fortran 3-1

 







          If any problems are encountered, a message such as the
          following appears:

          HP Fortran Version 8.0 TEST FAILED

          Similarly, you can run the CXML IVP after installation,
          or at other times, to ensure the integrity of installed
          files if system problems have occurred. You need system
          privileges to run the CXML IVP. To run the CXML IVP,
          execute the following command procedure:

          $ @SYS$TEST:CXML_IVP.COM

          If the IVP runs successfully, you will see the following
          display:

          CXML-I-IVP> Completed CXML Vnnnn Installation Verification Procedure

    3.2 Modifying the System-Wide Startup Command Procedure

          Add the following lines to the system-wide startup file
          (if you have not done so previously), such as the file
          SYS$MANAGER:SYSTARTUP_VMS.COM or a command procedure that
          it invokes:

          $ @SYS$STARTUP:FORT$STARTUP
          $ @SYS$STARTUP:CXML$STARTUP

          These command procedures install HP Fortran and CXML images
          in memory and perform related actions.

          The Fortran startup procedure line does not take any
          parameters (arguments).

          The CXML startup procedure line lets you specify certain
          parameters to:

          o  Control the default CXML link library

          o  Specify names of CXML shareable images to be installed
             as shared images

          o  Specify names of CXML shareable images to be installed
             as resident images

          Among other things, inserting this line in the startup
          procedure makes the correct CXML library available
          automatically, eliminating the need for the user to
          explicitly specify the CXML link library on the LINK
          command line.

    3-2 After Installing HP Fortran

 







              In addition, individual users can select a user-
              specific default CXML link library, by executing the
              SYS$LIBRARY:CXML$SET_LIB command procedure.

              For more information on the CXML startup procedure
              arguments and specifying a user-specific default CXML link
              library, see Section 3.8.

        3.3 Making the Product Usable on a VMScluster

              If you want to run HP Fortran on multiple nodes of
              a VMScluster, first check to see that you have the
              appropriate software license (see Section 1.4). Then
              perform the following steps after you install HP Fortran:

              1. Issue the LICENSE LOAD command, as described in the HP
                 OpenVMS License Management Utility Manual, to activate
                 the license on each node in the VMScluster on which HP
                 Fortran is to be executed.

              2. The commands in this step should be executed on all
                 cluster nodes, whether or not they are licensed to use
                 HP Fortran; failure to do so may cause unexpected errors
                 for users.

                ________________________ Note ________________________

                If you are using a dual-architecture (VAX and Alpha
                systems) heterogeneous cluster, before executing these
                commands, make sure the appropriate logical names
                have been set to define the scope of the SYSMAN DO
                commands. For more information, see the HP OpenVMS
                System Manager's Manual.

                ______________________________________________________

              3. While logged in as SYSTEM, or as another username that
                 has the CMKRNL and SYSPRV privileges enabled, use the
                 OpenVMS SYSMAN utility to make the new versions of
                 shareable images available, as follows:





                                          After Installing HP Fortran 3-3

 







             $ RUN SYS$SYSTEM:SYSMAN
             SYSMAN> SET ENVIRONMENT/CLUSTER
             %SYSMAN-I-ENV, current command environment:
                  Clusterwide on local cluster
                  Username SYSTEM       will be used on nonlocal nodes
             SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE
             %SYSMAN-I-OUTPUT, command execution on node NODE1
             %SYSMAN-I-OUTPUT, command execution on node NODE2
             SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DEC$FORRTL.EXE
             %SYSMAN-I-OUTPUT, command execution on node NODE1
             %SYSMAN-I-OUTPUT, command execution on node NODE2
             SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DPML$SHR.EXE
             %SYSMAN-I-OUTPUT, command execution on node NODE1
             %SYSMAN-I-OUTPUT, command execution on node NODE2

             If any of the INSTALL commands fail, reboot the affected
             node.

             The SYSMAN utility will cause each DO command to be
             executed on all nodes of the local cluster.

          4. The SYS$STARTUP:FORT$STARTUP.COM file installs the
             compilers as a known image. This command procedure
             file should be executed on all cluster nodes using the
             following DO command:

             SYSMAN> DO @SYS$STARTUP:FORT$STARTUP
             %SYSMAN-I-OUTPUT, command execution on node NODE1
             %SYSMAN-I-OUTPUT, command execution on node NODE2

          5. Finally, exit from SYSMAN.

             SYSMAN> EXIT
             $

    3.4 Making the FORTRAN Command Available After Installation

          HP Fortran is now installed and can be invoked by all users
          with the FORTRAN command.

          The installation procedure modifies the DCL command table
          so that the FORTRAN commands are recognized and processed.
          However, the previous command table is still in effect for
          those users who are currently logged in.

    3-4 After Installing HP Fortran

 







              All logged-in users who want to use the FORTRAN command
              must log out and log in again, or use the following DCL
              command:

              $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES

        3.5 Setting User Account Quotas

              No special privileges are needed to use HP Fortran.
              There is no benefit from installing the compilers with
              privileges.

              To use HP Fortran, a user account does not need to meet any
              special quota requirements. However, for users who will be
              compiling very large programs (many program units compiled
              together) or running very large performance-critical
              programs, consider the adjusting working set (WSDEF,
              WSQUOTA, WSEXTENT) and page file (PGFLQUOTA) account quotas
              to improve performance.

              Use the OpenVMS Authorize Utility from a suitably
              privileged account to change the process quotas in the
              user authorization file (UAF). Some sites may restrict the
              use of the Authorize Utility to certain accounts or people.

              After the quotas for the account have been changed, the
              user should log out of the account and log in again for the
              new quotas to take effect.

              For information on using the Authorize Utility, see the HP
              OpenVMS System Manager's Manual, Volume 1: Essentials.

        3.6 Enhancing HP Fortran Performance

              This section includes information on system tuning and
              explains how to install HP Fortran as a shared image.

              After you install HP Fortran, you might want to adjust
              your system to enhance performance or lower the use of some
              system resources.

              If users will be compiling very large programs (many
              program units compiled together) or running very large
              performance-critical programs, consider the following:

              o  Check that adequate page file space exists. Large
                 programs need more virtual memory during compilation and
                 execution than small programs. Use the INSTALL command

                                          After Installing HP Fortran 3-5

 







             to extend an existing page file or create one or more
             new page files.

          o  The SYSGEN parameter virtual page count is related to
             the total amount of page file space. If you create more
             page file space, review the virtual page count parameter
             and increase it if necessary.

          o  The SYSGEN parameter maximum working set (WSMAX) might
             also be checked if a larger process working set is
             needed.

          For more information on page file use and SYSGEN
          parameters, see the HP OpenVMS System Manager's Manual,
          Volume 2: Tuning, Monitoring, and Complex Systems.
          For information about system tuning and performance
          investigation, see the Guide to OpenVMS Performance
          Management.

    3.7 Removing HP Fortran

          To remove HP Fortran from the system, use the following
          command:

          $ PRODUCT REMOVE FORTRAN

          You may be asked if you would like to also remove the
          FORRTL product. HP recommends that you answer NO to this
          prompt.

          After removing HP Fortran from the system, remove the call
          to SYS$STARTUP:FORT$STARTUP.COM from your system startup
          procedure.

          To remove Compaq Extended Math Library from the system, use
          the following command:

          $ PRODUCT REMOVE CXML

          After removing Compaq Extended Math Library from the
          system, remove the call to SYS$STARTUP:CXML$STARTUP.COM
          from your system startup procedure.



    3-6 After Installing HP Fortran

 







        3.8 Performing CXML Postinstallation Startup Tasks

              As part of the post-installation process described in
              Section 3.2, you need to add the following line to your
              system's startup procedure:

              @SYS$STARTUP:CXML$STARTUP

              Among other things, inserting this line in the startup
              procedure will make the correct CXML library available
              automatically, eliminating the need for the user to
              explicitly specify the CXML link library on the LINK
              command line.

              In addition, individual users can select a user-
              specific default CXML link library, by executing the
              SYS$LIBRARY:CXML$SET_LIB command procedure, as described
              in Section 3.8.2.

              This command procedure has three system-wide default
              parameters, which you can optionally change (as described
              below). The default parameters control the following
              things:

              o  The first parameter sets the default CXML link library.
                 Its default value is "IEEE".

              o  The second parameter is a list of the names of CXML
                 shareable images to be installed as shared images. Its
                 default value is " " (none).

              o  The third parameter is a list of the names of CXML
                 shareable images to be installed as resident images.
                 Its default value is " " (none).

              If the default parameter values described above are
              acceptable, you can skip the rest of this step.

              If you want to change any of these parameters, use the
              following instructions.





                                          After Installing HP Fortran 3-7

 







    3.8.1 Setting CXML System-Wide Parameters

          The first parameter controls the default CXML link library.
          If it has the value "IEEE", the library of routines using
          IEEE floating-point format will be designated as the
          default CXML link library. If its value is "VAX", the
          library of VAX floating-point format routines will be
          designated as the default CXML link library. The default
          value of this first parameter is "IEEE". If it does not
          have the value "VAX" or "IEEE", an error message will be
          given.

          The second parameter is a list of the names of CXML
          shareable images to be installed as shared images. Its
          default value is "".

          The third parameter is a list of the names of CXML
          shareable images to be installed as resident images. Its
          default value is "".

          The list entries are not case-sensitive. If more than one
          name appears in a list, the names are separated by commas.
          The list may contain only the above names and comma(s). If
          a CXML shareable image name appears in both lists, it will
          be installed as a shared image.

          For example, the following command will set the default
          CXML link library to be the one using IEEE floating-point
          format and will install the IEEE-format COMMON shareable
          image along with all the IEEE-format BLAS shareable images
          as resident images. No other CXML shareable images will be
          installed.

          $ @SYS$STARTUP:CXML$STARTUP IEEE "" -
          $_ IEEE_BLAS1,IEEE_BLAS1E,IEEE_BLAS2,IEEE_BLAS3,IEEE_COMMON

          To install CXML images, your system must have sufficient
          resources available. Refer to the following tables to
          obtain the total number of global resources required.

          If you are installing images as a /SHARED resource, add
          all relevant entries under the columns GBLPAGES and
          GBLSECTIONS. Then check that your system is configured
          with a sufficient number of free global pages and free
          global sections to accommodate the images to be installed.

    3-8 After Installing HP Fortran

 







              If you are installing images as /RESIDENT resources, add
              all relevant entries under the column GH_RSRVPGCNT. Check
              that your system has sufficient free pages in the resident
              image code area of the granularity hint region.

        3.8.2 Select a User-Specific Default CXML Link Library

              Individual users can change the CXML link library by
              changed by invoking SYS$LIBRARY:CXML$SET_LIB from their
              process.

              The system-wide default CXML link library is set using
              the system startup file SYS$STARTUP:CXML$STARTUP, as
              described in Section 3.8.1. In addition, individual users
              may change their own specific default library by invoking
              SYS$LIBRARY:CXML$SET_LIB themselves. For example, the
              following command alters the default CXML link library
              for the current user to the VAX format library:

              $ @SYS$LIBRARY:CXML$SET_LIB VAX

              For information on using CXML, see the Compaq Extended Math
              Library Reference Guide or the Web site at:

              http://www.hp.com/techservers/software/cxml

        3.9 Troubleshooting the Installation

              If your installation is not successful, check for the
              following possible problems:

              o  The appropriate PAK must be available to the user
                 performing the installation. The PAK must be registered
                 and loaded before you can install HP Fortran. For
                 information about registering a PAK, see Section 1.4.
                 Then reinstall HP Fortran.

              o  The DCLTABLES.EXE file should be in the
                 SYS$COMMON:[SYSLIB] directory. There should not be a
                 copy of DCLTABLES.EXE in SYS$SPECIFIC:[SYSLIB].

                 If a copy of DCLTABLES.EXE is found in a SYS$SPECIFIC
                 root, rename it to DCLTABLES.OLD, do an INSTALL REPLACE
                 SYS$LIBRARY:DCLTABLES, then reinstall HP Fortran.

              o  The system logical name SYS$SYSROOT should not be
                 modified from the preset definition provided by the
                 OpenVMS Alpha operating system.

                                          After Installing HP Fortran 3-9

 







    3.10 Getting Help and Reporting Problems

          If an error occurs while HP Fortran is in use and you
          believe the error is caused by a problem with HP Fortran,
          do one of the following:

          o  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.

          o  If you do not have a service contract, you can arrange
             for per-call CSC support.

          When you initially contact the CSC, indicate the following:

          o  The name and version number of the operating system
             (OpenVMS Alpha) you are using

          o  The name (HP Fortran) and version number of HP Fortran
             you are using

          o  The hardware system you are using (such as a model
             number)

          o  How critical the problem is

          o  A very brief description of the problem (one sentence if
             possible)

          When you submit information electronically or are speaking
          on the phone to the appropriate support specialist, you
          can provide more detailed information. This includes the
          specific commands used to compile and link the program, the
          error messages displayed, and relevant detailed information
          (possibly including source program listings). Ttry to
          narrow the cause of the problem to a specific source module
          or lines of code.

          CSC personnel may ask for additional information, such
          as listings of any command files, INCLUDE files, relevant
          data files, and so forth. If the program is longer than
          50 lines, submit a copy of it electronically or provide
          machine-readable media (floppy diskette or magnetic tape).

    3-10 After Installing HP Fortran

 







              Experience shows that problem reports sometimes do not
              contain enough information to duplicate or identify the
              problem. Concise, complete information helps HP give
              accurate and timely service to software problems.

              To obtain information about purchasing HP support services,
              contact your local sales representative.

              You can also send comments and questions about the
              HP Fortran product to the following email address:
              fortran@hp.com


































                                         After Installing HP Fortran 3-11

 










                                                                        A
        _________________________________________________________________

                               Files Added or Updated During Installation


              This appendix lists, for each of the installable kits,
              the files that are added to or updated on your OpenVMS
              system during installation. Note that some files may not
              be installed depending on selected options or your system's
              configuration or operating system version.

              FORTRAN (Fortran Compiler)

              [SYS$STARTUP]FORT$STARTUP.COM
              [SYSEXE]F90$MAIN.EXE
              [SYSEXE]FORT$FSPLIT.EXE
              [SYSEXE]FORT$MAIN.EXE
              [SYSHLP]FORTRAN.RELEASE_NOTES
              [SYSHLP]FORTRAN_RELEASE_NOTES.PS
              [SYSLIB]FORSYSDEF.TLB
              [SYSLIB]FORT$FORTRAN-F77.CLD
              [SYSLIB]FORT$FORTRAN-F95.CLD
              [SYSMSG]F90$MSG.EXE
              [SYSMSG]FORT$MSG.EXE
              [SYSMSG]FORT$MSG2.EXE
              [SYSTEST]FORT$IVP.COM

              FORRTL (Fortran Run-Time Libary)

              [SYSHLP]FORRTL.RELEASE_NOTES
              [SYSLIB]DEC$FORRTL.EXE
              [SYSLIB]DPML$SHR.EXE
              [SYSLIB]FORDEF.FOR
              [SYSLIB]FORIOSDEF.FOR
              [SYSTEST]FOR$RTL_IVP.COM
              [SYSTEST]FOR$RTL_IVP.OBJ
              [SYSUPD]FOR$INSTALL_FORRTL.COM

              CXML (Extended Math Library)


                           Files Added or Updated During Installation A-1

 








          [SYS$STARTUP]CXML_STARTUP.COM
          [SYSHLP]CXML_LAPACK_C.TXT
          [SYSHLP]CXML_LAPACK_D.TXT
          [SYSHLP]CXML_LAPACK_S.TXT
          [SYSHLP]CXML_LAPACK_Z.TXT
          [SYSHLP]CXML_V5201_RELEASE_NOTES.PS
          [SYSHLP]CXML_V5201_RELEASE_NOTES.TXT
          [SYSHLP.EXAMPLES.CXML]CXML_ITSOL_PRINT.FOR
          [SYSHLP.EXAMPLES.CXML]CXML_REBUILD_MOD_FILES.COM
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_DSS.C
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_DSS.F
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_DSS.F90
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_ITSOL_1.C
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_ITSOL_1.CXX
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_ITSOL_1.FOR
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_ITSOL_2.FOR
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_ITSOL_3.FOR
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_ITSOL_4.FOR
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_ITSOL_5.FOR
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_LAPACK_1.C
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_LAPACK_1.FOR
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_LAPACK_2.FOR
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_SFFT_1D.C
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_SFFT_2D.C
          [SYSHLP.EXAMPLES.CXML]EXAMPLE_SIG_PROC.FOR
          [SYSHLP.EXAMPLES.CXML]READ_ME.INDEX
          [SYSHLP]CXML.HLP
          [SYSLIB]CXML_EMACS.ML
          [SYSLIB]CXML_EVE.TPU
          [SYSLIB]CXML_FGS.OLB
          [SYSLIB]CXML_SET_LIB.COM
          [SYSLIB]CXML_STS.OLB
          [SYSLIB]CXML_STS_SCIPORT.OLB
          [SYSLIB]CXMLDEF.FOR
          [SYSLIB]CXMLDEF.H
          [SYSLIB]CXML_DSS.F77
          [SYSLIB]CXML_DSS.F90
          [SYSLIB]CXML_DSS.F90$MOD
          [SYSLIB]CXML_DSS.H
          [SYSLIB]CXML_DSS.HXX
          [SYSLIB]CXML_DSS_PRIVATE.F90$MOD
          [SYSLIB]CXML_EQUIVALENCE_LAPACK.C


    A-2 Files Added or Updated During Installation

 







              [SYSTEST.CXML]BLAS_BUILD_TEST.OBJ
              [SYSTEST.CXML]DSS_BUILD_TEST.OBJ
              [SYSTEST.CXML]IVP_LAPACK_IEEE.OBJ
              [SYSTEST.CXML]IVP_LAPACK_VAX.OBJ
              [SYSTEST.CXML]IVP_SIG_IEEE.OBJ
              [SYSTEST.CXML]IVP_SIG_VAX.OBJ
              [SYSTEST.CXML]IVP_SPARSE_B1_IEEE.OBJ
              [SYSTEST.CXML]IVP_SPARSE_B1_VAX.OBJ
              [SYSTEST.CXML]IVP_SPARSE_IS_IEEE.OBJ
              [SYSTEST.CXML]IVP_SPARSE_IS_VAX.OBJ
              [SYSTEST.CXML]IVP_VLIB_IEEE.OBJ
              [SYSTEST.CXML]IVP_VLIB_VAX.OBJ
              [SYSTEST.CXML]LAPACK_BUILD_TEST.OBJ
              [SYSTEST.CXML]SIG_PROC_BUILD_TEST.OBJ
              [SYSTEST.CXML]SORT_BUILD_TEST.OBJ
              [SYSTEST.CXML]SPARSE_BUILD_TEST.OBJ
              [SYSTEST.CXML]VLIB_BUILD_TEST.OBJ
              [SYSTEST]CXML_IVP.COM
              [SYSUPD]CXML_REMOVE_FILES.COM


























                           Files Added or Updated During Installation A-3

 










                                                                        B
        _________________________________________________________________

                                                    Installation Messages


              This appendix lists the more common diagnostic messages
              you might see during product installation. If you encounter
              a message not shown here, use the HELP/MESSAGE command
              to display information about it. If you add the /LOG
              qualifier to the PRODUCT INSTALL command, many additional
              informational messages will be displayed, which can be
              ignored.

              FAILCONF, failed to resolve conflicting requirements for 'object-type'
              'object-name'

              Explanation:  More than one product supplies a managed object of the same
                            name, type, and scope. They cannot coexist because of a
                            conflict in the objects' properties. Files, directories, and
                            library modules are examples of managed objects.

              User Action:  If you are installing the FORRTL kit on OpenVMS 7.1, ignore this
                            message and continue the installation.  Otherwise, report the
                            problem to HP.

              INSTALLERR,  error executing DCL INSTALL command

              Explanation:  The POLYCENTER Software Installation utility installs a file
                            as a known image by having the DCL command INSTALL execute in
                            a subprocess. The INSTALL command failed.

              User Action:  Take action based on the accompanying messages. If you specify
                            the /TRACE qualifier when you retry the operation, you can
                            view the command sent to the subprocess.

              IVPFAILURE,  test procedure completed with an error status

              Explanation:  The installation verification test procedure for the product
                            completed with an exit status that indicates a failure. If you
                            were executing a PRODUCT INSTALL command, the product has been
                            completely installed, but its test procedure failed.

                                                Installation Messages B-1

 







          User Action:  Take action based on the accompanying messages. If you specify
                        the /TRACE qualifier when you retry the operation, you can
                        view the commands sent to the subprocess and the output
                        generated when these commands are executed.

          RETAIN,  'object' 'object-name' was not replaced because 'object'
          from kit does not have higher generation number

          Explanation:  During installation of a software product (or a patch to
                        a software product), the specified object (either a file
                        or a library module) was not copied from the kit to the
                        destination disk. The installation utility found an object
                        with the same name already installed on the destination disk
                        and that object's generation (sequencing) number was the same
                        or greater than the generation number of the object from the
                        kit. Therefore, the object with the latest generation number
                        (the previously installed item) was left on your destination
                        disk.

                 This condition typically occurs when you install multiple
                        patches or updates to the same product. The installation
                        utility performs conflict detection and resolution so that
                        your system will always retain the most current files even if
                        updates are not installed in chronological order.

          User Action:  None.



















    B-2 Installation Messages
