Compaq Fortran
Installation Guide for
OpenVMS Alpha Systems
Previous Contents

Chapter 2
Installing Compaq Fortran

This chapter describes:

Before you start the installation, read Chapter 1, which describes the general options and requirements for installing Compaq Fortran. After you complete installation, see Chapter 3.

2.1 Compaq Fortran Installation Instructions

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

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

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

  1. Log in to a privileged account on the system (or cluster) where you will install Compaq Fortran. This account must have the following privileges enabled:
    Do not proceed with the installation unless your account has the CMKRNL, SYSLCK, and SYSPRV privileges enabled. If your process has the SETPRV privilege, you can enable the CMKRNL, SYSLCK, and SYSPRV privileges by typing the following command: 


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

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


    $ SHOW PROCESS/PRIVILEGES

  2. To obtain the kit directory location of the Compaq Fortran product distribution files on the appropriate OpenVMS Alpha Software Product Library CD-ROM (media CD-ROM), do one of the following:
    For information about using the CDMENU utility and the CD-ROM files on the media CD-ROM set, see the Software Product Library CD--ROM User's Guide (media CD-ROM user guide), which accompanies the media CD-ROM distribution kit. The media CD-ROM user guide and CD-ROM master index file are provided as online files in the [README] directory on the first media CD-ROM.
  3. To determine whether the appropriate media CD-ROM is already mounted on your system, type the following command: 


    $ SHOW DEVICE DKA400

    Note
    DKA400 is the device name used in examples in this document to show where the appropriate media CD-ROM has been mounted.
  4. If the media CD-ROM containing the Compaq Fortran installation files is not mounted, either contact the appropriate system manager or insert the appropriate media CD-ROM (write down the volume label) into an available CD-ROM drive. Type the appropriate MOUNT command to mount the media CD-ROM (omit the /FOREIGN qualifier), such as the following: 


    $ MOUNT DKA400 label

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

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


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

  6. To extract the Compaq Fortran online release notes before you install Compaq Fortran, type the following command: 


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

    In this command, disk:[dir] is the specification of the disk and directory containing the product installation files. If your process default directory is the directory on the CD-ROM that contains the Compaq Fortran product distribution files, you can specify the /SOURCE directory as /SOURCE=[].
    You can view or print the file FORTRAN.RELNOTES before you continue with the installation (next command). For example: 


    $ TYPE/PAGE FORTRAN.RELNOTES

  7. In addition to the Compaq Fortran compiler (development) kit, Compaq Fortran also provides a separate Run-Time Library kit. The Compaq Fortran Run-Time Library (FORRTL) may be freely redistributed on other OpenVMS Alpha systems provided the terms specified in the Software Product Description (SPD) are honored. A copy of the Compaq Fortran SPD can be found in the [.DOCUMENTATION] subdirectory of the Compaq Fortran product directory on the OpenVMS Alpha Software Product Library CD-ROM.
    The Compaq Fortran Run-Time Library kit contains a shared Compaq Fortran and Compaq Fortran 77 Run-Time Library (Fortran RTL) needed to execute (RUN) Fortran programs. The Fortran RTL kit provided with Compaq Fortran compiler media contains changes needed to run Compaq Fortran programs that are not included in the Fortran RTL version supplied with the OpenVMS Alpha operating system Version 7.1 or 7.2.
    The Fortran RTL kit includes the shareable image DEC$FORRTL.EXE, which is compatible with DEC Fortran for OpenVMS Alpha Version 7.1 or later releases. This compatibility allows you to copy Fortran executable images from other OpenVMS systems and run them on systems where the DEC$FORRTL.EXE from the Compaq Fortran kit is installed.
    To run Compaq Fortran images on other OpenVMS Alpha systems, you must install the Fortran RTL kit on those OpenVMS Alpha systems. This Fortran RTL kit can be installed on other licensed OpenVMS systems---see the Compaq Fortran Software Product Description (SPD) for details.
    An OpenVMS Alpha release after Version 7.2 includes RTL components which are sufficient to run both Compaq Fortran and Compaq Fortran 77 applications. The RTL kit provided with Compaq Fortran will not replace components provided by OpenVMS Alpha if the existing components are newer.
    To install the Compaq Fortran Run-Time Library, type the following PRODUCT INSTALL command: 


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

    Where disk:[dir] is the specification of the disk and directory containing the product installation files.
    The following text appears for a Run-Time Library installation: 


     If the installation fails, repeat the PRODUCT INSTALL command(s) adding 
 the qualifiers /LOG/TRACE to the command line.  The additional output 
 will help Compaq support analyze the problem. 
 
The following product has been selected: 
  DEC AXPVMS FORRTL 7.n         Layered Product 
 
Do you want to continue? [YES][Return]
*** DEC AXPVMS FORRTL 7.n      Layered Product 
 
