# 2 Installing Digital Fortran

Before you start the installation, read Chapter 1, which describes the general options and requirements for installing Digital Fortran.

The installation procedure loads Digital Fortran files on to the system disk on the system where you perform the installation.

To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all files it has created up to that point and exits. You can then start the installation again.

Defaults appear in brackets ([]) throughout the installation procedure.

This chapter contains the following topics:

- How to use POLYCENTER (PCSI) to install Digital Fortran (Section 2.1)

- How to use VMSINSTAL to install Digital Fortran (Section 2.2)

- How to recover from installation errors (Section 2.3)

# 2.1 Using POLYCENTER (PCSI) to Install Digital Fortran

PCSI software is bundled with the OpenVMS operating system and can only be used on OpenVMS VAX Version 6.1 or higher.

For general information on required system parameters and disk space for installation, see Section 1.6. For specific POLYCENTER installation requirements, see Section 1.6.2.

For information on saving a previous version of Digital Fortran before installing the newest version, see Section 1.7.

To install Digital Fortran using PCSI, follow these steps:

1. Log in to a privileged account, such as SYSTEM. You can use a different privileged account if it has the necessary privileges and quotas.

   You must have BYPASS, CMKRNL, and SYSLCK privileges enabled to install using PCSI. To check whether you have these privileges, enter the following command:

       $ SHOW PROCESS/PRIVILEGES

   If you do not have these privileges, but you have the SETPRV privilege, you can enable the BYPASS, CMKRNL, and SYSLCK privileges by entering the following command:

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

2. If your version of OpenVMS VAX is later than Version 6.1, you can skip this step and proceed to step 3.

   Verify that the current OpenVMS product version is registered with PCSI by entering the following command:

       $ PRODUCT SHOW PRODUCT VMS
       PRODUCT
       -------
       DEC VAXVMS VMS V6.n

       1 item found

   If the OpenVMS product is not found, then register the OpenVMS product with PCSI; for example:

       $ PRODUCT REGISTER PRODUCT VMS /VERSION=V6.n -
       $_ /SOURCE=SYS$UPDATE:
       The following product has been selected:
       DEC VAXVMS VMS V6.n     [Available]

       Do you want to continue? [YES] <Return>
       The following product will be registered:
       DEC VAXVMS VMS V6.n
       Portion Done: 0%...10%...20%...30%...40%...50%...60%...
                         70%...100%
       The following product has been registered:
       DEC VAXVMS VMS V6.n

3. Determine whether the appropriate distribution media is already mounted on your system. For example, if the appropriate media CD-ROM is mounted at device DKA400, enter the following command:

       $ SHOW DEVICE DKA400

   If the media CD-ROM containing the Digital Fortran installation files is not mounted, insert (load) the appropriate media (CD-ROM or tape) in the CD-ROM or tape drive. Enter the following command to mount the media device (do not use the /FOREIGN qualifier):

       $ MOUNT DKA400 label

   The label is the volume label of the media CD-ROM or tape drive in the device named.

   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.

4. Set your process default disk and directory to the device and directory where the Digital Fortran product installation files are located. For example:

       $ SET DEFAULT DKA400:[dir.subdir]

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

       $ DIRECTORY

       Directory DKA400:[dir.subdir]

       DEC-VAXVMS-FORTRAN-Vnnnn-x-1.PCSI

       Total of 1 file.

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

       $ PRODUCT EXTRACT RELEASE_NOTES FORTRAN/FILE=SYS$LOGIN:FORT.RELNOTES

   You should view or print the file FORT.RELNOTES before you continue with the installation. For example:

       $ TYPE/PAGE SYS$LOGIN:FORT.RELNOTES

   You can also read the release notes after installation (see Section 3.8).

