The following tasks can be performed after Compaq Fortran is installed:

• Running the Installation Verification Procedure (IVP) separately ( Section 3.1)
• Modifying the system-wide startup command procedure ( Section 3.2)
• Making the product usable on a VMScluster ( Section 3.3)
• Making the recently installed FORTRAN command available to users after installation ( Section 3.4)
• Setting user account quotas ( Section 3.5)
• Enhancing performance ( Section 3.6)
• OpenVMS upgrade issues ( Section 3.7)
• Removing Compaq Fortran ( Section 3.8)
• Troubleshooting tips ( Section 3.9)
• Getting help and reporting problems ( Section 3.10)

The Compaq Fortran Installation Verification Procedure (IVP) runs automatically during Compaq 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:

Compaq Fortran Version 7.n TEST FAILED

3.2 Modifying the System-Wide Startup Command Procedure

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 Compaq Fortran images in memory and performs related actions.

3.3 VMScluster Considerations

If you want to run Compaq 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 Compaq 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 Compaq 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 use Compaq Fortran; failure to do so may cause unexpected errors for users.

   Note If you are using a dual-architecture (VAX® and Alpha systems) heterogeneous cluster, before executing these 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 System Manager's Manual.

   
   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.

3. The SYS$STARTUP:FORT$STARTUP.COM file installs the compilers as a known image. This command procedure file should be executed on all cluster nodes using the following DO command:

   SYSMAN> DO @SYS$STARTUP:FORT$STARTUP %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2

4. Finally, exit from SYSMAN.

   SYSMAN> EXIT $

Compaq 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 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 command must log out and log in again, or use the following DCL command:

$ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES

3.5 User Account Requirements

No special privileges are needed to use Compaq Fortran. There is no benefit from installing the compilers with privileges.

To use Compaq 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.

3.6 Enhancing Compaq Fortran Performance

This section includes information on system tuning and explains how to install Compaq Fortran as a shared image.

After you install Compaq 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:

• Check that adequate page file space exists. Large programs need more virtual memory during compilation and execution than small programs. Use the INSTALL command to extend an existing page file or create one or more new page files.
• The SYSGEN parameter virtual page count is related to the total amount of page file space. If you create more page file space, review the virtual page count parameter and increase it if necessary.
• The SYSGEN parameter maximum working set (WSMAX) might also be checked if a larger process working set is needed.

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.

3.7 OpenVMS Upgrade Issues

You should always use the most recent version of the Compaq Fortran Run-Time Library available. When you preparing for an upgrade of the OpenVMS operating system, be aware that the Compaq Fortran Run-Time Library ships with the OpenVMS operating system. This means that an OpenVMS upgrade can install an older version of the Compaq Fortran Run-Time Library, which is shared by Compaq Fortran and Compaq Fortran 77.

The Run-Time Library provided with Compaq Fortran Version 7.2 contains changes that are not included in the version provided with OpenVMS Alpha Version 7.2 and earlier; these changes will be included in a future version after OpenVMS Alpha Version 7.2.

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 Compaq 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 Compaq 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.

3.8 Removing Compaq Fortran

To remove Compaq 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:

• It will not affect the Fortran Run-Time Library on the system.
• It will remove a separate copy that is used by FOR$INSTALL_FORRTL to replace the Run-Time Library after OpenVMS upgrades.

If your installation is not successful, check for the following possible problems:

• The appropriate PAK must be available to the user performing the installation. The PAK must be registered and loaded before you can install Compaq Fortran. For information about registering a PAK, see Section 1.3. Then reinstall Compaq Fortran.
• The DCLTABLES.EXE file should be in the SYS$COMMON:[SYSLIB] directory. There should not be a copy of DCLTABLES.EXE in SYS$SPECIFIC:[SYSLIB].
  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 Compaq Fortran.
• The system logical name SYS$SYSROOT should not be modified from the preset definition provided by the OpenVMS Alpha operating system.

If you encounter a problem while using Compaq Fortran, report it to Compaq.

If an error occurs while Compaq Fortran is in use and you believe the error is caused by a problem with Compaq Fortran, take one of the following actions:

• If you have a Software Product Services Support Agreement, consider contacting your Customer Support Center (CSC) by telephone (in the United States, 1-800-354-9000) or by using the electronic means provided with your support agreement. You can use DSNlink or other electronic means to report the problem to the CSC.
• Customers without a service contract can arrange for per-call CSC support.

When you initially contact the CSC, please indicate the following:

• The name and version number of the operating system (OpenVMS Alpha) you are using
• The name (Compaq Fortran) and version number of Compaq Fortran you are using
• The hardware system you are using (such as a model number)
• How critical the problem is
• A very brief description of the problem (one sentence if possible)

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 Compaq give accurate and timely service to software problems.

To obtain information about purchasing Compaq support services, please contact your local sales representative.

You may also send comments and questions about the Compaq Fortran product to the following Internet mail address: fortran@compaq.com.

Previous

Contents

Contents