This library is designed for use with the NAg F90 compiler (which accepts fixed-format F77 code) but is compatible also with the Salford FTN90 compiler. Here at UMIST we have this Salford compiler (in M:\program files\salford); we do not have the NAg compiler. Testing indicates that the Salford FTN95 compiler is compatible with these libraries also --- but only if certain libraries from the FTN90 installation are available to the FTN95 compiler. (The simplest way to ensure these libraries, in particular ftn89.dll are available is to install Salford Fortran 95 on top of --- in the same directory as --- Salford Fortran 90.)

4.1. Available Compiled Libraries

The following compiled libraries are provided:

• NAGLIB.LIB: for building statically-linked executable programmes;
• NAGLIB.DLL: for building dynamically-linked executable programmes.

4.2. A Simple Example of Compilation, Static Linking and Execution

...with the Salford FTN90 compiler (this library will work successfully with the Salford FTN95 compiler). This example assumes you are working from a commmand line (cmd.exe). It is based on one of the examples supplied with this NAg library; a statically-linked executable is produced.

First add the Salford directory to your path so that Windows can find the FTN90 (or FTN95) compiler and its libraries. To do this you can use the batch-file FTN90VAR.BAT. So type

"M:\PROGRAM FILES\SALFORD\FTN90VAR"

Next

COPY M:\NAG\FLW3219D9\EXAMPLES\DATA\C06EAFE.DAT COPY M:\NAG\FLW3219D9\EXAMPLES\SOURCE\C06EAFE.FOR

Compile:

FTN90 C06EAFE.FOR

Link:

ECHO LOAD C06EAFE.OBJ > SLINK.LST ECHO LOAD M:\NAG\FLW3219D9\NAGLIB.LIB >> SLINK.LST ECHO FILE C06EAFE.EXE >> SLINK.LST SLINK SLINK.LST

Run:

C06EAFE < C06EAFE.DAT > C06EAFE.RES

This may seem long-winded but may be automated by means of a batch file.

4.3. A Simple Example of Compilation, Dynamic Linking and Execution

Exactly as above except replace NAGLIB.LIB with NAGLIB.DLL.

4.4. Example Programme Material

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

• examples\source\??????e.for
• examples\data\??????e.dat
• examples\results\??????e.res

• BATCH\NAGEX
• BATCH\NAGEXDLL
• BATCH\NAGEX_FTN95

    M:\NAGFL19D9\BATCH\NAGEX c06eaf

    M:\NAGFL19D9\BATCH\NAGEX_FTN95 c06eaf

    M:\NAGFL19D9\BATCH\NAGEXDLL c06eaf

4.5. Further Available Documentation

4.5.1. On-Line Documentation: The NAg Web Site

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

4.5.2. On-Line Documentation at UMIST

This documentation is available on-line.

4.5.3. Hard-Copy Documentation

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

4.5.4. On-disk Documentation

All paths quoted below are relative to:

M:\NAG\NAGFL19D9

Users' Notes

Users' note: doc\un.html. This document is essential reading for every user of the NAG Fortran Library Implementation specified in the title. It provides implementation-specific detail that augments the information provided in the NAG Fortran Library Manual and Introductory Guide. Wherever those manuals refer to the "Users' Note for your implementation", you should consult this note.

Essential Introduction to the NAG Fortran Library

doc\essint: This document is "essential" reading for any prospective user of the library. It contains information regarding: The Library and its Documentation; Using the Library; Using the Documentation; Support from NAg; Background to NAg; References.

NAg Fortran Mark 19 Library Concise Summary

doc\summary: A list of routine names and their function (e.g., Square root of complex number, or All zeros of complex polynomial, modified Laguerre method. (Does not include superseded routines or those scheduled for withdrawal.)

Mark 19 News

doc\news: What's new in Mark 19: new routines, withdrawn routines and routines scheduled for withdrawal.

Withdrawn Routines

doc\replaced: List of all routines that have been present in earlier Marks, but have since been withdrawn.

Calls

doc\calls: Gives the names of the routines called directly and indirectly by each routine and an example programme.

Called

doc\called: Gives the names of the routines which call directly or indirectly each routine and an example programme.

BLAS and LAPACK to NAg

doc\blas_lapack_to_nag: Gives NAg library equivalents of Basic Linear Algebra Subprograms (BLAS) and LAPACK routines.

NAg to BLAS and LAPACK

doc\nag_to_blas_lapack: Gives Basic Linear Algebra Subprograms (BLAS) and LAPACK equivalents of NAg library routines.