7. To install Digital Fortran, enter the following command:

       $ PRODUCT INSTALL FORTRAN

   A prompt asks you to verify that the correct product was selected:

       The following product has been selected:
         DEC VAXVMS Fortran Vv.v-nnn

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

   Press Return (default value YES) to continue installing Digital Fortran.

       *** DEC VAXVMS FORTRAN Vv.v-nnn: Digital Fortran for
            OpenVMS VAX Systems

           Copyright © Digital Equipment Corporation yyyy,yyyy -
            All rights reserved.

           This software product is sold by Digital Equipment Corporation

           This product uses the PAKs: FORTRAN, FORTRAN-USER or
            FORTRAN-G

           Do you want all the default values for this product?
             [YES] <Return>

   Press Return (default value YES) to accept the product defaults. (There are no options that you can select for this product).

           Please ignore any PCSI-E-FILNOTPUR messages

           Do you want to view the values? [NO] <Return>

   Press Return (default value NO) to skip displaying of the values and continue installation.

       Execution phase starting ...
       The following product will be installed:
           DEC VAXVMS FORTRAN Vv.v-nnn
       %PCSI-I-VOLINFO, estimated space information for
         volume DISK$xxxxxxx
       -PCSI-I-VOLSPC, nnnn required; nnnnnn available; nnnnnn net
       Portion Done: 0%...10%...20%...30%...40%...50%...90%...100%
       The following product has been installed:
           DEC VAXVMS FORTRAN Vv.v-nnn
       %PCSI-I-EXETSTSTART, start of test procedure
       %PCSI-I-EXETSTOK, end of test procedure; completed with
         no errors

       *** DEC VAXVMS FORTRAN Vv.v-nnn: Digital Fortran for OpenVMS VAX Systems

           Type HELP FORTRAN Release_Notes for release notes
             location

           Be sure to @SYS$UPDATE:FORTRAN$POST_INSTALL on other
             cluster nodes

       $

8. If this installation was performed on a VMScluster, enter the following command on all other cluster nodes:

       $ @SYS$UPDATE:FORTRAN$POST_INSTALL

For information on other PCSI utility features, see the POLYCENTER Software Installation Utility User's Guide.

# 2.2 Using VMSINSTAL to Install Digital Fortran

For general information on required system parameters and disk space for installation, see Section 1.6. For specific VMSINSTAL installation requirements, see Section 1.6.3 .

For information on saving a previous version of Digital Fortran before installing the newest version, see Section 1.7.

To install Digital Fortran using VMSINSTAL, follow these steps:

1. Log in to a privileged account, such as SYSTEM. You can use a different privileged account if it has the necessary privileges and quotas.

   You must have CMKRNL, SYSPRV, and WORLD privileges enabled to install using VMSINSTAL. To check whether you have these privileges, enter the following command:

       $ SHOW PROCESS/PRIVILEGES

   If you do not have these privileges, but you have the SETPRV privilege, you can enable the CMKRNL, SYSPRV, and WORLD privileges by entering the following command:

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

2. To start the installation, invoke VMSINSTAL as follows:

       @SYS$UPDATE:VMSINSTAL saveset-name device-name options-list

   saveset_name
     Is the installation name for the component. For Digital Fortran, use the following installation name:

         FORT06n

     Where n represents the maintenance update of Digital Fortran. Refer to the label on the Digital Fortran distribution kit or the Digital Fortran BOM or BIL for the maintenance update number of your kit.

   device-name
     Is the name of the device on which you plan to mount the media. For example, MUA0: is the device name used in examples in this document.

     If you are installing Digital Fortran from a CD-ROM, specify the device of the CD device and also the directory that contains the Digital Fortran save set.

   options-list
     Is the word OPTIONS followed by one or more of the following options designators: G, L, N, R.

     - Get save set option (G)

       Lets you store product save sets temporarily on a magnetic tape or in a disk directory.

     - File log option (L)

       Logs all activity to the terminal during installation.

     - Display or print release notes (N)

       Indicates you want to see the installation question on release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. You should review the release notes before proceeding with the installation in case they contain additional information about the installation.

       If you are restarting the installation and have already reviewed the release notes, you do not need to specify OPTIONS N.

     - Alternate root option (R)

       Lets you install the product to a system root other than that of the running system.

     To specify more than one option, separate the options with commas; for example OPTIONS L,R.

     For detailed information on these options, see the OpenVMS documentation on software installation.

   The following example invokes VMSINSTAL to install Digital Fortran and shows the system response. This example uses the OPTIONS N release note parameter.

       $ @SYS$UPDATE:VMSINSTAL FORT06n MUA0: OPTIONS N

             OpenVMS VAX Software Product Installation Procedure Vn.n

       It is dd-mmm-yyyy at hh:mm.
       Enter a question mark (?) at any time for help.

   If you do not supply either the product name or the device name, VMSINSTAL prompts you for this information later in the installation procedure. VMSINSTAL does not prompt you for any options, so be sure to include OPTIONS N on the VMSINSTAL command line to access the release notes during the installation.

   When you invoke VMSINSTAL, it checks to see whether you have adequate privileges and quotas for installation (see Section 1.6.3).

   VMSINSTAL then checks to determine whether any users are logged in to the system. If users are logged in, you will be asked whether you want to continue the installation. If you want to continue, enter Yes. If you want to stop the installation, press Return.

