Compaq Fortran
Installation Guide for
OpenVMS Alpha Systems


Previous Contents


Chapter 3
After Installing Compaq Fortran

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

3.1 Running the Installation Verification Procedure Separately

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:

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
    $ 
    

3.4 Making the FORTRAN Command Available After Installation

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:

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:

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:

3.10 Getting Help and Reporting Problems

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:

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


Appendix A
Compaq Fortran and CXML Files

Appendix A lists the Compaq Fortran and CXML files that the installation procedure writes on your system in Table A-1 and Table A-2. Note that not all files may be installed because of options selected or OpenVMS version.

Table A-1 Files Installed by the Compaq Fortran Kit
FORTRAN
SYS$SYSTEM:  
F90$MAIN.EXE Fortran 90/95 compiler
FORT$MAIN.EXE Fortran 77 compiler
FORT$FSPLIT.EXE FSPLIT utility
   
SYS$LIBRARY:  
FORSYSDEF.TLB  
FORT$FORTRAN-F77.CLD Defines FORTRAN as Fortran 77
FORT$FORTRAN-F95.CLD Defines FORTRAN as Fortran 95
   
SYS$MESSAGE:  
F90$MSG.EXE  
FORT$MSG.EXE  
FORT$MSG2.EXE  
   
SYS$TEST:  
FORT$IVP.COM  
   
SYS$HELP:  
FORTRAN.RELEASE_NOTES  
FORTRAN_RELEASE_NOTES.PS  
   
SYS$STARTUP:  
FORT$STARTUP.COM  
   
FORRTL
SYS$LIBRARY:  
STARLET.OLB (updated)  
DEC$FORRTL.EXE  
DPML$SHR.EXE  
FORDEF.FOR  
FORIOSDEF.FOR  
   
SYS$HELP:  
FORRTL.RELEASE_NOTES  
   
ADX072
SYS$HELP:  
DBG$HELP_V72X.HLB  
DBG$UIHELP_V72X.HLB  
   
SYS$MESSAGE:  
DBGTBKMSG_V72X.EXE  
   
SYS$LIBRARY:  
CS_IN_DEBUG.CLD  
CS_OUT_DEBUG.CLD  
DEBUG_V72X.EXE  
DEBUGSHR_V72X.EXE  
TRACE.EXE  
DEBUGSRVSHR_V72X.EXE  
DEBUGUISHR_V72X.EXE  
VMSDEBUGUIL_V72X.UID  
DBG$HA_V72X.UID  
DBG$HA_KERNEL_V72X.EXE  
DBG$HA_MAIN_V72X.EXE  
LIBRTL_INSTRUMENTED.EXE  
   
SYS$SYSTEM:  
LINKER64.EXE  
   
SYS$UPDATE:  
DBGKITUNINSTAL.COM  
   
SYS$STARTUP:  
DEBUGSETUP.COM  
DEBUG$STARTUP_V72X.COM  
   
SYS$TEST:  
DBG$IVP.COM  
DBG$DW$IVP.COM  
DBG_IVP IVP_IMAGE.PAS  
DBG_IVP IVP_IMAGE.EXE  
DBG_IVP IVP_SCRIPT.TST  
DBG_IVP IVP_SCRIPT.OUT_OLD  
   
DECW$SYSTEM_DEFAULTS:  
VMSDEBUG_V72X.DAT  
   

Table A-2 Files Installed by the CXML Kit
CXML
SYS$STARTUP.COM  
CXML$STARTUP.COM Startup command procedure
   
SYS$HELP  
CXML_V359_RELEASE_NOTES.TXT Online release notes
CXML_LAPACK_C.TXT  
CXML_LAPACK_D.TXT  
CXML_LAPACK_S.TXT  
CXML_LAPACK_Z.TXT  
CXMLREF_VMS.PDF CXML Reference Manual --- online
CXMLREF_VMS.PS CXML Reference Manual --- hardcopy
   
SYS$TEST  
CXML$IVP.COM IVP command procedure
   
SYS$LIBRARY  
CXML$FGS.OLB CXML routines --- VAX Floating-point
CXML$FGS_BLAS1.EXE  
CXML$FGS_BLAS1E.EXE  
CXML$FGS_BLAS2.EXE  
CXML$FGS_BLAS3.EXE  
CXML$FGS_COMMON.EXE  
CXML$FGS_LAPACK.EXE  
CXML$FGS_SIG_PROC.EXE  
CXML$FGS_SPARSE.EXE  
CXML$FGS_VLIB.EXE  
   
CXML$STS.OLB CXML routines --- IEEE Floating-point
CXML$STS_BLAS1.EXE  
CXML$STS_BLAS1E.EXE  
CXML$STS_BLAS2.EXE  
CXML$STS_BLAS3.EXE  
CXML$STS_COMMON.EXE  
CXML$STS_LAPACK.EXE  
CXML$STS_SIG_PROC.EXE  
CXML$STS_SPARSE.EXE  
CXML$STS_VLIB.EXE  
CXMLDEF.FOR and DXMLDEF.FOR Definition file for signal processing
CXMLDEF.H and DXMLDEF.H Definition file for signal processing
CXML_EQUIVALENCE_LAPACK.C LINPACK/LAPACK names conversion program
CXML$EMACS.ML Editor support
CXML$EVE.TPU  
CXML$IMAGELIB_GS.OLB VAX Floating-point library
CXML$IMAGELIB_TS.OLB IEEE Floating-point library
CXML$SET_LIB.COM Library selection procedure
   
SYS$COMMON:[SYSTEST.CXML]  
BLAS_BUILD_TEST.OBJ  
IVP_LAPACK_VAX.OBJ  
IVP_LAPACK_IEEE.OBJ  
IVP_SIG_VAX.OBJ  
IVP_SIG_IEEE.OBJ  
IVP_SPARSE_B1_VAX.OBJ  
IVP_SPARSE_B1_IEEE.OBJ  
IVP_SPARSE_IS_VAX.OBJ  
IVP_SPARSE_IS_IEEE.OBJ  
IVP_SPARSE_SKY_VAX.OBJ  
IVP_SPARSE_SKY_IEEE.OBJ  
IVP_VLIB_VAX.OBJ  
IVP_VLIB_IEEE.OBJ  
LAPACK_BUILD_TEST.OBJ  
SIG_PROC_BUILD_TEST.OBJ  
SPARSE_BUILD_TEST.OBJ  
VLIB_BUILD_TEST.OBJ  
   
SYS$COMMON:[SYSHLP.EXAMPLES.CXML]  
EXAMPLE_ITSOL_1.C  
EXAMPLE_ITSOL_1.CXX  
EXAMPLE_ITSOL_1.FOR  
EXAMPLE_ITSOL_2.FOR  
EXAMPLE_ITSOL_3.FOR  
EXAMPLE_ITSOL_4.FOR  
EXAMPLE_ITSOL_5.FOR  
EXAMPLE_LAPACK_1.C  
EXAMPLE_LAPACK_1.FOR  
EXAMPLE_LAPACK_2.FOR  
EXAMPLE_SFFT_1D_2.C  
EXAMPLE_SFFT_2D_2.C  
EXAMPLE_SKYSOL_1.C  
EXAMPLE_SKYSOL_1.CXX  
EXAMPLE_SKYSOL_1.FOR  
EXAMPLE_SKYSOL_2.FOR  
EXAMPLE_SKYSOL_3.FOR  
EXAMPLE_SKYSOL_4.FOR  
EXAMPLES_SIG_PROC.FOR  
READ_ME.INDEX Road map for the examples


Previous Contents