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
Items (a), (b) and (c) are included in the NAG Parallel Library Manual, which should be available locally in printed and PDF form (see Section 4); item (d) is this document, which is provided in HTML form.
Assuming that a link to libnagmpi.a has been placed in a directory in the search path of the linker, then you may link to the NAG Parallel Library as follows:
mpxlf driver.f -lnagmpiwhere driver.f is your application program.
After the application is developed it may be linked with the IBM Parallel ESSL (if available). Some ScaLAPACK routines in the NAG Parallel Library may appear to 'hang' when linked with PESSL. To avoid this the environment variable PESSL_ERROR_SYNC must be set to 'no' when the application is run. IBM advise that PESSL_ERROR_SYNC should be set to 'no' only when the application is debugged. To link with the NAG Parallel Library and PESSL use:
mpxlf driver.f -lessl -lpessl -lblacs -lnagmpipessl
poe a.out -procs 4instructs the system to execute the executable program a.out in four parallel processes. Consult local documentation for full details of the facilities of poe or alternatives to it.
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. Almost all the example programs have 4 processes. nagmpiexample uses poe to run all these processes on the hosts specified in the file ./host.list
See Section 4 for additional documentation.
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 = 8.11296384146067D+31 X02BBF = 2147483647 X02BEF = 15 X02DAF = .FALSE.
On-line documentation is also 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 please quote your NAG site reference and NAG product code (in this case FDIB303DM).
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
http://www.nag.com/ (in North America)
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: email@example.com 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: firstname.lastname@example.org Tel: +1 630 971 2337 Tel: +1 630 971 2345 Fax: +1 630 971 2706 Fax: +1 630 971 2706 Nihon NAG KK Yaesu Nagaoka Building No. 6 1-9-8 Minato Chuo-ku Tokyo Japan email: email@example.com Tel: +81 (0)3 5542 6311 Fax: +81 (0)3 5542 6312