3. VMSINSTAL asks if you are satisfied with your system backup, as follows:

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

   You should always back up your system disk before performing an installation. If you are satisfied with the backup of your system disk, press Return. Otherwise, enter No to discontinue the installation. After you back up your system disk, you can restart the installation.

4. You are now asked to mount the first distribution volume on the device you specified when you invoked VMSINSTAL:

       Please mount the first volume of the set on MUA0:.
       * Are you ready? YES
       %MOUNT-I-MOUNTED, FORT MOUNTED ON MUA0:
       The following products will be processed:
         FORT V6.n

           Beginning installation of FORT V6.n at 20:01

       %VMSINSTAL-I-RESTORE, Restoring product saveset A...

   The device name appears in the line preceding the question. VMSINSTAL then asks you if you are ready to continue with the installation.

   If you respond Yes to indicate that you are ready, VMSINSTAL displays a message that the media containing Digital Fortran has been mounted on the specified device and that the installation has begun.

   If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter No in response to the "Are you ready?" question. To abort the installation for other reasons, press Ctrl/Y.

5. If you specified OPTIONS N when you invoked VMSINSTAL, you are now asked to choose one of the following options for reviewing the release notes:

       Release Notes Options:

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

       * Select option [2]:

   If you press Return (select option 2), VMSINSTAL sends the file to the default output print device unless you enter a different queue name:

       * Queue name [SYS$PRINT]:

   If you choose another option, the following occurs:

   - Option 1 causes VMSINSTAL to immediately display the release notes on the console terminal. You can terminate the display at any time by pressing Ctrl/C.

   - Option 3 causes VMSINSTAL to immediately display the release notes on the console terminal and then prompts you for a queue name for the printed version.

   - Option 4 prevents VMSINSTAL from displaying or printing the release notes. This option should be selected if you have already reviewed the release notes and are restarting the installation.

   You are now asked the following question:

       * Do you want to continue the installation [N]?: YES
       %VMSINSTAL-I-RELMOVED, The product's release notes have been
                              successfully moved to SYS$HELP.

   To continue the installation, enter Yes. Otherwise, press Return. In either case, the text form of the release notes is copied to a file in the SYS$HELP directory. After installation, you can read these release notes (see Section 3.8).

6. You are asked if you want to purge files replaced by the installation, as follows:

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

   The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE, SYS$SYSTEM, SYS$TEST and SYS$UPDATE may contain previous versions of Digital Fortran files. These files are replaced during the installation with new files, but the old files are not automatically purged. Purging is recommended. In response to the purging prompt, press Return to purge the files or enter No to keep them.

