Before you start the installation, read Chapter 1, which describes the general options and requirements for installing Digital Fortran.
The installation procedure loads Digital Fortran files on to the system disk on the system where you perform the installation.
To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all files it has created up to that point and exits. You can then start the installation again.
Defaults appear in brackets ([]) throughout the installation procedure.
This chapter contains the following topics:
PCSI software is bundled with the OpenVMS operating system and can only be used on OpenVMS VAX Version 6.1 or higher.
For general information on required system parameters and disk space for installation, see Section 1.6. For specific POLYCENTER installation requirements, see Section 1.6.2.
For information on saving a previous version of Digital Fortran before installing the newest version, see Section 1.7.
To install Digital Fortran using PCSI, follow these steps:
You must have BYPASS, CMKRNL, and SYSLCK privileges enabled to install using PCSI. To check whether you have these privileges, enter the following command:
$ SHOW PROCESS/PRIVILEGES
If you do not have these privileges, but you have the SETPRV privilege, you can enable the BYPASS, CMKRNL, and SYSLCK privileges by entering the following command:
$ SET PROCESS/PRIVILEGE=(BYPASS,CMKRNL,SYSLCK)
Verify that the current OpenVMS product version is registered with PCSI by entering the following command:
$ PRODUCT SHOW PRODUCT VMS PRODUCT ------- DEC VAXVMS VMS V6.n 1 item found
If the OpenVMS product is not found, then register the OpenVMS product with PCSI; for example:
$ PRODUCT REGISTER PRODUCT VMS /VERSION=V6.n - $_ /SOURCE=SYS$UPDATE: The following product has been selected: DEC VAXVMS VMS V6.n [Available] Do you want to continue? [YES] <Return> The following product will be registered: DEC VAXVMS VMS V6.n Portion Done: 0%...10%...20%...30%...40%...50%...60%... 70%...100% The following product has been registered: DEC VAXVMS VMS V6.n
$ SHOW DEVICE DKA400
If the media CD-ROM containing the Digital Fortran installation files is not mounted, insert (load) the appropriate media (CD-ROM or tape) in the CD-ROM or tape drive. Enter the following command to mount the media device (do not use the /FOREIGN qualifier):
$ MOUNT DKA400 label
The label is the volume label of the media CD-ROM or tape drive in the device named.
For information about using the CDMENU utility and the CD-ROM files on the media CD-ROM set, see the Software Product Library CD-ROM User's Guide (media CD-ROM user guide), which accompanies the media CD-ROM distribution kit. The media CD-ROM user guide and CD-ROM master index file are provided as online files in the [README] directory on the first media CD-ROM.
$ SET DEFAULT DKA400:[dir.subdir]
$ DIRECTORY Directory DKA400:[dir.subdir] DEC-VAXVMS-FORTRAN-Vnnnn-x-1.PCSI Total of 1 file.
$ PRODUCT EXTRACT RELEASE_NOTES FORTRAN/FILE=SYS$LOGIN:FORT.RELNOTES
You should view or print the file FORT.RELNOTES before you continue with the installation. For example:
$ TYPE/PAGE SYS$LOGIN:FORT.RELNOTES
You can also read the release notes after installation (see Section 3.8).
$ PRODUCT INSTALL FORTRAN
A prompt asks you to verify that the correct product was selected:
The following product has been selected: DEC VAXVMS Fortran Vv.v-nnn Do you want to continue? [YES] <Return>
Press Return (default value YES) to continue installing Digital Fortran.
*** DEC VAXVMS FORTRAN Vv.v-nnn: Digital Fortran for OpenVMS VAX Systems Copyright © Digital Equipment Corporation yyyy,yyyy - All rights reserved. This software product is sold by Digital Equipment Corporation This product uses the PAKs: FORTRAN, FORTRAN-USER or FORTRAN-G Do you want all the default values for this product? [YES] <Return>
Press Return (default value YES) to accept the product defaults. (There are no options that you can select for this product).
Please ignore any PCSI-E-FILNOTPUR messages Do you want to view the values? [NO] <Return>
Press Return (default value NO) to skip displaying of the values and continue installation.
Execution phase starting ... The following product will be installed: DEC VAXVMS FORTRAN Vv.v-nnn %PCSI-I-VOLINFO, estimated space information for volume DISK$xxxxxxx -PCSI-I-VOLSPC, nnnn required; nnnnnn available; nnnnnn net Portion Done: 0%...10%...20%...30%...40%...50%...90%...100% The following product has been installed: DEC VAXVMS FORTRAN Vv.v-nnn %PCSI-I-EXETSTSTART, start of test procedure %PCSI-I-EXETSTOK, end of test procedure; completed with no errors *** DEC VAXVMS FORTRAN Vv.v-nnn: Digital Fortran for OpenVMS VAX Systems Type HELP FORTRAN Release_Notes for release notes location Be sure to @SYS$UPDATE:FORTRAN$POST_INSTALL on other cluster nodes $
$ @SYS$UPDATE:FORTRAN$POST_INSTALL
For information on other PCSI utility features, see the POLYCENTER Software Installation Utility User's Guide.
For general information on required system parameters and disk space for installation, see Section 1.6. For specific VMSINSTAL installation requirements, see Section 1.6.3 .
For information on saving a previous version of Digital Fortran before installing the newest version, see Section 1.7.
To install Digital Fortran using VMSINSTAL, follow these steps:
You must have CMKRNL, SYSPRV, and WORLD privileges enabled to install using VMSINSTAL. To check whether you have these privileges, enter the following command:
$ SHOW PROCESS/PRIVILEGES
If you do not have these privileges, but you have the SETPRV privilege, you can enable the CMKRNL, SYSPRV, and WORLD privileges by entering the following command:
$ SET PROCESS/PRIVILEGE=(CMKRNL,SYSPRV,WORLD)
@SYS$UPDATE:VMSINSTAL saveset-name device-name options-list
FORT06n
Where n represents the maintenance update of Digital Fortran. Refer to the label on the Digital Fortran distribution kit or the Digital Fortran BOM or BIL for the maintenance update number of your kit.
If you are installing Digital Fortran from a CD-ROM, specify the device of the CD device and also the directory that contains the Digital Fortran save set.
Lets you store product save sets temporarily on a magnetic tape or in a disk directory.
Logs all activity to the terminal during installation.
Indicates you want to see the installation question on release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. You should review the release notes before proceeding with the installation in case they contain additional information about the installation.
If you are restarting the installation and have already reviewed the release notes, you do not need to specify OPTIONS N.
Lets you install the product to a system root other than that of the running system.
To specify more than one option, separate the options with commas; for example OPTIONS L,R.
For detailed information on these options, see the OpenVMS documentation on software installation.
The following example invokes VMSINSTAL to install Digital Fortran and shows the system response. This example uses the OPTIONS N release note parameter.
$ @SYS$UPDATE:VMSINSTAL FORT06n MUA0: OPTIONS N OpenVMS VAX Software Product Installation Procedure Vn.n It is dd-mmm-yyyy at hh:mm. Enter a question mark (?) at any time for help.
If you do not supply either the product name or the device name, VMSINSTAL prompts you for this information later in the installation procedure. VMSINSTAL does not prompt you for any options, so be sure to include OPTIONS N on the VMSINSTAL command line to access the release notes during the installation.
When you invoke VMSINSTAL, it checks to see whether you have adequate privileges and quotas for installation (see Section 1.6.3).
VMSINSTAL then checks to determine whether any users are logged in to the system. If users are logged in, you will be asked whether you want to continue the installation. If you want to continue, enter Yes. If you want to stop the installation, press Return.
* Are you satisfied with the backup of your system disk [YES]?
You should always back up your system disk before performing an installation. If you are satisfied with the backup of your system disk, press Return. Otherwise, enter No to discontinue the installation. After you back up your system disk, you can restart the installation.
Please mount the first volume of the set on MUA0:. * Are you ready? YES %MOUNT-I-MOUNTED, FORT MOUNTED ON MUA0: The following products will be processed: FORT V6.n Beginning installation of FORT V6.n at 20:01 %VMSINSTAL-I-RESTORE, Restoring product saveset A...
The device name appears in the line preceding the question. VMSINSTAL then asks you if you are ready to continue with the installation.
If you respond Yes to indicate that you are ready, VMSINSTAL displays a message that the media containing Digital Fortran has been mounted on the specified device and that the installation has begun.
If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter No in response to the "Are you ready?" question. To abort the installation for other reasons, press Ctrl/Y.
Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]:
If you press Return (select option 2), VMSINSTAL sends the file to the default output print device unless you enter a different queue name:
* Queue name [SYS$PRINT]:
If you choose another option, the following occurs:
You are now asked the following question:
* Do you want to continue the installation [N]?: YES %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully moved to SYS$HELP.
To continue the installation, enter Yes. Otherwise, press Return. In either case, the text form of the release notes is copied to a file in the SYS$HELP directory. After installation, you can read these release notes (see Section 3.8).
* Do you want to purge files replaced by this installation [YES]?
The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE, SYS$SYSTEM, SYS$TEST and SYS$UPDATE may contain previous versions of Digital Fortran files. These files are replaced during the installation with new files, but the old files are not automatically purged. Purging is recommended. In response to the purging prompt, press Return to purge the files or enter No to keep them.
Select the components you want to install by answering Yes or No to the prompts. If you want a more detailed description of any component, enter a question mark (?). After the explanation is displayed, you will be prompted again for a response.
* Do you want to install the compiler [YES]?
The compiler component includes the Digital Fortran compiler, compiler message files, help text, installation verification procedure, post-installation procedure, deinstallation procedure, and command line definition.
If this is a new installation, you should select installation of the compiler component by pressing Return (or entering Yes). Choosing the compiler component automatically selects the Run- Time Library component as well; this is indicated by the message:
%FORT06n-I-RTLREQ, The Run-Time Library support will also be installed
If you do not want to install the compiler component, enter No. The the installation procedure will then ask:
* Do you want to install the Run-Time Library support [YES]?
If you have installed a new version of OpenVMS since the last time you installed Digital Fortran, or if you want to install the Run-Time Library support on a system where Digital Fortran programs will be run, press Return. If you do not wish to install the Run-Time Library support, enter No.
You are now asked the following:
* Do you want to create a new FORSYSDEF.TLB [YES]?
SYS$LIBRARY:FORSYSDEF.TLB is a library of OpenVMS system interface definitions that can be used by FORTRAN programs. FORSYSDEF.TLB is built from a master set of definitions that is provided with OpenVMS; it contains declarations of OpenVMS system services, Run-Time Library routines, structures, and constants.
Because FORSYSDEF.TLB is generated from OpenVMS definitions, you do not need to rebuild it unless this is a new installation or you have installed a new version of OpenVMS since the last time you installed Digital Fortran. (The installation procedure will make a recommendation on whether FORSYSDEF.TLB should be rebuilt.)
If you press Return, the installation procedure builds a new system definition file, FORSYSDEF.TLB, based on the system definitions for the version of OpenVMS installed on your system.
The installation procedure then displays the components you selected and displays the following prompt:
* Is this correct [YES]?
If you enter No, the installation procedure reissues the prompts for selecting components.
Product: FORTRAN Producer: Digital Version: 6.n Release Date: dd-mmm-yyyy
* Does this product have an authorization key registered and loaded?: YES
If you have not registered and loaded your PAK, you must answer No to this question; the installation will continue but the Installation Verification Procedure (IVP) will not run. To successfully complete the IVP, you must first register and load your PAK (see Section 1.5).
* Do you want to run the IVP after the installation [YES]?
The IVP for Digital Fortran checks that the installation is successful. It is recommended that you run the IVP.
After Digital Fortran is installed, you can run the IVP independently to verify that the software is available on your system (see Section 3.1). You might need to run the IVP after a system failure to make sure that users can access Digital Fortran.
The Digital Fortran kit includes enhancements that may not exist in your current version of the OpenVMS operating system. (See the release notes for information on these enhancements.)
If the installation procedure determines that the installing system's version of OpenVMS does not include the enhanced support, the existing Run-Time Library images are replaced with the new versions (equivalent to those provided by OpenVMS VAX Version 7.0).
The installation procedure displays informational text describing these changes; press Return when prompted, to view the next screen of text. After the information related to run-time library support has been displayed, the installation procedure asks if you want to continue the installation:
Do you want to continue with the installation (N)? YES
To continue with the installation, enter Yes.
At this point, the installation procedure displays a number of informational messages that report on the progress of the installation. There are no further questions. If the installation procedure has been successful up to this point, VMSINSTAL moves the new or modified files to their target directories, updates help files, and updates DCL tables, if necessary. The new and modified files consist of the following:
SYS$HELP:FORT06n.RELEASE_NOTES [new] SYS$HELP:FORT06n_RELEASE_NOTES.DECW$BOOK [new] SYS$HELP:FORT06n_RELEASE_NOTES.PS [new] SYS$HELP:FORTRAN$MSGHLP.MSGHLP$DATA [new] SYS$HELP:HELPLIB.HLB [modified] SYS$LIBRARY:DCLTABLES.EXE [modified] SYS$LIBRARY:FORDEF.FOR [new] SYS$LIBRARY:FORIOSDEF.FOR [new] SYS$LIBRARY:FORRTL.EXE [new] SYS$LIBRARY:FORSYSDEF.TLB [new] SYS$LIBRARY:FORTRAN$FORRTL-VMS.EXE [saved old file] SYS$LIBRARY:FORTRAN$MTHRTL-VMS.EXE [saved old file] SYS$LIBRARY:FORTRAN$UVMTHRTL-VMS.EXE [saved old file] SYS$LIBRARY:FORTRAN$VMTHRTL-VMS.EXE [saved old file] SYS$LIBRARY:MTHRTL.EXE [new] SYS$LIBRARY:STARLET.OLB [modified] SYS$LIBRARY:STARLETSD.TLB [modified] SYS$LIBRARY:UVMTHRTL.EXE [new] SYS$LIBRARY:VMSRTL.EXE [new] SYS$LIBRARY:VMTHRTL.EXE [new] SYS$MESSAGE:FORTRAN$COMPILER_MSG.EXE [new] SYS$MESSAGE:FORTRAN$DICTIONARY_MSG.EXE [new] SYS$SYSTEM:FORTRAN$MAIN.EXE [new] SYS$TEST:FORTRAN$IVP.COM [new] SYS$UPDATE:FORTRAN$DEINSTALL.COM [new] SYS$UPDATE:FORTRAN$POST_INSTALL.COM [new]
The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE files are updated to include the new versions of the Digital Fortran help text and the FORTRAN command line definition.
Also, if you answered Yes in response to the prompt that requests a file purge at step 6, previous versions of the Digital Fortran files are now purged.
The end of the installation is indicated by the following message:
%VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories...
Beginning Digital Fortran Installation Verification Procedure Compiler image identification is FORT V6.n-eee Test compiler operation and error messages... Compile, link, and run program with parallel processing features... Test FORSYSDEF.TLB system definitions... Test I/O and Run-Time Library operation...
If Digital Fortran was installed successfully, the IVP displays the following:
Digital Fortran V6.n-eee IVP PASSED End of Digital Fortran Installation Verification Procedure
Installation of FORT V6.n completed at hh:mm VMSINSTAL procedure done at hh:mm $
If you installed the compiler component, proceed to Chapter 3 to perform necessary post-installation tasks. Otherwise, you can choose to install more products or to log out.
VMSINSTAL deletes or changes entries in the process symbol tables during the installation. So, if you are going to continue using the system manager's account and you want to restore these symbols, you should log out and log in again.
If the installation fails, you see the following message:
%VMSINSTAL-E-INSFAIL, The installation of Digital Fortran V6.n has failed.
If the IVP fails, you see these messages:
The FORT V6.n Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for FORT V6.n has failed.
If the installation fails, you must restart the installation procedure from step 2. If the installation fails due to an IVP failure, contact a Digital field service representative.
Errors can occur during the installation if any of the following conditions occur:
For descriptions of the error messages generated by these conditions, see the OpenVMS documentation on system messages, recovery procedures, and OpenVMS software installation; or use the online HELP/MESSAGE command. Take the appropriate action described in the message.
For information on system requirements for installing Digital Fortran, see Section 1.6.
To report a problem to Digital, see Section 3.11.
Copyright © 1996, Digital Equipment Corporation -- All rights reserved.