Copyright © Digital Equipment Corporation 1992-1999 - All rights reserved 
 
 This software is produced by Digital Equipment Corporation 
 
 This software is licensed under the OpenVMS product license 
 
 Do you want all the default values for this product? [YES] [Return]
 
 Do you want to view the values? [NO] [Return]
 %PCSIUI-I-DONEASK, execution phase starting 
 The following product will be installed: 
 DEC AXPVMS FORRTL 7.n 
 %PCSI-I-VOLINFO, estimated space information for volume DISK$vvvvvvvv 
 -PCSI-I-VOLSPC, nnnn required; nnnnnn available; nnnnnn net 
 Portion Done: 0%...20%...70%...90%...100% 
 The following product has been installed: 
 DEC AXPVMS FORRTL 7.n   Layered Product 
 
 *** DEC AXPVMS FORRTL 7.n   Layered Product 
 
   Release notes are in SYS$HELP:FORRTL.RELEASE_NOTES 
 
 Do INSTALL REPLACE SYS$LIBRARY:DEC$FORRTL.EXE on all other cluster nodes 
$

  8. Installation of the Run-Time Library kit takes about one minute (depending on your system). When installation has been completed, the DCL $ prompt reappears.
  9. If DEC Fortran 90 Version 2.0 was previously installed on this system, it must be removed before Compaq Fortran is installed. To determine if DEC Fortran 90 is present, type the following command: 


    $ PRODUCT SHOW PRODUCT FORTRAN90

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


    PRODUCT 
------- 
DEC AXPVMS FORTRAN90 Vn.n 
 
1 item found

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


    PRODUCT 
------- 
 
0 items found

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


    $ PRODUCT REMOVE FORTRAN90

    The following text appears: 


    The following product has been selected: 
    DEC AXPVMS FORTRAN90 V2.0 
 
%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 Compaq Fortran, see Section 3.8.

  10. To install the Compaq Fortran compilers, type the following PRODUCT INSTALL command: 


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

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


    The following product has been selected: 
  DEC AXPVMS FORTRAN V7.n         Layered Product 
 
