The following tasks can be performed after DIGITAL Fortran is installed:
The DIGITAL Fortran Installation Verification Procedure (IVP) runs automatically during DIGITAL Fortran installation.
If system problems occur, you should run the IVP separately to ensure the integrity of the installed files. To run the IVP, type the following command:
$ @SYS$TEST:FORT$IVP.COM
If any problems are encountered, a message such as the following appears:
DIGITAL Fortran Version 7.n TEST FAILED
Add the following line to the system-wide startup file, such as the file SYS$MANAGER:SYSTARTUP_VMS.COM or a command procedure that it invokes:
$ @SYS$STARTUP:FORT$STARTUP
This command procedure installs DIGITAL Fortran images in memory and performs related actions.
If you want to run DIGITAL Fortran on multiple nodes of a VMScluster, first check to see that you have the appropriate software license (see Section 1.3). Then perform the following steps after you install DIGITAL Fortran:
While logged in as SYSTEM, or as another username that has the CMKRNL and SYSPRV privileges enabled, use the OpenVMS SYSMAN utility to make the new versions of DCLTABLES.EXE and DEC$FORRTL.EXE available, as follows:
$ RUN SYS$SYSTEM:SYSMAN
SYSMAN> SET ENVIRONMENT/CLUSTER
%SYSMAN-I-ENV, current command environment:
Clusterwide on local cluster
Username SYSTEM will be used on nonlocal nodes
SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE
%SYSMAN-I-OUTPUT, command execution on node NODE1
%SYSMAN-I-OUTPUT, command execution on node NODE2
SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DEC$FORRTL.EXE
%SYSMAN-I-OUTPUT, command execution on node NODE1
%SYSMAN-I-OUTPUT, command execution on node NODE2
The SYSMAN utility will cause each DO command to be executed on all nodes of the local cluster.
SYSMAN> DO @SYS$STARTUP:FORT$STARTUP %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2
SYSMAN> EXIT $
DIGITAL Fortran is now installed and can be invoked by all users with the FORTRAN and F90 commands.
The installation procedure modifies the DCL command table so that the FORTRAN and F90 commands are 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 or F90 commands must log out and log in again, or use the following DCL command:
$ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES
No special privileges are needed to use DIGITAL Fortran. There is no benefit from installing the compilers with privileges.
To use DIGITAL Fortran, a user account does not need to meet any special quota requirements. However, for users who will be compiling very large programs (many program units compiled together) or running very large performance- critical programs, consider the adjusting 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 the user authorization file (UAF). Some sites may restrict the use of the Authorize Utility to certain accounts or people.
After the quotas for the account have been changed, the user should log out of the account and log in again for the new quotas to take effect.
For information on using the Authorize Utility, see the OpenVMS System Manager's Manual: Essentials.
This section includes information on system tuning and explains how to install DIGITAL Fortran as a shared image.
After you install DIGITAL Fortran, you might want to adjust your system to enhance performance or lower the use of some system resources.
If users will be compiling very large programs (many program units compiled together) or running very large performance-critical programs, consider the following:
For more information on page file use and SYSGEN parameters, see the OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems. For information about system tuning and performance investigation, see the Guide to OpenVMS Performance Management.
You should always use the most recent version of the DIGITAL Fortran Run-Time Library available. When you preparing for an upgrade of the OpenVMS operating system, be aware that the DIGITAL Fortran Run-Time Library ships with the OpenVMS operating system. This means that an OpenVMS upgrade can install an older version of the DIGITAL Fortran Run-Time Library, which is shared by DEC Fortran and DIGITAL Fortran.
The Run-Time Library provided with DIGITAL Fortran Version 7.0 contains changes that are not included in the version provided with OpenVMS Alpha Version 7.0 and earlier; these changes will be included in a future version after OpenVMS Alpha Version 7.0.
In the future, if you install a version of OpenVMS that does not include the updated Fortran Run-Time Library support, the OpenVMS installation may overwrite the Run-Time Library supplied with DIGITAL Fortran with an earlier version. Therefore, after each installation of a new OpenVMS version, the system manager must execute the following command:
$ @SYS$UPDATE:FOR$INSTALL_FORRTL
This command restores the DIGITAL Fortran version of the Fortran Run-Time Library if it is newer than the version supplied by the OpenVMS Alpha operating system. If the OpenVMS version is newer, the procedure will not overwrite it.
To remove DIGITAL Fortran from the system, use the following command:
$ PRODUCT REMOVE FORTRAN
You may be asked if you would like to also remove the FORRTL product. It is safe to answer YES to this prompt:
If your installation is not successful, check for the following possible problems:
If a copy of DCLTABLES.EXE is found in a SYS$SPECIFIC root, rename it to DCLTABLES.OLD, do an INSTALL REPLACE SYS$LIBRARY:DCLTABLES, then reinstall DIGITAL Fortran.
If you encounter a problem while using DIGITAL Fortran, report it to DIGITAL.
If an error occurs while DIGITAL Fortran is in use and you believe the error is caused by a problem with DIGITAL Fortran, take one of the following actions:
When you initially contact the CSC, please indicate the following:
When you submit information electronically or are speaking on the phone to the appropriate support specialist, you can provide more detailed information. This includes the specific commands used to compile and link the program, the error messages displayed, and relevant detailed information (possibly including source program listings). Please try to narrow the cause of the problem to a specific source module or lines of code.
CSC personnel may ask for additional information, such as listings of any command files, INCLUDE files, relevant data files, and so forth. If the program is longer than 50 lines, submit a copy of it electronically or provide machine-readable media (floppy diskette or magnetic tape).
Experience shows that problem reports sometimes do not contain enough information to duplicate or identify the problem. Concise, complete information helps DIGITAL give accurate and timely service to software problems.
To obtain information about purchasing DIGITAL support services, please contact your local DIGITAL sales representative.
You may also send comments and questions about the DIGITAL Fortran product to the following Internet mail address: fortran@digital.com.