Whenever the NAG Fortran Library has been supplied in compiled form, that form is considered to be the standard library file. The use of all supplied software must be in accordance with the terms and conditions of the Software Licence signed by NAG and each site. In particular, users must not have free access to the text of the library routines. Any request to use NAG software on a computer other than the one licensed must be referred to NAG (see Section 6).
This implementation is a compiled, tested, ready-to-use version of the NAG Fortran Library that is considered suitable for operation on the computer systems detailed below:
hardware: all systems in the DEC Alpha AXP range operating system: Alpha AXP OpenVMS V6.1 or compatible Fortran compiler: Digital Fortran 77 and 90
For information about implementations of the NAG Fortran Library for use on other computer systems please contact NAG.
This implementation was produced at NAG Ltd., Oxford on the computing system detailed below:
hardware: DEC 3000 AXP model 500
operating system: Alpha AXP OpenVMS V6.1
Fortran compiler: Digital Fortran 77 V7.1-107-3313
and also tested with Digital Fortran 90 T7.1-323
compiler options: /CHECK=(NOBOUNDS,OVERFLOW,NOUNDERFLOW) /PAD_SOURCE
The entire Fortran Library, Mark 19, was compiled with default optimization (/OPTIMIZE), except for X04CBF, X04DBF and X04EBF which had to be compiled with no optimization (/NOOPTIMIZE).
This library has been tested using the Basic Linear Algebra Subprograms (BLAS) and linear algebra routines (LAPACK) provided by NAG (see the Chapter Introductions for F06, F07 and F08 in the NAG Fortran Library Manual).
It has also been tested using the set of BLAS and LAPACK supplied in the Digital Extended Math Library (DXML) version 2.8-79 for G-float.
For further details, refer to other documentation supplied or contact NAG (see Section 6).
The save set INSTALL.BCK contains the following files:
INSTALL.COM - an installation command procedure
MAKELIB.COM - a command procedure used by INSTALL.COM to re-compile the
routines and create a new object module library file
NAG$LINK.OPT - a linker options file for use with the shareable library
NAG$SHARE.OPT - a symbol vector options file ensuring compatibility of the
shareable library across all customer sites
NAGSHARE.COM - a command procedure which converts the NAG object module
library to shareable form
The save set DOC.BCK contains the following files:
IN.DOC - the Installer's Note for this implementation in plain text form
UN.DOC - the Users' Note for this implementation in plain text form
IN.HTML - the Installer's Note for this implementation in HTML form
UN.HTML - the Users' Note for this implementation in HTML form
ESSINT.DOC - the Essential Introduction to the NAG Fortran Library
SUMMARY.DOC - a brief summary of the routines
NEWS.DOC - an outline of the new and enhanced routines available at
Mark 19
REPLACED.DOC - a list of routines available at earlier Marks of the Library
but since withdrawn, together with recommended replacements
CALLS.DOC - a list of routines called directly or indirectly by each
routine in the Library, and by each example program
CALLED.DOC - for each routine in the Library (including auxiliaries), a list
of those routines and example programs which call it directly
or indirectly
BLAS_LAPACK_TO_NAG.DOC - BLAS/F06, LAPACK/F07 and LAPACK/F08 listing
NAG_TO_BLAS_LAPACK.DOC - F06/BLAS, F07/LAPACK and F08/LAPACK listing
The save set LIBRARY.BCK contains the following file:
NAG$LIBRARY.OLB - the NAG Fortran LibraryThe save set LIBRARY_DXML.BCK contains the following file:
NAG$LIBRARY_DXML.OLB - the NAG Fortran Library for use with the Digital
Extended Math Library (DXML) for G-float
The save set TEXT.BCK contains the following files:
*.FOR - the Fortran source text for all routines, including auxiliariesThe save set TEXT_F_AUX.BCK contains the following files:
*.FOR - the alternative Fortran source text necessary for using the Digital
Extended Math Library (DXML) versions of BLAS and LAPACK
The save set TEST.BCK contains the following files:
*.FOR - the Fortran source text of the example programs for F01ABF, F04ADF,
G05FFF and S17AKF
*.DAT - the data required to run the example programs for F01ABF, F04ADF and
S17AKF
*.RES - the results produced by the example programs for F01ABF, F04ADF, G05FFF
and S17AKF
The save set EXPT.BCK contains the following files:
*.FOR - the Fortran source text of the example programsThe save set EXPD.BCK contains the following files:
*.DAT - the data required to run the example programsThe save set EXPR.BCK contains the following files:
*.RES - the results produced by the example programsThe save set INTERFACE_BLOCKS.BCK contains the following files:
*.F90$MOD - modules which allow the Digital Fortran 90 compiler to check that
NAG Fortran Library routines are called correctly
*.F90 - the Fortran source text for the modules which allow the Digital
Fortran 90 compiler to check that NAG Fortran Library routines are
called correctly
compiled library: 38100 blocks (as supplied in compressed form) compiled library for use with DXML: 38000 blocks (as supplied in compressed form) example program material: 14100 blocks documentation files: 5400 blocks library source code: 47000 blocks (not needed on disk permanently) interface blocks: 6100 blocks (optional, needed only if using Digital Fortran 90)
$ SET FILE/ATTRIBUTE=(LRL:8192,RFM:FIX) *.BCK
$ MOUNT/MEDIA=CDROM/UNDEFINED_FAT=fixed:none:8192 DKA400: FLDAV19DG
$ BACKUP DKA400:[000000]INSTALL.BCK/SAVE_SET []
$ @INSTALL
This command procedure also gives you the option of
$ DISMOUNT DKA400:
$ MOUNT/MEDIA=CDROM/UNDEFINED_FAT=fixed:none:8192 DKA400: FLDAV19DG $ BACKUP DKA400:[000000]LIBRARY.BCK/SAVE_SET SYS$COMMON:[SYSLIB] $ DISMOUNT DKA400:or, if you wish to copy the object module library file for use with the Digital Extended Math Library (DXML) for G-float
$ MOUNT/MEDIA=CDROM/UNDEFINED_FAT=fixed:none:8192 DKA400: FLDAV19DG
$ BACKUP DKA400:[000000]LIBRARY_DXML.BCK/SAVE_SET -
SYS$COMMON:[SYSLIB]NAG$LIBRARY.OLB
$ DISMOUNT DKA400:
$ SET PROTECTION=W:RE SYS$COMMON:[SYSLIB]NAG$LIBRARY.OLB
$ DEFINE/JOB LNK$LIBRARY SYS$COMMON:[SYSLIB]NAG$LIBRARY.OLBIf the logical name LNK$LIBRARY is already in use then the first empty logical name from the following list should be used:
LNK$LIBRARY_1, LNK$LIBRARY_2, ....., LNK$LIBRARY_nIf the user has sufficient privileges, the JOB qualifier may be replaced by the GROUP or the SYSTEM qualifiers. N.B. The association should be placed in the appropriate initialising command file, for example SYLOGICALS.COM for the /SYSTEM qualifier or the LOGIN.COM of authorised users. This will ensure that the library will still be linked automatically even if the system has to be re-booted.
Alternatively you can set the library up as you wish, for example by linking explicitly with the library in each LINK command.
$ MOUNT/MEDIA=CDROM/UNDEFINED_FAT=fixed:none:8192 DKA400: FLDAV19DG $ BACKUP DKA400:[000000]INSTALL.BCK/SAVE_SET [] $ BACKUP DKA400:[000000]LIBRARY.BCK/SAVE_SET [] $ DISMOUNT DKA400:or, if you wish to copy the object module library file for use with the Digital Extended Math Library (DXML) for G-float
$ MOUNT/MEDIA=CDROM/UNDEFINED_FAT=fixed:none:8192 DKA400: FLDAV19DG $ BACKUP DKA400:[000000]INSTALL.BCK/SAVE_SET [] $ BACKUP DKA400:[000000]LIBRARY_DXML.BCK/SAVE_SET []NAG$LIBRARY.OLB $ DISMOUNT DKA400:
$ @NAGSHAREand then copy the file required to use the shareable library to an appropriate directory, e.g.
$ COPY NAG$SHARE.EXE SYS$COMMON:[SYSLIB]NAG$SHARE.EXEThe supplied file NAG$SHARE.OPT (for this implementation) should be in the current directory when this procedure is used, if compatibility with previous shared versions and compatibility between sites is to be assured.
$ SET PROTECTION=W:RE SYS$COMMON:[SYSLIB]NAG$*.*
An options file should be used when linking to the shareable image, e.g.
$ LINK MYPROG, NAG$LINK.OPT/OPTIONSwhere NAG$LINK.OPT contains the line NAG$SHARE/SHAREABLE.
The association with the logical name NAG$SHARE may be achieved in the following fashion:
$ DEFINE/JOB NAG$SHARE SYS$COMMON:[SYSLIB]NAG$SHARE.EXE
The installer should also ensure that the advice given to users in Section 3.6 of the Users' Note is suitable for the installation. If Digital Fortran 90 is not being used, the section may be deleted.
If any externally-provided library of Basic Linear Algebra Subprograms (BLAS) such as the Digital Extended Math Library (DXML) is to be used then the following example programs should also be run:
F06EAF - testing real Level 1 BLAS
F06GAF - testing complex Level 1 BLAS
F06ERF - testing real sparse Level 1 BLAS
F06GRF - testing complex sparse Level 1 BLAS
F06PAF - testing real Level 2 BLAS
F06SAF - testing complex Level 2 BLAS
F06YAF - testing real Level 3 BLAS
F06ZAF - testing complex Level 3 BLAS
Note that the last four example programs take longer to execute than the average example program.
The following material should also be made accessible to users:
documentation files:
ESSINT.DOC from the save set DOC.BCK SUMMARY.DOC from the save set DOC.BCK NEWS.DOC from the save set DOC.BCK REPLACED.DOC from the save set DOC.BCK CALLS.DOC from the save set DOC.BCK CALLED.DOC from the save set DOC.BCK BLAS_LAPACK_TO_NAG.DOC from the save set DOC.BCK NAG_TO_BLAS_LAPACK.DOC from the save set DOC.BCKcompiled library:
NAG$LIBRARY.OLB from the save set LIBRARY.BCK or LIBRARY_DXML.BCK (or the shareable library created from it)example program material:
*.FOR from the save set EXPT.BCK *.DAT from the save set EXPD.BCK *.RES from the save set EXPR.BCKinterface block files (optional, needed only if using Digital Fortran 90):
*.F90$MOD from the save set INTERFACE_BLOCKS.BCK
Note that the example material has been adapted, if necessary, from that printed in the NAG Fortran Library Manual, so that programs are suitable for execution with this implementation with no further changes (but see Section 4.4.2 for comments about possible differences in results obtained). Making the example material directly available to users provides them with easily adaptable templates for their own problems.
The "example programs" for the routines in the F06 chapter are not typical example programs and they are not in the Library Manual. They are test programs, which are supplied to sites for use in an installation test of the Library. Some of them take much longer to run than other example programs. Routines which are equivalent to BLAS, are tested twice: once when called by their NAG F06 names, and once when called by their BLAS names.
A full on-line version of the NAG Fortran Library Manual is available in the form of Portable Document Format (PDF) files. Please contact NAG if you are interested in this.
The NAG Response Centres are available for general enquiries from all users and also for technical queries from sites with an annually licensed product or support service.
The Response Centres are open during office hours, but contact is possible by fax, email and phone (answering machine) at all times.
When contacting a Response Centre please quote your NAG site reference and NAG product code (in this case FLDAV19DG).
The NAG websites are an information service providing items of interest to users and prospective users of NAG products and services. The information is reviewed and updated regularly and includes implementation availability, descriptions of products, downloadable software, product documentation and technical reports. The NAG websites can be accessed at
or
http://www.nag.com/ (in North America)
or
http://www.nag-j.co.jp/ (in Japan)
NAG Ltd Wilkinson House Jordan Hill Road OXFORD OX2 8DR NAG Ltd Response Centre United Kingdom email: support@nag.co.uk Tel: +44 (0)1865 511245 Tel: +44 (0)1865 311744 Fax: +44 (0)1865 310139 Fax: +44 (0)1865 310139 Nihon NAG KK Yaesu Nagaoka Building No. 6 1-9-8 Minato Chuo-ku Tokyo Japan email: help@nag-j.co.jp Tel: +81 (0)3 5542 6311 Fax: +81 (0)3 5542 6312 [NP3524/IN]