Do you want to continue? [YES] [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 V7.n: Compaq Fortran for OpenVMS Alpha Systems 
 
 Copyright © Digital Equipment Corporation 1992-1999 - All rights reserved 
 
 This software product is sold by Compaq Computer Corporation 
 
 PAKs used: FORTRAN, FORTRAN90, FORTRAN-USER or FORTRAN90-USER 
 
 Do you want all the default values for this product? [YES]

    If you want both the Compaq Fortran and Compaq Fortran 77 compilers installed, or wish to use the same selection as a previous installation, type YES at this prompt (or press the Return key to accept the default of YES). If you wish to only install the Compaq Fortran compiler (and not Compaq Fortran 77 compiler), type NO and answer the additional prompts.
    The following text will be displayed: 


    By default, the FORTRAN command invokes Fortran 95 
 
Starting with version V7.2 of this product, the FORTRAN command verb, 
by default, invokes the Fortran 95 compiler.  This is different from 
previous versions where FORTRAN invoked the Fortran 77 compiler.  While 
we have made the Fortran 95 compiler highly compatible with the Fortran 
77 compiler, there are some differences and some users may prefer to use 
the older compiler.
With the default installation, the Fortran 77 compiler may be invoked 
using FORTRAN/OLD_F77. Command definition files are provided which 
allow system managers and individual users to select the previous 
arrangement where FORTRAN invokes Fortran 77 and F90 invokes Fortran 
95. (The F90 verb invokes Fortran 95 in either case.) 
 
Please read, and ask your Fortran users to read, the release notes 
for more details on this change and how it may affect applications 
and build scripts. 
 
Do you want to continue? [YES] [Return]

    By default, the Compaq Fortran 95 and Compaq Fortran 77 compilers are both installed. Installation continues with the following text displayed: 


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

    If you type YES, you can choose whether you want to install the Compaq Fortran 77 compiler (follow the additional prompts).
    If you type NO or press the Return key, installation continues with the following text displayed: 


     Execution phase starting ... 
The following product will be installed: 
    DEC AXPVMS FORTRAN V7.n              DISK$VOLUMExxx:[VMS$COMMON] 
The following product has been removed: 
    DEC AXPVMS FORTRAN V7.n              DISK$VOLUMExxx:[VMS$COMMON] 
 
%PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS FORTRAN V7.n.. 
%PCSI-I-IVPSUCCESS, test procedure completed successfully 
 
DEC AXPVMS FORTRAN V7.n: Compaq Fortran for OpenVMS Alpha Systems 
 
  Execute SYS$STARTUP:FORT$STARTUP.COM on all other VMScluster nodes 
  
  Type HELP FORTRAN Release_notes for release notes location 
 
  Insert the following lines in SYS$MANAGER:SYSTARTUP_VMS.COM: 
      @SYS$STARTUP:FORT$STARTUP 
$

  11. Installation takes about 2-5 minutes (depending on your system). When installation has been completed, the DCL $ prompt reappears.
  12. To obtain a list of files installed, type the following command: 


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

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

2.2 Installing 64-Bit Tools Support

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

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

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

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

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

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

Follow these steps to install DEBUG64:

  1. Log in to a privileged account on the system (or cluster) where you will install Compaq Fortran. This account must have the following privileges enabled:
    Do not proceed with the installation unless your account has the CMKRNL, SYSLCK, and SYSPRV privileges enabled. If your process has the SETPRV privilege, you can enable the CMKRNL, SYSLCK, and SYSPRV privileges by typing the following command: 


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

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


    $ SHOW PROCESS/PRIVILEGES

  2. To obtain the kit directory location of the Compaq Fortran product distribution files on the appropriate OpenVMS Alpha Software Product Library CD-ROM (media CD-ROM), do one of the following:
    For information about using the CDMENU utility and the CD-ROM files on the media CD-ROM set, see the Software Product Library CD--ROM User's Guide (media CD-ROM user guide), which accompanies the media CD-ROM distribution kit. The media CD-ROM user guide and CD-ROM master index file are provided as online files in the [README] directory on the first media CD-ROM.
  3. To determine whether the appropriate media CD-ROM is already mounted on your system, type the following command: 


    $ SHOW DEVICE DKA400

    Note
    DKA400 is the device name used in examples in this document to show where the appropriate media CD-ROM has been mounted.
  4. If the media CD-ROM containing the Compaq Fortran installation files is not mounted, either contact the appropriate system manager or insert the appropriate media CD-ROM (write down the volume label) into an available CD-ROM drive. Type the appropriate MOUNT command to mount the media CD-ROM (omit the /FOREIGN qualifier), such as the following: 


    $ MOUNT DKA400 label

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

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


    $ DIRECTORY ADX*.* 
Directory DKA400:[dir.subdir] 
 
ADX072.A         ADX072.B          ADX072.C 
 
Total of 3 files.

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


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

    The release notes are copied to SYS$HELP:ADX072.RELEASE_NOTES. VMSINSTAL then displays the following text: 


    Additional Release Notes Options: 
 
 1.  Display release notes 
 2.  Print release notes 
 3.  Both 1 and 2 
 4.  None of the above 
 
* Select option [2]: [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.

  7. To install DEBUG64, type the following command: 


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

    The following text appears: 


      OpenVMS AXP Software Product Installation Procedure V7.2 
 
      It is 19-APR-1999 at 15:43. 
 
      Enter a question mark (?) at any time for help. 
 
  * Are you satisfied with the backup of your system disk [YES]? [Return]

    Press Return to proceed: 


    The following products will be processed: 
 
 ADX V7.2 
 
 Beginning installation of ADX V7.2 at 15:43 
 
  %VMSINSTAL-I-RESTORE, Restoring product save set A ... 
  %VMSINSTAL-I-RELMOVED, Product's release notes have been 
  moved to SYS$HELP. 
 
************************************************************** 
 
 OpenVMS Alpha Debug V7.2X 
 
 COPYRIGHT (C) 1978, 1999 BY DIGITAL EQUIPMENT CORPORATION, MAYNARD 
 MASSACHUSETTS.  ALL RIGHTS RESERVED.
 RESTRICTED RIGHTS: USE, DUPLICATION, OR DISCLOSURE BY THE U.S. 
 GOVERNMENT IS SUBJECT TO RESTRICTIONS AS SET FORTH IN SUBPARAGRAPH 
 (C) (1) (II) OF DFARS 252.227-7013, OR IN FAR 52.227-19, OR IN FAR 
 52.227-14 ALT. III, AS APPLICABLE. 
 
 THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED 
 ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE INCLUSION 
 OF THE ABOVE COPYRIGHT NOTICE.  THIS SOFTWARE OR ANY OTHER COPIES 
 THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY OTHER 
 PERSON.  NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY TRANSFERRED. 
 
 THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE AND 
 SHOULD NOT BE CONSTRUED AS A COMMITMENT BY COMPAQ COMPUTER CORPORATION. 
 
 COMPAQ ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
 SOFTWARE ON EQUIPMENT THAT IS NOT SUPPLIED BY COMPAQ. 
********************************************************************* 
 This kit installs Debug version V7.2X.  It will install on Alpha 
 OpenVMS V6.2 to V7.2 systems. 
 
 This kit requires an installed DCE for its client/server configurations 
 (see release motes).  If DCE is not installed, the "server" portion of 
 the debugger cannot be linked and a warning is printed during the 
 installation, for example, "%ADX-W-LINKABORT, NO DEBUGSRVSHR linked, 
 SYS$LIBRARY:DCE$LIB_SHR missing (install DCE)".  You can safely ignore 
 this message.  The normal operation of the debugger is not affected, 
 however, the client/server mode will NOT be operational. 
 
 A new Heap Analyzer will be also installed on V7.1 or later systems. 
 
 If your system is later upgraded from V6 to V7 or if DCE or MOTIF are 
 later installed, then this kit MUST be rerun, i.e. the V7.2X debugger 
 MUST be reinstalled. 
 
 System Code Debugger features will NOT be installed as part of 
 this kit, use the system supplied debugger for that. 
 
 This installation will NOT replace your current OpenVMS system supplied 
 debugger.  However, it will replace any previous versions of the 
 V7.2X debugger that may be installed AND it will remove any earlier 
 network kit debuggers, e.g. V71C. 
 
 This installation takes ~5 minutes.
 
* Do you want to run the IVP after the installation [YES]? [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]
%ADX-I-DONEASK, No further questions will be asked during this 
   installation. 
%VMSINSTAL-I-RESTORE, Restoring product save set B ... 
%VMSINSTAL-I-RESTORE, Restoring product save set C ... 
%ADX-I-ENDRESTORE, All Debugger savesets have been restored. 
%ADX-I-LINKING, Linking V7 images. 
%ADX-I-LINKDONE, DEBUGSHR has been linked. 
%ADX-I-LINKDONE, DEBUG has been linked. 
%ADX-I-LINKDONE, DEBUGUISHR has been linked. 
%ADX-I-LINKDONE, DEBUGSRVSHR has been linked. 
%ADX-I-LINKDONE, HA_MAIN has been linked. 
%ADX-I-LINKDONE, HA_KERNEL has been linked. 
%ADX-I-LINKDONE, TRACE has been linked. 
%ADX-I-CLEANUP, Cleanup has been performed. 
%ADX-I-PROHELP, Providing Debugger Help files... 
%ADX-I-PROMSG, Providing Debugger message image... 
%ADX-I-PROMSG, Providing Debugger .CLD file... 
%ADX-I-PROEXE, Providing Debugger files... 
%ADX-I-PROEXE, Providing Heap Analyzer files... 
%ADX-I-PROMSG, Providing startup files ... 
If you want the debugger installed by this kit to be the default system 
debugger: 
 
  -  Add the following line to the system startup procedure: 
 
      $ @SYS$STARTUP:DEBUG$STARTUP_V72X.COM V72X 
 
     You should remove any other *DEBUG$STARTUP*.COM reference. 
 
  -  Enter the following command from a privileged account: 
 
       @SYS$STARTUP:DEBUG$STARTUP_V72X.COM V72X 
 
     To install the images and define the default system debugger 
     on other Alpha nodes of a VMScluster, enter this command on 
     each such node.  Note, however, that this is a /SYSTEM setup 
     (also see SYS$STARTUP:DEBUGSETUP.COM) and also modifies and 
     install/replaces your SYS$SHARE:DCLTABLES.EXE. 
 
 If you want the regular system debugger installed to be the default 
 system debugger, then do the same as above but use "VMS" as the input 
 parameter, for example: 
 
      @SYS$STARTUP:DEBUG$STARTUP_V72X.COM VMS 
 
 Users can also dynamically switch debuggers by using 
 SYS$STARTUP:DEBUGSETUP.COM.  It's input options are VMS, V72X, V72, 
 V71C, or UNSET.  It also needs the logical table switch /JOB or /SYSTEM. 
 For example: 
 
      @SYS$STARTUP:DEBUGSETUP.COM V72X /JOB 
%ADX-I-PROIVP, Providing test files for IVP... 
 
 The Debugger IVP has been moved to the SYS$TEST  directory.  To run the 
 IVP after installation, first setup to use the V72X debugger by executing 
 the command "@SYS$STARTUP:DEBUGSETUP V72X /JOB" Then, run the character 
 cell IVP by executing the command "@SYS$TEST:DBG$IVP.COM" or, if 
 DECWindows Motif has been installed on your system, run 
 the interactive DECWindows Motif IVP by executing the command 
 "@SYS$TEST:DBG$DW$IVP.COM" 
 
%ADX-I-INSTALLDONE, OpenVMS Alpha Debug V7.2X installation done 
%VMSINSTAL-I-MOVEFILES, Files will now be moved to their 
 target directories... 
 Beginning the Debug V7.2X Verification Procedure 
 
 COPYRIGHT (c) 1988, 1998 BY 
 DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS. 
 ALL RIGHTS RESERVED. 
 
 Debug verification procedure successful. 
 
 Installation of ADX V7.2 completed at 15:49 
 
 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY 
 
 Creating installation data file: VMI$ROOT:[SYSUPD]ADX072.VMI_DATA 
 
       VMSINSTAL procedure done at 15:49

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

Previous Next Contents