7. Select the components of the kit that you want to install. The choices are as follows:

   - Compiler (includes help text, command definition, and IVP)

   - Enhanced Run-Time Libraries (required if Compiler is selected)

   - FORSYSDEF.TLB (OpenVMS system symbol definition library)

   Select the components you want to install by answering Yes or No to the prompts. If you want a more detailed description of any component, enter a question mark (?). After the explanation is displayed, you will be prompted again for a response.

       * Do you want to install the compiler [YES]?

   The compiler component includes the Digital Fortran compiler, compiler message files, help text, installation verification procedure, post-installation procedure, deinstallation procedure, and command line definition.

   If this is a new installation, you should select installation of the compiler component by pressing Return (or entering Yes). Choosing the compiler component automatically selects the Run- Time Library component as well; this is indicated by the message:

       %FORT06n-I-RTLREQ, The Run-Time Library support will also be
                          installed

   If you do not want to install the compiler component, enter No. The the installation procedure will then ask:

       * Do you want to install the Run-Time Library support [YES]?

   If you have installed a new version of OpenVMS since the last time you installed Digital Fortran, or if you want to install the Run-Time Library support on a system where Digital Fortran programs will be run, press Return. If you do not wish to install the Run-Time Library support, enter No.

   You are now asked the following:

       * Do you want to create a new FORSYSDEF.TLB [YES]?

   SYS$LIBRARY:FORSYSDEF.TLB is a library of OpenVMS system interface definitions that can be used by FORTRAN programs. FORSYSDEF.TLB is built from a master set of definitions that is provided with OpenVMS; it contains declarations of OpenVMS system services, Run-Time Library routines, structures, and constants.

   Because FORSYSDEF.TLB is generated from OpenVMS definitions, you do not need to rebuild it unless this is a new installation or you have installed a new version of OpenVMS since the last time you installed Digital Fortran. (The installation procedure will make a recommendation on whether FORSYSDEF.TLB should be rebuilt.)

   If you press Return, the installation procedure builds a new system definition file, FORSYSDEF.TLB, based on the system definitions for the version of OpenVMS installed on your system.

   The installation procedure then displays the components you selected and displays the following prompt:

       * Is this correct [YES]?

   If you enter No, the installation procedure reissues the prompts for selecting components.

   Note
     If you answered No to the first prompt in this step (``Do you want to install the compiler?''), steps 8 and 9 are omitted. If you also answered No to the prompt ``Do you want to install the Run-Time Library Support?'', step 10 is omitted.

8. Digital Fortran supports the OpenVMS License Management Facility (LMF). The installation procedure displays license information about Digital Fortran. It asks whether you have registered and loaded your authorization key for the product. The following is an example of the information and the queries presented by the installation procedure:

             Product:      FORTRAN
             Producer:     Digital
             Version:      6.n
             Release Date: dd-mmm-yyyy

       * Does this product have an authorization key registered and loaded?: YES

   If you have not registered and loaded your PAK, you must answer No to this question; the installation will continue but the Installation Verification Procedure (IVP) will not run. To successfully complete the IVP, you must first register and load your PAK (see Section 1.5).

9. Unless you answered No to the license registration question, the installation procedure now asks if you want to run the IVP:

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

   The IVP for Digital Fortran checks that the installation is successful. It is recommended that you run the IVP.

   After Digital Fortran is installed, you can run the IVP independently to verify that the software is available on your system (see Section 3.1). You might need to run the IVP after a system failure to make sure that users can access Digital Fortran.

10. You can now respond to Run-Time Library queries.

    The Digital Fortran kit includes enhancements that may not exist in your current version of the OpenVMS operating system. (See the release notes for information on these enhancements.)

    If the installation procedure determines that the installing system's version of OpenVMS does not include the enhanced support, the existing Run-Time Library images are replaced with the new versions (equivalent to those provided by OpenVMS VAX Version 7.0).

    Warning
      Programs linked against the new Math Library images will not run on OpenVMS systems (earlier than Version 6.1) where the new versions of these images are not installed. The existing versions supplied by OpenVMS will be saved as FORTRAN$MTHRTL-VMS, FORTRAN$UVMTHRTL-VMS, and FORTRAN$VMTHRTL-VMS in SYS$LIBRARY:. Fortran programs that do not use the Math library will run on older OpenVMS system versions V5.0-1 or higher as long as they do not use the nonnative data in I/O feature or the /ASSUME=BYTERECL command line qualifier. Please make sure that all users, even those not using Digital Fortran, read the explanatory text in the release notes. In addition, if you update the system version of OpenVMS, the enhanced versions of the Math and Fortran Run-Time Library images may be overwritten with versions that lack the enhanced support. Be sure to reinstall the Digital Fortran kit after each OpenVMS system update. Please also read Chapter 3 for important post- installation tasks.

    The installation procedure displays informational text describing these changes; press Return when prompted, to view the next screen of text. After the information related to run-time library support has been displayed, the installation procedure asks if you want to continue the installation:

        Do you want to continue with the installation (N)? YES

    To continue with the installation, enter Yes.

