This document is essential reading for every user of the NAG DMC implementation specified in the title. It provides implementation-specific detail that augments the information provided in the documentation.
In addition, NAG recommends that before calling any NAG DMC function you should read the following reference material (see Section 4):
(a) Essential Introduction
(b) User Guide
(c) Function Document
Assuming that libnagdmc.a has been installed in a directory in the search path of the linker, such as /usr/lib, and that NAG DMC include files have been moved to /usr/include, then you may link to NAG DMC in the following manner:
xlc_r -q64 -qthreaded -o driver.exe driver.c -lnagdmc -lmwhere driver.c is your application program. If libnagdmc.a is in a location other than /usr/lib, such as /opt/NAG/lib, and the include files are in a location other than /usr/include, such as /opt/NAG/include, then you may link to NAG DMC in the following manner:
xlc_r -q64 -qthreaded -o driver.exe -I/opt/NAG/include driver.c -L/opt/NAG/lib -lnagdmc -lm
A number of example programs are provided in the directory examples. Where an example program refers to a data file, users should check that the file name (including path) is appropriate for their system before compiling the source text.
In order to compile and link an example, say pca_ex.c, copy the source files from the directory examples to your current directory. If a data file is required, copy the data file from the directory examples to the current directory or modify the source text to include the path to the data file.
Issue the compilation command
xlc_r -q64 -qthreaded -o pca_ex.exe pca_ex.c -lnagdmc -lm
This command will create in the current directory an executable file called pca_ex.exe.
Documentation is provided in the form of a set of PDF files, and is available in the documents directory.
NAG DMC documentation consists of:
In addition the Users' Note (this document) is provided.
Queries concerning this document or the implementation generally should be directed initially to your local Advisory Service. If you have difficulty in making contact locally, you can contact NAG directly at one of the addresses given in the Appendix. Users subscribing to the support service are encouraged to contact one of the NAG Response Centres (see below).
The NAG Response Centres are available for general enquiries from all users and also for technical queries from sites with support service.
The Response Centres are open during office hours, but contact is possible by fax, e-mail 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 DRAI620DAL).
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:
http://www.nag.co.uk/, http://www.nag.com/ or http://www.nag-j.co.jp/
If you would like to be kept up to date with news from NAG then please register to receive our free electronic newsletter, which will alert you to special offers, announcements about new products or product/service enhancements, customer stories and NAG's event diary. You can register via one of our websites, or by contacting us at: firstname.lastname@example.org.
Many factors influence the way NAG's products and services evolve and your ideas are invaluable in helping us to ensure that we meet your needs. If you would like to contribute to this process we would be delighted to receive your comments. Please contact your local NAG Response Centre (shown below).
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 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: email@example.com Tel: +81 (0)3 5542 6311 Fax: +81 (0)3 5542 6312