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)
• Removing Compaq Fortran ( Section 3.7)
• CXML Post-Installation Startup Options ( 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. Similarly, the Compaq Extended Math Library (CXML) IVP runs during CXML installation.

If system problems occur, you should run the Compaq Fortran 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

Similarly, you can run the CXML IVP after installation, or at other times, to ensure the integrity of installed files if system problems have occurred. You need system privileges to run the CXML IVP. To run the CXML IVP, execute the following command procedure:

$ @SYS$TEST:CXML_IVP.COM

If the IVP runs successfully, you will see the following display:

CXML-I-IVP> Completed CXML Vnnnn Installation Verification Procedure

3.2 Modifying the System-Wide Startup Command Procedure

Add the following lines to the system-wide startup file (if you have not done so previously), such as the file SYS$MANAGER:SYSTARTUP_VMS.COM or a command procedure that it invokes:

$ @SYS$STARTUP:FORT$STARTUP $ @SYS$STARTUP:CXML$STARTUP

These command procedures install Compaq Fortran and CXML images in memory and perform related actions.

The Fortran startup procedure line does not take any parameters (arguments).

The CXML startup procedure line lets you specify certain parameters to:

• Control the default CXML link library
• Specify names of CXML shareable images to be installed as shared images
• Specify names of CXML shareable images to be installed as resident images

Among other things, inserting this line in the startup procedure makes the correct CXML library available automatically, eliminating the need for the user to explicitly specify the CXML link library on the LINK command line.

In addition, individual users can select a user-specific default CXML link library, by executing the SYS$LIBRARY:CXML$SET_LIB command procedure.

For more information on the CXML startup procedure arguments and specifying a user-specific default CXML link library, see Section 3.8.

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 shareable images 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 SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DPML$SHR.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2

   
   If any of the INSTALL commands fail, reboot the affected node.
   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 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. Compaq recommends that you answer NO to this prompt.

After removing Compaq Fortran from the system, remove the call to SYS$STARTUP:FORT$STARTUP.COM from your system startup procedure.

To remove Compaq Extended Math Library from the system, use the following command:

$ PRODUCT REMOVE CXML

After removing Compaq Extended Math Library from the system, remove the call to SYS$STARTUP:CXML$STARTUP.COM from your system startup procedure.

3.8 CXML Post-Installation Startup Options

As part of the post-installation process described in Section 3.2, you need to add the following line to your system's startup procedure:

@SYS$STARTUP:CXML$STARTUP

Among other things, inserting this line in the startup procedure will make the correct CXML library available automatically, eliminating the need for the user to explicitly specify the CXML link library on the LINK command line.

In addition, individual users can select a user-specific default CXML link library, by executing the SYS$LIBRARY:CXML$SET_LIB command procedure, as described in Section 3.8.2.

This command procedure has three system-wide default parameters, which you can optionally change (as described below). The default parameters control the following things:

• The first parameter sets the default CXML link library. Its default value is "IEEE".
• The second parameter is a list of the names of CXML shareable images to be installed as shared images. Its default value is " " (none).
• The third parameter is a list of the names of CXML shareable images to be installed as resident images. Its default value is " " (none).

If the default parameter values described above are acceptable, you can skip the rest of this step.

If you want to change any of these parameters, use the following instructions.

3.8.1 Setting CXML System-Wide Parameters

First parameter---controls the default CXML link library. If it has the value "IEEE", the library of routines using IEEE floating-point format will be designated as the default CXML link library. If its value is "VAX", the library of VAX floating-point format routines will be designated as the default CXML link library. The default value of this first parameter is "IEEE". If it does not have the value "VAX" or "IEEE", an error message will be given.

Second parameter---a list of the names of CXML shareable images to be installed as shared images. Its default value is "". Allowable names in this list are described in the following table.

Third parameter---a list of the names of CXML shareable images to be installed as resident images. Its default value is "". Allowable names in this list are described Table 3-1.

Table 3-1 Allowable names for the Second and Third CXML Startup Line Parameters

IEEE_BLAS1	VAX_BLAS1
IEEE_BLAS1E	VAX_BLAS1E
IEEE_BLAS2	VAX_BLAS2
IEEE_BLAS3	VAX_BLAS3
IEEE_COMMON	VAX_COMMON
IEEE_LAPACK	VAX_LAPACK
IEEE_SIG_PROC	VAX_SIG_PROC
IEEE_SPARSE	VAX_SPARSE
IEEE_VLIB	VAX_VLIB

The list entries are not case sensitive. If more than one name appears in a list, the names are separated by commas. The list may contain only the above names and comma(s). If a CXML shareable image name appears in both lists, it will be installed as a shared image.

For example, the following command will set the default CXML link library to be the one using IEEE floating-point format and will install the IEEE-format COMMON shareable image along with all the IEEE-format BLAS shareable images as resident images. No other CXML shareable images will be installed.

$ @SYS$STARTUP:CXML$STARTUP IEEE "" - $_ IEEE_BLAS1,IEEE_BLAS1E,IEEE_BLAS2,IEEE_BLAS3,IEEE_COMMON

To install CXML images, your system must have sufficient resources available. Refer to the following tables to obtain the total number of global resources required.

If you are installing images as a /SHARED resource, add all relevant entries under the columns "GBLPAGES" and "GBLSECTIONS". Then check that your system is configured with a sufficient number of free global pages and free global sections to accomodate the images to be installed.

If you are installing images as /RESIDENT resources, add all relevant entries under the column "GH_RSRVPGCNT". Check that your system has sufficient free pages in the resident image code area of the granularity hint region (see Table 3-2 and Table 3-3).

Table 3-2 Global System Resoures For Installed Images---IEEE Format

Image Name	GBLPAGES	GBLSECTIONS	GH_RSRVPGCNT
CXML$STS_BLAS1	160	1	8
CXML$STS_BLAS1E	192	1	10
CXML$STS_BLAS2	2224	1	127
CXML$STS_BLAS3	3488	2	213
CXML$STS_COMMON	96	2	1
CXML$STS_LAPACK	7584	2	469
CXML$STS_SIG_PROC	7904	2	489
CXML$STS_SPARSE	1856	1	114
CXML$STS_VLIB	112	2	2

Table 3-3 Global System Resoures For Installed Images---VAX Format

Image Name	GBLPAGES	GBLSECTIONS	GH_RSRVPGCNT
CXML$FGS_BLAS1	160	1	8
CXML$FGS_BLAS1E	192	1	10
CXML$FGS_BLAS2	2224	1	127
CXML$FGS_BLAS3	3488	2	213
CXML$FGS_COMMON	96	2	1
CXML$FGS_LAPACK	7568	2	468
CXML$FGS_SIG_PROC	7904	2	489
CXML$FGS_SPARSE	1856	1	114
CXML$FGS_VLIB	112	2	2

3.8.2 Select a User-Specific Default CXML Link Library

Individual users can change the CXML link library by changed by invoking SYS$LIBRARY:CXML$SET_LIB from their process.

The system-wide default CXML link library is set using the system startup file SYS$STARTUP:CXML$STARTUP, as described in Section 3.8.1. In addition, individual users may change their own specific default library by invoking SYS$LIBRARY:CXML$SET_LIB themselves. For example, the following command alters the default CXML link library for the current user to the VAX format library:

$ @SYS$LIBRARY:CXML$SET_LIB VAX

For information on using CXML, refer to the Compaq Extended Math Library Reference Guide. Refer also to the Web site http://www.compaq.com/math/ .

3.9 Troubleshooting Tips

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.