11. Read informational messages.

    At this point, the installation procedure displays a number of informational messages that report on the progress of the installation. There are no further questions. If the installation procedure has been successful up to this point, VMSINSTAL moves the new or modified files to their target directories, updates help files, and updates DCL tables, if necessary. The new and modified files consist of the following:

            SYS$HELP:FORT06n.RELEASE_NOTES                  [new]
            SYS$HELP:FORT06n_RELEASE_NOTES.DECW$BOOK        [new]
            SYS$HELP:FORT06n_RELEASE_NOTES.PS               [new]

            SYS$HELP:FORTRAN$MSGHLP.MSGHLP$DATA             [new]
            SYS$HELP:HELPLIB.HLB                            [modified]
            SYS$LIBRARY:DCLTABLES.EXE                       [modified]

            SYS$LIBRARY:FORDEF.FOR                          [new]
            SYS$LIBRARY:FORIOSDEF.FOR                       [new]
            SYS$LIBRARY:FORRTL.EXE                          [new]

            SYS$LIBRARY:FORSYSDEF.TLB                       [new]
            SYS$LIBRARY:FORTRAN$FORRTL-VMS.EXE              [saved old file]
            SYS$LIBRARY:FORTRAN$MTHRTL-VMS.EXE              [saved old file]

            SYS$LIBRARY:FORTRAN$UVMTHRTL-VMS.EXE            [saved old file]
            SYS$LIBRARY:FORTRAN$VMTHRTL-VMS.EXE             [saved old file]
            SYS$LIBRARY:MTHRTL.EXE                          [new]

            SYS$LIBRARY:STARLET.OLB                         [modified]
            SYS$LIBRARY:STARLETSD.TLB                       [modified]
            SYS$LIBRARY:UVMTHRTL.EXE                        [new]

            SYS$LIBRARY:VMSRTL.EXE                          [new]
            SYS$LIBRARY:VMTHRTL.EXE                         [new]
            SYS$MESSAGE:FORTRAN$COMPILER_MSG.EXE            [new]

            SYS$MESSAGE:FORTRAN$DICTIONARY_MSG.EXE          [new]
            SYS$SYSTEM:FORTRAN$MAIN.EXE                     [new]
            SYS$TEST:FORTRAN$IVP.COM                        [new]

            SYS$UPDATE:FORTRAN$DEINSTALL.COM                [new]
            SYS$UPDATE:FORTRAN$POST_INSTALL.COM             [new]

    The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE files are updated to include the new versions of the Digital Fortran help text and the FORTRAN command line definition.

    Also, if you answered Yes in response to the prompt that requests a file purge at step 6, previous versions of the Digital Fortran files are now purged.

    The end of the installation is indicated by the following message:

        %VMSINSTAL-I-MOVEFILES, files will now be moved to their
                                target directories...

12. If you chose to run the IVP (step 8), VMSINSTAL now invokes the IVP to verify that Digital Fortran was installed successfully.

        Beginning Digital Fortran Installation Verification Procedure

        Compiler image identification is FORT V6.n-eee

        Test compiler operation and error messages...

        Compile, link, and run program with parallel processing features...

        Test FORSYSDEF.TLB system definitions...

        Test I/O and Run-Time Library operation...

    If Digital Fortran was installed successfully, the IVP displays the following:

        Digital Fortran V6.n-eee IVP PASSED

        End of Digital Fortran Installation Verification Procedure

13. The installation procedure ends as follows:

           Installation of FORT V6.n completed at hh:mm

           VMSINSTAL procedure done at hh:mm

        $

If you installed the compiler component, proceed to Chapter 3 to perform necessary post-installation tasks. Otherwise, you can choose to install more products or to log out.

VMSINSTAL deletes or changes entries in the process symbol tables during the installation. So, if you are going to continue using the system manager's account and you want to restore these symbols, you should log out and log in again.

If the installation fails, you see the following message:

    %VMSINSTAL-E-INSFAIL, The installation of Digital Fortran V6.n has failed.

If the IVP fails, you see these messages:

    The FORT V6.n Installation Verification Procedure failed.

    %VMSINSTAL-E-IVPFAIL, The IVP for FORT V6.n has failed.

If the installation fails, you must restart the installation procedure from step 2. If the installation fails due to an IVP failure, contact a Digital field service representative.

# 2.3 Recovering from Installation Errors

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

- The operating system version is incorrect.

- The product license has not been registered and loaded.

- A prerequisite software version is incorrect.

- Privileges and quotas for successful installation are insufficient.

- The OpenVMS help library is currently in use.

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

For information on system requirements for installing Digital Fortran, see Section 1.6.

To report a problem to Digital, see Section 3.11.

Click to return to contents

Copyright © 1996, Digital Equipment Corporation -- All rights reserved.