VAX FORTRAN Installation Guide August 1989 This manual contains instructions for installing VAX FORTRAN on the VMS operating system. It also explains how to display or print the online release notes before or after installing the product. This manual applies to VAX FORTRAN Version 5.4 and all future maintenance updates to that version. (This online version of the Installation Guide is more cur- rent than the latest hardcopy version. Hardcopy versions are revised only when a new version of the product is issued (for example, Version 5.0) or when major changes to the installa- tion procedure are made between point releases of the product (for example, between Version 5.2 and Version 5.3).) Revision/Update Information: This revised manual supersedes the VAX FORTRAN Installation Guide (Order Number AA-H953G- TE). Operating System and Version: VMS Version 5.2 or higher. Future maintenance releases may require higher versions. Software Version: VAX FORTRAN Version 5.4 digital equipment corporation maynard, massachusetts ________________________ First Printing, April 1980 Revised, April 1982 Revised, March 1984 Revised, September 1984 Revised, June 1988 Revised, August 1989 __________ 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 ©1980, 1982, 1984, 1988, 1989 by Digital Equipment Corporation All Rights Reserved. Printed in U.S.A. The following are trademarks of Digital Equipment Corporation: DEC DIBOL UNIBUS DEC/CMS EduSystem VAX DEC/MMS IAS VAXcluster DECnet MASSBUS VMS DECsystem-10 PDP VT DECSYSTEM-20 PDT DECUS RSTS DECwriter RSX DIGITAL ZK-5329 Contents________________________________________________________ Preface________________________________________________________v Preparing to Install VAX FORTRAN_______________________________1 Prerequisite Software_____________________________________1 Accessing the Online Release Notes________________________1 Installation Procedure Requirements_______________________2 User Account Quotas_______________________________________4 VMS License Management Facility___________________________5 Using VMSINSTAL___________________________________________6 Installing VAX FORTRAN_________________________________________7 Installing VAX FORTRAN on a VAXcluster___________________17 After the Installation________________________________________18 Running the Installation Verification Procedure Separately____18 Error Conditions______________________________________________19 Installing VAX FORTRAN as a Shared Image______________________20 Maintenance Updates___________________________________________21 Updating FORSYSDEF_______________________________________22 Determining and Reporting Problems____________________________22 Sample Installation___________________________________________23 iii Preface ________________________________________________________________ This manual describes how to install VAX FORTRAN on the VMS operating system. This manual is intended for system managers. It applies to VAX FORTRAN Version 5.4 and all future maintenance updates to that version. A major version number is represented by the digits to the left of the decimal point, and the maintenance update version number is indicated by the digits to the right of the decimal point. Keep this manual with your distribution kit. You will need it to install maintenance updates or to reinstall VAX FORTRAN for any other reason. At the back of this manual are two Reader's Comments forms. If you have any comments about this manual, please fill out a form and mail it; your comments will be considered for the next revision of the installation guide. For more information about installing VAX FORTRAN on VMS systems, refer to your processor-specific installa- tion/operations guide. The installation procedure is described step-by-step and is, for the most part, self-explanatory. The system prompts you to answer questions and to change volumes, and waits for you to tell it to continue. v Defaults appear in brackets ([]) throughout the installation procedure. vi __________________________________________________________ Preparing to Install VAX FORTRAN Your bill of materials (BOM) and indented bills report (BIL) specify the number and contents of your media. Be sure to check the contents of your kit against this information. If your kit is damaged or if you find that parts of it are missing, call your Digital representative. Distribution media must be mounted in numerical order. The installation procedure prompts you to mount the volumes. For more information on how to mount distribution media, refer to your processor-specific installation/operations guide. This guide also details several options to the installation procedure. __________________________________________________________ Prerequisite Software VAX FORTRAN Version 5.4 requires VMS Version 5.2 or higher. The VMS operating system comes with a variety of support options, or classes. Classes include such features as net- working and RMS journaling. To use VAX FORTRAN, your system should be running a version of VMS that includes the classes listed in the Software Support Addendum (SSA), which comes with the Software Product Description (SPD). __________________________________________________________ Accessing the Online Release Notes VAX FORTRAN provides online release notes. The prompt to display or print the release notes before installation ap- pears in step 5 of the installation procedure when you invoke VMSINSTAL with the OPTIONS N parameter. To obtain the release notes after the installation, type or print the file SYS$HELP:FORT05n.RELEASE_NOTES, where n is the maintenance update number associated with your VAX FORTRAN distribution kit. VAX FORTRAN Installation Guide 1 Online help also directs you to the release notes. After the installation, type the following DCL command: $ HELP FORTRAN RELEASE_NOTES __________________________________________________________ Installation Procedure Requirements Installing VAX FORTRAN should take approximately 5 minutes to 120 minutes, depending on the type of media, your system configuration, and the kit components chosen. Before starting the installation, you must have the following privileges and resources: o SETPRV privilege, or CMKRNL, WORLD, and SYSPRV privileges. o A minimum of 10,000 blocks of free disk space during the installation of the full VAX FORTRAN kit. (When the installation is completed, the installed software uses approximately 4650 blocks of disk space.) Disk space usage can be reduced by omitting certain components of VAX FORTRAN during installation. See the section Installing VAX FORTRAN for more information. Note that the space requirements specified in this instal- lation guide may vary slightly from the amounts required for an actual installation. Refer to the messages printed out by the installation procedure for precise information on space requirements associated with the installation kit and its various components. o The minimum number of free global pages and global sec- tions depends on whether SYS$SYSTEM:FORTRAN.EXE was previ- ously installed as a shared known image: - If not previously installed as shared -- 1 global section and a sufficient number of contiguous free global pages to contain the file SYS$LIBRARY:DCLTABLES.EXE 2 VAX FORTRAN Installation Guide - If previously installed as shared -- 2 global sections and approximately 600 contiguous free global pages plus a sufficient number of contiguous free global pages to contain the file SYS$LIBRARY:DCLTABLES.EXE NOTE You must ensure that your system has the necessary global page and global section SYSGEN quotas for the installation. Failure to do so could cause the DCL tables to be corrupted in some situations. To determine the number of global pages required by SYS$LIBRARY:DCLTABLES.EXE, type the following DCL command: $ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE This command returns the size (in blocks) of SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this figure as the number of global pages needed for the file. To determine the number of contiguous free global pages and free global sections, type the following DCL commands: $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") 12345 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") 12 If you do not have enough free global pages to install VAX FORTRAN, you can either delete an existing known image using the VMS Install Utility or increase the GBLPAGES system parameter using the VMS System Generation Utility (SYSGEN). Using the SYSGEN utility to increase the GBLPAGES parameter involves the following steps: 1.Editing the file SYS$SYSTEM:MODPARAMS.DAT 2.Invoking the AUTOGEN command procedure (SYS$UPDATE:AUTOGEN.COM) VAX FORTRAN Installation Guide 3 For more information on using the AUTOGEN command procedure, refer to your processor-specific installation/operations guide. If you do not have enough free global sections to install the compiler, you must make a sufficient number available by increasing the GBLSECTIONS system parameter. (You can increase the GBLSECTIONS system parameter using the same method used to increase the GBLPAGES system parameter.) __________________________________________________________ User Account Quotas To use VAX FORTRAN, each account must have the following minimum quota requirements: o AST limit (ASTLM) = 24 o Buffered I/O quota (BIOLM) = 18 o Buffered I/O byte count quota (BYTLM) = 18000 o Direct I/O quota (DIOLM) = 18 o Enqueue quota (ENQLM) = 30 o Open file limit (FILLM) = 20 Use the VMS Authorize Utility (AUTHORIZE) to compare the current values of these quotas with the requirements for VAX FORTRAN. For example, the account used in the following example is the SYSTEM account: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> SHOW SYSTEM To change the values of these quotas, use the VMS Authorize Utility's MODIFY command. For more information, see the VMS Authorize Utility Manual. 4 VAX FORTRAN Installation Guide __________________________________________________________ VMS License Management Facility The VMS License Management Facility (LMF) was incorporated in Version 5.0 of the VMS operating system. You must register your VAX FORTRAN software license with LMF when you install VAX FORTRAN. The license registration information you need is contained in the Product Authorization Key (PAK) that is shipped with VAX FORTRAN. The PAK is a paper certificate that contains information about the license you have to run a particular piece of software. During the installation, you are asked if you have registered the VAX FORTRAN license and loaded the appropriate autho- rization key. You must register and load your license for VAX FORTRAN before you start the installation in order to run the Installation Verification Procedure (IVP) and use the software. To register a license, first log in to the system manager's account, SYSTEM. You then have a choice of two ways to per- form the registration: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your Product Authorization Key (PAK). o Issue the DCL command LICENSE REGISTER with the appro- priate qualifiers that correspond to information on the PAK. For complete information on using LMF, see the manual on the License Management Utility in the VMS documentation set (VMS License Management Utility Manual). VAX FORTRAN Installation Guide 5 __________________________________________________________ Using VMSINSTAL After you log in to a privileged account, set the default directory to SYS$UPDATE: and then invoke VMSINSTAL, the command procedure that installs VAX FORTRAN. An example of this procedure is shown in steps 1 and 2 of the section Installing VAX FORTRAN. The VMSINSTAL command procedure has the following syntax: $ @VMSINSTAL FORT05n ddcu: [OPTIONS N] n Represents the maintenance update of VAX FORTRAN. Refer to the label on the VAX FORTRAN distribution kit or the VAX FORTRAN BOM or BIL for the maintenance update number of your kit. ddcu: Represents the name of the device on which the distribution volumes will be mounted for the VAX FORTRAN installation media, where dd is the device code, c is the controller code, and u is the unit number. It is not necessary to use the console drive to install VAX FORTRAN. If you do use the console drive, you should replace any media that you removed from the drive. CSA1: is the device name used in examples in this document. (Note that the device name CSA1: is not appropriate for the VAX 8600, 8650, or 8800.) OPTIONS N Is an optional parameter you should provide if you want to be prompted to display or print the release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not prompt you to display or print the release notes. Note that VMSINSTAL permits the use of several other options. For more information on these options, see your processor-specific installation/operations guide. 6 VAX FORTRAN Installation Guide If you do not supply the first two parameters, VMSINSTAL prompts you for the product and device names. If you wish to be prompted for the product and device names and prompted to display or print the release notes, type the following: $ @VMSINSTAL "" "" OPTIONS N When you invoke VMSINSTAL, it checks the following: o Whether you logged in to a privileged account. Digital recommends that you install software from the system manager's account with your default device and directory set to SYS$UPDATE. o Whether you have adequate quotas for installation. VMSINSTAL checks for the following quota values: ASTLM = 24 BIOLM = 18 BYTLM = 18000 DIOLM = 18 ENQLM = 30 FILLM = 20 VMSINSTAL then checks to determine whether any users are logged in to the system. If users are logged in, you will be asked whether you want to continue the installation. If you want to continue, type YES. If you want to stop the installation, press RETURN. __________________________________________________________ Installing VAX FORTRAN This section contains excerpts from the installation pro- cedure and explains each step. Note that defaults appear in brackets throughout the installation procedure. To abort the installation procedure at any time, press CTRL/Y. When you press CTRL/Y, the installation procedure deletes all files it has created up to that point and re- turns you to DCL level. If you want to retry the installation VAX FORTRAN Installation Guide 7 procedure after pressing CTRL/Y, you must proceed from step 2. Step 1: Log in to a privileged account and set your default device and directory to SYS$UPDATE. Username: SYSTEM Password: $ SET DEFAULT SYS$UPDATE Step 2: Invoke VMSINSTAL. $ @VMSINSTAL FORT05n CSA1: OPTIONS N VAX/VMS Software Product Installation Procedure VX.X It is dd-mmm-yyyy at hh:mm. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? If you are satisfied with the backup of your system disk, press RETURN. Otherwise, type NO and press RETURN to discon- tinue the installation. Step 3: Insert the first installation kit volume. Please mount the first volume of the set on CSA1:. * Are you ready? YES The following products will be processed: 8 VAX FORTRAN Installation Guide FORT V5.n Beginning installation of FORT V5.n at hh:mm %VMSINSTAL-I-RESTORE, Restoring product saveset A... To indicate that you want to continue the installation, mount volume 1, type YES, and then press RETURN. Step 4: Insert the subsequent installation kit volumes. %BACKUP-I-READYREAD, mount volume 2 on _CSA1: for reading Enter "YES" when ready: YES VMSINSTAL prompts you to insert the next volume and waits for you to type YES after inserting it. If you type NO, VMSINSTAL displays the prompt again. This prompt is displayed only if your installation kit contains more than one volume. Step 5: Select a release notes option. This step applies only if you specified OPTIONS N in step 2. (The OPTIONS N parameter is described in the section Using VMSINSTAL.) Release notes included with this kit are always copied to SYS$HELP Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: VAX FORTRAN Installation Guide 9 The effects of these options are as follows: o If you select option 1, VMSINSTAL displays the release notes immediately on your screen. You can terminate the display at any time by pressing CTRL/C. o If you select option 2, VMSINSTAL prompts you for a queue name. * Queue name [SYS$PRINT]: Either type a queue name or press RETURN to send the file to the default output print device. o If you select option 3, VMSINSTAL displays and prints the release notes. o If you select option 4, VMSINSTAL does not print or dis- play the release notes in this step. Next, VMSINSTAL displays the following prompt: Do you want to continue the installation [NO]?: YES %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully moved to SYS$HELP. If you want to continue the installation, type YES and press RETURN. If you type NO and press RETURN, VMSINSTAL discontin- ues the installation. If you continue the installation, VMSINSTAL always copies the release notes to SYS$HELP, regardless of which release notes option you select. NOTE The version of the release notes file copied by VMSINSTAL is labeled with the current product name and version number. Take care not to delete the release notes for previous versions of VAX FORTRAN. 10 VAX FORTRAN Installation Guide Step 6: Select installation options. * Do you want to purge files replaced by this installation [YES]? The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE, SYS$SYSTEM, SYS$TEST, and VUE$LIBRARY may contain previ- ous versions of VAX FORTRAN files. These files are replaced during the installation with new files, but the old files are not automatically purged. Purging is recommended. In response to the purging prompt, press RETURN to purge the files or type NO to keep them. The installation procedure allows you to select the compo- nents of the kit that you want to install. The choices are as follows: o VAX FORTRAN compiler o VAX FORTRAN help files o System definition file, FORSYSDEF.TLB o DECwindows Compiler Interface The installation procedure gives you information about the space requirements of each component as well as the number of disk blocks available on your system. Select the components you wish to install by answering YES or NO to the following questions. If you want a more detailed description of any component, type a question mark (?). After the explanation is displayed, you will be prompted again for a response. * Do you want to install the VAX FORTRAN compiler [YES]? If you do not want to install the VAX FORTRAN compiler, type NO. If you type NO, skip to the question on installing VAX FORTRAN help. If you type YES, continue with the next question. VAX FORTRAN Installation Guide 11 * Do you want to install the command and language help [YES]? If you have enough space, we suggest that you always install the larger version of VAX FORTRAN online help, which provides help for both the FORTRAN command line and the VAX FORTRAN language. * Do you want to build a new FORSYSDEF.TLB [YES]? SYS$LIBRARY:FORSYSDEF.TLB is a library of VMS system in- terface definitions that can be used by FORTRAN programs. FORSYSDEF.TLB is built from a master set of definitions that is provided with VMS, and contains declarations of VMS sys- tem services, Run-Time Library routines, structures, and constants. Because FORSYSDEF.TLB is generated from VMS definitions, you do not need to rebuild it unless this is a new installation or you have installed a new version of VMS since the last time you installed VAX FORTRAN. (The installation procedure will make a recommendation on whether FORSYSDEF.TLB should be rebuilt.) If you type YES, the installation procedure builds a new system definition file, FORSYSDEF.TLB, based on the system definitions for the version of VMS being installed on. * Do you want to install the DECwindows Compiler Interface [YES]? The DECwindows Compiler Interface (DWCI) for VAX FORTRAN allows you to use a window-style interface to select compiler options when you compile a FORTRAN program. See the VAX FORTRAN Release Notes for more information on DWCI. The DWCI option requires that the FileView directories [VUE$LIBRARY.SYSTEM] and [VUE$LIBRARY.USER] be present on the target disk. For more information on FileView, see the VMS DECwindows User's Guide. 12 VAX FORTRAN Installation Guide The installation procedure then displays the components you have selected and issues the following prompt: * Is this correct [YES]? If you type NO, the installation procedure reissues the prompts for selecting components. Step 7: Respond to License Registration Queries. VAX FORTRAN supports the VMS License Management Facility (LMF). The installation procedure displays license informa- tion about your product and then asks if you have registered and loaded your authorization key for VAX FORTRAN. The fol- lowing is an example of such information: Product: FORTRAN Producer: DEC Version: 5.n Release Date: dd-mmm-yyyy * Does this product have an authorization key registered and loaded?: YES If you have not registered and loaded your authorization key, you must answer "NO" to this question. You have to register and load your product authorization key to successfully complete the installation. If you have not done so, you should stop the installation, register and load your product authorization key, and then restart the installation. Step 8: Respond to prompt controlling Installation Verification Procedure. * Do you want to run the IVP after the installation [YES]? VAX FORTRAN Installation Guide 13 The Installation Verification Procedure (IVP) runs several tests to check whether the installation procedure was suc- cessful. Press RETURN to run the IVP after the installation. If you do not want to run the IVP, type NO in response to the prompt. Step 9: Read informational messages. The VAX FORTRAN installation procedure produces informational messages that report on the progress of the installation. All questions regarding the installation of VAX FORTRAN have been asked. Depending upon your configuration, time estimates for the installation(s) have been provided. VAX FORTRAN compiler: 1 to 10 minutes FORTRAN HELP: 1 to 15 minutes FORSYSDEF.TLB: 5 to 30 minutes DWCI support: 1 to 2 minutes +-------------------------------------------------------+ | Installing the VAX FORTRAN V5 Compiler | +-------------------------------------------------------+ +-------------------------------------------------------+ | Installing VAX FORTRAN HELP | +-------------------------------------------------------+ +-------------------------------------------------------+ | Installing FORSYSDEF.TLB | +-------------------------------------------------------+ +-------------------------------------------------------+ | Installing DECwindows Compiler Interface | +-------------------------------------------------------+ If the installation procedure is successful, the new and modified files are moved to their target directories and the following messages are displayed: 14 VAX FORTRAN Installation Guide Your VMS system will now be updated to include the following new and modified file(s): SYS$HELP:FORT05n.RELEASE_NOTES [new] SYS$SYSTEM:FORTRAN.EXE [new] SYS$MESSAGE:FORTERR1.EXE [new] SYS$MESSAGE:FORTERR2.EXE [new] SYS$LIBRARY:FORTV5CLD.CLD [new] SYS$LIBRARY:DCLTABLES.EXE [modified] SYS$TEST:FORTRAN$IVP.COM [new] SYS$HELP:HELPLIB.HLB [modified] SYS$LIBRARY:FORSYSDEF.TLB [new] VUE$LIBRARY:FORTRAN$DWCI.EXE [new] VUE$LIBRARY:FORTRAN$DWCI.UID [new] VUE$LIBRARY:VUE$COMPILE.COM [new] SYS$HELP:FORTRAN$DWCI.HLB [new] The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE files are updated to include the new versions of the VAX FORTRAN help text and the FORTRAN command line definition. Also, if you typed YES in response to the prompt that re- quests a file purge at step 6, previous versions of the VAX FORTRAN files are now purged. The end of the installation is indicated by the following message: %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... Step 10: Observe the Installation Verification Procedure If you chose to run the IVP in step 8, VMSINSTAL now invokes the IVP to verify that VAX FORTRAN was installed success- fully. VAX FORTRAN Installation Guide 15 Beginning VAX FORTRAN Installation Verification Procedure Compiler image identification is FORT V5.n-eee Test compiler operation and error messages... Compile, link, and run program with parallel processing features... Test FORSYSDEF.TLB system definitions... Test I/O and Run-Time Library operation... If VAX FORTRAN was installed successfully, the IVP displays the following: VAX FORTRAN V5.n-eee TEST PASSED End of VAX FORTRAN Installation Verification Procedure Step 11: End the installation procedure. Installation of VAX FORTRAN V5.n completed at hh:mm VMSINSTAL procedure done at hh:mm $ LOGOUT SYSTEM logged out at dd-mmm-yyyy hh:mm:ss.ss When the installation is complete, you can choose to in- stall more products or to log out (as shown here). If you removed any media from the console drive before beginning the installation, you should replace it now. Note that VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, if you are going to continue using the system manager's account and you want to restore these symbols, you should log out and log in again. 16 VAX FORTRAN Installation Guide __________________________________________________________ Installing VAX FORTRAN on a VAXcluster If you want to run VAX FORTRAN on multiple nodes of a VAXcluster, first check to see that you have the appropriate software license. Then, perform the following steps after you install VAX FORTRAN: 1.Issue the LICENSE LOAD command to activate the license on each node in the VAXcluster on which VAX FORTRAN is to be executed as described in the VMS License Management Utility Manual. 2.Determine whether FORTRAN.EXE was installed using the VMS Install Utility (as described in the section Installing VAX FORTRAN as a Shared Image). If INSTALL was used, perform all of the following steps. If INSTALL was not used, omit step 4b. 3.Log in to a node on the cluster. 4.Run the VMS Install Utility as described in the section Installing VAX FORTRAN as a Shared Image, with the follow- ing exceptions: a.After invoking the VMS Install Utility, type the fol- lowing command: INSTALL> REPLACE SYS$LIBRARY:DCLTABLES.EXE This command updates the DCL tables. b.Then, if FORTRAN.EXE was installed using the Install Utility, type the following command: INSTALL> REPLACE SYS$SYSTEM:FORTRAN.EXE This command replaces the INSTALL entry for FORTRAN.EXE. 5.Repeat steps 3 and 4 for each node of the cluster. VAX FORTRAN Installation Guide 17 __________________________________________________________ After the Installation VAX FORTRAN is now installed and can be invoked by all users with the FORTRAN command. The installation procedure modifies the DCL command table so that the FORTRAN command is recognized and processed. However, the previous command table is still in effect for those users who are currently logged in. All logged-in users who want to use the FORTRAN command must log out and log in again. If VAX FORTRAN will be used extensively on your system, you can reduce system overhead and memory requirements by in- stalling it as a shared image using the VMS Install Utility. For more information, see the section Installing VAX FORTRAN as a Shared Image. __________________________________________________________ Running the Installation Verification Procedure Separately The Installation Verification Procedure (IVP) is usually run at installation. If you want to run the IVP separately -- for example, to ensure the integrity of installed files when system problems occur -- execute the following command procedure: $ @SYS$TEST:FORTRAN$IVP.COM. If the IVP fails for any reason, the following message is displayed: VAX FORTRAN VERSION 5 TEST FAILED 18 VAX FORTRAN Installation Guide __________________________________________________________ Error Conditions If the installation procedure fails for any reason, the following message is displayed: %VMSINSTAL-E-INSFAIL, The installation of VAX FORTRAN V5.n has failed. An error during the installation can occur if one or more of the following conditions exist: o Operating system version is incorrect. o Quotas necessary for successful installation are sufficient (see the section Installation Procedure Requirements). o Process quotas required by VMSINSTAL are incorrect (see the section Using VMSINSTAL). o The VMS help library is currently in use. o The product was registered incorrectly or not registered. For descriptions of the error messages generated by these conditions, see the VMS System Messages and Recovery Procedures Reference Volume, your processor-specific in- stallation/operations guide, or the VMS License Management Utility Manual. If you are notified that any of these conditions exist, you should take the appropriate action as described in the mes- sage. You may need to change a system parameter or increase an authorized quota value. For information on require- ments, see the material provided in the section Installation Procedure Requirements and the section Using VMSINSTAL. If the installation fails, you must restart the installation procedure from step 2. If the installation fails due to an IVP failure, contact a Digital field service representative. VAX FORTRAN Installation Guide 19 __________________________________________________________ Installing VAX FORTRAN as a Shared Image If VAX FORTRAN will be used extensively on your system, you can reduce the system overhead and memory requirements by installing it as a shared image. To perform the instal- lation on a system that is currently running, use the VMS Install Utility while you are logged in to a privileged account. If errors occur, see your processor-specific in- stallation/operations guide. You should perform the following steps on a system that has just been bootstrapped because the available space in the global page table is less likely to be fragmented. If errors occur, see the VMS System Messages and Recovery Procedures Reference Volume. First, determine the number of available global pages and global sections on your system. See the section Installation Procedure Requirements for information on how to do this. Then, invoke the VMS Install Utility and install VAX FORTRAN as a shared image by typing the following commands: $ INSTALL INSTALL> ADD SYS$SYSTEM:FORTRAN.EXE/OPEN/SHARED/HEADER_RESIDENT INSTALL> EXIT Then, update the system startup file to install VAX FORTRAN. To ensure that VAX FORTRAN is installed as a shared image each time the system is bootstrapped, include the following lines in SYS$MANAGER:SYSTARTUP_V5.COM (the site-specific startup file): $ INSTALL ADD SYS$SYSTEM:FORTRAN.EXE/OPEN/SHARED/HEADER_RESIDENT EXIT 20 VAX FORTRAN Installation Guide In addition, if you are installing the VAX FORTRAN compiler with privileges, then all shareable images used must also be installed. The shareable images include the callable in- terface to the VAX Common Data Dictionary (CDD), CDDSHR.EXE, and the two message files, FORTERR1.EXE and FORTERR2.EXE. This is a VMS security feature that prevents a user from activating a private (noninstalled) image with privileges. Likewise, if your system already has the callable interface to the VAX Common Data Dictionary, CDDSHR.EXE, installed as a protected image, then the two message files FORTERR1.EXE and FORTERR2.EXE must be installed as well. To install the message files, use the following commands: $ INSTALL INSTALL> ADD SYS$MESSAGE:FORTERR1.EXE INSTALL> ADD SYS$MESSAGE:FORTERR2.EXE INSTALL> EXIT __________________________________________________________ Maintenance Updates Digital may periodically issue maintenance updates of VAX FORTRAN. Each update consists of an installation kit. You should install this kit as described in this manual or in any documentation that may accompany the maintenance update. Each time a maintenance update is released, the version number changes. For example, if the current version is 5.3, the version number of the next maintenance update will be 5.4. In addition, the maintenance update includes new release notes. The release notes describe the changes that have been made to VAX FORTRAN since the previous release. VAX FORTRAN provides release notes for each maintenance up- date. You should read the release notes before you install VAX FORTRAN. For information on accessing the release notes before VAX FORTRAN is installed, follow the installation pro- cedure through step 5. The release notes are also accessible VAX FORTRAN Installation Guide 21 at any time after the product is installed. To access the re- lease notes after VAX FORTRAN is installed, display or print the file SYS$HELP:FORT05n.RELEASE_NOTES. __________________________________________________________ Updating FORSYSDEF As with the previous major version of VAX FORTRAN (Version 4), the mechanism for building FORSYSDEF.TLB for Version 5 is to process the master description of some of the system def- inition modules from STARLETSD.TLB during each installation. STARLETSD.TLB is shipped with all VMS releases. FORSYSDEF.TLB should be built during the initial VAX FORTRAN installation on a system. It does not need to be installed with succeeding VAX FORTRAN updates, but should be installed after a VMS update is performed on the system. In this way, the FORSYSDEF modules are automatically updated to reflect any changes to the VMS system definitions in a release of VMS. The installation process allows the FORSYSDEF.TLB component of the compiler kit to be installed separately. __________________________________________________________ Determining and Reporting Problems If an error occurs while you are using VAX FORTRAN and you believe that the error is caused by a problem with VAX FORTRAN, take one of the following actions: o If you purchased VAX FORTRAN within the past 90 days and you think the problem is caused by a software error, you can submit a Software Performance Report (SPR). o If you have a Basic or DECsupport Software Agreement, you should call your Customer Support Center. With these services, you receive telephone support that provides high-level advisory and remedial assistance. For more information, contact your local Digital representative. 22 VAX FORTRAN Installation Guide o If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR). If you find an error in the VAX FORTRAN documentation, you should fill out and submit a Reader's Comments form from the back of the manual in which the error was found. Include the section and page number where the error was found. __________________________________________________________ Sample Installation This section contains a sample installation of each of the components on the VAX FORTRAN kit. Note that this is only a sample. Sometimes the installation procedure is modified in maintenance updates of this product. Because this installa- tion guide is not usually revised for maintenance updates, be sure to read the Read Before Installing or Using VAX FORTRAN letter before you install this product. This letter notes any significant changes in the installation that vary from this sample. Sample VAX FORTRAN Installation: $ @sys$update:vmsinstal fort054 mua0: options n VAX/VMS Software Product Installation Procedure V5.3 It is 5-DEC-1989 at 11:59. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? Please mount the first volume of the set on MUA0:. * Are you ready? y %MOUNT-I-MOUNTED, FORT mounted on _MUA0: The following products will be processed: FORT V5.4 Beginning installation of FORT V5.4 at 12:01 %VMSINSTAL-I-RESTORE, Restoring product save set A ... VAX FORTRAN Installation Guide 23 Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: 4 * Do you want to continue the installation [NO]? y %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully moved to SYS$HELP. VAX FORTRAN V5.4 Copyright © Digital Equipment Corporation. 1978, 1989. All rights reserved. * Do you want to purge files replaced by this installation [YES]? y The VAX FORTRAN kit is provided as a set of components from which you may select those you wish to install. For each component listed below, a peak disk block usage and a net disk block usage is shown. Peak usage is the number of blocks that must be available for installation. Net usage is the number of blocks that remain after installation. Component Peak blocks Net blocks ---------------------------------------------------------- Base kit (required) 2000 200 Compiler, messages, IVP 600 750 FORTRAN command help 200 50 FORTRAN language help 1200 600 FORSYSDEF.TLB 6700 2700 DECwindows Compiler Interface 0 350 Complete kit 10000 4650 (Peak block usage for complete kit is less than sum of components, due to overlap in disk usage.) There are currently 36755 disk blocks available. 24 VAX FORTRAN Installation Guide Please select the components you wish to install by answering YES or NO to the following questions. If you want a more detailed description of any component, answer with a question mark "?"; after the explanation is displayed, you will be prompted again for a response. * Do you want to install the compiler [YES]? yes * Do you want to install both the command and language help [YES]? yes FORSYSDEF.TLB, which provides VMS interface definitions for FORTRAN applications, is not present and therefore should be created. For more information on FORSYSDEF.TLB, enter a question mark "?" at the following prompt. * Do you want to create a new FORSYSDEF.TLB [YES]? yes * Do you want to install the DECwindows Compiler Interface [YES]? yes You have selected the following components: Compiler Command and language help FORSYSDEF.TLB DECwindows Compiler Interface * Is this correct [YES]? yes Product: FORTRAN Producer: DEC Version: 5.4 Release Date: 1-AUG-1989 * Does this product have an authorization key registered and loaded? yes This kit contains an Installation Verification Procedure (IVP) to verify the correct installation of the VAX FORTRAN compiler. The IVP will be left in: SYS$TEST:FORTRAN$IVP.COM. After the installation is complete, you can invoke the command file at any time to reverify that VAX FORTRAN is installed and working correctly. * Do you want to run the IVP after the installation [YES]? yes VAX FORTRAN Installation Guide 25 All questions regarding the installation of VAX FORTRAN have now been asked. Depending upon your configuration, time estimates for the installation(s) have been provided. VAX FORTRAN compiler: 1 to 10 minutes FORTRAN HELP: 1 to 15 minutes FORSYSDEF.TLB: 5 to 30 minutes DWCI support 1 to 2 minutes +-------------------------------------------------------+ | Installing the VAX FORTRAN Compiler | +-------------------------------------------------------+ +-------------------------------------------------------+ | Installing VAX FORTRAN HELP | +-------------------------------------------------------+ +-------------------------------------------------------+ | Installing FORSYSDEF.TLB | +-------------------------------------------------------+ +-------------------------------------------------------+ | Installing DECwindows Compiler Interface | +-------------------------------------------------------+ Your VMS system will now be updated to include the following new and modified file(s): 26 VAX FORTRAN Installation Guide SYS$HELP:FORT054.RELEASE_NOTES [new] SYS$SYSTEM:FORTRAN.EXE [new] SYS$MESSAGE:FORTERR1.EXE [new] SYS$MESSAGE:FORTERR2.EXE [new] SYS$LIBRARY:FORTV5CLD.CLD [new] SYS$LIBRARY:DCLTABLES.EXE [modified] SYS$TEST:FORTRAN$IVP.COM [new] SYS$LIBRARY:FORSYSDEF.TLB [new] SYS$HELP:HELPLIB.HLB [modified] VUE$LIBRARY:FORTRAN$DWCI.EXE [new] VUE$LIBRARY:FORTRAN$DWCI.UID [new] VUE$LIBRARY:VUE$COMPILE.COM [new] SYS$HELP:FORTRAN$DWCI.HLB [new] %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Beginning VAX FORTRAN Installation Verification Procedure Compiler image identification is FORT V5.4-79 Test compiler operation and error messages... Compile, link and run program with parallel processing features... Test FORSYSDEF.TLB system definitions... Test I/O and Run-Time Library operation... VAX FORTRAN V5.4-79 IVP PASSED End of VAX FORTRAN Installation Verification Procedure Installation of FORT V5.4 completed at 12:12 VMSINSTAL procedure done at 12:12 VAX FORTRAN Installation Guide 27