Please note,

3.1. Available Software/Libraries

The following compiled libraries are provided:

• libnagfl90.a

3.2. Module Files

Compared to the use of the F77 compiler and libraries, use of the F90 compiler and libraries is complicated by one additional requirement on the command line: when invoking the F90 compiler the -M<pathname> option should be specified on each invocation. For the current release the path is

/software/nag/fnsol03db/nag_mod_dir

This tells the compiler where to find the module (.mod) files.

3.3. A Simple Example of the Compilation/Linking/Execution Cycle

This example is based on one of those included with the distribution of this library which is installed on Cosmos.

First copy the source from the installation directory to a directory of your own:

cp /software/nag/fnsol03db/examples/source/nag_airy_fun_ex01.f90

Then compile and link:

oldf90 -M/software/nag/fnsol03db/nag_mod_dir nag_airy_fun_ex01.f90 -lnagfl90

This line requires some explanation:

• There are two versions of the Fortran 90 compiler installed on Cosmos, one from the Sun Workshop Release 4.2, the other from Release 5.0. The compiler from Release 5.0 does not work with the NAg libraries; that from Release 4.2 does, hence oldf90, a link to the 4.2 compiler, is used.
• -M/software/... tells the compiler where to look for the module files of compiler, USEd modules.
• And -lnagfl90 tells the compiler to use the NAg F90 library.

Finally, run the executable by typing

a.out

The following should be output:

    Example Program Results for nag_airy_fun_ex01

           x          Ai(x)
      -1.000E+01    4.024E-02
      -1.000E+00    5.356E-01
       0.000E+00    3.550E-01
       .            .
       .            .

3.4. Example Programme Material

As part of the installation there is an example programme for each routine; these may be found in:

examples/source/*.f90 examples/data/*.dat examples/results/*.r

A script to aid in the use of these examples is provided:

scripts/nagexample

For example typing

/software/nag/fnsol03db/scripts/nagexample nag_write_mat_ex01

will copy the example programme and any associated input data file to the current directory, compile the programme and link it (showing you the commands used), and finally execute the resulting object.

3.5. Further Available Documentation

3.5.1. On-Line Documentation at UMIST

This documentation is available on-line.

3.5.2. On-Line Documentation: The NAg Web Site

NAg have a web site at www.nag.co.uk. Documentation for the F90 library is available there.

3.5.3. Hardcopy

• A paper copy of this documentation will be available from Helpdesk in the near future.
• A reference copy of the full NAg printed documentation, including full documentation for each routine, is available for consultation by asking at Helpdesk.

3.5.4. On-disk Documentation (in HTML or Plain Text)

Whilst there is no available on-disk or on-line routine-by-routine documentation as yet for the Fortran 90 library, there is a certain amount of on-disk documentation of a general nature. This can be found at

/software/nag/fnsol03db/doc/FN03_index.html

This documentation consists of the following sections:

Essential Introduction

This document is a summary of the essential features of the design of the NAG Fortran 90 Library. It assumes that you are famiiar with Fortran 90. If you want a more informal and expansive introduction to the Library, or are unfamiliar with Fortran 90, then refer to the tutorial...

Tutorial

This tutorial describes those aspects of the Fortran 90 language that are important when calling NAG fl90 procedures. It also explains any relevant conventions that have been adopted in the design and documentation of the Library.

It is not a self-contained introduction to Fortran 90; it assumes that you already have some general knowledge of the language.

Conversion from the NAG Fortran 77 Library

This document offers guidance to users who are familiar with the NAG Fortran 77 Library and who now wish to use the NAG Fortran 90 Library, especially users who have Fortran 77 programs which call NAG Fortran 77 Library routines and who wish to convert such programs to Fortran 90 and to call NAG Fortran 90 library procedures.

List of Contents

A list of all the routines available in the Fortran 90 library and, an indication of what they do. For more details see the printed documentation.

Future Developments

A brief indication of routines which will be available in the next release.

Release 3 News

A brief indication of the routines available in this release which were not available in the previous release (Release 2).

3.5.5. On-disk: Installer's Note

There is an installers' note in

/software/nag/fnsol03db/doc/in

This is essential reading for System Administrators.

3.6. Source

The source directory contains the Fortran 90 source code to each routine. The license states that this should not be available to users, so its not.