 















             PDP-11 FORTRAN-77 Installation Guide

             Order Number: AA-V196E-TK



             April 1990

             This manual describes the installation and verification
             procedures for FORTRAN-77 Version 5.4.




             Revision Information:         This revised manual supersedes
                                           the FORTRAN-77 Installation
                                           Guide, Version 5.3.

             Operating System and Version: RSX-11M Version 4.4 or higher
                                           RSX-11M-PLUS Version 4.2 or
                                           higher
                                           Micro/RSX Version 4.2 or higher
                                           RSTS/E Version 9.6 or higher
                                           VAX-11 RSX Version 2.4 or
                                           higher with VMS Version 5.0
                                           or higher

             Software Version:             FORTRAN-77 Version 5.4
             digital equipment corporation
             maynard, massachusetts

 





             ________________________
             First Printing, August 1983
             Revised, October 1984
             Revised, May 1987
             Revised, August 1988
             Revised, March 1990

             The information in this document is subject to change without
             notice and should not be construed as a commitment by Digital
             Equipment Corporation. Digital Equipment Corporation assumes
             no responsibility for any errors that may appear in this
             document.

             The software described in this document is furnished under a
             license and may be used or copied only in accordance with the
             terms of such license.

             No responsibility is assumed for the use or reliability
             of software on equipment that is not supplied by Digital
             Equipment Corporation or its affiliated companies.

             Restricted Rights: Use, duplication, or disclosure by the
             U.S. Government is subject to restrictions as set forth in
             subparagraph (c)(1)(ii) of the Rights in Technical Data and
             Computer Software clause at DFARS 252.227-7013.

             __________
             Copyright ©1983, 1984, 1987, 1988, 1990

             All Rights Reserved.
             Printed in U.S.A.

             The postpaid Reader's Comments forms at the end of this docu-
             ment request your critical evaluation to assist in preparing
             future documentation.

             The following are trademarks of Digital Equipment Corporation:

             ALL-IN-1        EduSystem     RT

             DEC             IAS           ULTRIX

             DEC/CMS         MASSBUS       UNIBUS

             DEC/MMS         PDP           VAX

             DECnet          PDT           VAXcluster

             DECmate         P/OS          VMS

             DECsystem-10    Professional  VT

             DECSYSTEM-20    Q-bus         Work Processor

             DECUS           Rainbow

             DECwriter       RSTS

             DIBOL           RSX           DIGITAL

             This document was prepared using VAX DOCUMENT, Version 1.2

 















                                                                  Contents
          ________________________________________________________________

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


          ________________________________________________________________
          Chapter 1  Introduction to Installing FORTRAN-77

          ________________________________________________________________
          Chapter 2  Installing FORTRAN-77 on RSX-11M and
                     RSX-11M-PLUS Operating Systems

               2.1   Preparing to Install the FORTRAN-77 Compiler ..   2-2
                     2.1.1 Default Compiler Attributes..............   2-2
                     2.1.2 Default Setting for Compile-Time
                           Switches .................................... 2-2
                     2.1.3 FORTRAN-77 Object Time System (OTS)
                           Resident Libraries......................... 2-4

               2.2   Mounting the Distribution Medium ................ 2-5

               2.3   Installing and Verifying the FORTRAN-77
                     Compiler ............................................   2-6
                     2.3.1 Installing Auto-Install...................  2-6
                     2.3.2 Invoking Auto-Install.....................  2-7
                     2.3.3 Installation Dialogue.....................  2-7

                     2.3.4 Installation Verification Procedure.....   2-14
                     2.3.5 After the Installation.................... 2-15

                                                                       iii

 







               2.4   Installation Files.................................  2-16

               2.5   Accessing the Release Notes...................... 2-21

               2.6   Reinstalling FORTRAN-77 from an Existing
                     Installation........................................   2-21


          ________________________________________________________________
          Chapter 3  Installing on a MICRO/RSX System

          ________________________________________________________________
          Chapter 4  Installing FORTRAN-77 on a RSTS/E Operating
                     System

               4.1   Preparing to Install the FORTRAN-77 Compiler ..   4-2
                     4.1.1 Default Compiler Attributes..............   4-2
                     4.1.2 Default Setting for Compile-Time
                           Switches .................................... 4-2
                     4.1.3 FORTRAN-77 Object Time System (OTS)
                           Resident Libraries......................... 4-4

               4.2   Mounting the Distribution Medium ................ 4-5

               4.3   Installing and Verifying the FORTRAN-77
                     Compiler ............................................   4-6
                     4.3.1 Installing Auto-Install...................  4-6
                     4.3.2 Invoking Auto-Install.....................  4-6
                     4.3.3 Installation Dialogue.....................  4-7
                     4.3.4 Installation Verification Procedure.....   4-12
                     4.3.5 Installing Resident Libraries............  4-13
                     4.3.6 Start-Up Control File..................... 4-13

               4.4   Installation Files.................................  4-14

               4.5   Accessing the Release Notes...................... 4-18


          iv

 






               4.6   Reinstalling FORTRAN-77 from an Existing
                     Installation........................................   4-19


          ________________________________________________________________
          Chapter 5  Installation on VMS with VAX-11 RSX

          ________________________________________________________________
          Tables

               2-1   Compile-Time Switches............................. 2-3

               2-2   RSX-11M/M-PLUS FORTRAN-77 Files ................. 2-16

               3-1   Micro/RSX FORTRAN-77 Files ....................... 3-4

               4-1   Compile-Time Switches............................. 4-3

               4-2   RSTS/E FORTRAN-77 Files........................... 4-14

               5-1   VAX-11 Version 2.4 RSX FORTRAN-77 Software
                     Components..........................................  5-6

















                                                                         v

 














                                                                   Preface
          ________________________________________________________________



             This manual describes the procedure for installing and veri-
             fying
             FORTRAN-77 on the following systems:

              o RSX-11M and RSX-11M-PLUS

              o Micro/RSX

              o RSTS/E

              o VAX-11 RSX

          ____________________________________________________________

          Intended Audience

             This manual is intended for the system manager or the priv-
             ileged user responsible for installing the FORTRAN-77 com-
             piler.







                                                                         v

 





          ____________________________________________________________

          Conventions

             The following conventions are used in this manual:

             _____________________________________________________________
             Conventions_Meaning__________________________________________

             <CTRL/x>    The symbol <CTRL/x> (in code or display examples)
             or          or CTRL/x (in text) indicates that you hold
             CTRL/x      down the key labeled CTRL while simultaneously
                         pressing the specified letter key; for example,
                         <CTRL/C>, <CTRL/O>.

             <RET>       A symbol with a 1- to 3-character abbreviation in
                         an example indicates that you must press a key on
                         the terminal; for example, <RET> indicates that
                         you press the RETURN key on your terminal.

              . . .      Horizontal ellipsis indicates that you can enter
                         additional parameters, values, or other informa-
                         tion.

             [ ]         Brackets usually indicate optional syntax.
                         Brackets that are part of directory names,
                         however, do not indicate optional syntax. In
                         addition, certain MCR directives use brackets as
                         part of their required syntax.











          vi

 





             _____________________________________________________________
             Conventions_Meaning__________________________________________

             UPPERCASE   Uppercase words and letters used in examples
             WORDS       indicate that you type the word or letter exactly
                         as shown.

             lowercase   Lowercase words or letters in examples indicate
             words       that you substitute a word or value of your
                         choice.

             Color_______Color_is_used_to_show_user_input.________________




























                                                                       vii

 

















                                                                      Chapter 1


                                          Introduction to Installing FORTRAN-77
               ________________________________________________________________


                  PDP-11 FORTRAN-77 Version 5.4 offers new features and en-
                  hancements to PDP-11 users of FORTRAN-77. Before you can
                  use the new version, you must install it on your system.
                  This chapter provides information you need to perform the
                  installation.

                  On each of the supported operating systems, FORTRAN-77 is
                  installed with an automatic installation procedure. The
                  installation procedure prompts you for information that you
                  must supply to complete the installation.

                  If your operating system is RSX-11M/M-PLUS, or RSTS/E, the
                  installation procedure in your distribution kit is an au-
                  tomatic installation procedure that is new in FORTRAN-77
                  Version 5.4. The new procedure, called Auto-Install, func-
                  tions as follows:

                   o Automatically checks the installation files for a new
                     version of itself or an update. If Auto-Install finds a
                     new version or update, it asks you if you want to install
                     it. If you respond YES, Auto-Install displays the commands
                     needed to perform the installation or update. If you
                     respond NO, Auto-Install issues a warning that this could
                     cause installations to fail and reprompts you to perform
                     the installation or update.







                                     Introduction to Installing FORTRAN-77  1-1

 











                   o Combines the installation and update procedures for all
                     products. Auto-Install checks the update area to ensure
                     that updates for the version being installed are applied
                     to the product's installation files prior to performing
                     the installation.

                     For RSX, the update procedures for FORTRAN-77 are in
                     directory LB:[246,200].

                     For RSTS/E, the update procedures for FORTRAN-77 are
                     normally in a directory with the logical name PATCH$.

                                                 NOTE

                         On RSX and RSTS systems, if no update files are
                         found in the update area, you will receive the
                         following message:

                           WARNING -- Update file not found, kit files
                           not updated, procedure continuing

                         This message is normal; it does not indicate an
                         error.

                   o Creates the following log files of the installation in the
                     user's login directory:

                        AUTOIN.LOG, which contains the main installation proce-
                        dure's dialogue.

                        F77F77.LOG, which contains the FORTRAN-77 portion of
                        the dialogue.

                   o Creates temporary work areas on the user's device and
                     deletes them before the installation completes. If any of
                     these remain after an installation, you may delete them.
                     The temporary work areas are created as follows:

                        On RSX:

                           Auto-Install sets your default device and directory
                           to your login device and directory. It then creates
                           the work area in directory [367,100] on your login
                           device.

               1-2  Introduction to Installing FORTRAN-77

 











                        On RSTS/E:

                           Auto-Install creates a directory with logical name
                           AUTWRK$, which is normally the directory [0,80] on
                           the system device, as the Auto-Install work area.

                   o Creates temporary files in the user's login directory and
                     deletes them before the installation completes. If any
                     remain after an installation, you may delete them. The
                     names of the temporary files are:

                     CUSTOM.DAT      INSTAL.TMP      F77F77.SAV

                     UPDATE.DAT      AUTUPD.DAT      F77F77.TMP

                     ISTAT.DAT       F77F77.CFG





























                                     Introduction to Installing FORTRAN-77  1-3

 











                   o Allows its own installation files to remain on the system
                     after it is installed. RSX stores Auto-Install files in
                     [367,367] on the system device; RSTS/E stores them in
                     the logical name directory AUTOIN$ (normally [0,80]).
                     These files are needed to reinstall FORTRAN-77 and other
                     products and are usually not deleted. If the files have
                     been deleted, you can reinstall Auto-Install from the
                     distribution kit.

                     On RSX, the names and functions of the installation files
                     are:

                     AUTOIN.CMD       Controls installations

                     PRODIN.CMD       Installs individual layered products

                     CUSTOM.CMD       Controls customization processes

                     CUSTOM.TSK       Customizes the configuration data file

                     UPDATE.CMD       Controls the updating of the configura-
                                      tion data file

                     UPDATE.TSK       Updates the configuration data file

                     PRDTBL.DAT       Lists products Auto-Install may support

                     INSTAL.DAT       Lists products installed by Auto-Install

                     DEFUPD.TSK       Updates the status of the configuration
                                      data file

                     On RSTS/E the names and functions of the installation
                     files are:

                     AUTOIN.COM       Controls installations

                     PRODIN.COM       Installs individual layered products

                     CUSTOM.COM       Controls customization processes

                     CUSTOM.TSK       Customizes the configuration data file



               1-4  Introduction to Installing FORTRAN-77

 












                     UPDATE.COM       Controls the updating of the configura-
                                      tion data file

                     UPDATE.TSK       Updates the configuration data file

                     PRDTBL.DAT       Lists products Auto-Install may support

                     INSTAL.DAT       Lists products installed by Auto-Install

                     DEFUPD.TSK       Updates the status of the configuration
                                      data file

                   o Stores FORTRAN-77 installation data files on the sys-
                     tem after it is installed. On RSX the directory is
                     dev:[246,246], where dev is specified during customiza-
                     tion; on RSTS/E, the directory is FRTRN7$. Do not delete
                     these files. If they are deleted, subsequent installations
                     will fail unless they are performed from the distribution
                     kit.

                   o Handles error messages as follows:

                        Ignores WARNING messages

                        Aborts the installation of a product if FATAL messages
                        are received during the installation of the product

                        Aborts itself if FATAL messages are received during
                        Auto-Install's installation dialogue

                        Aborts the installation of a product if ERROR messages
                        are received during the installation of the product

                   o Uses a configuration data file, which contains the pa-
                     rameters and values needed to determine which features of
                     FORTRAN-77 are supported by default.

                   o Provides a procedure that assists you in customizing
                     your configuration data file to indicate which FORTRAN-77
                     features your compiler uses by default.

                   o Makes every attempt to restore the system to its prior
                     state if an installation fails.

                                     Introduction to Installing FORTRAN-77  1-5

 

















                                                                      Chapter 2


                    Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating
                                                                        Systems
               ________________________________________________________________


                  This chapter explains how to install FORTRAN-77 on the
                  RSX-11M and RSX-11M-PLUS operating systems. Prior to in-
                  stalling this version of the FORTRAN-77 compiler, perform the
                  following steps:

                   1. Read this chapter, which contains information necessary
                     for installing the compiler.

                   2. Read the release notes, which describe new features
                     and known problems for this version of FORTRAN-77. For
                     information on how to access the release notes, see
                     Section 2.5.

                   3. Ensure that the RSX operating system is installed and
                     functioning properly.

                   4. Ensure that your system meets the minimum software and
                     hardware requirements for FORTRAN-77. See the Software
                     Product Description (SPD) in your kit for a list of the
                     minimum software and hardware requirements.

                   5. Choose the optional attributes for your compiler. See
                     Section 2.1.1 for information on optional compiler at-
                     tributes.

                  A FORTRAN-77 installation requires between 15 and 30 min-
                  utes to complete, depending on whether or not you choose
                  to include resident libraries in the compiler. It may re-
                  quire additional time if you choose to set your own compiler
                  attributes rather than accepting the defaults.

       Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems  2-1

 










               ____________________________________________________________

               2.1  Preparing to Install the FORTRAN-77 Compiler

                  Unless you choose the default installation, you must choose
                  optional attributes for your FORTRAN-77 compiler. Among the
                  attributes you must choose are the default attributes for
                  your compiler, the default setting for compile-time switches,
                  and the FORTRAN-77 Object Time System (OTS) libraries, if
                  any, that you wish to install. The following sections discuss
                  these options in detail.

               ____________________________________________________________

               2.1.1  Default Compiler Attributes

                  The configuration data file contains questions and answers
                  that determine the default compiler attributes. You can
                  accept these defaults or, if you choose to customize your
                  compiler, you can change them by answering questions in the
                  installation dialogue. The file is called F77F77.CFG and is
                  stored in directory [246,246] on the device you specify in
                  answer to the question in the installation dialogue: "Where
                  do you want to store the installation files?"

                  Note that no question exists on floating-point hardware; if
                  floating-point hardware is on the system, the compiler uses
                  it automatically. If your system does not have the floating-
                  point hardware, your compiler cannot perform floating-point
                  constant folding at compile time.

               ____________________________________________________________

               2.1.2  Default Setting for Compile-Time Switches

                  As explained previously, the contents of the configuration
                  data file, whether customized or not, determine the default
                  attributes of the FORTRAN-77 compiler. These default at-
                  tributes determine the default setting of the compile-time
                  switches. Whatever default attributes you choose for your
                  compiler, you can override them at compilation time by means
                  of compile-time switches. Table 2-1 lists and describes the
                  compile-time switches. The FORTRAN-77 User Manual contains
                  detailed information on these switches and their DIGITAL
                  Command Language (DCL) equivalents.

               2-2  Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems

 











                                               NOTE

                      When you change the default of an MCR compile-time
                      switch during the installation, the equivalent DCL
                      qualifier also changes.

                  Table 2-1:  Compile-Time Switches
                  _____________________________________________________________
                  Switch__Description__________________________________________

                  /CK     Checks array references to ensure that they are
                          within the array address boundaries specified.

                  /CO:n   Accepts at least n continuation lines. Value of n can
                          be 0 to 111(8).

                  /DB     Provides symbol table information for use by the
                          Symbolic Debugger.

                  /DE     Compiles lines with the letter D in column 1.

                  /DS     Uses I- and D-space active page registers.

                  /EX     Accepts source text up to column 132(10) of an input
                          record.

                  /I4     Allocates 2 words for the default length of integer
                          and logical variables.

                  /LA     Causes current switch specifications to be retained
                          for subsequent compilations.

                  /LI:n   Determines content of listings: source and map or
                          source, map, and generated code.

                  /OP     Produces optimized code.

                  /RO     Specifies pure code and data sections as read-only to
                          allow code sharing in multiuser tasks.
                  _____________________________________________________________
                                                       (continued on next page)




       Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems  2-3

 











                  Table 2-1 (Cont.):  Compile-Time Switches
                  _____________________________________________________________
                  Switch__Description__________________________________________

                  /SP     Automatically prints the listing file.

                  /ST:xxx Flags extensions to ANSI standard in source code.

                  /TR:xxx Controls the amount of extra code included in the
                          compiled output for use by the Object Time System
                          during error traceback.

                  /WF:n   Determines the number of temporary disk work files to
                          be used during compilation.

                  /WR_____Enables_compiler_warning_diagnostics.________________


               ____________________________________________________________

               2.1.3  FORTRAN-77 Object Time System (OTS) Resident Libraries

                  Use of the FORTRAN-77 Object Time System (OTS) memory-
                  resident libraries may reduce the size of users' tasks and
                  may lower
                  FORTRAN-77's requirements for system resources. During
                  the installation dialogue, you are asked, "Build resident
                  library?". If you answer YES, you will be asked two ad-
                  ditional questions regarding which libraries you wish to
                  build. Your choices are the three File Control Services
                  (FCS) libraries, F7FRES, F7FCLS, and F7SRES, and the Record
                  Management Services (RMS) library F7RCLS. You can build as
                  many as two resident libraries: the RMS library plus one of
                  FCS libraries. You can omit either or both if you prefer.

                  Your answer to the "File Services?" question determines the
                  libraries that you can build. You are asked to build an FCS
                  library if you replied FCS or BOTH; you are asked to build an
                  RMS library if you replied RMS or BOTH.






               2-4  Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems

 










               ____________________________________________________________

               2.2  Mounting the Distribution Medium

                  To install FORTRAN-77, perform the following steps:

                   1. Log in to a privileged account. The installation procedure
                     generates a log file, which will remain in your default
                     login directory after you complete the installation.
                     Therefore, it is not essential to use a hard-copy terminal
                     to produce a record of your installation session. However,
                     some informative operating system messages are omitted
                     from the log file; if you need a detailed record of the
                     installation, you may prefer to use a hard-copy terminal.

                   2. Verify that no one on your system is performing an instal-
                     lation using Auto-Install.

                   3. Verify that no one else on your system is using a previ-
                     ously installed version of FORTRAN-77.

                   4. If Auto-Install is not already installed on your system,
                     verify that you have 800 free blocks of contiguous storage
                     space available for Auto-Install on the system device
                     (specified by sysdev in the installation procedure.)

                   5. Verify that you have 2270 free blocks of storage space
                     available on the system device. Of this, you need 400 con-
                     tiguous blocks for the FORTRAN-77 task and 150 contiguous
                     blocks apiece for each OTS memory-resident library (as
                     many as 700 contiguous blocks in all).

                   6. Place your distribution medium in the drive.

                     If your distribution medium is a disk, insert the disk
                     in the drive and set the switch to the RUN position. Make
                     certain that the READY light is on.

                     If your distribution medium is tape, load the tape ac-
                     cording to the instructions for your drive. Set the
                     ONLINE/OFFLINE indicator to ONLINE and make certain that
                     the READY light is on.

                     If your distribution medium is a TK50 tape cartridge, in-
                     sert the tape into the drive according to the instructions
                     for the drive, and close the cartridge-release button on
                     the drive. Press the LOAD button and make certain the LOAD
                     light is on.

       Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems  2-5

 











                   7. Allocate and mount the device. Disks and tapes must be
                     mounted foreign. For more information about allocating and
                     mounting devices, see the RSX-11M/M-PLUS Command Language
                     Manual.

               ____________________________________________________________

               2.3  Installing and Verifying the FORTRAN-77 Compiler

                  FORTRAN-77 is installed using the Auto-Install software.
                  If Version 1.1 or a higher version of Auto-Install has not
                  been installed on your system, you must install it before
                  attempting to install FORTRAN-77.

               ____________________________________________________________

               2.3.1  Installing Auto-Install

                  To install Auto-Install, you must invoke the Backup and
                  Restore Utility (BRU). If BRU is not installed on your sys-
                  tem, install it with the following command:

                    > INS $BRU <RET>

                  If BRU is available, invoke it with one of the following
                  commands, according to the type of distribution medium you
                  have purchased:

                  For Disks:

                    >BRU/UFD/NOI/NEW/IMAGE:RESTORE/BAC:AUT101.A indev: sysdev: <RET>

                  For Tapes:

                    >BRU/DENS:dens/REW/UFD/NOI/NEW/BAC:AUT101.A indev: sysdev: <RET>

                  Replace indev with the name of the device on which you allo-
                  cated and mounted your distribution medium. Replace sysdev
                  with the name of your system device. Tape users replace dens
                  with the bit density used on the kit tape. See the RSX-11M/M-
                  PLUS Utilities Manual for more information on the Backup and
                  Restore Utility.



               2-6  Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems

 










               ____________________________________________________________

               2.3.2  Invoking Auto-Install

                  You can invoke Auto-Install with any one of the following
                  commands:

                   1. @sysdev:[367,367]AUTOIN.CMD

                   2. @sysdev:[367,367]AUTOIN.CMD F77

                   3. @sysdev:[367,367]AUTOIN.CMD indev:F77

                  Replace sysdev with the name of your system device. Replace
                  indev with the name of the device on which you allocated and
                  mounted your distribution medium. Press RETURN to execute the
                  command.

                  If you use command 1, the installation dialogue begins with
                  step 1 in the following section.

                  If you use command 2, the installation dialogue begins with
                  step 2.

                  If you use command 3, the installation dialogue begins with
                  step 2 and skips to step 4.

               ____________________________________________________________

               2.3.3  Installation Dialogue

                  This section describes the installation dialogue that appears
                  on your screen. The text that follows each question explains
                  the answers to the question. These explanations do not appear
                  in the actual installation dialogue.

                  The default answer appears at the end of each question,
                  enclosed in angle brackets (< >). In some cases, the text
                  of the question shows possible alternative answers in angle
                  brackets, followed by the default in angle brackets. You
                  can accept the default answer by simply pressing RETURN.
                  If you enter an explicit answer, whether equivalent to the
                  default or not, you must press RETURN to complete it. If you
                  want to exit Auto-Install at any point (thus terminating the
                  installation procedure), type CTRL/Z.

                  Depending on how you invoked Auto-Install, you will enter the
                  dialogue at step 1 or step 2.

                   1. Which product(s) do you want to install?

       Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems  2-7

 











                     In response to this prompt, type F77, which is the product
                     name for FORTRAN-77. Press CTRL/Z to exit from Auto-
                     Install at this point.

                   2. Where are the update files located <sysdev:>?

                     If the update files are located on the system device (the
                     sysdev default refers to the boot device), press RETURN.
                     If the update files are not located on the system device,
                     enter the name of the device on which they are located,
                     including the colon (:).  To exit from Auto-Install at
                     this point, press CTRL/Z.

                   3. Which device are the distribution files for F77 (F77)
                     located on (include colon)?

                     If you are installing FORTRAN-77 from a distribution kit,
                     specify the drive on which you allocated and mounted the
                     distribution disk or tape. If you are installing from
                     an account on your system (for example, reinstalling an
                     existing installation), specify the name of the device
                     on which the source files are located. To exit from Auto-
                     Install at this point, press CTRL/Z.

                     If you are installing from the distribution kit or have
                     answered YES to the "Allow future customization of this
                     file?" question during a previous installation, Auto-
                     Install will issue the following question:

                   4. Do you want to customize F77 (F77) (Y/N) <N>?

                     Type Y to customize your FORTRAN-77 installation.

                     Type N or press RETURN if you do not wish to customize
                     FORTRAN-77.

                     The default compiler may fulfill your system requirements.
                     However, you may be able to improve compiler performance
                     by customizing the compiler.

                     If you have already customized your compiler during a
                     previous installation, or if you want the default con-
                     figuration, type N or press RETURN. The installation
                     procedure will then skip all other questions pertaining to
                     customization.

                  If you choose to customize, you will be asked further ques-
                  tions. Press RETURN to accept the default answer; press
                  CTRL/Y to abort customization; press CTRL/Z to exit from
                  customization but retain any changes made so far; or type a

               2-8  Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems

 











                  new value. If a question has multiple choices for the answer,
                  the choices will be listed in angle brackets (< >).

                                               NOTE

                      The default answers given in angle brackets (and the
                      explanations of the defaults) apply if you have not
                      changed the configuration data file to customize the
                      compiler. The defaults may be different if you have
                      already customized the configuration data file. The
                      answers you provide in this file become the default
                      answers in the installation procedure, overriding the
                      defaults shown in the questions.

                    Target device <LB:>?

                  Specify the target device (that is, the device where the
                  compiler will reside after the installation).

                    Task directory <[3,54]>?

                  Specify the UIC of the directory on the target device where
                  the compiler will reside after the installation. The default
                  is [3,54] on RSX-11M-PLUS, as shown; the default is [1,54] on
                  RSX-11M.

                    Where do you want to store the installation files <SY0:>?

                  This is the device on which the distribution files will be
                  stored when the installation is complete. Press RETURN if you
                  want to store them on your default login device. Otherwise,
                  enter the name of another device followed by a colon (:).
                  The installation files will be stored in directory [246,246]
                  on this device.

                    Allow future customization of this file <YES>?

                  Answer NO only if you want to disallow future customizing of
                  the compiler.

                    Purge old versions of FORTRAN if installation is successful <YES>?

                  If you do not answer NO, previous versions of FORTRAN-77 will
                  be purged. You may want to keep previous versions until you
                  are satisfied that existing programs compile correctly on the
                  new version.

       Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems  2-9

 











                    Print release notes <NO>?

                  Answer YES if you want to print release notes on the system
                  default printer during the installation.

                    Print log file <NO>?

                  Answer YES if you want to print the installation log on the
                  system default printer during the installation.

                    Error message type <LONG, SHORT> <LONG>?

                  Your answer determines the form in which FORTRAN-77 error
                  messages will be presented.

                    File services <FCS,RMS,BOTH> <BOTH>?

                  Specify FCS if you want FCS services but not RMS. Specify
                  RMS if you want RMS services but not FCS. Default if you want
                  both FCS and RMS services. Your response to this question
                  determines which types of resident libraries you will be
                  allowed to specify later in the installation dialogue.

                    Use alternate convert module <YES, NO> <NO>?

                  Answer YES if you want to include the alternate convert
                  module. Note that the alternate convert module requires
                  floating-point hardware on the system.

                    Build resident library <YES, NO> <NO>?

                  Answer YES if you intend to build at least one resident
                  library. If you answer YES, you will see one or both of the
                  following two questions (depending on how you answered the
                  "File services" question).

                    FCS OTS resident library name <F7FRES,F7FCLS,F7SRES>
                    <F7FCLS>?

                  Choose one of the three FCS libraries, or allow the F7FCLS
                  default.

                    Build RMS OTS resident library F7RCLS <YES,NO> <NO>?


               2-10  Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems

 











                  Answer YES if you also want the RMS library, F7RCLS.
                  Otherwise, the RMS library is omitted.

                                               NOTE

                      On RSX-11M systems, if you receive an error indicating
                      that Auto-Install was unable to install the libraries,
                      check to see that a library partition was created at
                      system generation. If no library partition exists, you
                      must create one before retrying the installation.

                    Stack size (must never be less than 512 words) <1024>?

                  Defines the size of the SP stack.

                    Compiler's dynamic storage <3840>?

                  Defines the amount of resident memory used by the work file
                  on a virtual memory system. If your operating system supports
                  dynamic memory allocation, the size of the compiler's dynamic
                  storage is determined by assigning your response to the
                  EXTTSK Task Builder option. If dynamic memory allocation
                  is not supported, the compiler will use all of the memory
                  available on the partition.

                    Control section STACK1 (expression analyzer/common block definitions)
                    <1160>?

                  Defines the size of the control section STACK1. FORTRAN-77
                  uses STACK1 as the expression analyzer stack in pass 1 and
                  for named common block definitions in later passes.

                    DO stack (nested DO/IF statements) <240>?

                  Defines the size of the control section DOSTK1, which
                  FORTRAN-77 uses for nesting DO and IF statements.

                    Lines per page (plus 3 lines of heading) <octal value>
                    <67>?

                  Specifies the number of lines allowed on a page of the de-
                  fault printer. Note that you must express this as an octal
                  value.

                    Printer line width <octal value> <204>?

      Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems  2-11

 











                  Specifies the number of character positions across the width
                  of a line on the default printer. Note that you must express
                  this as an octal value.

                    Supersede output files <0=NO, 1=YES> <0>?

                  A value of 0 indicates the compiler should not supersede
                  output listing and object files. A value of 1 allows super-
                  seding.

                    I- and D-Space support <0=NO, 1=YES> <1>?

                  A value of 1 indicates the compiler will generate object
                  files that can be used to build I-space and D-space tasks. A
                  value of 0 disallows this.

                    Octal/decimal Version numbers <0=Octal, 1=Decimal> <0>?

                  Specifies whether to maintain version numbers of FORTRAN-
                  generated files in octal values or decimal values.

                    Reinitialize switches <0=NO, 1=YES> <0>?

                  Defines the default setting for the /LA switch.

                    Array subscript bounds checking <0=NO, 1=YES> <0>?

                  Defines the default setting for the /CK switch.

                    Number of continuation lines <octal value> <23>?

                  Defines the default setting for the CO:n switch.

                    Include debug lines <0=NO, 1=YES> <0>?

                  Defines the default setting for the /DE switch.

                    Default to INTEGER*4 values <0=NO, 1=YES> <0>?

                  Defines the default setting for the /I4 switch.

                    Listing <1=Source, 2=(Source,Map) 3=(Source,Map,Generated code)> <2>?

                  Defines the default setting for the /LI switch.

                    Read Only code sections <0=NO, 1=YES> <0>?

                  Defines the default setting for the /RO switch.

                    Spool listing <0=NO, 1=YES> <0>?

               2-12  Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems

 











                  Defines the default setting for the /SP switch.

                    Trace <0=NONE, 1=NAMES, 3=BLOCKS 7=ALL> <3>?

                  Defines the default setting for the /TR:xxx switch.

                    Number of temporary files <Range 1-3> <2>?

                  Defines the default setting for the /WF:n switch.

                    Enable optional warnings <0=NO, 1=YES> <1>?

                  Defines the default setting for the /WR switch.

                    FORTRAN ANSI interpretation <0=FORTRAN-66, 1=FORTRAN-77> <1>?

                  Defines the default setting for the /F77 switch.

                    Standards checking <0=NONE, 1=SOURCE, 2=SYNTAX, 3=ALL> <0>?

                  Defines the default setting for the /ST:xxx switch.

                    Produce symbolic debugger information <0=NO, 1=YES> <0>?

                  Defines the default setting for the /DB switch.

                    Extend source line <0=NO (72 cols), 1=YES (132 cols)> <0>?

                  Defines the default setting for the /EX switch.

                    Code optimization <0=NO, 3=YES> <3>?

                  Defines the default setting for the /OP switch.

                    Do you want to customize F77 again <Y/N><NO>?

                  Type Y if you want to change any of your answers to the
                  customization questions. If not, press RETURN or type N.

                  Once the contents of the configuration data file are com-
                  plete, Auto-Install installs FORTRAN-77. Throughout the
                  installation process, Auto-Install displays several informa-
                  tional messages. Following the installation, Auto-Install
                  runs the Installation Verification Procedure (IVP) for
                  FORTRAN-77.

      Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems  2-13

 










               ____________________________________________________________

               2.3.4  Installation Verification Procedure

                  The Installation Verification Procedure (IVP) consists of two
                  tests: one checks the compiler's ability to detect a compile-
                  time error and another checks the ability of the Object Time
                  System (OTS) to detect a run-time error. Both tests require
                  floating point hardware. If the first test is successful, the
                  following message is displayed on your terminal:

                    F77 -- ERROR 28-E Overflow while converting constant or constant expression
                                         [I = 71347] in module F77TST at line 6

                    F77 -- 1 Error F77TST.FTN;1































               2-14  Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems

 











                  If the second test is successful, the following message is
                  displayed on your terminal:

                     NNNNNN  --  ERROR 73
                       Floating zero divide
                       at PC = xxxxxx
                         in   "F77TST" at or after 6

                      Where NNNNNN is the task name and xxxxxx is the actual program location

                  If these messages are not displayed on your terminal, an
                  error has occurred in your installation.

                  On a machine without floating point hardware, the IVP is-
                  sues different messages. You can check the installation by
                  attempting to compile and run a user program.

                  When the IVP is complete and the installation is successful,
                  the following message is displayed on your terminal:

                    Installation of F77 (F77) successful.

               ____________________________________________________________

               2.3.5  After the Installation

                  After the installation, it is useful to place certain com-
                  mands in your system start-up command file, STARTUP.CMD, to
                  ensure that certain functions performed during the installa-
                  tion are automatically performed again whenever the system
                  is rebooted. These commands include the reinstallation of
                  FORTRAN-77 and the resident libraries and the removal of any
                  existing libraries of the same name as those being installed.
                  The commands are as follows:

                  RSX-11M-PLUS:

                    INSTALL LB:[3,54]F77.TSK
                    REMOVE libraryname/REG
                    INSTALL LB:[1,1]libraryname/RON=yes

                  RSX-11M:

                    INSTALL LB:[1,54]F77.TSK
                    REMOVE libraryname
                    INSTALL LB:[1,1]libraryname

      Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems  2-15

 











                  Replace libraryname with the names of the FCS and RMS res-
                  ident libraries you wish to install. The FCS libraries are
                  F7FRES, F7FCLS, and F7SRES. The RMS library is F7RCLS.

                  For further information on these commands, see the RSX-11M/M-
                  PLUS MCR Operations Manual or the RSX-11M/M-PLUS Command
                  Language Manual.

               ____________________________________________________________

               2.4  Installation Files

                  Table 2-2 lists and describes the files left in the system
                  directories as a result of the installation.

                                               NOTE

                      FORTRAN-77 searches specific directories for the files
                      it needs. If you move these files to a different lo-
                      cation, be sure to restore the original directory
                      configuration before installing an update. The instal-
                      lation procedure deletes intermediary files, so that
                      the files remaining in [246,246] when the installa-
                      tion procedure is complete are those you will need for
                      reinstalling FORTRAN-77.

                  Table 2-2 lists the files remaining on your target disk after
                  installation. Do not delete any of these files; the compiler
                  needs them to function properly. Do not modify files related
                  to the resident libraries; the compiler requires the current
                  versions.

                  Table 2-2:  RSX-11M/M-PLUS FORTRAN-77 Files
                  _____________________________________________________________
                  ___________________Compiler_Building_Files___________________

                  File_Name_______Location_______File_Purpose__________________

                  F7711M.ODL      [1,2]          Compiler overlay descriptor
                                                 file

                  F77TKB.CMD      [1,2]          Compiler Task Builder (TKB)
                                                 command file

                  _____________________________________________________________
                                                       (continued on next page)

               2-16  Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems

 











                  Table 2-2 (Cont.):  RSX-11M/M-PLUS FORTRAN-77 Files
                  _____________________________________________________________
                  ____________________Compiler-related_Files___________________

                  File_Name_______Location_______File_Purpose__________________

                  F77.TSK         [3,54][1]      Task image

                  F77COM.MSG      [1,2]          Compiler error-message file

                  F77REL.DOC      [1,2]          Release notes

                  _____________________________________________________________
                  __________Installation_Verification_Procedure_Files__________

                  File_Name_______Location_______File_Purpose__________________

                  F77IVP.CMD      [246,246]      IVP command file

                  F77TST.FTN      [246,246]      IVP test program

                  _____________________________________________________________
                  ________________Object_Time_System_(OTS)_Files_______________

                  File_Name_______Location_______File_Purpose__________________

                  F77FCS.OLB      [1,1]          FCS version of the OTS

                  F77RMS.OLB      [1,1]          RMS version of the OTS

                  F7711S.OBS      [1,1]          RSX-11S OTS

                  _____________________________________________________________
                  ___________Optional_Object_Time_System_(OTS)_Files___________

                  File_Name_______Location_______File_Purpose__________________

                  F77CVF.OBJ      [1,1]          Alternate OTS module for
                                                 floating point

                  F77EIS.OBS      [1,1]          Alternate OTS modules for
                                                 Extended Instruction Set (EIS)
                                                 floating-point functions

                  [1]On_RSX-11M_operating_systems_this_directory_is_[1,54].____

                  _____________________________________________________________
                                                       (continued on next page)

      Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems  2-17

 











                  Table 2-2 (Cont.):  RSX-11M/M-PLUS FORTRAN-77 Files
                  _____________________________________________________________
                  ___________Optional_Object_Time_System_(OTS)_Files___________

                  File_Name_______Location_______File_Purpose__________________

                  F77NER.OBS      [1,1]          Alternate OTS modules for
                                                 error reporting

                  F77NIO.OBS      [1,1]          Alternate OTS modules for I/O
                                                 support

                  F77RAN.OBS      [1,1]          Alternate OTS modules for
                                                 random numbers

                  FCS11M.ODL      [1,1]          Module to build an overlaid
                                                 FCS OTS

                  PDFMAP.OBS      [1,1]          Module to map intrinsic func-
                                                 tions

                  RMS11M.ODL      [1,1]          Module to build an overlaid
                                                 RMS OTS

                  _____________________________________________________________
                  ____________Files_for_Building_Resident_Libraries____________

                  File_Name_______Location_______File_Purpose__________________

                  F7FCLS.BLD      [1,1]          Command file for clustered FCS
                                                 OTS

                  F7FCLS.CMD      [1,1]          TKB command file for clustered
                                                 FCS OTS

                  F7FCLS.MAC      [1,1]          File to tailor clustered FCS
                                                 OTS

                  F7FRES.BLD      [1,1]          Command file for nonclustered
                                                 FCS OTS

                  _____________________________________________________________
                                                       (continued on next page)


               2-18  Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems

 











                  Table 2-2 (Cont.):  RSX-11M/M-PLUS FORTRAN-77 Files
                  _____________________________________________________________
                  ____________Files_for_Building_Resident_Libraries____________

                  File_Name_______Location_______File_Purpose__________________

                  F7FRES.CMD      [1,1]          TKB command file for nonclus-
                                                 tered FCS OTS

                  F7FRES.MAC      [1,1]          File to tailor nonclustered
                                                 FCS OTS

                  F7SRES.BLD      [1,1]          Command file for FCS OTS
                                                 linked with FCSFSL

                  F7SRES.CMD      [1,1]          TKB command file for FCS OTS
                                                 linked with FCSFSL

                  F7SRES.MAC      [1,1]          File to tailor FCS OTS linked
                                                 with FCSFSL

                  F7RCLS.BLD      [1,1]          Command file for clustered RMS
                                                 OTS

                  F7RCLS.CMD      [1,1]          TKB command file for clustered
                                                 RMS OTS

                  F7RCLS.MAC      [1,1]          File to tailor clustered RMS
                                                 OTS

                  _____________________________________________________________
                  ____________________Resident_Library_Files___________________

                  File_Name_______Location_______File_Purpose__________________

                  F77EP.MAC       [1,1]          File to build OTS resident
                                                 libraries and vector

                  F77GBL.XCL      [1,1]          File to exclude FORTRAN OTS
                                                 entry points

                  _____________________________________________________________
                                                       (continued on next page)


      Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems  2-19

 











                  Table 2-2 (Cont.):  RSX-11M/M-PLUS FORTRAN-77 Files
                  _____________________________________________________________
                  ____________________Resident_Library_Files___________________

                  File_Name_______Location_______File_Purpose__________________

                  F77VEC.MAC      [1,1]          File helps build OTS resident
                                                 library vector

                  F7RCLS.TSK      [1,1]          Task image for clustered RMS
                                                 library

                  F7RCLS.STB      [1,1]          Symbol table definition file
                                                 for clustered RMS library

                  F7FRES.TSK      [1,1]          Task image for nonclustered
                                                 FCS library

                  F7FRES.STB      [1,1]          Symbol table definition file
                                                 for nonclustered FCS file

                  F7FCLS.TSK      [1,1]          Task image for clustered FCS
                                                 library

                  F7FCLS.STB      [1,1]          Symbol table definition file
                                                 for clustered FCS library

                  F7SRES.TSK      [1,1]          Task image for FCS library
                                                 linked with FCSFSL

                  F7SRES.STB      [1,1]          Symbol table definition file
                                                 for FCS library linked with
                                                 FCSFSL

                  FCS.MAC         [1,1]          File helps build FCS OTS
                  _______________________________resident_library______________

                  See Chapter 1 for a list of Auto-Install files.







               2-20  Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems

 










               ____________________________________________________________

               2.5  Accessing the Release Notes

                  The FORTRAN-77 release notes describe new features and known
                  problems for this version of FORTRAN-77. To copy the release
                  notes file from the distribution medium prior to installing
                  FORTRAN-77, be sure that the Backup/Restore Utility (BRU) is
                  installed and enter one of the following commands according
                  to the distribution medium you have purchased:

                  For Disks:

                    >BRU/NOI/UFD/NEW/IMAGE:RESTORE/BAC:F77REL.BCK indev: outdev: <RET>

                  For Tapes:

                    >BRU/DENS:dens/BAC:F77REL.BCK/REW/NOI/UFD/NEW indev: outdev: <RET>

                  If necessary, you can install BRU with the following command:

                    >INS $BRU <RET>

                  Replace indev with the device on which your distribution
                  medium is allocated and mounted. Replace outdev with the
                  destination device. See the RSX-11M/M-PLUS Utilities Manual
                  for more information on BRU. After you issue this command,
                  you can use the PRINT command to print the release notes,
                  which will be located in directory [367,100].

                  During the installation, Auto-Install automatically copies
                  the release notes file from the distribution medium to di-
                  rectory [1,2] on your system disk and names it F77REL.DOC.
                  If you accept the default installation or answer YES to the
                  question during the installation dialogue "Print release
                  notes?" Auto-Install prints the file for you.

               ____________________________________________________________

               2.6  Reinstalling FORTRAN-77 from an Existing Installation

                  Auto-Install allows you to reinstall FORTRAN-77 Version 5.4
                  from an existing installation. The reinstallation proce-
                  dure differs according to the decisions you made during the
                  previous installation. This section explains the differences.

      Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems  2-21

 











                  When you reinstall the product, the installation procedure
                  asks the question, "Which device are the distribution files
                  for F77 (F77) located on (include colon)?" Your response
                  should be the name of the device you specified during your
                  previous installation in answer to the question, "Where do
                  you want to store the installation files?" The installa-
                  tion dialogue then proceeds as it did during the previous
                  installation.

                  If you have manually deleted installation files, you must use
                  the distribution kit to reinstall the product. If you have
                  deleted the configuration data file, F77F77.CFG, you must do
                  a complete installation from the distribution kit.

                  If you have not deleted the configuration data file, you may
                  use the current file by copying it to your login directory.
                  Copy it from directory [246,246] on the device you named
                  when answering the question, "Where do you want to store the
                  installation files?" during your previous installation. This
                  forces Auto-Install to overlook the configuration data file
                  contained on the kit and to use your customized one. From
                  this point, the installation proceeds with the customization
                  and installation dialogue as it did previously.






















               2-22  Installing FORTRAN-77 on RSX-11M and RSX-11M-PLUS Operating Systems

 

















                                                                      Chapter 3


                                               Installing on a MICRO/RSX System
               ________________________________________________________________


                  To install FORTRAN-77 on a Micro/RSX system, use the
                  Micro/RSX automatic installation procedure, OPTION.CMD. As
                  this procedure executes, it displays prompts to which you
                  must respond to install FORTRAN-77. This section explains how
                  to use the OPTION installation procedure.

                  Before you invoke the installation procedure, complete the
                  following steps:

                   1. Log in to a privileged account.

                   2. Verify that you have sufficient disk space to install
                     FORTRAN-77. Your system requires 1760 blocks for installa-
                     tion.[1]

                   3. Verify that, within these 1760 blocks, you have 400 free
                     blocks of contiguous storage for the FORTRAN-77 task
                     and 150 free blocks of contiguous storage for each OTS
                     library.

                   4. Note that installation should take approximately 5 to
                     15 minutes, depending on your system environment, your
                     configuration, and the software options you select during
                     installation.

               ___________________
             [1] This block-count specification refers to the disk space re-
                 quired on your system disk.  The sizes are approximations;
                 actual sizes may vary depending on your system environment,
                 your configuration, and the software options you select during

                 installation.

                                          Installing on a MICRO/RSX System  3-1

 











                   5. Insert the F77 Version 5.4 RX50 diskette or TK50 tape
                     into the drive. If you insert the F77 tape, you also need
                     to press the LOAD button. (The LOAD button will blink
                     slowly for about 15 seconds. Wait until the button stops
                     blinking.)

                  Release notes are copied automatically as part of the in-
                  stallation procedure. You can read them online or print them
                  after you complete installation. They reside in directory
                  [1,2] and are called F77REL.DOC.

                  To invoke the installation procedure, you type a command. If
                  you are an inexperienced FORTRAN-77 user, type the following
                  standard command:

                    $ @OPTION <RET>

                  If you are an experienced FORTRAN-77 user, you may wish to
                  modify the standard command in one of the following ways:

                    $ @OPTION /FULL <RET>
                    $ @OPTION /DISK <RET>

                  The /FULL switch allows diskette and tape users to condi-
                  tionalize FORTRAN-77 during installation. You can specify
                  a particular record access method rather than accepting the
                  default that supplies both.

                  If you use the /FULL switch, you will be asked whether you
                  want to install FORTRAN-77 to use File Control Services
                  (FCS), Record Management Services (RMS), or both. See your
                  Micro/RSX operating system documentation for more information
                  on FCS and RMS record access methods.

                  The /DISK switch allows tape users to install FORTRAN-77 on a
                  disk other than the system disk (LB:). For example, you can
                  use an optional fixed disk, if you have one.

                  If you use the /DISK switch, the output disk you want to use
                  must be spinning and mounted as a public device. You must
                  also include two lines in the file LB:[1,2]STARTUP.CMD to
                  ensure that this disk is mounted as a public device each
                  time the system is started up. Insert the following lines
                  immediately before the label .APP1:

                    .IF $$CLI EQ "MCR" MOU device:/SYS
                    .IF $$CLI EQ "DCL" MOUNT device:/SYSTEM

               3-2  Installing on a MICRO/RSX System

 











                  After you type the standard or a modified @OPTION command,
                  OPTION displays its main menu.

                  If FORTRAN-77 is already installed on your system, you must
                  type R to indicate that you want to remove the old version
                  of FORTRAN-77. The installation command procedure displays
                  the information you need to perform this operation. After
                  the task has been removed, reinvoke OPTION.CMD by typing the
                  standard or a modified @OPTION command.

                  When you are ready to install FORTRAN-77, type I to indi-
                  cate that you want to install software. Then, follow the
                  instructions displayed on your terminal.

                  OPTION.CMD installs FORTRAN-77 and runs the Installation
                  Verification Procedure (IVP). The IVP is a program that
                  tests features of FORTRAN-77 and ensures that it is working
                  properly. If the IVP completes successfully, the following
                  message displays:

                    FORTRAN--77 installation verification successful.

                  If the installation procedure completes successfully, the
                  following message displays:

                    Procedure successfully completed.

                  When you see this message, FORTRAN-77 is ready for use. Be
                  sure to remove your diskette or tape from the drive.

                  If the installation procedure fails, your system issues an
                  error message that identifies the reason for failure. For
                  explanations of error messages issued by the installation
                  procedure and suggestions for possible user actions to fix
                  problems, consult the appropriate operating system manual.

                  Table 3-1 lists the files you should see on your fixed disk
                  after installation. Do not delete any of these files; the
                  compiler needs them to function properly.






                                          Installing on a MICRO/RSX System  3-3

 











                  Table 3-1:  Micro/RSX FORTRAN-77 Files
                  _____________________________________________________________
                  ________________________Compiler_Files_______________________

                  Name____________Location_____Purpose_________________________

                  F77.INS         [1,2]        Installation command file

                  F77.TSK         [3,54]       Task image

                  F77COM.MSG      [1,2]        Compiler error-message file

                  F77REL.DOC      [1,2]        Release notes

                  FORTRAN.HLP     [1,2]        Help file

                  _____________________________________________________________
                  ________Installation_Verification_Procedure_(IVP)Files_______

                  Name____________Location_____Purpose_________________________

                  F77IVP.CMD      [246,246]    IVP command file

                  F77IVP.FTN      [246,246]    IVP test program

                  F77IVP.MST      [246,246]    IVP master file

                  _____________________________________________________________
                  ________________Object_Time_System_(OTS)_Files_______________

                  File_Name_______Location_____File_Purpose____________________

                  F77FCS.OLB      [1,1]        FCS version of the OTS

                  F77RMS.OLB      [1,1]        RMS version of the OTS

                  F7711S.OBS      [1,1]        RSX-11S OTS
                  _____________________________________________________________
                                                       (continued on next page)






               3-4  Installing on a MICRO/RSX System

 











                  Table 3-1 (Cont.):  Micro/RSX FORTRAN-77 Files
                  _____________________________________________________________
                  ______________Optional_Object_Time_System_Files______________

                  Name____________Location_____Purpose_________________________

                  F77EIS.OBS      [1,1]        Alternate OTS modules for EIS
                                               functions

                  F77NER.OBS      [1,1]        Alternate OTS modules for error
                                               reporting

                  F77NIO.OBS      [1,1]        Alternate OTS modules for I/O
                                               support

                  F77RAN.OBS      [1,1]        Alternate OTS modules for random
                                               numbers

                  FCS11M.ODL      [1,1]        Module to build an overlaid FCS
                                               OTS

                  PDFMAP.OBS      [1,1]        Module to map intrinsic func-
                                               tions

                  RMS11M.ODL      [1,1]        Module to build an overlaid RMS
                                               OTS

                  _____________________________________________________________
                  ____________________Resident_Library_Files___________________

                  Name____________Location_____Purpose_________________________

                  F7FCLS.STB      [1,1]        Symbol table for clustered FCS
                                               OTS

                  F7FCLS.TSK      [1,1]        Task file for clustered FCS OTS

                  F7RCLS.STB      [1,1]        Symbol table for clustered RMS
                                               OTS

                  F7RCLS.TSK______[1,1]________Task_file_for_clustered_RMS_OTS_




                                          Installing on a MICRO/RSX System  3-5

 

















                                                                      Chapter 4


                             Installing FORTRAN-77 on a RSTS/E Operating System
               ________________________________________________________________


                  This chapter explains how to install FORTRAN-77 on the RSTS/E
                  operating system. Prior to installing this version of the
                  FORTRAN-77 compiler, perform the following steps:

                   1. Read this chapter, which contains information necessary
                     for installing the compiler.

                   2. Read the release notes, which describe new features and
                     known problems for this version of FORTRAN-77. For infor-
                     mation on how to access the release notes, see Section 4.5
                     in this chapter.

                   3. Ensure that the RSTS/E operating system is installed and
                     working properly.

                   4. Ensure that your system meets the minimum software and
                     hardware requirements for FORTRAN-77. See the Software
                     Product Description (SPD) for a list of the minimum soft-
                     ware and hardware requirements.

                   5. Choose the optional attributes for your compiler.
                     For information on optional compiler attributes, see
                     Section 4.1.1 in this chapter.

                  A FORTRAN-77 installation requires between 15 and 30 min-
                  utes to complete, depending on whether or not you choose
                  to include resident libraries in the compiler. It may re-
                  quire additional time if you choose to set your own compiler
                  attributes rather than accepting the defaults.



                        Installing FORTRAN-77 on a RSTS/E Operating System  4-1

 










               ____________________________________________________________

               4.1  Preparing to Install the FORTRAN-77 Compiler

                  Unless you accept the default installation, you must choose
                  optional attributes for your FORTRAN-77 compiler. Among
                  the attributes you must choose are the default compiler at-
                  tributes, the default setting for compile-time switches, and
                  the FORTRAN-77 Object Time System (OTS) resident libraries,
                  if any, that you wish to install. The following sections
                  discuss these options in detail.

               ____________________________________________________________

               4.1.1  Default Compiler Attributes

                  The configuration data file contains parameters and values
                  that determine the default compiler attributes. You can ac-
                  cept these defaults or change them by answering the questions
                  you will be asked in the installation dialogue if you choose
                  to customize your compiler. The configuration data file is
                  called F77F77.CFG. It is stored in the logical name FRTRN7$
                  location (FRTRN7$ specifies device and directory).

                  Note that no question exists on floating-point hardware; if
                  floating-point hardware is on the system, the compiler uses
                  it automatically. If your system does not have the floating-
                  point hardware, your compiler cannot perform floating-point
                  constant folding at compile time.

                  Section 4.3.3 shows the dialogue for customizing the configu-
                  ration data file.

               ____________________________________________________________

               4.1.2  Default Setting for Compile-Time Switches

                  As explained previously, the contents of the configuration
                  data file, whether customized or not, determine the default
                  attributes of the FORTRAN-77 compiler. These default at-
                  tributes determine the default settings of the compile-time
                  switches. Whatever default attributes you choose for your
                  compiler, you can override them at compilation time by means
                  of the compile-time switches.


               4-2  Installing FORTRAN-77 on a RSTS/E Operating System

 











                  Table 4-1 lists and describes the compile-time switches. The
                  PDP-11 FORTRAN-77 User's Guide contains detailed information
                  on these switches and their DIGITAL Command Language (DCL)
                  equivalents.

                                               NOTE

                      When you change a CCL compile-time switch during
                      the installation, the equivalent DCL qualifier also
                      changes.

                  Table 4-1:  Compile-Time Switches
                  _____________________________________________________________
                  Switch__Description__________________________________________

                  /CK     Checks array references to ensure that they are
                          within the array address boundaries specified.

                  /CO:n   Accepts at least n continuation lines. Value of n can
                          be 0 to 111(8).

                  /DB     Provides symbol table information for use by the
                          Symbolic Debugger.

                  /DE     Compiles lines with the letter D in column 1.

                  /DS     Uses I- and D-space active page registers.

                  /EX     Accepts source text up to column 132(10) of an input
                          record.

                  /I4     Allocates 2 words for the default length of integer
                          and logical variables.

                  /LA     Causes current switch specifications to be retained
                          for subsequent compilations.

                  /LI:n   Determines content of listings: source and map or
                          source, map, and generated code.
                  _____________________________________________________________
                                                       (continued on next page)




                        Installing FORTRAN-77 on a RSTS/E Operating System  4-3

 











                  Table 4-1 (Cont.):  Compile-Time Switches
                  _____________________________________________________________
                  Switch__Description__________________________________________

                  /OP     Produces optimized code.

                  /RO     Specifies pure code and data sections as read-only to
                          allow code sharing in multiuser tasks.

                  /SP     Automatically prints the listing file.

                  /ST:xxx Flags extensions to ANSI standard in source code.

                  /TR:xxx Controls the amount of extra code included in the
                          compiled output for use by the Object Time System
                          during error traceback.

                  /WF:n   Determines the number of temporary disk work files to
                          be used during compilation.

                  /WR_____Enables_compiler_warning_diagnostics.________________


               ____________________________________________________________

               4.1.3  FORTRAN-77 Object Time System (OTS) Resident Libraries

                  Use of the FORTRAN-77 Object Time System (OTS) memory-
                  resident libraries may reduce the size of users' tasks and
                  may lower FORTRAN-77's requirements for system resources.
                  During the installation dialogue, you are asked, "File ser-
                  vices?" You reply either RMS, FCS, or BOTH to that question.
                  Your reply determines your options when you are later asked,
                  "Build resident library?"

                  On RSTS/E, there are two resident libraries you can build:
                  the RMS clustered resident library (F7RCLS) and the FCS
                  resident library (F7FRES). You can build the RMS library
                  if you responded either RMS or BOTH to the "File services?"
                  question. Similarly, you can build the FCS library if you
                  responded either FCS or BOTH.




               4-4  Installing FORTRAN-77 on a RSTS/E Operating System

 










               ____________________________________________________________

               4.2  Mounting the Distribution Medium

                  To prepare for the installation of FORTRAN-77, perform the
                  following steps:

                   1. Log in to a privileged account. The installation procedure
                     generates a log file, which will remain in your default
                     login area after you complete the installation. Therefore,
                     it is no longer essential to use a hard-copy terminal to
                     produce a record of your installation session.

                   2. Verify that no one else on your system is performing an
                     installation using Auto-Install.

                   3. Verify that no one on your system is using a previously
                     installed version of FORTRAN-77.

                   4. If Auto-Install is not already installed on your system,
                     verify that you have 750 free blocks of contiguous storage
                     space available for Auto-Install.

                   5. Verify that you have 2270 free blocks of storage space
                     available on the system device. Of this, you need 400 con-
                     tiguous blocks for the FORTRAN-77 task and 160 contiguous
                     blocks apiece for each OTS memory-resident library (as
                     many as 720 contiguous blocks in all).

                   6. Place your distribution medium in the drive.

                     If your distribution medium is a disk, insert the disk in
                     the drive and set the switch to the RUN position. Ensure
                     that the READY light is on.

                     If your distribution medium is tape, load the tape ac-
                     cording to the instructions for the drive. Set the
                     ONLINE/OFFLINE indicator to ONLINE and ensure that the
                     READY light is on.

                     If your distribution medium is a TK50 tape cartridge, in-
                     sert the tape into the drive according to the instructions
                     for the drive, and push down the cartridge-release handle
                     on the drive. Press the LOAD button and ensure that the
                     LOAD light is on.

                        Installing FORTRAN-77 on a RSTS/E Operating System  4-5

 










               ____________________________________________________________

               4.3  Installing and Verifying the FORTRAN-77 Compiler

                  FORTRAN-77 is installed using the Auto-Install software.
                  If Auto-Install (Version 1.1 or higher) has not been in-
                  stalled on your system, you must install it before installing
                  FORTRAN-77.

               ____________________________________________________________

               4.3.1  Installing Auto-Install

                  To install Auto-Install, type the following command:

                    $ RESTORE/REPLACE/ACCOUNT/END=NODISMOUNT indev:[1,2]AUT101.A
                    AUTOIN$:*.* <RET>

                  Replace indev with the name of the device (diskette or tape)
                  on which you physically mounted your distribution medium.

               ____________________________________________________________

               4.3.2  Invoking Auto-Install

                  You can invoke Auto-Install with any one of the following
                  commands:

                   1. @AUTOIN$:AUTOIN.COM

                   2. @AUTOIN$:AUTOIN.COM F77

                   3. @AUTOIN$:AUTOIN.COM indev:F77

                  Replace indev with the name of the device on which you phys-
                  ically mounted your distribution medium. Press RETURN to
                  execute the command.

                  If you use command 1, the installation dialogue begins with
                  step 1 in the following section.

                  If you use command 2, the installation dialogue begins with
                  step 2.

                  If you use command 3, the installation dialogue begins with
                  step 2 and skips to step 4.

               4-6  Installing FORTRAN-77 on a RSTS/E Operating System

 










               ____________________________________________________________

               4.3.3  Installation Dialogue

                  This section describes the installation dialogue that appears
                  on your screen. The text that follows each question explains
                  the answers to the question. These explanations do not appear
                  in the actual installation dialogue.

                  The default answer appears at the end of each question,
                  enclosed in angle brackets (< >). In some cases the text of
                  the question shows valid answers in angle brackets, followed
                  by the default in angle brackets. You can accept the default
                  answer by by simply pressing RETURN. If you enter an explicit
                  answer, whether equivalent to the default or not, you must
                  press RETURN to complete it. If you want to exit Auto-Install
                  at any point (thus terminating the installation procedure),
                  type CTRL/Z.

                  Depending on how you invoked Auto-Install, you will enter the
                  dialogue at step 1 or step 2.

                   1. Which product(s) do you want to install?

                     In response to this prompt, type F77, which is the product
                     name for FORTRAN-77. Press CTRL/Z to exit from Auto-
                     Install at this point.

                   2. Where are the update files located <PATCH$:>?

                     If the name of the patch account is PATCH$, press RETURN.
                     If the patch account is not named PATCH$, enter the cor-
                     rect name, including the colon (:).  To exit from Auto-
                     Install at this point, press CTRL/Z.

                   3. Which device are the distribution files for F77 (F77)
                     located on (include colon)?

                     If you are installing FORTRAN-77 from a distribution kit,
                     specify the drive on which you allocated and mounted the
                     distribution disk or tape. If you are installing from
                     an account on your system (for example, reinstalling an
                     existing installation), specify FRTRN7$:. To exit from
                     Auto-Install at this point, press CTRL/Z.

                     If you are installing from the distribution kit or have
                     answered YES to the "Allow future customization of this
                     file?" question during a previous installation, Auto-
                     Install will issue the following question:

                   4. Do you want to customize F77 (F77) (Y/N) <N>?

                     Type Y to customize your FORTRAN-77 installation.

                        Installing FORTRAN-77 on a RSTS/E Operating System  4-7

 











                     Type N or press RETURN if you do not wish to customize
                     FORTRAN-77.

                     The default compiler may fulfill your system requirements.
                     However, you may be able to improve compiler performance
                     by customizing the compiler.

                     If you have already customized your compiler during a
                     previous installation, or if you want the default con-
                     figuration, type N or press RETURN. The installation
                     procedure will then skip all other questions pertaining to
                     customization.

                  If you choose to customize, you will be asked further ques-
                  tions. Press RETURN to accept the default answer; press
                  CTRL/Y to abort customization; press CTRL/Z to exit from
                  customization but retain any changes made so far; or type a
                  new value. If a question has multiple choices for the answer,
                  the choices will be listed in angle brackets (< >).

                                               NOTE

                      The default answers given in angle brackets (and the
                      explanations of the defaults) apply if you have not
                      changed the configuration data file to customize the
                      compiler. The defaults may be different if you have
                      already customized the configuration data file. The
                      answers you provide in this file become the default
                      answers in the installation procedure, overriding the
                      defaults shown in the questions.

                    Target device <SY:>?

                  Specify the target device, (that is, the device where the
                  compiler will reside after the installation).

                    Task directory <[1,2]>?

                  Specify the directory in which you want the compiler tasks to
                  reside after the installation.

                    Allow future customization of this file <YES>?

                  Answer NO only if you want to disallow future customizing of
                  the compiler.

                    Print release notes <NO>?

               4-8  Installing FORTRAN-77 on a RSTS/E Operating System

 











                  Answer YES if you want to print release notes on the system
                  default printer during the installation.

                    Print log file <NO>?

                  Answer YES if you want to print the installation log on the
                  system default printer during the installation.

                    Error message type <LONG, SHORT> <LONG>?

                  Your answer determines the form in which FORTRAN-77 error
                  messages will be presented.

                    File services <FCS,RMS,BOTH> <BOTH>?

                  Specify FCS if you want FCS services but not RMS. Specify
                  RMS if you want RMS services but not FCS. Default if you want
                  both FCS and RMS services. Your response to this question
                  determines which types of resident libraries you will be
                  allowed to specify later in the installation dialogue.

                    Use alternate convert module <YES, NO> <NO>?

                  Answer YES if you want to include the alternate convert
                  module. Note that the alternate convert module requires
                  floating-point hardware on the system.

                    Build resident library <YES, NO> <NO>?

                  Answer YES if you intend to build at least one resident
                  library. If you reply YES to this question, you will see
                  either or both of the following two questions, depending on
                  how you replied to the previous "File services?" question.

                    Build RMS clustered resident library <YES,NO> <NO>?

                    Build FCS resident library <YES,NO> <NO>?

                  Answer YES to each question if you want to include the indi-
                  cated library in the compiler.

                    Stack size (must never be less than 512 words) <1024>?

                  Defines the size of the SP stack.

                    Compiler's dynamic storage <3840>?

                        Installing FORTRAN-77 on a RSTS/E Operating System  4-9

 











                  Defines the amount of resident memory used by the work file
                  on a virtual memory system. If your operating system supports
                  dynamic memory allocation, the size of the compiler's dynamic
                  storage is determined by assigning your response to the
                  EXTTSK Task Builder option. If dynamic memory allocation
                  is not supported, the compiler will use all of the memory
                  available on the partition.

                    Control section STACK1 (expression analyzer/common block definitions)
                    <1160>?

                  Defines the size of the control section STACK1. FORTRAN-77
                  uses STACK1 as the the expression analyzer stack in pass 1
                  and for named common block definitions in later passes.

                    DO stack (nested DO/IF statements) <240>?

                  Defines the size of the control section DOSTK1, which
                  FORTRAN-77 uses for nesting DO and IF statements.

                    Lines per page (plus 3 lines of heading) <octal value>
                    <67>?

                  Specifies the number of lines allowed on a page of the de-
                  fault printer. Note that you must express this as an octal
                  value.

                    Printer line width <octal value> <204>?

                  Specifies the number of character positions across the width
                  of a line on the default printer. Note that you must express
                  this as an octal value.

                    Supersede output files <0=NO, 1=YES> <0>?

                  A value of 0 indicates the compiler should not supersede
                  output listing and object files. A value of 1 allows super-
                  seding.

                    I- and D-Space support <0=NO, 1=YES> <1>?

                  A value of 1 indicates the compiler will generate object
                  files that can be used to build I-space and D-space tasks. A
                  value of 0 disallows this.

                    Reinitialize switches <0=NO, 1=YES> <0>?

               4-10  Installing FORTRAN-77 on a RSTS/E Operating System

 











                  Defines the default setting for the /LA switch.

                    Array subscript bounds checking <0=NO, 1=YES> <0>?

                  Defines the default setting for the /CK switch.

                    Number of continuation lines <octal value> <23>?

                  Defines the default setting for the CO:x switch.

                    Include debug lines <0=NO, 1=YES> <0>?

                  Defines the default setting for the /DE switch.

                    Default to INTEGER*4 values <0=NO, 1=YES> <0>?

                  Defines the default setting for the /I4 switch.

                    Listing <1=Source, 2=(Source,Map) 3=(Source,Map,Generated code)> <2>?

                  Defines the default setting for the /LI switch.

                    Read Only code sections <0=NO, 1=YES> <0>?

                  Defines the default setting for the /RO switch.

                    Spool listing <0=NO, 1=YES> <0>?

                  Defines the default setting for the /SP switch.

                    Trace <0=NONE, 1=NAMES, 3=BLOCKS 7=ALL> <3>?

                  Defines the default setting for the /TR:xxx switch.

                    Number of temporary files <Range 1-3> <2>?

                  Defines the default setting for the /WF:n switch.

                    Enable optional warnings <0=NO, 1=YES> <1>?

                  Defines the default setting for the /WR switch.

                    FORTRAN ANSI interpretation <0=FORTRAN-66, 1=FORTRAN-77> <1>?

                  Defines the default setting for the /F77 switch.

                    Standards checking <0=NONE, 1=SOURCE, 2=SYNTAX, 3=ALL> <0>?

                  Defines the default setting for the /ST:xxx switch.

                    Produce symbolic debugger information <0=NO, 1=YES> <0>?

                       Installing FORTRAN-77 on a RSTS/E Operating System  4-11

 











                  Defines the default setting for the /DB switch.

                    Extend source line <0=NO (72 cols), 1=YES (132 cols)> <0>?

                  Defines the default setting for the /EX switch.

                    Code optimization <0=NO, 3=YES> <3>?

                  Defines the default setting for the /OP switch.

                    Do you want to customize F77 again <Y/N><NO>?

                  Type Y if you want to change any of your answers to the
                  customization questions. If not, press RETURN or type N.

                  Once the contents of the configuration data file are com-
                  plete, Auto-Install installs FORTRAN-77. Throughout the
                  installation process, Auto-Install displays several informa-
                  tional messages. Following the installation, Auto-Install
                  runs the Installation Verification Procedure (IVP) for
                  FORTRAN-77.

               ____________________________________________________________

               4.3.4  Installation Verification Procedure

                  The Installation Verification Procedure (IVP) consists of two
                  tests: one checks the compiler's ability to detect a compile-
                  time error and another checks the ability of the Object Time
                  System (OTS) to detect a run-time error. Both tests require
                  floating point hardware. If the first test is successful, the
                  following message is displayed on your terminal:

                    F77 -- ERROR 28-E Overflow while converting constant or constant expression
                                         [I = 71347] in module F77TST at line 6

                    F77 -- 1 Error F77TST.FTN;1

                  If the second test is successful, the following message is
                  displayed on your terminal:

                    NNNNNN  --  ERROR 73
                      Floating zero divide
                      at PC = xxxxxx
                        in   "F77TST" at or after 6

                     Where NNNNNN is the task name and xxxxxx is the actual program location

               4-12  Installing FORTRAN-77 on a RSTS/E Operating System

 











                  If these messages are not displayed on your terminal, an
                  error has occurred in your installation.

                  On a machine without floating point hardware, the IVP is-
                  sues different messages. You can check the installation by
                  attempting to compile and run a user program.

                  When the IVP is complete and the installation is successful,
                  the following message is displayed on your terminal:

                    Installation of F77 (F77) successful.

               ____________________________________________________________

               4.3.5  Installing Resident Libraries

                  If you plan to install a FORTRAN-77 resident library, you
                  must first remove any old ones that may be installed. To do
                  so, use the REMOVE command as follows:

                    $ REMOVE/LIBRARY name <RET>

                  To install the new resident libraries, use the INSTALL com-
                  mand as follows:

                    $ INSTALL/LIBRARY LB:name [/qualifier[,s]] <RET>

                  In these commands, replace name with the name of the FCS or
                  RMS library (F7FRES for FCS, F7RCLS for RMS).

                  For further information on these commands, see the RSTS/E
                  System Manager's Guide.

               ____________________________________________________________

               4.3.6  Start-Up Control File

                  After installing FORTRAN-77, use a text editor to modify the
                  start-up control file (START.COM) in your operating system to
                  include the following UTILITY command. This command will then
                  be defined at the beginning of each time-sharing session:

                    DEFINE/COMMAND/SYSTEM F77 dev:[x,y]F77.TSK

                  where dev: is the value established by the "Target device?"
                  question and [x,y] is the value established by "Task di-
                  rectory?" If you do not change the configuration data file
                  defaults, the command is:

                       Installing FORTRAN-77 on a RSTS/E Operating System  4-13

 











                    DEFINE/COMMAND/SYSTEM F77 SY:[1,2]F77.TSK

                  If you plan to use one of the FORTRAN-77 resident libraries,
                  you can add the INSTALL commands for installing them to
                  this file. These commands are described in the RSTS/E System
                  Manager's Guide.

               ____________________________________________________________

               4.4  Installation Files

                  Table 4-2 lists and describes the files stored during instal-
                  lation. These files are necessary to the compiler. Deleting
                  them will cause the compiler to malfunction. Do not modify
                  the resident library-related files; the compiler requires the
                  current versions.

                                               NOTE

                      After installation, FORTRAN-77 causes specific direc-
                      tories to be searched for the files it needs. If you
                      move these files to a different location, be sure to
                      restore the original directory configuration before
                      installing a subsequent update. The installation pro-
                      cedure deletes intermediary files, so that the files
                      remaining in FRTRN7$ upon installation completion are
                      those you will need for rebuilding FORTRAN-77.

                  Table 4-2:  RSTS/E FORTRAN-77 Files
                  _____________________________________________________________
                  ___________________Compiler_Building_Files___________________

                  File_Name_______Location_____File_Purpose____________________

                  F77RST.ODL      [1,2]        Compiler overlay descriptor file

                  F77RST.CMD      [1,2]        Compiler TKB command file
                  _____________________________________________________________
                                                       (continued on next page)






               4-14  Installing FORTRAN-77 on a RSTS/E Operating System

 











                  Table 4-2 (Cont.):  RSTS/E FORTRAN-77 Files
                  _____________________________________________________________
                  ________________________Compiler_Files_______________________

                  Name____________Location_____Purpose_________________________

                  F77.TSK         [1,2]        Task image

                  F77COM.MSG      [1,2]        Compiler error-message file

                  F77REL.DOC      [1,2]        Release notes

                  _____________________________________________________________
                  _______Installation_Verification_Procedure_Files_(IVP)_______

                  Name____________Location_____Purpose_________________________

                  F77IVP.COM      FRTRN7$:     IVP command file

                  F77TST.FTN      FRTRN7$:     IVP test program

                  _____________________________________________________________
                  ________________Object_Time_System_(OTS)_Files_______________

                  Name____________Location_____Purpose_________________________

                  F77FCS.OLB      [1,1]        FCS version of the OTS

                  F77RMS.OLB      [1,1]        RMS version of the OTS

                  F7711S.OBS      [1,1]        RSX-11S OTS

                  _____________________________________________________________
                  ___________Optional_Object_Time_System_(OTS)_Files___________

                  Name____________Location_____Purpose_________________________

                  F77CVF.OBJ      [1,1]        Alternate OTS module for float-
                                               ing point

                  F77EIS.OBS      [1,1]        Alternate OTS modules for EIS
                                               functions

                  F77NER.OBS      [1,1]        Alternate OTS modules for error
                                               reporting
                  _____________________________________________________________
                                                       (continued on next page)

                       Installing FORTRAN-77 on a RSTS/E Operating System  4-15

 











                  Table 4-2 (Cont.):  RSTS/E FORTRAN-77 Files
                  _____________________________________________________________
                  ___________Optional_Object_Time_System_(OTS)_Files___________

                  Name____________Location_____Purpose_________________________

                  F77NIO.OBS      [1,1]        Alternate OTS modules for I/O
                                               support

                  F77RAN.OBS      [1,1]        Alternate OTS modules for random
                                               numbers

                  FCS11M.ODL      [1,1]        Module to build an overlaid FCS
                                               OTS

                  PDFMAP.OBS      [1,1]        Module to map intrinsic func-
                                               tions

                  RMS11M.ODL      [1,1]        Module to build an overlaid RMS
                                               OTS

                  _____________________________________________________________
                  ____________Files_for_Building_Resident_Libraries____________

                  Name____________Location_____Purpose_________________________

                  F7FRES.BLD      [1,1]        Command file for nonclustered
                                               FCS OTS

                  F7FRES.CMD      [1,1]        TKB command file for nonclus-
                                               tered FCS OTS

                  F7FRES.MAC      [1,1]        File to tailor nonclustered FCS
                                               OTS

                  F7RCLS.BLD      [1,1]        Command file for clustered RMS
                                               OTS
                  _____________________________________________________________
                                                       (continued on next page)






               4-16  Installing FORTRAN-77 on a RSTS/E Operating System

 











                  Table 4-2 (Cont.):  RSTS/E FORTRAN-77 Files
                  _____________________________________________________________
                  ____________Files_for_Building_Resident_Libraries____________

                  Name____________Location_____Purpose_________________________

                  F7RCLS.CMD      [1,1]        TKB command file for clustered
                                               RMS OTS

                  F7RCLS.MAC      [1,1]        File to tailor clustered RMS OTS

                  _____________________________________________________________
                  ________________Resident_Library-Related_Files_______________

                  Name____________Location_____Purpose_________________________

                  F7RCLS.LIB      [1,1]        Clustered RMS library

                  F7RCLS.TSK      [1,1]        Task image for clustered RMS
                                               library

                  F7RCLS.STB      [1,1]        Symbol table definition file for
                                               clustered RMS library

                  F7FRES.LIB      [1,1]        Nonclustered RMS library

                  F7FRES.TSK      [1,1]        Task image for nonclustered FCS
                                               library

                  F7FRES.STB      [1,1]        Symbol table definition file for
                                               nonclustered FCS file

                  F77EP.MAC       [1,1]        File to build OTS resident
                                               libraries and vector
                  _____________________________________________________________
                                                       (continued on next page)









                       Installing FORTRAN-77 on a RSTS/E Operating System  4-17

 











                  Table 4-2 (Cont.):  RSTS/E FORTRAN-77 Files
                  _____________________________________________________________
                  ________________Resident_Library-Related_Files_______________

                  Name____________Location_____Purpose_________________________

                  F77GBL.XCL      [1,1]        File to exclude FORTRAN OTS
                                               entry points

                  F77VEC.MAC      [1,1]        File helps build OTS resident
                                               library vector

                  FCS.MAC         [1,1]        File helps build FCS OTS resi-
                  _____________________________dent_library____________________

                  See Chapter 1 for a list and description of the Auto-Install
                  files.

               ____________________________________________________________

               4.5  Accessing the Release Notes

                  The FORTRAN-77 release notes describe new features and known
                  problems for this version of FORTRAN-77. To copy the release
                  notes file from the distribution medium prior to installing
                  FORTRAN-77, enter the following command:

                    $ RESTORE/REPLACE/END=NODISMOUNT indev:[1,2]F77REL.BCK
                    FRTRN7$:*.* <RET>

                  Replace indev with the device on which your distribution
                  medium is allocated and mounted. Once you have copied the
                  release notes file to your login directory, you can use the
                  PRINT command to print it.

                  Auto-Install also automatically copies the release notes file
                  from the distribution medium to directory [1,2] and names it
                  F77REL.DOC.

                  If you accept the default installation or answer YES to the
                  question in the customization portion of the installation
                  dialogue,"Print the release notes automatically?" Auto-
                  Install prints the release notes file.


               4-18  Installing FORTRAN-77 on a RSTS/E Operating System

 










               ____________________________________________________________

               4.6  Reinstalling FORTRAN-77 from an Existing Installation

                  Auto-Install allows you to reinstall FORTRAN-77 Version 5.4
                  from an existing installation. The reinstallation proce-
                  dure differs according to the decision you made during the
                  previous installation. This section explains the differences.

                  When you reinstall the product, the installation procedure
                  asks the question "Which device are the distribution files
                  for F77 (F77) located on (include colon)?" Your response
                  should be FRTRN7$:. The installation dialogue then proceeds
                  as it did during the previous installation.

                  If you have manually deleted installation files, you must use
                  the distribution kit to reinstall the product.

                  If you have deleted the configuration data file, F77F77.CFG,
                  you must do a complete installation from the distribution
                  kit. If you have not deleted the configuration data file,
                  you may use the current file by copying it to your login
                  directory from FRTRN7$:. This forces Auto-Install to overlook
                  the configuration data file contained on the kit and to
                  use your customized one. From this point, the installation
                  procedure proceeds as it did previously.




















                       Installing FORTRAN-77 on a RSTS/E Operating System  4-19

 

















                                                                      Chapter 5


                                            Installation on VMS with VAX-11 RSX
               ________________________________________________________________


                  This chapter describes how to install the PDP-11 FORTRAN-77
                  on VAX-11 RSX using VMSINSTAL.

                  VMSINSTAL is the command procedure that installs PDP-11
                  FORTRAN-77 on your VAX-11 RSX system. As the command pro-
                  cedure executes, it displays questions regarding installa-
                  tion options. This section explains these questions, their
                  answers, and other steps you must take to install FORTRAN-77.

                  Default settings are provided for all the questions. If you
                  want to accept a default, press RETURN. Otherwise, type your
                  reply and press RETURN.

                  Before you invoke VMSINSTAL, do the following:

                   1. Log in to the system account.

                   2. Be sure the logical name SYS$DISK is assigned to the disk
                     that contains the current version of VMS. This disk also
                     contains the command procedure that initiates the new
                     installation or update procedure. Note that SYS$DISK
                     should not be SYS$SYSTEM.

                   3. Alter your system so that it is operating in standalone
                     mode. This way, other user activity will not interfere
                     with your installation.

                   4. Verify that you have sufficient disk space to install and
                     use
                     FORTRAN-77. Your system requires 2500 blocks for installa-
                     tion; it requires 1400 blocks for permanent use.[1]

               ___________________
             [1] This block-count specification refers to the disk space re-
                 quired on your system disk.  The sizes are approximations;

                                       Installation on VMS with VAX-11 RSX  5-1

 











                   5. Verify that, within these blocks, you have 400 free blocks
                     of contiguous storage for the FORTRAN-77 task and 150 free
                     blocks of contiguous storage for each OTS library.

                   6. Note that installation should take approximately 20-
                     30 minutes, depending on your system environment, your
                     configuration, and the software options you select during
                     installation.

                   7. Issue the following command:

                       $ SET DEFAULT SYS$UPDATE <RET>

                  Release notes are copied automatically as part of the instal-
                  lation procedure. You can retrieve any release notes copied
                  from the SYS$HELP directory. During the installation you
                  will receive a prompt asking if you want to print the release
                  notes and how many copies you want to print.

                  After you have completed these steps, you are ready to invoke
                  the installation procedure. Type the following command:

                    $ @VMSINSTAL FOR77PDP054 dev: <RET>

                  Replace dev with the device in which you placed your distri-
                  bution kit.

                  The installation procedure first checks to ensure that you
                  are running it in standalone mode. If you are not doing
                  so, VMSINSTAL issues a warning message that identifies the
                  active processes on your system. It also asks if you want to
                  continue.

                    Do you want to continue anyway [NO]?

                  If you want to install FORTRAN-77 in standalone mode, press
                  RETURN. The installation procedure stops, so you can recon-
                  figure your system and reinvoke VMSINSTAL.

                  If you want to install FORTRAN-77 while processes are active
                  on your system, type YES and press RETURN.

               ___________________

                 actual sizes may vary depending on your system environment,
                 your configuration, and the software options you select during

                 installation.

               5-2  Installation on VMS with VAX-11 RSX

 











                  VMSINSTAL then asks you if you are satisfied with the backup
                  of your system disk.

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

                  If you are not satisfied, type NO and press RETURN. VMSINSTAL
                  will abort, and you can then backup your system disk. If you
                  are satisfied, press RETURN.

                  After you have accepted the backup of your system disk, the
                  following message displays:

                    Please mount the first volume of the set on dev:

                    Are you ready?

                  Place the first volume of your distribution kit in a free
                  drive. Then, answer YES and press RETURN to proceed. If you
                  answer NO, VMSINSTAL will abort.

                  VMSINSTAL confirms that the distribution volume has been
                  mounted; then, the following messages appear:

                    The following products will be processed:

                    FOR77PDP V5.4

                    Beginning installation of FOR77PDP V5.4 at hh:mm

                    %VMSINSTAL-I_RESTORE, Restoring produce to saveset A...

                  For each additional volume of your distribution kit, the
                  installation procedure displays the following message:

                    %BACKUP-I-READYREAD, mount volume n on dev: for reading
                    Enter "Yes" when ready:

                  Place each volume in a free drive. Type YES and press RETURN.
                  VMSINSTAL recognizes when you have mounted the correct number
                  of volumes for your system and moves to the next step in in-
                  stallation. If you do not mount the correct number, VMSINSTAL
                  aborts.

                  VMSINSTAL next checks your version of VAX-11 RSX. Installation
                  halts if your system runs a version that is too old. If VAX-
                  11 RSX Version 2.4 or higher has been installed, VMSINSTAL
                  displays the following message:

                                       Installation on VMS with VAX-11 RSX  5-3

 











                    %ANALYZE-I-ERRORS, VMI$ROOT:[SYSEXE]RSX.EXE;11          0 errors
                    %FOR&&DPD-I-RSXINSTALLED, The version of VAX--11 RSX installed is
                       VAXRSX V2.3

                  The next prompt displays five release notes options from
                  which you can make a selection.

                    1.  Display release notes
                    2.  Print release notes
                    3.  Both 1 and 2
                    4.  Copy release notes to SYS$HELP
                    5.  Do not display, print, or copy release notes

                    Select option [2]:2

                  The effects of these options are as follows:

                   1. Option 1 displays the release notes immediately on your
                     screen. You can terminate the display of the release notes
                     at any time by pressing CTRL/C. When you have finished,
                     VMSINSTAL copies the release notes to SYS$HELP.

                   2. Option 2 prompts you for a queue name, as follows:

                       Queue name [SYS$PRINT]:

                     You can either specify a queue name and press RETURN, or
                     press RETURN to send the file to the default output print
                     device. When printing has finished, VMSINSTAL copies the
                     release notes to SYS$HELP.

                   3. Option 3 displays the release notes, prints them, and then
                     copies them to SYS$HELP.

                   4. Option 4 copies the release notes to SYS$HELP, but does
                     not print or display them.

                   5. Option 5 does not print, display, or copy the release
                     notes in this step. However, the release notes will be
                     copied to SYS$HELP later during the installation proce-
                     dure.

                  Next, VMSINSTAL displays the following prompt:

                    Do you want to continue the installation [NO]?:YES

                  If you want to continue the installation, type YES and press
                  RETURN. If you type NO or press RETURN, VMSINSTAL discontin-
                  ues the installation.

               5-4  Installation on VMS with VAX-11 RSX

 











                  The next prompt asks you to enter information concerning
                  product licensing.

                    Product:        PDP11-FORTRAN77
                    Producer:       DEC
                    Version:        5.4
                    Release Date:   31-October-1990

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

                  This prompt refers to the Product Authorization Key (PAK)
                  that is provided in the PDP-11 FORTRAN-77 kit. You must
                  verify that PDP-11 FORTRAN-77 has been registered correctly.
                  If you have registered PDP-11 FORTRAN-77 using the PAK, type
                  YES. If you have not, type NO or simply press RETURN. As a
                  result, VMSINSTAL will discontinue the installation.

                  The next prompt you receive asks the following:

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

                  If you do not want to save any of the files from the previ-
                  ous version of FORTRAN-77, press RETURN. The files will be
                  deleted during the installation procedure. However, if you
                  want to save any files from the previous version, type NO.

                  VMSINSTAL asks if you want to perform the Installation
                  Verification Procedure (IVP).

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

                  The IVP is a program that tests features of the FORTRAN-77
                  compiler and its OTS to ensure that they are working prop-
                  erly. It should be run after each FORTRAN-77 installation.

                  If you accept the default, VMSINSTAL begins the IVP as soon
                  as it completes installation. If you type NO, VMSINSTAL stops
                  after installation.

                  When you answer the IVP prompt, VMSINSTAL completes in-
                  stallation. Informational messages appear on your screen
                  as VMSINSTAL finishes each step.

                  If the IVP runs, output from it displays on your screen.
                  When the IVP has completed successfully, VMSINSTAL displays
                  a message informing you whether or not the installation
                  was successful. After the IVP finishes running, you should
                  terminate the installation procedure.

                                       Installation on VMS with VAX-11 RSX  5-5

 











                  To terminate the installation procedure, enter EXIT in re-
                  sponse to the following prompt:

                    Products:

                  If you are using the console device, VMSINSTAL displays the
                  following message:

                    Please mount the console volume on dev:
                    Are you ready?

                  Mount the console volume in the console drive and type YES to
                  continue. A message confirming the mounting of the console
                  volume is displayed.

                  VMSINSTAL then signals termination with the following mes-
                  sage:

                    VMSINSTAL procedure done at hh:mm

                  If this installation is successful, PDP-11 FORTRAN-77 is
                  ready for your use when the installation procedure is com-
                  plete.

                  If the installation is not successful, consult the Guide
                  to VAX/VMS Software Installation for possible causes of the
                  failure.

                  Table 5-1 lists the files you should see on your target disk
                  after installation. Do not delete any of these files; the
                  software needs them to function. Do not modify the resident
                  library-related files; the software requires the current
                  versions.

                  Table 5-1:  VAX-11 Version 2.4 RSX FORTRAN-77 Software
                              Components
                  _____________________________________________________________
                  ____________________Compiler-related_Files___________________

                  File_Name_______Location_____File_Purpose____________________

                  F77.EXE         [1,54]       Task image

                  F77COM.MSG      [1,2]        Compiler error-message file
                  _____________________________________________________________
                                                       (continued on next page)

               5-6  Installation on VMS with VAX-11 RSX

 











                  Table 5-1 (Cont.):  VAX-11 Version 2.4 RSX FORTRAN-77
                                      Software Components
                  _____________________________________________________________
                  ____________________Compiler-related_Files___________________

                  File_Name_______Location_____File_Purpose____________________

                  F77REL.DOC      [SYSHLP]     Release notes

                  _____________________________________________________________
                  ______________________IVP-related_Files______________________

                  File_Name_______Location_____File_Purpose____________________

                  F77IVP.COM      [SYSHLP]     IVP command file

                  F77TST.FTN      [SYSHLP]     IVP test program

                  _____________________________________________________________
                  ______________________OTS-related_Files______________________

                  File_Name_______Location_____File_Purpose____________________

                  F77FCS.OLB      [1,1]        FCS version of the OTS

                  F77RMS.OLB      [1,1]        RMS version of the OTS

                  F7711S.OBS      [1,1]        RSX-11S OTS

                  _____________________________________________________________
                  __________________Optional_OTS-related_Files_________________

                  File_Name_______Location_____File_Purpose____________________

                  F77CVF.OBJ      [1,1]        Alternate OTS module for float-
                                               ing point

                  F77EIS.OBS      [1,1]        Alternate OTS modules for EIS
                                               functions

                  F77NER.OBS      [1,1]        Alternate OTS modules for error
                                               reporting
                  _____________________________________________________________
                                                       (continued on next page)

                                       Installation on VMS with VAX-11 RSX  5-7

 











                  Table 5-1 (Cont.):  VAX-11 Version 2.4 RSX FORTRAN-77
                                      Software Components
                  _____________________________________________________________
                  __________________Optional_OTS-related_Files_________________

                  File_Name_______Location_____File_Purpose____________________

                  F77NIO.OBS      [1,1]        Alternate OTS modules for I/O
                                               support

                  F77RAN.OBS      [1,1]        Alternate OTS modules for random
                                               numbers

                  FCS11M.ODL      [1,1]        Module to build an overlaid FCS
                                               OTS

                  PDFMAP.OBS      [1,1]        Module to map intrinsic func-
                                               tions

                  RMS11M.ODL      [1,1]        Module to build an overlaid RMS
                                               OTS

                  _____________________________________________________________
                  ______________Files_Building_Resident_Libraries______________

                  File_Name_______Location_____File_Purpose____________________

                  F7FCLS.BLD      [1,1]        Command file for clustered FCS
                                               OTS

                  F7FCLS.CMD      [1,1]        TKB command file for clustered
                                               FCS OTS

                  F7FCLS.MAC      [1,1]        File to tailor clustered FCS OTS

                  F7FRES.BLD      [1,1]        Command file for nonclustered
                                               FCS OTS

                  F7FRES.CMD      [1,1]        TKB command file for nonclus-
                                               tered FCS OTS
                  _____________________________________________________________
                                                       (continued on next page)



               5-8  Installation on VMS with VAX-11 RSX

 











                  Table 5-1 (Cont.):  VAX-11 Version 2.4 RSX FORTRAN-77
                                      Software Components
                  _____________________________________________________________
                  ______________Files_Building_Resident_Libraries______________

                  File_Name_______Location_____File_Purpose____________________

                  F7FRES.MAC      [1,1]        File to tailor nonclustered FCS
                                               OTS

                  F7RCLS.BLD      [1,1]        Command file for clustered RMS
                                               OTS

                  F7RCLS.CMD      [1,1]        TKB command file for clustered
                                               RMS OTS

                  F7RCLS.MAC      [1,1]        File to tailor clustered RMS OTS

                  _____________________________________________________________
                  ________________Resident_Library-Related_Files_______________

                  File_Name_______Location_____File_Purpose____________________

                  F77EP.MAC       [1,1]        File to build OTS resident
                                               libraries and vector

                  F77GBL.XCL      [1,1]        File to exclude F-77 OTS entry
                                               points

                  F77VEC.MAC      [1,1]        File helps build OTS resident
                                               library vector

                  FCS.MAC         [1,1]        File helps build FCS OTS resi-
                                               dent library

                  F77RESLIB.COM   [SYSMGR]     File to install F-77 resident
                  _____________________________OTS_libraries___________________








                                       Installation on VMS with VAX-11 RSX  5-9
