| Previous | Contents |
This section explains the installation procedure prompts and displays.
Examples in this section use generic version numbers, such as
"Vn.n" or (in subset identifiers)
"nnn". During installation, the actual version
numbers will appear on your screen.
2.2.1 Selecting Compaq Fortran Subsets
After you mount the media CD-ROM (for a local installation) and use setld to load and identify where the Compaq Fortran subsets are located, specify which Compaq Fortran subsets you want to load.
The sample installation in this section shows Version 5.n subset numbers and the CD-ROM subset directory /mnt/dfannn/kit (where the Compaq Fortran subsets are located on the locally mounted media CD-ROM).
When installing a version after Version 5.n, the displayed numbers for the subsets, version, and subset directory will differ.
The subset numbers are listed in the online release notes (see Section 1.1).
If you are installing from a RIS distribution area, the numbers of the Compaq Fortran subsets can vary depending on what products are available in the RIS area and how many subsets they have. |
The subsets listed below are optional:
There may be more optional subsets than can be presented on a single
screen. If this is the case, you can choose subsets screen by screen
or all at once on the last screen. All of the choices you make will
be collected for your confirmation before any subsets are installed.
1) CXML Common Files for the Extended Math Lib, Vn.n
2) CXML Extended Math Libraries (Serial and Parallel) for Ev4, Vn.n
3) CXML Extended Math Libraries (Serial and Parallel) for Ev5, Vn.n
4) CXML Extended Math Libraries (Serial and Parallel) for Ev6, Vn.n
5) CXML Reference (man)Pages
6) CXML Reference (man)Pages in HTML format
7) CXML Vn.n SCIPORT library
8) Compaq Compiled Code Support Library #nnn
9) Compaq Fortran 90 and 77 Vn.n for Compaq Tru64 UNIX Alpha Systems
10) Compaq Fortran RTL #nnn for Compaq Tru64 UNIX Alpha Systems (f90 and f77
11) Compaq Fortran Vn.n Release Notes and Man Page
12) Compaq Fortran Vn.n Tools & their Man Pages
13) High Performance Fortran Runtime Libraries
Or you may choose one of the following options:
14) ALL of the above
15) CANCEL selections and redisplay menus
16) EXIT without installing any subsets
Enter your choices or press RETURN to redisplay menus.
Choices (for example, 1 2 4-6): 1,3,5-13
|
The actual display shown on your system might not include certain lines if you have a recent version of Compaq Fortran 77 or Compaq Fortran installed. For example, if the same version of the "Compaq Fortran RTL #nnn for Tru64 UNIX Alpha" (subset DFARTL) on the Compaq Fortran kit has already been installed, that line will not be displayed. The following text in this section assumes this is a new installation.
To compile and run Fortran 77 programs using the Compaq Fortran 77 tools, you must choose subset numbers 2, 3, and 5.
To compile and run Fortran programs using the Compaq Fortran tools, you must choose subset numbers 2, 3, 5, and 13.
To use parallel directives for either set of tools, you must also choose subset number 1.
To use the Compaq Extended Math Library, you must also choose subset numbers 1, 3, 6 and one or more of the following: 7, 8, or 9. The other numbers are optional.
To install only the online release notes without installing Compaq Fortran, choose subset number 4.
If you specify more than one number at the prompt, use spaces (not commas) to separate the numbers. Enter 14 to install all of the listed subsets.
The "Compaq Compiled Code Support Library" (OTABASE subset) is once again provided on the Compaq Fortran kit. This subset contains libraries required to support parallel directives. If a newer version of these libraries already exists on you system, the installation will not override them. |
Next, the procedure lets you verify your choice. For example, if you enter 14 in response to the previous prompt, the following display appears:
You are installing the following optional subsets:
CXML Common Files for the Extended Math Lib, Vn.n
CXML Extended Math Libraries (Serial and Parallel) for Ev4, Vn.n
CXML Extended Math Libraries (Serial and Parallel) for Ev5, Vn.n
CXML Extended Math Libraries (Serial and Parallel) for Ev6, Vn.n
CXML Reference (man)Pages
CXML Reference (man)Pages in HTML format
CXML Vn.n SCIPORT library
Compaq Compiled Code Support Library #nnn
Compaq Fortran 90 and 77 Vn.n for Compaq Tru64 UNIX Alpha Systems
Compaq Fortran RTL #nnn for Compaq Tru64 UNIX Alpha Systems (f90 and f77
Compaq Fortran Vn.n Release Notes and Man Page
Compaq Fortran Vn.n Tools & their Man Pages
High Performance Fortran Runtime Libraries
Is this correct? (y/n):
|
If the displayed subsets are not the ones you intended to choose, enter n . In this case, the subset selection menu is again displayed, and you can correct your choice of optional subsets.
If the displayed subsets are the ones you want to load, enter
y
.
2.2.2 Monitoring Displays During the Subset Loading Process
The installation procedure loads and verifies the selected Compaq Fortran subsets.
If you install the Compaq Extended Math Library (CXML), the installation procedure asks several questions that you must be able to answer pertaining to choices of subsets, libraries, and names of libraries. This section provides information that will help you to answer these questions.
When installing the Compaq Extended Math Library, you must install a minimum of the following subsets:
CXML Extended Math Libraries (Serial and Parallel) for Ev4 (XMDLIB4xxx)
CXML Extended Math Libraries (Serial and Parallel) for Ev5 (XMDLIB5xxx)
CXML Extended Math Libraries (Serial and Parallel) for Ev6 (XMDLIB6xxx)
Optionally, you can also install one or more of the following:
Note about XMDLIB4xxx, XMDLIB5xxx, XMDLIB6xxx
Each of these subsets is specially tuned for one family of Alpha processors (21064, 21164, 21264). Typically, you should install only one of these subsets. However, any number of these subsets can be installed. For best performance, we highly recommend that you install the subset that matches your platform's processor type.
All three subsets contain both the serial and the parallel CXML libraries. Each subset contains the serial CXML library in archive and shared library form (libcxml.a, libcxml.so). Each also contains the parallel CXML library in both archive and shared library form (libcxmlp.a, libcxmlp.so).
If you select a subset that does not match your platform's hardware, the installation procedure will verify that you want to continue to install that subset.
By default, both the serial and the parallel CXML libraries will be installed. You can choose to install only the serial CXML or only the parallel CXML library.
By default, both shared and archive CXML libraries will be installed. You can choose to install only shared libs, e.g. libcxml.so, or only archive libs, e.g. libcxml.a.
If you install an XMDLIBjnnn subset that matches the platform, the installation procedure will construct the CXML libraries you selected with names that show the platform explicitly (e.g. libcxml_ev5.so). It will also construct symbolic links from /usr/lib or /usr/shlib to the selected libraries.
By default, this installation will also construct symbolic links from the standard CXML library names (e.g., /usr/shlib/libcxml.so) to your selected libraries, unless you select not to use standard names.
If you install an XMDLIBjnnn subset that does not match the platform, the installation procedure will ask you if you want the CXML libraries you are currently installing to have the standard CXML library names (e.g. /usr/shlib/libcxml.so), as well as the platform-specific names.
The following example shows a display where all Compaq Fortran Version 5.3 subsets, the CXML EV5 library subset, and the other non-library CXML subsets (Common, manpages, manpages in html, and sciport) are being loaded from the media CD-ROM:
Checking file system space required to install selected subsets:
File system space checked OK.
11 subset(s) will be installed.
Loading 1 of 11 subset(s)....
**************************************************************************
* *
* Copyright Compaq Computer Corporation 1993,1999. All rights reserved. *
* *
**************************************************************************
Compaq Extended Math Library V3.6 for Tru64 UNIX
Common Files Subset XMDCOMnnn
The common CXML files will be installed.
CXML Common Files for the Extended Math Lib, V3.6
Copying from . (disk)
Verifying
Loading 2 of 11 subset(s)....
*************************************************************************
* *
*Copyright Compaq Computer Corporation 1993,1999. All rights reserved.*
* *
*************************************************************************
Deleting obsolete versions of CXML HTML manpages
Completed deleting obsolete versions of CXML HTML manpages
CXML Reference (man)Pages in HTML format
Copying from . (disk)
Verifying
Loading 3 of 11 subset(s)....
***************************************************************************
* *
* Copyright Compaq Computer Corporation 1993,1999. All rights reserved. *
* *
***************************************************************************
Compaq Extended Math Library Vn.n for Tru64 UNIX
CXML Serial and Parallel libraries, tuned for EV5
CXML Extended Math Libraries (Serial and Parallel) for Ev5, Vn.n
Copying from . (disk)
Verifying
Loading 4 of 11 subset(s)....
**************************************************************************
* *
*Copyright Compaq Computer Corporation 1993,1999. All rights reserved. *
* *
**************************************************************************
Deleting obsolete versions of CXML manpages
Completed deleting obsolete versions of CXML manpages
CXML Reference (man)Pages
Copying from . (disk)
Verifying
Loading 5 of 11 subset(s)....
**********************************************************************
* *
* Copyright Compaq Computer Corporation 1999. All rights reserved. *
* *
**********************************************************************
CXML Vn.n SCIPORT library for Tru64 UNIX
CXML Vn.n SCIPORT library
Copying from . (disk)
Verifying
Loading 6 of 11 subset(s)....
Installation of this subset proceeds automatically, and should complete
in approximately 1 minute.
Compaq Compiled Code Support Library #nnn
Copying from . (disk)
Verifying
Loading 7 of 11 subset(s)....
Copyright (c) Digital Equipment Corporation, 1995, 1998. All Rights Reserved.
High Performance Fortran Runtime Libraries Vn.n-n for DIGITAL UNIX Alpha Systems
Subset: High Performance Fortran Runtime Libraries (HPFLIBSnnn)
Starting installation at Mon Nov 15 11:58:12 EST 1999.
Installation of this subset proceeds automatically, and should complete
in approximately 1 minute.
There are no installation questions for this subset.
High Performance Fortran Runtime Libraries
Copying from . (disk)
Verifying
Loading 8 of 11 subset(s)....
Installation of this subset proceeds automatically, and should complete
in approximately 1 minute.
Compaq Fortran RTL #nnn for Compaq Tru64 UNIX Alpha Systems (f90 and f77)
Copying from . (disk)
Verifying
Loading 9 of 11 subset(s)....
Installation of this subset proceeds automatically, and should complete
in approximately 1 minute.
Copyright Digital Equipment Corporation 1992,1999. All rights reserved
Restricted Rights: Use, duplication, or disclosure by the U.S. Government is
subject to restrictions as set forth in subparagraph (c) (1) (ii) of
DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as
applicable.
This software is proprietary to and embodies the confidential technology of
Digital Equipment Corporation. Possession, use, or copying of this software
and media is authorized only pursuant to a valid written license from DIGITAL
or an authorized sublicensor.
Compaq Fortran 90 and 77 Vn.n for Compaq Tru64 UNIX Alpha Systems
Copying from . (disk)
Verifying
Loading 10 of 11 subset(s)....
Installation of this subset proceeds automatically, and should complete
in approximately 1 minute.
Compaq Fortran Vn.n Tools & their Man Pages
Copying from . (disk)
Verifying
Loading 11 of 11 subset(s)....
Copyright Digital Equipment Corporation 1992,1999. All rights reserved
Restricted Rights: Use, duplication, or disclosure by the U.S. Government is
subject to restrictions as set forth in subparagraph (c) (1) (ii) of
DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as
applicable.
This software is proprietary to and embodies the confidential technology of
Digital Equipment Corporation. Possession, use, or copying of this software
and media is authorized only pursuant to a valid written license from DIGITAL
or an authorized sublicensor.
Compaq Fortran Vn.n Release Notes and Man Page
Copying from . (disk)
Verifying
11 of 11 subset(s) installed successfully.
Configuring "CXML Common Files for the Extended Math Lib, Vn.n" (XMDCOMnnn)
The CXML Manpages in HTML are now installed.
To view them, point your browser to
/usr/opt/XMDHTMnnn/cxml_webpages/cxml_home_page.html
Configuring "CXML Reference (man)Pages in HTML format" (XMDHTMnnn)
You are installing the CXML subset XMDLIB5nnn .
This subset contains serial and parallel libraries which are
tuned for the 21164 family of the Alpha AXP processor types.
By default, both the serial and the parallel CXML libraries
will be installed. You can choose to install
only the serial CXML [s]
only the parallel CXML [p]
Please choose now: install only the serial CXML [s]
install only the parallel CXML [p]
(hit RETURN to get the default -> install both) ?
By default, both shared and archive CXML libraries
will be installed. You can choose to install
only shared libs, e.g. libcxml.so [s]
only archive libs, e.g. libcxml.a [a]
Please choose now: install only shared CXML libs [s]
install only archive CXML libs [a]
(hit RETURN to get the default -> install both) ?
This installation will construct the CXML libraries you selected
with names that show the platform explicitly, e.g. libcxml_ev5.so.
This installation will construct symbolic links from /usr/lib or
/usr/shlib to the selected libraries.
By default, this installation will also construct symbolic links
from the standard CXML library names to your selected libraries
e.g. /usr/shlib/libcxml.so
unless you choose NO standard names [n].
Please choose now: no standard names [n]
(hit RETURN to get the default -> standard names) ?
The requested CXML libraries will be constructed and installed.
The installation will take just a few minutes.
... unpacking the serial libraries ...
... building the shared serial libraries ...
... unpacking the parallel libraries ...
... building the shared parallel libraries ...
Configuring "CXML Extended Math Libraries (Serial and Parallel) for
Ev5, Vn.n" (XMDLIB5nnn)
Creating Links to new manpages for CXML
Configuring "CXML Reference (man)Pages" (XMDMANnnn)
Creating Links to new manpages for CXML Vn.n SCIPORT
To run the IVP after the installation, please use
setld -v XMDSCInnn
Configuring "Compaq Compiled Code Support Library #nnn" (OTABASEnnn)
OTABASEnnn, information: Shared library installed.
Creating softlinks for HPFLIBSnnn ...done.
High Performance Fortran Runtime Libraries Vn.n-n for DIGITAL UNIX Alpha Systems
Subset: High Performance Fortran Runtime Libraries (HPFLIBSnnn)
Installation completed at Mon Nov 15 12:04:41 EST 1999.
Configuring "High Performance Fortran Runtime Libraries" (HPFLIBSnnn)
Copyright (c) Digital Equipment Corporation, 1995, 1998. All Rights Reserved.
High Performance Fortran Runtime Libraries Vn.n-n for DIGITAL UNIX Alpha Systems
Subset: High Performance Fortran Runtime Libraries (HPFLIBSnnn)
Starting configuration (INSTALL) at Mon Nov 15 12:04:42 EST 1999.
Completing configuration (INSTALL) at Mon Nov 15 12:04:42 EST 1999.
Configuring "Compaq Fortran RTL #387 for Compaq Tru64 UNIX Alpha Systems
(f90 and f77)" (DFARTL387)
DFARTLnnn, information: Shared libraries installed.
DFABASEnnn, information: You can run the Installation Verification
Procedure using the following command from root:
setld -v DFABASEnnn
Configuring "Compaq Fortran 90 and 77 Vn.n for Compaq Tru64 UNIX Alpha Systems"
(DFABASEnnn)
Configuring "Compaq Fortran Vn.n Tools & their Man Pages" (DFACOMnnn)
DFADOCnnn, information: The f77 release notes are in
./usr/lib/cmplrs/fort/relnotes
and the f90 release notes are in
./usr/lib/cmplrs/fort90/relnotes90
Configuring "Compaq Fortran Vn.n Release Notes and Man Page" (DFADOCnnn)
|
This chapter describes the following tasks performed after installing Compaq Fortran:
It also describes the files you need for running Compaq Fortran
applications ( Section 3.3).
3.1 Running the Installation Verification Procedure (IVP)
After installing Compaq Fortran, you can run the Installation Verification Procedure (IVP) independently to verify that the software is available on your system. You might also want to run the IVP after a system failure, to be sure that users can access Compaq Fortran.
The IVP verifies the installation by using the fverify command with the -y option (see the fverify(8) reference page). Depending on which Compaq Fortran subsets you specify on the setld -v command line, the following checks might occur:
To run the IVP after an installation, enter the following command:
# setld -v subset-name |
In this command, subset-name can be any Compaq Fortran subset, such as DFABASEnnn and DFADOCnnn. (For nnn, substitute the appropriate version number). For a sample listing of the Compaq Fortran IVP, see Appendix A.
If the verification process fails, look in the
/var/adm/smlogs/fverify.log
file for information to help diagnose the problem.
3.2 Deleting Compaq Fortran from Your System
If you must remove a version of Compaq Fortran from your system, delete each subset that you previously installed.
To delete subsets:
# cd / |
# setld -i | egrep 'HPFLIBS|DFA' |
# setld -d HPFLIBSnnn DFABASEnnn DFADOCnnn DFACOMnnn |
In this command, nnn is the version number (such as 530 for Version 5.3).
For example, to delete the Compaq Fortran Version 5.0 subsets after installing Version 5.n, type the following command:
# setld -d DFABASE500 DFADOC500 DFACOM500 |
Compaq Fortran Version 5.n also has subsets, F9ABASE5nn and F9ADOC5nn. Earlier releases of Compaq Fortran 5.n had subsets F9ABASEnnn and F9ADOCnnn. Also, the CXML subsets have a prefix of XMD. For example, you can use the following setld -i command to check for these subsets: setld -i | egrep 'F9A|XMD'.
If you plan to run Compaq Fortran applications, do not delete the DFARTL subset (see Section 3.3). Before you delete the DFACOM and DFARTL subsets, be aware that the Compaq Fortran and Compaq Fortran 77 products (DFABASE subset) use these subsets. If you have one of these products installed and there is only one version of the subset on your system, do not delete that subset. If multiple versions of the same subset exist, before you delete the older versions, make sure that Fortran programmers using the system no longer need the older versions. |
When you delete Compaq Fortran, the /usr/lib/cmplrs/fort90_nnn and /usr/lib/cmplrs/fort_nnn directories are deleted and symbolic links are removed. If you have another version of Compaq Fortran installed, then you must use the SELECT option to reestablish the symbolic links for the remaining version of Compaq Fortran for each subset deleted. For example, to reestablish the symbolic links for the DFABASEnnn subset:
# setld -c DFABASEnnn SELECT |
You need Compaq Fortran shared libraries and the message catalog to run
Compaq Fortran applications on your system.
3.3.1 Shared Libraries
To run Compaq Fortran applications compiled with the default -call_shared flag, you must have the following Compaq Fortran subsets (and included shared libraries) installed:
| Subset Name | Shared Libraries |
|---|---|
| DFACOM nnn | libshcom.so |
| DFARTL nnn | libfor.so, libUfor.so, libFutil.so |
| HPFLIBS nnn | libphpf.so, libphpfp.so, libshpf.so (Fortran 90 only) |
| OTABASE nnn | libots3.so (Fortran 90 only) |
| XMDLIBj nnn (where j is 4, 5, or 6) | libcxml.so and libcxmlp.so |
The shared library files included in the DFARTLnnn subset can be installed on any system licensed to run the Compaq Tru64 UNIX operating system. This allows executable programs created with Compaq Fortran to be executed regardless of whether Compaq Fortran is installed on that system.
In addition to being supplied with Compaq Fortran, some or all of these subsets are included on the Compaq Tru64 UNIX operating system CD-ROM distribution media (see the Compaq Tru64 UNIX Installation Guide).
You should always use the most recent versions of these subsets.
The Compaq Fortran release notes list the versions of the subsets
included in the Compaq Fortran kit.
3.3.2 The Message Catalog
The message catalog contains the text for all messages issued by the Compaq Fortran run-time library. The message catalog should be installed on any system used to run Compaq Fortran applications.
If the message catalog is not present and a Compaq Fortran application signals an error from the run-time library, you will see the error message number and a message saying that for_msg.cat is missing. The descriptive text for the error will not be displayed.
The message catalog is included in the DFARTLnnn subset. This subset must be installed if you want to be able to read the descriptive text associated with Compaq Fortran run-time library errors.
The message catalog file included in the DFARTLnnn subset can be installed on any system licensed to run the Compaq Tru64 UNIX operating system.
DFARTLnnn subset is included with Compaq Fortran and also in the /mnt/alpha/dec_fortran_rtl directory on the Compaq Tru64 UNIX operating system CD-ROM distribution media (see the Tru64 UNIX Installation Guide).
You should always use the most recent version of this subset.
The Compaq Fortran release notes list the version of the DFARTL subset included in the Compaq Fortran kit.
The message catalog is installed in the /usr/lib/cmplrs/fortrtl directory and is pointed to by a symbolic link in /usr/lib/nls/msg/en_us.iso8859-1 .
Compaq Fortran uses the NLSPATH environment variable to find its run-time message catalog. If NLSPATH is not set, the default used is /usr/lib/nls/msg/en_us.iso8859-1/for_msg.cat .
If the Compaq Fortran run-time library cannot find its message catalog, it displays a message that includes the following:
Check environment variable NLSPATH and protection of
/usr/lib/nls/msg/en_US.ISO8859-1/for_msg.cat
|
In this case, check to see if for_msg.cat exists and that users have access to it. The for_msg.cat file is bundled with Compaq Fortran.
For more information on NLSPATH , see the Compaq Tru64 UNIX documentation or the catopen(3) reference page.
| Previous | Next | Contents |