Chapter 4 Postinstallation Tasks

---

This chapter contains the following sections:

• 4.1, "How to Run the Installation Verification Procedure (IVP)"
• 4.2, "How to Delete Compaq Fortran from Your System"
• 4.3, "How to Run Compaq Fortran Applications"
• 4.4, "Reporting Problems to Compaq"

4.1 How to Run 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:

• For the DFABASEnnn subset, the IVP first compiles, links, and runs a Fortran program with Compaq Fortran 77 tools, and then compiles, links, and runs a Fortran program with Compaq Fortran 95/90 tools.
• For Compaq Extended Math Library subsets (identifiers starting with XMD), the IVP links and executes test programs that exercise the CXML and SCIPORT libraries.
• For other subsets, the IVP verifies that certain files are present. For instance, the DFARTLnnn and HPFLIBSnnn subsets verify that the run-time libraries exist.

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

If the verification process fails, look in the /var/adm/smlogs/fverify.log file for information to help diagnose the problem.

4.2 How to Delete 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:

1. Log in as superuser (login name root).
2. Make sure you are at the root directory (/) by entering the following command:

   # cd /
    
   

3. Enter the following form of the setld command:

   # setld -i | egrep 'PSESH|DFA|HPFLIBS|XMD|OTABASE'
    
   

4. Look for the word "installed" in the listing produced. You can delete any subset names displayed in response to the previous command, especially older versions if multiple versions exist. Enter a setld command like the following to delete subsets:

   # setld -d HPFLIBSnnn DFABASEnnn DFADOCnnn DFACOMnnn
    
   

In this command, nnn is the version number (such as 540 for Version 5.4).

The CXML subsets have a prefix of XMD. You can use the following setld command to check for CXML subsets:

# setld -i | egrep 'XMD' 

Note:

If you plan to run Compaq Fortran applications, do not delete the DFARTL subset (see Section 4.3.1, "Subsets and Shared Libraries").

Before you delete the DFACOM or DFARTL subsets, be aware that the Compaq Fortran 95/90 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.

After installation, anytime you delete an older subset, you must use the SELECT option to reestablish the symbolic links for each subset.

For example, to reestablish the symbolic links for the DFABASEnnn subset:

# setld -c DFABASEnnn SELECT 

4.3 How to Run Compaq Fortran Applications

You need Compaq Fortran shared libraries and the message catalog to run Compaq Fortran applications on your system.

4.3.1 Subsets and 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:

Table 4-1 Subset Names for Shared Libraries

Subset Name	Shared Libraries
DFACOMnnn	libshcom.so
DFARTLnnn	libfor.so, libUfor.so, libFutil.so
HPFLIBSnnn	libphpf.so, libphpfp.so, libshpf.so (Fortran 95/90 only)
OTABASEnnn	libots3.so (Fortran 95/90 only)
XMDLIBxnnn (where x 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.

Some of these subsets are also 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 Release Notes list the versions of the subsets included in the Compaq Fortran kit (see Section 1.2, "Reading the Release Notes and Cover Letter").

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

The DFARTLnnn subset is included with Compaq Fortran and is 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 Release Notes list the version of the DFARTL subset included in the Compaq Fortran kit (see Section 1.2, "Reading the Release Notes and Cover Letter").

The message catalog is installed in the /usr/lib/cmplrs/fortrtl directory and is pointed to by a symbolic link in the following directory:

/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 following default location is used:

/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/msgen_US.ISO8859-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.

4.4 Reporting Problems 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, you can do either of the following:

• If you have a Software Product Services Support Agreement, contact 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.
• If you don't have a support agreement, you can arrange or per-call CSC support.

When you initially contact the CSC, indicate the following:

1. The name and version number of the operating system you are using
2. The name and version number of Compaq Fortran you are using
3. The hardware system you are using (such as a model number)
4. Whether or not the problem is critical
5. A brief description of the problem (one sentence if possible)

When you submit information electronically or are speaking on the phone to a 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 module or lines of code.

CSC personnel might 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).

For information about submitting media, see the tar(1) reference page.

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.

If the problem is related to Compaq Fortran documentation, see the information in "Sending Compaq Your Comments" in the front of this guide.