NAG recommends that users read the following minimum reference material before calling any library routine:
(a) Essential Introduction
(b) Chapter Introduction
(c) Routine Document
(d) Implementation-specific Users' Note
First check that you are set up to use Sun ClusterTools 7 by invoking the ompi_info and mpif90 -V commands. This should report the version of ClusterTools and the version of the Fortran Compiler and confirm that you are not using some other implementation of MPI (such as LAM or MPICH).
> mpif90 -V f95: Sun Fortran 95 8.2 2005/10/13 Usage: f95 [ options ] files. Use 'f95 -flags' for details
Assuming that a link to libnagmpi.so, libnagmpi_nag.so and libnagmpi_spl.so has been placed in a directory in the search path of the linker, then you may link to the NAG Parallel Library as follows:
mpif90 -xarch=v9a driver.f -lnagmpi -lnagmpi_nagor (if you want to use the Sun Performance Library for the BLAS instead, as is recommended)
mpif90 -xarch=v9a driver.f -lnagmpi -lnagmpi_spl -xlic_lib=sunperfwhere driver.f is your application program. If you want to link in the NAG Libraries statically:
mpif90 -xarch=v9a driver.f -Bstatic -lnagmpi -lnagmpi_spl -Bdynamic -xlic_lib=sunperf
mpirun -np 4 a.outinstructs the system to execute the executable program a.out in four parallel processes. Consult local documentation for full details of the facilities of mpirun. If the executable uses shared libraries that are not on the linker's default path, make sure that LD_LIBRARY_PATH is set in your shell startup file to point to where the shared libraries are.
The example programs are most easily accessed by using the script nagmpiexample, which will copy an example program and its data, compile it, link it with the libraries and run it.
For example, give the command
nagmpiexample f04ebfpto run the F04EBFP example program.
The values of the machine constants are:
The basic parameters of the model
X02BHF = 2 X02BJF = 53 X02BKF = -1021 X02BLF = 1024 X02DJF = .TRUE.Derived parameters of the floating-point arithmetic
X02AJF = 1.11022302462516D-16 X02AKF = 2.22507385850721D-308 X02ALF = 1.79769313486231D+308 X02AMF = 2.22507385850721D-308 X02ANF = 2.22507385850721D-308Parameters of other aspects of the computing environment
X02AHF = 1.42724769270596D+45 X02BBF = 2147483647 X02BEF = 15 X02DAF = .FALSE.
On-line documentation is provided, in PDF form, with this implementation. Please refer to local information for access to this documentation.
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, it helps us deal with your enquiry quickly if you can quote your NAG site reference and NAG product code (in this case FDSO603DM).
The NAG websites provide information about implementation availability, descriptions of products, downloadable software, product documentation and technical reports. The NAG websites can be accessed at the following URLs:
http://www.nag.co.uk/, http://www.nag.com/ or http://www.nag-j.co.jp/
NAG Ltd Wilkinson House Jordan Hill Road OXFORD OX2 8DR NAG Ltd Response Centre United Kingdom email: firstname.lastname@example.org Tel: +44 (0)1865 511245 Tel: +44 (0)1865 311744 Fax: +44 (0)1865 310139 Fax: +44 (0)1865 310139 NAG Inc 1431 Opus Place, Suite 220 Downers Grove IL 60515-1362 NAG Inc Response Center USA email: email@example.com Tel: +1 630 971 2337 Tel: +1 630 971 2337 Fax: +1 630 971 2706 Fax: +1 630 971 2706 Nihon NAG KK Hatchobori Frontier Building 2F 4-9-9 Hatchobori Chuo-ku Tokyo 104-0032 Japan email: firstname.lastname@example.org Tel: +81 (0)3 5542 6311 Fax: +81 (0)3 5542 6312