                                     D                 Digital_Fortran_____________________________________&                 Installation Guide for#                 OpenVMS VAX Systems   )                 Order Number: AA-PUYRB-TE                      February 1996   C                 This guide describes how to install Digital Fortran E                 (formerly DEC Fortran) on a VAX processor running the B                 OpenVMS operating system. It also describes how to.                 read the online release notes.              @                 Revision/Update Information:  This revised guide<                                               supersedes allB                                               previous DEC FortranE                                               installation guides for B                                               OpenVMS VAX Systems.  A                 Operating System:             OpenVMS VAX Version A                                               5.4 (or higher; see :                                               Section 1.1)  E                 Software Version:             Digital Fortran Version =                                               6.4 (or higher)   -                 Digital Equipment Corporation &                 Maynard, Massachusetts                 F       ________________________________________________________________"       First Printing, January 1993       Revised, February 1996  <       Digital Equipment Corporation makes no representations=       that the use of its products in the manner described in >       this publication will not infringe on existing or future>       patent rights, nor do the descriptions contained in this>       publication imply the granting of licenses to make, use,:       or sell equipment or software in accordance with the       description.  >       Possession, use, or copying of the software described in=       this publication is authorized only pursuant to a valid @       written license from Digital or an authorized sublicensor.  @        Digital Equipment Corporation 1996. All Rights Reserved.  =       The postpaid Reader's Comments forms at the end of this <       document request your critical evaluation to assist in%       preparing future documentation.   7       The following are trademarks of Digital Equipment ?       Corporation: Alpha AXP, AlphaGeneration, AXP, Bookreader, >       CDD, CDD/Plus, CDD/Repository, DEC, DEC Fortran, DECnet,7       DECset, DECsupport, DECwindows, Digital, OpenVMS, ?       POLYCENTER, VAX, VAX DOCUMENT, VMS, and the DIGITAL logo.   /       The following is a third-party trademark:   A       PostScript is a registered trademark of Adobe Systems, Inc.   <       All other trademarks and registered trademarks are the+       property of their respective holders.   B                                                             ZK6121  +       This document is available on CD-ROM.   @       This document was prepared using VAX DOCUMENT Version 2.1.                                 > ______________________________________________________________  ?                                                        Contents       ? ...................................................           v   ,   Preparing for Digital Fortran Installation  1     1.1   The Software Product Library CD-ROM and ?           Installation-Related Documentation Files......    1-1 1     1.2   The Tape Media and Installation-Related ?           Documentation Files...........................    1-3 ?     1.3   Required Operating System Components..........    1-3 ?     1.4   Optional Software.............................    1-4 ?     1.5   License Registration..........................    1-4 ?     1.6   Installation Procedure Requirements...........    1-5 ?     1.6.1     System Parameters.........................    1-6 3     1.6.1.1     Calculating Values for GBLPAGES and ?                 GBLSECTIONS.............................    1-6 5     1.6.1.2     Changing System Parameter Values with ?                 AUTOGEN.................................    1-7 ?     1.6.2     POLYCENTER (PCSI) Requirements............    1-8 ?     1.6.3     VMSINSTAL Requirements....................    1-9 ?     1.6.4     Digital Fortran Requirements..............   1-10 1     1.7   Creating Coexisting Versions of Digital ?           Fortran.......................................   1-11 ?     1.8   Backing Up Your System Disk...................   1-11      Installing Digital Fortran  4     2.1   Using POLYCENTER (PCSI) to Install Digital?           Fortran.......................................    2-1 ?     2.2   Using VMSINSTAL to Install Digital Fortran....    2-5 ?     2.3   Recovering from Installation Errors...........   2-16         ?                                                             iii                    # 3  After Installing Digital Fortran   1       3.1   Running the Installation Verification B             Procedure Separately..........................     3-2B       3.2   VMScluster Considerations.....................     3-26       3.3   Making the FORTRAN Command Available AfterB             Installation..................................     3-3B       3.4   Removing Obsolete Files.......................     3-4B       3.5   User Account Requirements.....................     3-5B       3.6   Enhancing Digital Fortran Performance.........     3-5B       3.6.1     Tuning Your System........................     3-5:       3.6.2     Installing the Digital Fortran Compiler asB                 a Shared Image............................     3-6B       3.7   OpenVMS Upgrade Issues........................     3-7+       3.8   Reading the Release Notes After B             Installation..................................     3-7B       3.9   Removing Digital Fortran......................     3-8B       3.10  Troubleshooting Tips..........................     3-9B       3.11  Getting Help and Reporting Problems...........     3-9   Tables  B       1         Conventions Used in This Document.........    viii  B       1-1       Optional Software.........................     1-4  B       1-2       Required System Parameter Values..........     1-6  B       3-1       Obsolete Files............................     3-4                                 iv                             E     _________________________________________________________________   E                                                               Preface       @           This guide describes how to install Digital Fortran onC           VAX processors that are running the OpenVMS VAX operating            system.   A           Keep this document with your distribution kit. You will @           need it to install maintenance updates or to reinstall/           Digital Fortran for any other reason.   C           This manual applies to Version 6.4 of Digital Fortran and D           all subsequent minor releases until a revised installationD           guide is issued. (The major version number is the digit toE           the left of the decimal point, and the minor version number :           is the digit to the right of the decimal point.)       Intended Audience   @           This guide is intended for system managers who install           Digital Fortran.       Structure of this Document  5           This guide contains the following chapters:   :           o  Chapter 1 describes the hardware and softwareC              requirements for Digital Fortran installation. It also C              lists related procedures that you must complete before (              installing Digital Fortran.  C           o  Chapter 2 describes how to install Digital Fortran and ,              includes example installations.  A           o  Chapter 3 describes post-installation procedures and               considerations.  E                                                                     v                     Associated Documents  4       In addition to this guide, the Digital Fortran5       documentation set includes the following books:   .       o  DEC Fortran Language Reference Manual  8       o  DEC Fortran User Manual for OpenVMS VAX Systems  >       o  DEC Fortran Performance Guide for OpenVMS VAX Systems  @       o  A letter titled Read Before Installing or Using Digital;          Fortran Version n.n for OpenVMS VAX Systems ("read           first" cover letter)   -       o  Digital Fortran online release notes   @       For the location of the Digital Fortran "read first" cover4       letter and the release notes, see Section 1.1.  >       Once installed, you can use Digital Fortran online HELP,>       which describes the FORTRAN command qualifiers, explains?       run-time messages, and provides a quick-reference summary @       of language topics. To use online HELP, enter the command:         $ HELP FORTRAN  @       The following manuals in the OpenVMS VAX documentation set:       contain information relevant to installing software:  9       o  OpenVMS System Manager's Manual, which includes:   7          -  OpenVMS System Manager's Manual: Essentials   @          -  OpenVMS System Manager's Manual: Tuning, Monitoring,             and Complex Systems   2       o  OpenVMS License Management Utility Manual  0       o  Guide to OpenVMS Performance Management  >       o  POLYCENTER Software Installation Utility User's Guide  ;       For help understanding OpenVMS system error messages, =       see the OpenVMS System Messages and Recovery Procedures ;       Reference Manual or the online HELP/MESSAGE facility.    vi                   0     Sending Digital Your Comments on This Manual  C           We welcome your comments on this or any other Digital (or E           DEC) Fortran manual. You can send comments in the following            ways:   C           o  Internet electronic mail: fortran_docs@zko.mts.dec.com   D           o  FAX: 603-881-0120 Attn: Languages Documentation, ZKO2-3              /K35   A           o  A completed Reader's Comments card (postage paid, if E              mailed in the United States) located at the back of each 5              printed Digital (or DEC) Fortran manual.   #           o  A letter addressed to:   *              Digital Equipment Corporation0              Languages Documentation, ZK02-3/K35               110 Spit Brook Road#              Nashua, NH  03062-2698               USA  A           o  The online questionnaire form. Send the form located E              near the end of the online release notes to our Internet E              address or send it by Internet mail, FAX, or through the               postal service.  D           If you have suggestions for improving a particular section>           or find any errors, please indicate the title, orderC           number, and section (if available). Digital also welcomes            general comments.        Getting Help from Digital   C           If you have a customer support contract and have comments >           or questions about Digital Fortran software, you canE           contact Digital's Customer Support Center (CSC), preferably ?           using electronic means such as DSNlink. In the United C           States, customers can call the CSC at 1-800-354-9000 (see            Section 3.11).  D           You can also send questions by Internet electronic mail to           fortran@digital.com.  E                                                                   vii                     Conventions   :       Table 1 lists the conventions used in this document.  A       Table_1__Conventions_Used_in_This_Document_________________   A       Convention____________Meaning______________________________   ?       UPPERCASE_TEXT        Uppercase letters indicate the name @                             of a command, a file, a parameter, a2                             procedure, or utility.  @       $ RUN                 In interactive examples, prompts andA       SYS$SYSTEM:SYSMAN     displayed text appear in a monospaced =                             font. User input appears in bold.   =       $                     The dollar sign indicates the DCL @                             prompt. This prompt may be different+                             on your system.   ?       Ctrl/x                In interactive examples, a sequence =                             such as Ctrl/x indicates that you ?                             must hold down the key labeled Ctrl <                             while you press another key or a@                             pointing device button; for example,-                             Ctrl/C or Ctrl/Z.   >       <Return>              In code examples, a boxed key name?                             indicates that you press a key on a %                             keyboard.   =       [YES]                 Square brackets indicate that the <                             enclosed item is a default value<                             in an installation prompt. Also,?                             square brackets serve as delimiters :                             for a directory name in a file*                             specification.  @       VMS, OpenVMS          These terms refer to the OpenVMS VAX=                             operating system unless otherwise A       ______________________specified.___________________________   ?       In this manual, some version numbers are given as "Vn.n". :       When you install Digital Fortran, the actual version$       numbers appear on your screen.   viii                         E                                                                     1 E     _________________________________________________________________   E                            Preparing for Digital Fortran Installation     @           This chapter contains information that should be read,A           and procedures that should be performed before starting A           the installation (described in Chapter 2). This chapter (           contains the following topics:  D           o  Files that are on the installation CD-ROM (Section 1.1)  :           o  Files that are on the installation tape media              (Section 1.2)  =           o  Required operating system version and components               (Section 1.3)  ,           o  Optional software (Section 1.4)  /           o  License registration (Section 1.5)   A           o  Installation procedure requirements; such as account ?              privileges, disk space, and so forth (Section 1.6)   <           o  Creating coexisting versions of Digital Fortran              (Section 1.7)  6           o  Backing up your system disk (Section 1.8)  D     1.1 The Software Product Library CD-ROM and Installation-Related         Documentation Files   B           The OpenVMS Alpha Software Product Library CD-ROM (media3           CD-ROM) set provides the following files:   3           o  Digital Fortran installation kit files   C           o  Digital Fortran documentation files, including a "read D              first" cover letter, this installation guide, and other              files  >           o  Online CD-ROM documentation files in the [README]D              directory on the first media CD-ROM, including a CD-ROM:              user guide and master list of CD-ROM products  E                        Preparing for Digital Fortran Installation 1-1                           o  A CDMENU utility   :       To determine whether the appropriate media CD-ROM is=       already mounted on your system, contact the appropriate        system manager.   A       Digital Fortran provides online release notes and an online         "read first" cover letter:  :       o  You can read the online "read first" cover letter?          provided on the media CD-ROM set or read the published           hardcopy letter.   =       o  You can extract the Digital Fortran release notes to >          a file and type or print them before starting Digital@          Fortran installation. The Digital Fortran release notes>          are also installed on your system after installation.  >       The media CD-ROM user guide and CD-ROM master index file?       are provided as online files in the [README] directory on ?       the first media CD-ROM in the distribution kit. The index >       file will show the location of the Digital Fortran cover
       letter._  <       Once the appropriate media CD-ROM has been mounted and=       the appropriate Digital Fortran documentation directory '       located, do one of the following:   ?       o  Use a TYPE command to display the ASCII version of thew7          Digital Fortran cover letter (on your screen).E  =       o  Use a PRINT command to print the ASCII or PostScriptM9          version of the Digital Fortran cover letter to a           printer.e  <       For information about reading the online release notes?       before installation, see step 6 in Section 2.1 if you are >       using POLYCENTER (PCSI), or step 5 in Section 2.2 if you       are using VMSINSTAL.  A       Digital strongly recommends that you read the release noteso=       and the cover letter before installing Digital Fortran.y@       They contain information about changes to the installation@       and use of Digital Fortran, such as the minimum version of@       the OpenVMS VAX operating system required for this release       of Digital Fortran.o  / 1-2  Preparing for Digital Fortran Installation                    A           After installation, the release notes are installed in:a  )            SYS$HELP:FORT06n.RELEASE_NOTESn  :           Other forms of the release notes (PostScript andA           Bookreader) are also provided after installation in thei           following files:  -             SYS$HELP:FORT06n_RELEASE_NOTES.PSp4             SYS$HELP:FORT06n_RELEASE_NOTES.DECW$BOOK  C     1.2 The Tape Media and Installation-Related Documentation Files   B           Digital Fortran tape media includes the following files:  3           o  Digital Fortran installation kit filesh  E           o  The following Digital Fortran documentation files, which E              are provided in both PostScript form (file type .PS) and )              ASCII form (file type .TXT):   A              -  The Digital Fortran installation guide, file namee                 FORTnnn_IGUIDE  @              -  The "read first" letter, file name FORTnnn_COVER  >              -  The Digital Fortran SPD, file name FORTnnn_SPD  A              For example, you might use the following commands to B              copy the Digital Fortran SPD from the Digital FortranD              Version 6.4 media tape physically loaded on drive MUA0:                $ MOUNT MUA0: FORTd0              $ COPY/LOG MUA0:FORT064_SPD.TXT *.*  ,     1.3 Required Operating System Components  B           Digital Fortran Version 6.4 requires OpenVMS VAX Version           5.4 or higher.  E           Future Digital Fortran releases may require higher versions E           of the operating system, as described in the online releasem>           notes or the Read Before Installing or Using DigitalE           Fortran Version n.n for OpenVMS VAX Systems (cover) letter.   =           The OpenVMS VAX (formerly VAX VMS) operating system A           comes with a variety of support options, or components..@           Components include features such as networking. To useE           Digital Fortran, your system should be running a version of   E                        Preparing for Digital Fortran Installation 1-3. .  .              @       OpenVMS that includes the base component and the following       components:u         o  Programming support         o  Utilities  =       For a complete list of the required components, see theI?       Digital Fortran Software Product Description (SPD) on the.       media CD-ROM or tape.    1.4  Optional Software  >       Table 1-1 shows information about optional software that<       you can use with Digital Fortran. The media CD-ROM and?       tape contain a complete list of prerequisite and optionalu2       software and their required version numbers.  A Table_1-1__Optional_Software_____________________________________c   Product Name and MinimumA Version_Number________________Provided_FORTRAN_Feature___________-  : Common Data Dictionary        DICTIONARY statement support (CDD) Version 3.4, CDD/Plus Version 4.0, or CDD/Repository Version 5.0  ; Digital Extended Math         High-performance mathematical.& Library (DXML) Version 1.0    routines  8 Language-Sensitive Editor     Display of data dependence= /Source Code Analyzer         diagnostics, program design ando& (LSE/SCA) Version 3.1[1]      analysis  : Performance Coverage          Program performance analysis Analyzer (PCA) Version 3.0[1]A [1]LSE,_SCA,_and_PCA_are_components_of_DECset____________________T  A _________________________________________________________________.   1.5  License Registration   A       Before you install and run Digital Fortran Version 6.4 on a ?       newly-licensed node or cluster, you must first register a ?       License Product Authorization Key (License PAK) using the (       License Management Facility (LMF).  / 1-4  Preparing for Digital Fortran Installationa n  r              B           The License PAK may be shipped along with the kit if youB           ordered the license and media together; otherwise, it is@           shipped separately to a location based on your licenseC           order. If you are installing Digital Fortran as an updateeB           on a node or cluster already licensed for this software,A           you have already completed the License PAK registrationn           requirements.e  A           If you are installing prerequisite or optional software.?           along with Digital Fortran, review the PAK status andFD           install the PAKs for any prerequisite or optional software-           before you install Digital Fortran.s  E           You must register and load your license for Digital Fortrane?           before you start the installation in order to run the.?           Installation Verification Procedure (IVP) and use the.           software..  <           Log in to a privileged account, such as the systemA           manager's account, SYSTEM. You now have a choice of twoa%           ways to register a license:d  D           o  Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When itE              prompts you for information, respond with data from youra              License PAK.1  B           o  At the DCL prompt, enter the LICENSE REGISTER command?              with the appropriate qualifiers that correspond to %              License PAK information._  B           If you plan to use Digital Fortran on more than one nodeA           in a cluster, you need to perform a license load on thee?           other nodes after you complete this installation (sees           Section 3.2).   @           For complete information on using LMF, see the OpenVMS,           License Management Utility Manual.  +     1.6 Installation Procedure Requirementss  ?           The installation takes approximately 5 to 40 minutes, E           depending on your type of media, your system configuration, (           and the kit components chosen.  A           Installing Digital Fortran and running the InstallationsA           Verification Procedure (IVP) on a standalone VAXstation,8           4000-60 system takes approximately 15 minutes.  E                        Preparing for Digital Fortran Installation 1-5h g  e               1.6.1  System Parameters  :       Digital Fortran installation requires certain system<       parameter settings. Table 1-2 lists the minimum values       for these parameters:s  A       Table_1-2__Required_System_Parameter_Values________________a  A       System_Parameter____Minimum_Value__________________________e  @       Contiguous free     1,800, plus the size in blocks for the       GBLPAGES            file8                           SYS$LIBRARY:DCLTABLES.EXE (see*                           Section 1.6.1.1)  A       Free_GBLSECTIONS____6______________________________________   ?       These values represent the number of free global pagelets <       and global sections required for the installation, not<       the total number you need to run your system and other       software.t  ?          ________________________ Note ________________________n  ;          If you do not ensure your system has the necessaryO9          global pagelet and global section parameters fore:          installation, the DCL tables may become corrupted"          under certain conditions.  ?          ______________________________________________________   8 1.6.1.1  Calculating Values for GBLPAGES and GBLSECTIONS  7       To install and run Digital Fortran, you must havea@       sufficient contiguous free global pagelets and free global       sections.   <       To determine the number of global pagelets required byA       SYS$LIBRARY:DCLTABLES.EXE, enter the following DCL command:-  0       $ DIRECTORY/SIZE SYS$LIBRARY:DCLTABLES.EXE  2       This command returns the size (in blocks) of>       SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this?       figure as the number of global pagelets for the file (andt/       add it to the number shown in Table 1-2).O  / 1-6  Preparing for Digital Fortran Installation                    A           You can use the WRITE command with the F$GETSYI lexicaln@           function to find the current number of contiguous freeA           global pagelets and free global sections. The following D           example shows how to get this information at your terminal'           (the default for SYS$OUTPUT):   8           $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES")           15848n6           $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")           24  =           If the value of free global pagelets or free global C           sections is less than the required value (see Table 1-2),o9           you must increase the system parameter setting.   A           Section 1.6.1.2 describes how to increase these values.   9     1.6.1.2 Changing System Parameter Values with AUTOGENd  @           If you do not have enough free global pagelets or free@           global sections to install Digital Fortran, you can do"           either of the following:  B           o  Delete an existing known image by using the VMSINSTAL              Utility  >           o  Use the AUTOGEN command procedure to increase the6              GBLPAGES or GBLSECTIONS system parameters  B           AUTOGEN automatically adjusts values for parameters that?           are associated with the values you reset manually. To C           change system parameters with AUTOGEN, edit the followingt           file:   "           SYS$SYSTEM:MODPARAMS.DAT  E           To change a parameter value listed in this file, delete therD           current value associated with that parameter and enter the           new value.  =           To add a new parameter, add a line to the file thatr@           includes both the name of the parameter and its value.           For example:             WSMAX = 8096  E                        Preparing for Digital Fortran Installation 1-7y h                 ;       To modify incremental parameters such as GBLPAGES andt8       GBLSECTIONS, use the ADD_ prefix. For example, the=       following increases the global pagelet setting by 2000:n         ADD_GBLPAGES = 2000N  <       After you make all your changes, exit from the editor.=       Then execute the AUTOGEN procedure at the DCL prompt to 5       recalculate your system parameters, as follows:i  ,       $ @SYS$UPDATE:AUTOGEN SAVPARAMS REBOOT  ?       When you specify REBOOT, AUTOGEN does an automatic system <       shutdown and then reboots the system. Any users logged>       on to the system are immediately disconnected during the;       shutdown. The automatic reboot puts the new parameter_       values into effect._  ;       The AUTOGEN Utility automatically adjusts some of ther=       SYSGEN parameters based on the consumption of resources A       since the last reboot. If you do not want to take advantaget:       of this automatic adjustment, include the NOFEEDBACK,       qualifier on the AUTOGEN command line.  ?       For more information about using AUTOGEN and its command-o?       line parameters, see the OpenVMS System Manager's Manual:h.       Tuning, Monitoring, and Complex Systems.  % 1.6.2  POLYCENTER (PCSI) Requirementsd  =       The POLYCENTER Software Installation (PCSI) Utility cant@       only be used on systems running OpenVMS VAX Version 6.1 or0       higher. PCSI has the following advantages:  ;       o  It has a shorter installation time than VMSINSTAL.d  ?       o  It keeps track of what software versions are installeda          on the system.   ?       o  Digital Fortran is easily removed by using the PRODUCT           REMOVE command.  =       The compiler, command line, and help text are identical 9       between the PCSI and VMSINSTAL versions of the kit. ;       However, the PCSI kit differs in the following areas:   ?       o  The Math Run-Time Library is not provided (since it is .          included in OpenVMS VAX Version 6.1).  / 1-8  Preparing for Digital Fortran Installation,                   @           o  The PCSI kit includes a prebuilt FORSYSDEF.TLB that?              is based on OpenVMS VAX Version 7.0; the VMSINSTAL ?              kit builds FORSYSDEF.TLB during installation, from 1              definitions provided by OpenVMS VAX.r  E           o  The PCSI kit does not offer the choice of installing the_2              compiler or FORSYSDEF.TLB separately.  C           o  The PCSI kit does not provide the option of preservinglD              the previous version of the compiler. If you wish to doE              this, make a copy of SYS$SYSTEM:FORTRAN$MAIN.EXE using a 8              new name before installing the new version.  C           To install Digital Fortran using PCSI, you must be logged B           in to an account that has either the SETPRV privilege or+           the following privileges enabled:r             o  BYPASSc             o  CMKRNLe             o  SYSLCK   <           Digital Fortran requires 9,000 blocks of free disk@           storage both during and after installation. Disk space=           requirements may vary depending on the size of your B           system's DCLTABLES.EXE, and which OpenVMS VAX version is!           running on your system.   D           To determine the number of free disk blocks on the current7           system disk, enter the following DCL command:   %           $ SHOW DEVICE SYS$SYSDEVICE   C           For information on installing Digital Fortran using PCSI,            see Section 2.1.        1.6.3 VMSINSTAL Requirements  >           To install Digital Fortran using VMSINSTAL, you must?           be logged in to an account that has either the SETPRVk8           privilege or the following privileges enabled:             o  CMKRNLl             o  WORLD             o  SYSPRV   B           VMSINSTAL turns off BYPASS privilege at the start of the           installation.f  E                        Preparing for Digital Fortran Installation 1-9                    A       Digital Fortran requires 16,000 blocks of free disk storaget@       during installation, and 11,000 blocks after installation.?       Disk space requirements may vary depending on the size ofA@       your system's DCLTABLES.EXE, and which OpenVMS VAX version        is running on your system.  @       To determine the number of free disk blocks on the current3       system disk, enter the following DCL command:   !       $ SHOW DEVICE SYS$SYSDEVICE   9       When you invoke VMSINSTAL, it checks the following:   ,       o  Whether you are logged in as SYSTEM  <       o  Whether you have adequate privileges and quotas for          installation   <       o  Whether any other users are logged in to the system  =       VMSINSTAL requires that the installation account have ao&       minimum of the following quotas:         ASTLM = 24     DIOLM = 18t          BIOLM = 18     ENQLM = 200          BYTLM =        FILLM = 100       32,768  @       If VMSINSTAL detects any problems during the installation,:       it notifies you and asks if you want to continue the;       installation. In some instances, you can enter YES toh<       continue. To stop the installation process and correct?       the situation, enter NO or press Return. Then correct the +       problem and restart the installation.t  9       For information on installing Digital Fortran usingl!       VMSINSTAL, see Section 2.2.   # 1.6.4  Digital Fortran Requirementsa  ;       The VAX Vector Instruction Emulation Facility (VVIEF)e=       is a programming development tool that lets you execute =       vectorized applications on VAX systems that do not havew       vector hardware.  9       Vector instructions in a vectorized application arem<       automatically executed either in vector hardware or by@       the VVIEF, depending on the vector processing capabilities#       of the VAX system being used.i  0 1-10  Preparing for Digital Fortran Installation    S              D           For information on how to enable VVIEF on your system, seeB           the OpenVMS System Manager's Manual: Tuning, Monitoring,B           and Complex Systems; for systems running OpenVMS VersionD           5, consult the New and Changed Features manual for OpenVMS           Version 5.4.  7     1.7 Creating Coexisting Versions of Digital Fortrans  B           If you install Digital Fortran using VMSINSTAL, you willE           be offered an option of preserving the previously installedsE           version of Digital Fortran. If this option is selected, theeC           earlier version is renamed to FORTRAN$MAIN-Vnn.EXE, whereOE           Vnn is the previous version number with the period removed.   E           If you install Digital Fortran using POLYCENTER (PCSI), you B           will not be offered an option of preserving the previousE           version of the compiler. If you wish to preserve a previouseE           version, make a copy of SYS$SYSTEM:FORTRAN$MAIN.EXE using aa5           new name before installing the new version.   C           In either case, to use the saved version of the compiler,f>           define the logical name FORTRAN$MAIN to point to theC           saved version. For example, the following command defines B           FORTRAN$MAIN to point to the Digital Fortran Version 6.4           compiler:i  0           $ DEFINE FORTRAN$MAIN FORTRAN$MAIN-V64  =           For more information, see the online release notes.   #     1.8 Backing Up Your System Disk,  D           Digital recommends that you do a system disk backup before"           installing any software.  @           Use the backup procedures that are established at yourC           site. For details on performing a system disk backup, see &           the Using VMS BACKUP manual.              E                       Preparing for Digital Fortran Installation 1-11     i                    E                                                                     2 E     _________________________________________________________________   E                                            Installing Digital Fortran     <           Before you start the installation, read Chapter 1,B           which describes the general options and requirements for%           installing Digital Fortran.o  @           The installation procedure loads Digital Fortran filesC           on to the system disk on the system where you perform ther           installation.i  @           To abort the installation procedure at any time, pressC           Ctrl/Y. When you press Ctrl/Y, the installation procedure ?           deletes all files it has created up to that point anda;           exits. You can then start the installation again.s  9           Defaults appear in brackets ([]) throughout thet!           installation procedure.   5           This chapter contains the following topics:   D           o  How to use POLYCENTER (PCSI) to install Digital Fortran              (Section 2.1)  <           o  How to use VMSINSTAL to install Digital Fortran              (Section 2.2)  B           o  How to recover from installation errors (Section 2.3)  :     2.1 Using POLYCENTER (PCSI) to Install Digital Fortran  D           PCSI software is bundled with the OpenVMS operating systemD           and can only be used on OpenVMS VAX Version 6.1 or higher.  C           For general information on required system parameters andCD           disk space for installation, see Section 1.6. For specificB           POLYCENTER installation requirements, see Section 1.6.2.  A           For information on saving a previous version of Digital ;           Fortran before installing the newest version, seeg           Section 1.7.  E                                        Installing Digital Fortran 2-1     g              @       To install Digital Fortran using PCSI, follow these steps:  <       1. Log in to a privileged account, such as SYSTEM. You=          can use a different privileged account if it has then)          necessary privileges and quotas.l  <          You must have BYPASS, CMKRNL, and SYSLCK privilegesA          enabled to install using PCSI. To check whether you have 7          these privileges, enter the following command:   "          $ SHOW PROCESS/PRIVILEGES  >          If you do not have these privileges, but you have theA          SETPRV privilege, you can enable the BYPASS, CMKRNL, and =          SYSLCK privileges by entering the following command:s  7          $ SET PROCESS/PRIVILEGE=(BYPASS,CMKRNL,SYSLCK)l  =       2. If your version of OpenVMS VAX is later than Version ;          6.1, you can skip this step and proceed to step 3.o  ;          Verify that the current OpenVMS product version isn@          registered with PCSI by entering the following command:  #          $ PRODUCT SHOW PRODUCT VMSl          PRODUCT          -------          DEC VAXVMS VMS V6.n            1 item foundt  ?          If the OpenVMS product is not found, then register thee0          OpenVMS product with PCSI; for example:  7          $ PRODUCT REGISTER PRODUCT VMS /VERSION=V6.n -           $_ /SOURCE=SYS$UPDATE:s1          The following product has been selected:i,          DEC VAXVMS VMS V6.n     [Available]  0          Do you want to continue? [YES] <Return>2          The following product will be registered:          DEC VAXVMS VMS V6.n@          Portion Done: 0%...10%...20%...30%...40%...50%...60%...%                            70%...100%S3          The following product has been registered:r          DEC VAXVMS VMS V6.n   2-2  Installing Digital FortranP 1                 A           3. Determine whether the appropriate distribution mediawC              is already mounted on your system. For example, if thenB              appropriate media CD-ROM is mounted at device DKA400,)              enter the following command:t  !              $ SHOW DEVICE DKA400d  ?              If the media CD-ROM containing the Digital FortrannA              installation files is not mounted, insert (load) theiE              appropriate media (CD-ROM or tape) in the CD-ROM or tapeMB              drive. Enter the following command to mount the media8              device (do not use the /FOREIGN qualifier):  !              $ MOUNT DKA400 labeli  A              The label is the volume label of the media CD-ROM ore,              tape drive in the device named.  C              For information about using the CDMENU utility and the C              CD-ROM files on the media CD-ROM set, see the Software1C              Product Library CD-ROM User's Guide (media CD-ROM usersD              guide), which accompanies the media CD-ROM distribution?              kit. The media CD-ROM user guide and CD-ROM masteraD              index file are provided as online files in the [README]1              directory on the first media CD-ROM.m  ?           4. Set your process default disk and directory to theaC              device and directory where the Digital Fortran productu9              installation files are located. For example:e  .              $ SET DEFAULT DKA400:[dir.subdir]  E           5. To check that you have located the correct CD-ROM deviceTB              and directory, enter the following DIRECTORY command:                $ DIRECTORY  *              Directory DKA400:[dir.subdir]  .              DEC-VAXVMS-FORTRAN-Vnnnn-x-1.PCSI                Total of 1 file.y  @           6. To extract the Digital Fortran online release notesD              before you install Digital Fortran, enter the following              command:r  Q              $ PRODUCT EXTRACT RELEASE_NOTES FORTRAN/FILE=SYS$LOGIN:FORT.RELNOTES,  E                                        Installing Digital Fortran 2-3                    ?          You should view or print the file FORT.RELNOTES beforei9          you continue with the installation. For example:a  ,          $ TYPE/PAGE SYS$LOGIN:FORT.RELNOTES  ?          You can also read the release notes after installationt          (see Section 3.8).t  A       7. To install Digital Fortran, enter the following command:.  "          $ PRODUCT INSTALL FORTRAN  A          A prompt asks you to verify that the correct product wasm          selected:  1          The following product has been selected:   &            DEC VAXVMS Fortran Vv.v-nnn  /          Do you want to continue? [YES]<Return>   @          Press Return (default value YES) to continue installing          Digital Fortran.t  =          *** DEC VAXVMS FORTRAN Vv.v-nnn: Digital Fortran forn!               OpenVMS VAX Systems   B              Copyright  Digital Equipment Corporation yyyy,yyyy -"               All rights reserved.  ?              This software product is sold by Digital Equipmentm               Corporation   A              This product uses the PAKs: FORTRAN, FORTRAN-USER orF               FORTRAN-G)  A              Do you want all the default values for this product?C                [YES]<Return>  ?          Press Return (default value YES) to accept the producte@          defaults. (There are no options that you can select for          this product).y  8              Please ignore any PCSI-E-FILNOTPUR messages  9              Do you want to view the values? [NO]<Return>s   2-4  Installing Digital Fortran                    B              Press Return (default value NO) to skip displaying of2              the values and continue installation.  )              Execution phase starting ...l5              The following product will be installed: ,                  DEC VAXVMS FORTRAN Vv.v-nnn=              %PCSI-I-VOLINFO, estimated space information forG"                volume DISK$xxxxxxxH              -PCSI-I-VOLSPC, nnnn required; nnnnnn available; nnnnnn netH              Portion Done: 0%...10%...20%...30%...40%...50%...90%...100%6              The following product has been installed:,                  DEC VAXVMS FORTRAN Vv.v-nnn9              %PCSI-I-EXETSTSTART, start of test proceduresD              %PCSI-I-EXETSTOK, end of test procedure; completed with                no errors  U              *** DEC VAXVMS FORTRAN Vv.v-nnn: Digital Fortran for OpenVMS VAX Systems   B                  Type HELP FORTRAN Release_Notes for release notes                    location   E                  Be sure to @SYS$UPDATE:FORTRAN$POST_INSTALL on othero                     cluster nodes                $  @           8. If this installation was performed on a VMScluster,D              enter the following command on all other cluster nodes:  /              $ @SYS$UPDATE:FORTRAN$POST_INSTALLN  A           For information on other PCSI utility features, see the @           POLYCENTER Software Installation Utility User's Guide.  2     2.2 Using VMSINSTAL to Install Digital Fortran  C           For general information on required system parameters andBD           disk space for installation, see Section 1.6. For specificB           VMSINSTAL installation requirements, see Section 1.6.3 .  A           For information on saving a previous version of Digital ;           Fortran before installing the newest version, seeU           Section 1.7.    E                                        Installing Digital Fortran 2-5o e  r              >       To install Digital Fortran using VMSINSTAL, follow these       steps:  <       1. Log in to a privileged account, such as SYSTEM. You=          can use a different privileged account if it has theg)          necessary privileges and quotas.m  ;          You must have CMKRNL, SYSPRV, and WORLD privileges =          enabled to install using VMSINSTAL. To check whetherq@          you have these privileges, enter the following command:  "          $ SHOW PROCESS/PRIVILEGES  >          If you do not have these privileges, but you have theA          SETPRV privilege, you can enable the CMKRNL, SYSPRV, andm<          WORLD privileges by entering the following command:  6          $ SET PROCESS/PRIVILEGE=(CMKRNL,SYSPRV,WORLD)  @       2. To start the installation, invoke VMSINSTAL as follows:  D          @SYS$UPDATE:VMSINSTAL saveset-name device-name options-list            saveset_namee@          Is the installation name for the component. For Digital6          Fortran, use the following installation name:            FORT06n  =          Where n represents the maintenance update of DigitalV;          Fortran. Refer to the label on the Digital Fortranl?          distribution kit or the Digital Fortran BOM or BIL fora3          the maintenance update number of your kit.n            device-name=          Is the name of the device on which you plan to mountiA          the media. For example, MUA0: is the device name used inX#          examples in this document.n  =          If you are installing Digital Fortran from a CD-ROM,F9          specify the device of the CD device and also then>          directory that contains the Digital Fortran save set.            options-listI;          Is the word OPTIONS followed by one or more of theM3          following options designators: G, L, N, R.o  #          o  Get save set option (G)    2-6  Installing Digital Fortrang S  y              A                 Lets you store product save sets temporarily on ag5                 magnetic tape or in a disk directory.   #              o  File log option (L)N  8                 Logs all activity to the terminal during                 installation.   2              o  Display or print release notes (N)  C                 Indicates you want to see the installation questionuC                 on release notes. If you do not include the OPTIONSs=                 N parameter, VMSINSTAL does not ask you aboutt@                 the release notes. You should review the release@                 notes before proceeding with the installation inB                 case they contain additional information about the                 installation.   ?                 If you are restarting the installation and havesC                 already reviewed the release notes, you do not needn%                 to specify OPTIONS N.R  )              o  Alternate root option (R)i  C                 Lets you install the product to a system root other 0                 than that of the running system.  B              To specify more than one option, separate the options2              with commas; for example OPTIONS L,R.  ?              For detailed information on these options, see the,<              OpenVMS documentation on software installation.  ?              The following example invokes VMSINSTAL to install @              Digital Fortran and shows the system response. This?              example uses the OPTIONS N release note parameter.e  <              $ @SYS$UPDATE:VMSINSTAL FORT06n MUA0: OPTIONS N  K                    OpenVMS VAX Software Product Installation Procedure Vn.nV  (              It is dd-mmm-yyyy at hh:mm.<              Enter a question mark (?) at any time for help.  @              If you do not supply either the product name or theD              device name, VMSINSTAL prompts you for this information@              later in the installation procedure. VMSINSTAL doesB              not prompt you for any options, so be sure to include  E                                        Installing Digital Fortran 2-7M 2                 >          OPTIONS N on the VMSINSTAL command line to access the/          release notes during the installation.n  @          When you invoke VMSINSTAL, it checks to see whether you=          have adequate privileges and quotas for installations          (see Section 1.6.3).d  =          VMSINSTAL then checks to determine whether any usersr=          are logged in to the system. If users are logged in, ;          you will be asked whether you want to continue theM=          installation. If you want to continue, enter Yes. Ift9          you want to stop the installation, press Return.V  =       3. VMSINSTAL asks if you are satisfied with your systemc          backup, as follows:  G          * Are you satisfied with the backup of your system disk [YES]?t  :          You should always back up your system disk before>          performing an installation. If you are satisfied withA          the backup of your system disk, press Return. Otherwise,XA          enter No to discontinue the installation. After you backa?          up your system disk, you can restart the installation.n  A       4. You are now asked to mount the first distribution volumes@          on the device you specified when you invoked VMSINSTAL:  ;          Please mount the first volume of the set on MUA0:.d          * Are you ready? YESe0          %MOUNT-I-MOUNTED, FORT MOUNTED ON MUA0:2          The following products will be processed:            FORT V6.n  9              Beginning installation of FORT V6.n at 20:01p  =          %VMSINSTAL-I-RESTORE, Restoring product saveset A...f  :          The device name appears in the line preceding the>          question. VMSINSTAL then asks you if you are ready to(          continue with the installation.  ;          If you respond Yes to indicate that you are ready,r?          VMSINSTAL displays a message that the media containing A          Digital Fortran has been mounted on the specified devicei-          and that the installation has begun.    2-8  Installing Digital FortranT F  R              B              If you entered the wrong device name when you invokedE              VMSINSTAL and need to restart the installation, enter No C              in response to the "Are you ready?" question. To abort >              the installation for other reasons, press Ctrl/Y.  C           5. If you specified OPTIONS N when you invoked VMSINSTAL, E              you are now asked to choose one of the following options -              for reviewing the release notes:a  #              Release Notes Options:y  *                  1.  Display release notes(                  2.  Print release notes!                  3.  Both 1 and 2 &                  4.  None of the above  !              * Select option [2]:e  C              If you press Return (select option 2), VMSINSTAL sendssC              the file to the default output print device unless you *              enter a different queue name:  &              * Queue name [SYS$PRINT]:  @              If you choose another option, the following occurs:  @              o  Option 1 causes VMSINSTAL to immediately displayB                 the release notes on the console terminal. You canE                 terminate the display at any time by pressing Ctrl/C.   @              o  Option 3 causes VMSINSTAL to immediately displayB                 the release notes on the console terminal and thenE                 prompts you for a queue name for the printed version.s  >              o  Option 4 prevents VMSINSTAL from displaying orA                 printing the release notes. This option should betA                 selected if you have already reviewed the release :                 notes and are restarting the installation.  6              You are now asked the following question:  A              * Do you want to continue the installation [N]?: YES I              %VMSINSTAL-I-RELMOVED, The product's release notes have been C                                     successfully moved to SYS$HELP.t  @              To continue the installation, enter Yes. Otherwise,?              press Return. In either case, the text form of the >              release notes is copied to a file in the SYS$HELP  E                                        Installing Digital Fortran 2-9     I              :          directory. After installation, you can read these)          release notes (see Section 3.8).h  A       6. You are asked if you want to purge files replaced by thet"          installation, as follows:  J          * Do you want to purge files replaced by this installation [YES]?  <          The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE,A          SYS$SYSTEM, SYS$TEST and SYS$UPDATE may contain previouss;          versions of Digital Fortran files. These files are =          replaced during the installation with new files, but ?          the old files are not automatically purged. Purging isg>          recommended. In response to the purging prompt, press<          Return to purge the files or enter No to keep them.  :       7. Select the components of the kit that you want to-          install. The choices are as follows:K  A          o  Compiler (includes help text, command definition, ando             IVP)  @          o  Enhanced Run-Time Libraries (required if Compiler is             selected)/  ;          o  FORSYSDEF.TLB (OpenVMS system symbol definition              library)  ?          Select the components you want to install by answering >          Yes or No to the prompts. If you want a more detailedA          description of any component, enter a question mark (?).oA          After the explanation is displayed, you will be prompted           again for a response.  5          * Do you want to install the compiler [YES]?o  <          The compiler component includes the Digital Fortran5          compiler, compiler message files, help text,M?          installation verification procedure, post-installation6>          procedure, deinstallation procedure, and command line          definition.  9          If this is a new installation, you should select ;          installation of the compiler component by pressing 8          Return (or entering Yes). Choosing the compiler=          component automatically selects the Run-Time Libraryi=          component as well; this is indicated by the message:     2-10  Installing Digital Fortran s  e              I              %FORT06n-I-RTLREQ, The Run-Time Library support will also be.)                                 installed1  B              If you do not want to install the compiler component,D              enter No. The the installation procedure will then ask:  I              * Do you want to install the Run-Time Library support [YES]?   A              If you have installed a new version of OpenVMS since ?              the last time you installed Digital Fortran, or if @              you want to install the Run-Time Library support onA              a system where Digital Fortran programs will be run,iE              press Return. If you do not wish to install the Run-Time('              Library support, enter No.a  -              You are now asked the following:   ?              * Do you want to create a new FORSYSDEF.TLB [YES]?   E              SYS$LIBRARY:FORSYSDEF.TLB is a library of OpenVMS systemD>              interface definitions that can be used by FORTRANB              programs. FORSYSDEF.TLB is built from a master set ofC              definitions that is provided with OpenVMS; it contains >              declarations of OpenVMS system services, Run-Time9              Library routines, structures, and constants.i  <              Because FORSYSDEF.TLB is generated from OpenVMS>              definitions, you do not need to rebuild it unlessC              this is a new installation or you have installed a neweA              version of OpenVMS since the last time you installedDC              Digital Fortran. (The installation procedure will make @              a recommendation on whether FORSYSDEF.TLB should be              rebuilt.)  E              If you press Return, the installation procedure builds aTD              new system definition file, FORSYSDEF.TLB, based on theD              system definitions for the version of OpenVMS installed              on your system.  D              The installation procedure then displays the components<              you selected and displays the following prompt:  %              * Is this correct [YES]?c  E              If you enter No, the installation procedure reissues thel.              prompts for selecting components.  E                                       Installing Digital Fortran 2-11L Y  O              ?          ________________________ Note ________________________   <          If you answered No to the first prompt in this step:          (``Do you want to install the compiler?''), steps<          8 and 9 are omitted. If you also answered No to the=          prompt ``Do you want to install the Run-Time Librarye(          Support?'', step 10 is omitted.  ?          ______________________________________________________l  @       8. Digital Fortran supports the OpenVMS License Management<          Facility (LMF). The installation procedure displays6          license information about Digital Fortran. It9          asks whether you have registered and loaded your <          authorization key for the product. The following is@          an example of the information and the queries presented'          by the installation procedure:   $                Product:      FORTRAN$                Producer:     Digital                 Version:      6.n(                Release Date: dd-mmm-yyyy  R          * Does this product have an authorization key registered and loaded?: YES  <          If you have not registered and loaded your PAK, you?          must answer No to this question; the installation will-=          continue but the Installation Verification Procedurep9          (IVP) will not run. To successfully complete thet<          IVP, you must first register and load your PAK (see          Section 1.5).  ;       9. Unless you answered No to the license registration =          question, the installation procedure now asks if you           want to run the IVP:?  C          * Do you want to run the IVP after the installation [YES]?   A          The IVP for Digital Fortran checks that the installation ?          is successful. It is recommended that you run the IVP.   @          After Digital Fortran is installed, you can run the IVP?          independently to verify that the software is available @          on your system (see Section 3.1). You might need to run?          the IVP after a system failure to make sure that usersn$          can access Digital Fortran.  9       10.You can now respond to Run-Time Library queries.0    2-12  Installing Digital Fortran i  p              ?              The Digital Fortran kit includes enhancements that A              may not exist in your current version of the OpenVMS%E              operating system. (See the release notes for informationn$              on these enhancements.)  >              If the installation procedure determines that theD              installing system's version of OpenVMS does not include@              the enhanced support, the existing Run-Time LibraryE              images are replaced with the new versions (equivalent to 8              those provided by OpenVMS VAX Version 7.0).  C             _______________________ Warning _______________________   ?             Programs linked against the new Math Library imagesTA             will not run on OpenVMS systems (earlier than Versione?             6.1) where the new versions of these images are not @             installed. The existing versions supplied by OpenVMSB             will be saved as FORTRAN$MTHRTL-VMS, FORTRAN$UVMTHRTL-9             VMS, and FORTRAN$VMTHRTL-VMS in SYS$LIBRARY:.   =             Fortran programs that do not use the Math libraryi?             will run on older OpenVMS system versions V5.0-1 ori@             higher as long as they do not use the nonnative data?             in I/O feature or the /ASSUME=BYTERECL command line B             qualifier. Please make sure that all users, even those@             not using Digital Fortran, read the explanatory text!             in the release notes.p  <             In addition, if you update the system version of:             OpenVMS, the enhanced versions of the Math and>             Fortran Run-Time Library images may be overwritten<             with versions that lack the enhanced support. Be@             sure to reinstall the Digital Fortran kit after eachA             OpenVMS system update. Please also read Chapter 3 for .             important post-installation tasks.  B             ______________________________________________________  C              The installation procedure displays informational text:B              describing these changes; press Return when prompted,C              to view the next screen of text. After the information D              related to run-time library support has been displayed,D              the installation procedure asks if you want to continue              the installation:  C              Do you want to continue with the installation (N)? YESe  :              To continue with the installation, enter Yes.  E                                       Installing Digital Fortran 2-13     t              %       11.Read informational messages.t  =          At this point, the installation procedure displays a <          number of informational messages that report on the;          progress of the installation. There are no furtherX:          questions. If the installation procedure has been=          successful up to this point, VMSINSTAL moves the newt?          or modified files to their target directories, updates >          help files, and updates DCL tables, if necessary. The9          new and modified files consist of the following:h  B              SYS$HELP:FORT06n.RELEASE_NOTES                  [new]B              SYS$HELP:FORT06n_RELEASE_NOTES.DECW$BOOK        [new]B              SYS$HELP:FORT06n_RELEASE_NOTES.PS               [new]B              SYS$HELP:FORTRAN$MSGHLP.MSGHLP$DATA             [new]G              SYS$HELP:HELPLIB.HLB                            [modified]aG              SYS$LIBRARY:DCLTABLES.EXE                       [modified] B              SYS$LIBRARY:FORDEF.FOR                          [new]B              SYS$LIBRARY:FORIOSDEF.FOR                       [new]B              SYS$LIBRARY:FORRTL.EXE                          [new]B              SYS$LIBRARY:FORSYSDEF.TLB                       [new]M              SYS$LIBRARY:FORTRAN$FORRTL-VMS.EXE              [saved old file]dM              SYS$LIBRARY:FORTRAN$MTHRTL-VMS.EXE              [saved old file]rM              SYS$LIBRARY:FORTRAN$UVMTHRTL-VMS.EXE            [saved old file]rM              SYS$LIBRARY:FORTRAN$VMTHRTL-VMS.EXE             [saved old file]aB              SYS$LIBRARY:MTHRTL.EXE                          [new]G              SYS$LIBRARY:STARLET.OLB                         [modified]iG              SYS$LIBRARY:STARLETSD.TLB                       [modified]tB              SYS$LIBRARY:UVMTHRTL.EXE                        [new]B              SYS$LIBRARY:VMSRTL.EXE                          [new]B              SYS$LIBRARY:VMTHRTL.EXE                         [new]B              SYS$MESSAGE:FORTRAN$COMPILER_MSG.EXE            [new]B              SYS$MESSAGE:FORTRAN$DICTIONARY_MSG.EXE          [new]B              SYS$SYSTEM:FORTRAN$MAIN.EXE                     [new]B              SYS$TEST:FORTRAN$IVP.COM                        [new]B              SYS$UPDATE:FORTRAN$DEINSTALL.COM                [new]B              SYS$UPDATE:FORTRAN$POST_INSTALL.COM             [new]  ?          The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXEa=          files are updated to include the new versions of the ?          Digital Fortran help text and the FORTRAN command line           definition.  A          Also, if you answered Yes in response to the prompt thato>          requests a file purge at step 6, previous versions of2          the Digital Fortran files are now purged.    2-14  Installing Digital Fortran t                 <              The end of the installation is indicated by the              following message:n  E              %VMSINSTAL-I-MOVEFILES, files will now be moved to theirc:                                      target directories...  @           12.If you chose to run the IVP (step 8), VMSINSTAL now?              invokes the IVP to verify that Digital Fortran was $              installed successfully.  J              Beginning Digital Fortran Installation Verification Procedure  ;              Compiler image identification is FORT V6.n-eeeI  :              Test compiler operation and error messages...  P              Compile, link, and run program with parallel processing features...  5              Test FORSYSDEF.TLB system definitions...k  7              Test I/O and Run-Time Library operation...s  C              If Digital Fortran was installed successfully, the IVPI$              displays the following:  0              Digital Fortran V6.n-eee IVP PASSED  G              End of Digital Fortran Installation Verification Procedure   8           13.The installation procedure ends as follows:  <                 Installation of FORT V6.n completed at hh:mm  1                 VMSINSTAL procedure done at hh:mm                 $  =           If you installed the compiler component, proceed to A           Chapter 3 to perform necessary post-installation tasks.NB           Otherwise, you can choose to install more products or to           log out.  D           VMSINSTAL deletes or changes entries in the process symbolA           tables during the installation. So, if you are going toTE           continue using the system manager's account and you want toSE           restore these symbols, you should log out and log in again.s  E                                       Installing Digital Fortran 2-15r                   ?       If the installation fails, you see the following message:r  P       %VMSINSTAL-E-INSFAIL, The installation of Digital Fortran V6.n has failed.  /       If the IVP fails, you see these messages:   ?       The FORT V6.n Installation Verification Procedure failed.   =       %VMSINSTAL-E-IVPFAIL, The IVP for FORT V6.n has failed.i  5       If the installation fails, you must restart theA=       installation procedure from step 2. If the installationo:       fails due to an IVP failure, contact a Digital field       service representative.k  ( 2.3  Recovering from Installation Errors  <       Errors can occur during the installation if any of the!       following conditions occur:   3       o  The operating system version is incorrect.D  @       o  The product license has not been registered and loaded.  6       o  A prerequisite software version is incorrect.  >       o  Privileges and quotas for successful installation are          insufficient.  6       o  The OpenVMS help library is currently in use.  ?       For descriptions of the error messages generated by thesed9       conditions, see the OpenVMS documentation on systemT9       messages, recovery procedures, and OpenVMS softwarei@       installation; or use the online HELP/MESSAGE command. Take6       the appropriate action described in the message.  ;       For information on system requirements for installing '       Digital Fortran, see Section 1.6.   7       To report a problem to Digital, see Section 3.11.           2-16  Installing Digital Fortran o  t                    E                                                                     3 E     _________________________________________________________________   E                                      After Installing Digital Fortran     @           This chapter discusses the following post-installation#           tasks and considerations:t  ?           o  How to run the Installation Verification Procedure %              separately (Section 3.1)e  ;           o  How to make the product usable on a VMSclusterh              (Section 3.2)  =           o  How to make the newly installed FORTRAN compilert;              available to users who are currently logged int              (Section 3.3)  @           o  Which older files may now be obsolete (Section 3.4)  9           o  How to set user account quotas (Section 3.5)   =           o  How to enhance performance by tuning your system =              and installing Digital Fortran as a shared imageo              (Section 3.6)  =           o  Issues concerning OpenVMS upgrades (Section 3.7)   =           o  How to read the release notes after installationo              (Section 3.8)  ;           o  How to remove Digital Fortran from your system               (Section 3.9)  0           o  Troubleshooting tips (Section 3.10)  ?           o  How to get help and report problems (Section 3.11)D        E                                  After Installing Digital Fortran 3-1o i  n              ? 3.1  Running the Installation Verification Procedure Separatelyg  =       The Digital Fortran Installation Verification Procedure 5       (IVP) runs automatically during Digital Fortrant       installation.c  A       If system problems occur, you should run the IVP separatelyh@       to ensure the integrity of the installed files. To run the'       IVP, enter the following command:V  !       $ @SYS$TEST:FORTRAN$IVP.COMi  <       If any problems are encountered, a message such as the       following appears:  @       Digital Fortran Installation Verification Procedure Failed   3.2  VMScluster Considerations  :       If you want to run Digital Fortran on multiple nodes;       of a VMScluster, first check to see that you have thee:       appropriate software license (see Section 1.5). Then;       perform the following steps after you install Digitalo       Fortran:  <       1. Issue the LICENSE LOAD command, as described in the?          OpenVMS License Management Utility Manual, to activate,<          the license on each node in the VMScluster on which+          Digital Fortran is to be executed.   <       2. The commands in this step should be executed on all?          cluster nodes, whether or not they are licensed to useh?          Digital Fortran; failure to do so may cause unexpectedp          errors for users.  ?          ________________________ Note ________________________c  <          If you are using a dual-architecture (VAX and Alpha?          systems) heterogeneous cluster, before executing theser:          commands, make sure the appropriate logical names;          have been set to define the scope of the SYSMAN DO ?          commands. For more information, see the OpenVMS Systems          Manager's Manual.  ?          ______________________________________________________s  % 3-2  After Installing Digital Fortranl h  u              C              While logged in as SYSTEM, or as another username thatoB              has the CMKRNL and SYSPRV privileges enabled, use the?              OpenVMS SYSMAN utility to set your environment, asr              follows:   $              $ RUN SYS$SYSTEM:SYSMAN,              SYSMAN> SET ENVIRONMENT/CLUSTER8              %SYSMAN-I-ENV, current command environment:1                      Clusterwide on local clustereI                      Username SYSTEM       will be used on nonlocal nodesR  E           3. Update the active DCL command tables (DCLTABLES.EXE) and ;              Run-Time Library (DEC$FORRTL.EXE), as follows:a  <              SYSMAN> DO @SYS$UPDATE:FORTRAN$POST_INSTALL.COM>              %SYSMAN-I-OUTPUT, command execution on node NODE1>              %SYSMAN-I-OUTPUT, command execution on node NODE2  C             _______________________ Warning _______________________e  >             If you do not execute the SYS$UPDATE:FORTRAN$POST_9             INSTALL procedure on all nodes of the cluster ;             immediately after installation, run-time errors @             can occur (such as SHRIDMISMAT: "ident mismatch with             shareable image").  B             ______________________________________________________  /           4. Then EXIT from SYSMAN, as follows:T                SYSMAN> EXITb              $  @              The SYSMAN utility will cause the post-installation?              procedure to be executed on each node of the locale              cluster.e  ?     3.3 Making the FORTRAN Command Available After Installationr  C           The installation procedure modifies the DCL command tableoB           so that the FORTRAN command is recognized and processed.  C           After the new Digital Fortran compiler is installed, thiseB           command table is available to all users who log in afterD           installation. However, the previous command table is still@           in effect for those users who are currently logged in.  E                                  After Installing Digital Fortran 3-3n r  N              A       All logged-in users who want to use the FORTRAN command andeA       the new command table must log out and log in again, or use        the DCL command:  1       $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES    3.4  Removing Obsolete Files  ?       If you have installed previous versions of VAX FORTRAN or_A       VAX FORTRAN-HPO, there may be some obsolete files remaininge;       on your system that are no longer used by the currenta!       version of Digital Fortran.o  +       Table 3-1 lists these obsolete files:o  A       Table_3-1__Obsolete_Files__________________________________e  A       File_Specification___________Description___________________d  :       SYS$SYSTEM:FORTRAN.EXE       VAX FORTRAN Version 5.n+                                    compiler   ;       SYS$SYSTEM:FORTRAN-HPO.EXE   VAX FORTRAN-HPO compiler   @       SYS$HELP:FORTRAN$DWCI.HLB    DECwindows Compiler Interface  @       SYS$LIBRARY:FORTV5CLD.CLD    VAX FORTRAN Version 5 command-                                    definitiony  @       SYS$MESSAGE:FORTERR1.EXE     VAX FORTRAN Version 5 message'                                    filet  @       SYS$MESSAGE:FORTERR2.EXE     VAX FORTRAN Version 5 message'                                    fileo  @       VUE$LIBRARY:FORTRAN$DWCI.EXE DECwindows Compiler Interface  A       VUE$LIBRARY:FORTRAN$DWCI.UID_DECwindows_Compiler_Interface_   A       You can delete these files if you are certain that they arew@       no longer needed and you do not need a previous version of4       the compiler to coexist with the new compiler.      % 3-4  After Installing Digital Fortran     i              !     3.5 User Account RequirementsI  B           No special privileges are needed to use Digital Fortran.?           There is no benefit from installing the compiler withl           privileges.s  >           To use Digital Fortran, a user account does not need>           to meet any special quota requirements. However, forA           parallel-processing applications or very large programsaD           (many program units compiled together), consider adjustingB           the working set (WSDEF, WSQUOTA, WSEXTENT) and page file<           (PGFLQUOTA) account quotas to improve performance.  ;           Use the OpenVMS Authorize Utility from a suitably @           privileged account to change the process quotas in theD           user authorization file (UAF). Some sites may restrict theE           use of the Authorize Utility to certain accounts or people.h  A           After the quotas for the account have been changed, the E           user should log out of the account and log in again for thei$           new quotas to take effect.  A           For information on using the Authorize Utility, see the 6           OpenVMS System Manager's Manual: Essentials.  -     3.6 Enhancing Digital Fortran Performancet  @           This section contains information on system tuning andD           explains how to install Digital Fortran as a shared image.       3.6.1 Tuning Your System  ?           After installing Digital Fortran, you can adjust your A           system to enhance performance and lower the use of somet           system resources.t  E           If users will be compiling parallel-processing applications5=           or very large programs (many program units compiledn,           together), consider the following:  @           o  Adequate page file space must exist. Large programs@              (such as those using parallel processing) need moreA              virtual memory during compilation and execution than A              small programs. Use the INSTALL command to extend an E              existing page file or create one or more new page files.t  E                                  After Installing Digital Fortran 3-5  t  c              >       o  The SYSGEN parameter virtual page count is related to@          the total amount of page file space. If you create more<          page file space, be sure to review the virtual page6          count parameter and increase it if necessary.  =       o  The SYSGEN parameter working set maximum (WSMAX) cana;          also be checked if a larger process working set is;          needed.  @       For more information about tuning your system, see the DEC?       Fortran Performance Guide for OpenVMS VAX Systems and thes.       Guide to OpenVMS Performance Management.  @ 3.6.2  Installing the Digital Fortran Compiler as a Shared Image  ;       If you expect the Digital Fortran compiler to be usedn;       extensively on your system, you can reduce the system <       overhead and memory requirements by installing it as a=       shared image. This is done by using the OpenVMS Installo       Utility (INSTALL).  @       To install the compiler as a shared image on a system that?       is currently running, use a system that has been rebootedp>       recently, because the available space in the global page,       table is less likely to be fragmented.  @       Before installing the compiler as a shared image, you must=       first determine the number of available global pagelets =       and global sections on your system. See Section 1.6.1.1 ?       for information on how to verify and modify the number of A       global pagelets and global sections. Section 1.6.1 contains 2       the guidelines for setting these parameters.  <       Once you reset the system parameter values, invoke the@       Install Utility from a privileged account and then install4       Digital Fortran as a shared image, as follows:         $ INSTALL J       INSTALL> ADD SYS$SYSTEM:FORTRAN$MAIN.EXE/OPEN/SHARED/HEADER_RESIDENT       INSTALL> EXIT   ?       Add the following lines to the appropriate system startup :       command file so that the Digital Fortran compiler is9       available as a shared image each time the system is        started:  % 3-6  After Installing Digital Fortran                               $ INSTALLYE           ADD SYS$SYSTEM:FORTRAN$MAIN.EXE/OPEN/SHARED/HEADER_RESIDENTS           EXIT  A           If your site has modularized its startup procedures, beAA           sure you add the lines to the correct file. The default D           startup command file for OpenVMS is SYS$MANAGER:SYSTARTUP_           V5.COM.B  E           When you install Digital Fortran as a shared image, you maySB           need to increase the global pagelets and global sections)           parameters (see Section 1.6.1).o       3.7 OpenVMS Upgrade Issues  >           You should always use the most recent version of the5           Digital Fortran Run-Time Library available.   >           When you are preparing for an upgrade of the OpenVMSB           operating system, be aware that the Digital Fortran Run-D           Time Library ships with the OpenVMS operating system. ThisD           means that an OpenVMS upgrade may install an older version2           of the Digital Fortran Run-Time Library.  D           The Run-Time Library provided with the most recent versionC           of Digital Fortran contains changes that are not included B           in the version provided with OpenVMS VAX Version 5.4 andE           earlier; these changes will be included in a future versionD           of OpenVMS VAX.d  ?           If you install a new version of OpenVMS (earlier thaniE           Version 7.0), it may overwrite the existing Digital Fortran E           Run-Time Library, replacing it with an earlier version. So,nE           after every OpenVMS installation, reinstall Digital Fortran /           to keep the Run-Time Library current.n  4     3.8 Reading the Release Notes After Installation  D           During installation, the text form of the release notes isA           copied to the following file in the SYS$HELP directory:   (           SYS$HELP:FORT06n.RELEASE_NOTES  D           The n is replaced by the minor version of Digital Fortran,&           such as 4 (for Version 6.4).  E                                  After Installing Digital Fortran 3-7i P  e              @       After installation, you can enter the following command to       review the release notes:e  0       $ TYPE/PAGE SYS$HELP:FORT06n.RELEASE_NOTES  @       The Digital Fortran kit also provides the release notes in@       PostScript and DECwindows Bookreader forms. These forms of>       the release notes can be accessed after the installation6       has completed by using the following file names:  '       SYS$HELP:FORT06n_RELEASE_NOTES.PSt.       SYS$HELP:FORT06n_RELEASE_NOTES.DECW$BOOK  ?          ________________________ Note ________________________   :          Note that the name of the newly installed release8          notes file consists of the current product name<          and version number. Do not delete release notes for7          previous versions of Digital Fortran (if any).,  ?          ______________________________________________________a   3.9  Removing Digital Fortran,  9       From a process that has SYSPRV and CMKRNL or SETPRV <       privileges, use one of the following methods to remove&       Digital Fortran from the system:  A       o  If POLYCENTER (PCSI) was used to install Digital Fortrant  ?          You can use PCSI to remove Digital Fortran by enterings          the following command:   !          $ PRODUCT REMOVE FORTRAN   9       o  If VMSINSTAL was used to install Digital Fortran   =          You can use a SYS$UPDATE command procedure to removeg<          Digital Fortran, by entering the following command:  (          $ @SYS$UPDATE:FORTRAN$DEINSTALL  ;          This procedure removes all compiler-related files, :          modules, images and DCL commands from the system.  <          The procedure also provides an option to remove the=          Digital Fortran-provided Run-Time Library images andn=          replace them with those provided by OpenVMS. Digitalo>          does not recommend selecting this option, because any@          images linked against the newer Run-Time Library images  % 3-8  After Installing Digital Fortrann f  e              ?              may fail. Do not select this option unless you aresE              willing to relink any applications that have been linkedd1              since Digital Fortran was installed.n  C           If your system is a member of a VMScluster, you must thenaE           execute the following command on all other cluster members:s  1           $ INSTALL REPLACE SYS$LIBRARY:DCLTABLESr  B           The OpenVMS utility SYSMAN can be used for this purpose;9           see Section 3.2 for an example of using SYSMAN.,       3.10 Troubleshooting Tipst  ?           If your installation is not successful, check for thep&           following possible problems:  >           o  The appropriate PAK must be available to the userD              performing the installation. The PAK must be registeredC              and loaded before you can install Digital Fortran; forrB              information about registering a PAK, see Section 1.5.,              Then reinstall Digital Fortran.  4           o  The DCLTABLES.EXE file should be in theA              SYS$COMMON:[SYSLIB] directory. There should not be ai<              copy of DCLTABLES.EXE in SYS$SPECIFIC:[SYSLIB].  B              If a copy of DCLTABLES.EXE is found in a SYS$SPECIFICD              root, rename it to DCLTABLES.OLD, do an INSTALL REPLACEC              SYS$LIBRARY:DCLTABLES, then reinstall Digital Fortran.a  >           o  The system logical name SYS$SYSROOT should not be@              modified from the preset definition provided by the*              OpenVMS VAX operating system.  ,     3.11 Getting Help and Reporting Problems  A           If you encounter a problem while using Digital Fortran,t           report it to Digital.n  @           If an error occurs while Digital Fortran is in use andC           you believe the error is caused by a problem with Digital 5           Fortran, take one of the following actions:r  <           o  If you have a Software Product Services SupportA              Agreement, consider contacting your Customer Support D              Center (CSC) by telephone (in the United States, 1-800-E              354-9000) or by using the electronic means provided with)  E                                  After Installing Digital Fortran 3-9                    =          your support agreement. You can use DSNlink or other ;          electronic means to report the problem to the CSC.u  ?       o  If you do not have a service contract, you can arrangeo"          for per-call CSC support.  =       When you initially contact the CSC, please indicate thef       following:  <       o  The name and version number of the operating system$          (OpenVMS VAX) you are using  A       o  The name (Digital Fortran) and version number of DigitalO          Fortran you are using  ;       o  The hardware system you are using (such as a model           number)  $       o  How critical the problem is  A       o  A very brief description of the problem (one sentence ifw          possible)  @       When you submit information electronically or are speakingA       on the phone to the appropriate support specialist, you can 1       provide more detailed information, such as:   ;       o  The specific commands used to compile and link theN          program  %       o  The error messages displayedn  A       o  Relevant detailed information (possibly including sourcea          program listings)  A       Please try to narrow the cause of the problem to a specificc%       source module or lines of code.   @       CSC personnel may ask for additional information, such as:  &       o  Listings of any command files         o  INCLUDE files         o  Relevant data files  >       If the program is longer than 50 lines, submit a copy ofA       it electronically or provide machine-readable media (floppy !       diskette or magnetic tape).e  & 3-10  After Installing Digital Fortran ,  k              @           Experience shows that problem reports sometimes do notA           contain enough information to duplicate or identify theeC           problem. Concise, complete information helps Digital give_;           accurate and timely service to software problems.a  @           To obtain information about purchasing Digital support;           services, please contact your local Digital salesh           representative.i  @           You can also send comments and questions about Digital9           Fortran to the following Internet mail address:            fortran@digital.com.                                                                  E                                 After Installing Digital Fortran 3-11o