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 INSTALLE.BCK contains the following files:
INSTALLE.COM - an installation command procedure
MAKELIBE.COM - a command procedure used by INSTALLE.COM to re-compile the
routines and create a new object module library file
NAGESHARE.COM - a command procedure used by INSTALLE.COM to convert a NAG
object module library to shareable form
NAGE$SHARE.MAR - a base transfer vector ensuring compatibility of the shareable
library across all customer sites
TRAVECE.COM - a command procedure used by NAGESHARE.COM to convert the
object module library to a shareable library
TRALIBE.EXE - an executable module used by TRAVECE.COM
The save set DOCE.BCK contains the following files:
INE.DOC - the Installer's Note for this implementation in plain text
form
UNE.DOC - the Users' Note for this implementation in plain text form
INE.HTML - the Installer's Note for this implementation in HTML form
UNE.HTML - the Users' Note for this implementation in HTML form
ESSINT.DOC - the Essential Introduction to the NAG Fortran Library
SUMMARYE.DOC - a brief summary of the routines
NEWS.DOC - an outline of the new and enhanced routines available at
Mark 19
REPLACEDE.DOC - a list of routines available at earlier Marks of the Library
but since withdrawn, together with recommended replacements
CALLSE.DOC - a list of routines called directly or indirectly by each
routine in the Library, and by each example program
CALLEDE.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 LIBRARYE.BCK contains the following file:
NAGE$LIBRARY.OLB - the NAG Fortran LibraryThe save set TEXTE.BCK contains the following files:
*.FOR - the Fortran source text for all routines, including auxiliaries
*.MAR - the source text of those routines in chapter G05 which are written in
MACRO
The save set TESTE.BCK contains the following files:
*.FOR - the Fortran source text of the example programs for F01ABE, F04ADE,
G05FFE and S17AKE
*.DAT - the data required to run the example programs for F01ABE, F04ADE and
S17AKE
*.RES - the results produced by the example programs for F01ABE, F04ADE, G05FFE
and S17AKE
The save set EXPTE.BCK contains the following files:
*.FOR - the Fortran source text of the example programsThe save set EXPDE.BCK contains the following files:
*.DAT - the data required to run the example programsThe save set EXPRE.BCK contains the following files:
*.RES - the results produced by the example programs
compiled library: 17000 blocks (as supplied in compressed form) example program material: 10000 blocks documentation files: 5100 blocks library source code: 37100 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: FLDVV19SA
$ BACKUP DKA400:[000000]INSTALLE.BCK/SAVE_SET []
$ @INSTALLE
This command procedure also gives you the option of
$ DISMOUNT DKA400:
$ MOUNT/MEDIA=CDROM/UNDEFINED_FAT=fixed:none:8192 DKA400: FLDVV19SA $ BACKUP DKA400:[000000]LIBRARYE.BCK/SAVE_SET SYS$COMMON:[SYSLIB] $ DISMOUNT DKA400:
$ SET PROTECTION=W:RE SYS$COMMON:[SYSLIB]NAGE$LIBRARY.OLB
$ DEFINE/JOB LNK$LIBRARY SYS$COMMON:[SYSLIB]NAGE$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: FLDVV19SA $ BACKUP DKA400:[000000]INSTALLE.BCK/SAVE_SET [] $ BACKUP DKA400:[000000]LIBRARYE.BCK/SAVE_SET [] $ DISMOUNT DKA400:
$ @NAGESHAREand then copy the files required to use the shareable library to an appropriate directory, e.g.
$ COPY NAGE$SHARE.OLB SYS$COMMON:[SYSLIB]NAGE$SHARE.OLB $ COPY NAGE$SHARE.EXE SYS$COMMON:[SYSLIB]NAGE$SHARE.EXEThe supplied file NAGE$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 NAGE$SHARE.MAR should be kept and the newest version used for each subsequent rebuild.
$ SET PROTECTION=W:RE SYS$COMMON:[SYSLIB]NAGE$*.*
$ DEFINE/JOB NAGE$SHARE SYS$COMMON:[SYSLIB]NAGE$SHARE.EXEThe library file NAGE$SHARE.OLB should be associated with a LNK$LIBRARY name:
$ DEFINE/JOB LNK$LIBRARY SYS$COMMON:[SYSLIB]NAGE$SHARE.OLBThe library can have a higher LNK$LIBRARY names 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 DOCE.BCK SUMMARYE.DOC from the save set DOCE.BCK NEWS.DOC from the save set DOCE.BCK REPLACEDE.DOC from the save set DOCE.BCK CALLSE.DOC from the save set DOCE.BCK CALLEDE.DOC from the save set DOCE.BCK BLAS_LAPACK_TO_NAG.DOC from the save set DOCE.BCK NAG_TO_BLAS_LAPACK.DOC from the save set DOCE.BCKcompiled library:
NAGE$LIBRARY.OLB from the save set LIBRARYE.BCK (or the shareable library created from it)example program material:
*.FOR from the save set EXPTE.BCK *.DAT from the save set EXPDE.BCK *.RES from the save set EXPRE.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 FLDVV19SA).
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 [NP3464/IN]