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 VAX range operating system: VAX/VMS V5.5 or compatible Fortran compiler: VAX Fortran
For information about implementations of the NAG Fortran Library for use on other computer systems please contact NAG.
This implementation was produced at the Computing Centre of Cardiff University on the computing system detailed below:
hardware: DEC VAX-4200 operating system: VAX/VMS V5.5-2 Fortran compiler: VAX FORTRAN V5.9-173 Assembler: VAX MACRO V5.4-3 compiler options: /OPTIMIZE /CHECK=(NOBOUNDS,OVERFLOW,NOUNDERFLOW)
The entire Fortran Library, Mark 19, was compiled with full optimization.
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) only.
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
NAGSHARE.COM - a command procedure used by INSTALL.COM to convert a NAG object
module library to shareable form
NAG$SHARE.MAR - a base transfer vector ensuring compatibility of the shareable
library across all customer sites
TRAVEC.COM - a command procedure used by NAGSHARE.COM to convert the object
module library to a shareable library
TRALIB.EXE - an executable module used by TRAVEC.COM
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 TEXT.BCK contains the following files:
*.FOR - the Fortran source text for all routines, including auxiliaries
*.MAR - the source text of those routines in chapters G05 and X03 which are
written in MACRO
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 programs
compiled library: 17400 blocks (as supplied in compressed form) example program material: 10100 blocks documentation files: 5200 blocks library source code: 37300 blocks (not needed on disk permanently)
$ SET FILE/ATTRIBUTE=(LRL:8192,RFM:FIX) *.BCK
N.B. The MOUNT/MEDIA=CDROM/UNDEFINED_FAT=fixed:none:8192 and
$ MOUNT/MEDIA=CDROM/UNDEFINED_FAT=fixed:none:8192 DKA400: FLDVV19DA
$ 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: FLDVV19DA $ BACKUP DKA400:[000000]LIBRARY.BCK/SAVE_SET SYS$COMMON:[SYSLIB] $ 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: FLDVV19DA $ BACKUP DKA400:[000000]INSTALL.BCK/SAVE_SET [] $ BACKUP DKA400:[000000]LIBRARY.BCK/SAVE_SET [] $ DISMOUNT DKA400:
$ @NAGSHAREand then copy the files required to use the shareable library to an appropriate directory, e.g.
$ COPY NAG$SHARE.OLB SYS$COMMON:[SYSLIB]NAG$SHARE.OLB $ COPY NAG$SHARE.EXE SYS$COMMON:[SYSLIB]NAG$SHARE.EXEThe supplied file NAG$SHARE.MAR 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. After building the shared version for the first time, the resulting NAG$SHARE.MAR should be kept and the newest version used for each subsequent rebuild.
$ SET PROTECTION=W:RE SYS$COMMON:[SYSLIB]NAG$*.*
$ DEFINE/JOB NAG$SHARE SYS$COMMON:[SYSLIB]NAG$SHARE.EXEThe library file NAG$SHARE.OLB should be associated with a LNK$LIBRARY name:
$ DEFINE/JOB LNK$LIBRARY SYS$COMMON:[SYSLIB]NAG$SHARE.OLBThe library can have a higher LNK$LIBRARY name if required. If the user has sufficient privileges, the JOB qualifier may be replaced by the GROUP or the SYSTEM qualifiers. N.B. These associations 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.
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 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.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 FLDVV19DA).
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 [NP3463/IN]