| Previous | Contents |
The following tasks can be performed after Compaq Fortran is installed:
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 |
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:
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. |
$ 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
|
SYSMAN> DO @SYS$STARTUP:FORT$STARTUP %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 |
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 |
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.
| 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).
| 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 |
| 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 |
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:
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 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.
| 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 | |
| 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 |