NAG DMC, Release 2

DRAI620DAL - License Managed

IBM AIX 64-bit, xlc_r

Installer's Note


1. Introduction

This Installer's Note is essential reading for whoever is responsible for the installation of this implementation of NAG DMC. It is available together with the Users' Note (un.html) on the distribution medium.

2. Implementation Provided

2.1. Applicability

This implementation is a compiled, tested, ready-to-use version of NAG DMC that is considered suitable for operation on the computer systems detailed below:

hardware:         IBM RISC/6000 64-bit
operating system: AIX 5.3 and compatible
C compiler:       VisualAge C++ Professional / C for AIX Compiler, Version 6 and compatible (xlc_r)

2.2. Derivation

This implementation was produced at NAG Ltd., Oxford on the computer system detailed below:

hardware:         IBM RISC/6000 64-bit
operating system: AIX 5.3
C compiler:       VisualAge C++ Professional / C for AIX Compiler, Version 6 (xlc_r)
compiler options: -O3 -qstrict -qarch=com -q64 -qthreaded

3. Distribution Medium

The software is ordinarily distributed in tar format on CD-ROM, also it can be downloaded from any of the NAG web sites.

3.1. Contents

The following shows the directory/file organization of the implementation materials as they will be installed.
                                |-- in.html   (Installer's Note (this document))
                |-- documents --|-- un.html   (User's Note)
                |               |-- *.html
                |               |-- *.pdf  
                |               |-- *.c
drai620dal -----|-- examples ---|-- *.dat
                |               |-- results --|-- *.r
                |-- include ----|-- *.h
                |-- library ----|-- libnagdmc.a
                |               |-- bin --|-- * (directories of binaries for
                |               |                supported platforms)
                |-- licence ----|-- README.TXT
                                |-- doc -- *    (End User Guide)

4. Installation

4.1. Product Installation

To install NAG DMC materials use the tar utility:

tar xvf /cdrom/dr20.tar
(assuming the CD-ROM has been mounted as /cdrom).

To simplify access you may wish to move the library (library/libnagdmc.a) to a system location such as /usr/lib, so that it is in the default search path of the linker during the link phase.

The include files, in directory include, should be moved to a directory such as /usr/include so that they can be accessed during compilation, e.g.,

mv include/*.h /usr/include

4.1.1. Licence Management

The use of NAG DMC is controlled by the Kusari licence management system. This release of NAG DMC uses version 2.2 of Kusari.

In order to enable the software, NAG will issue you with a licence key. The licence key is a simple text file containing details of the software that will be enabled.

To request a licence key, run the program khostid located in the licence/bin/aix64 subdirectory of the software distribution. This utility must be run from a command prompt. Return the information that it displays by e-mail (or FAX) to NAG.

A short term (demonstration or trial) licence key contains one or more lines like the following:

DRAI620DA TRIAL 2007/09/12 "EMnxdA3oeoj0F1Yvi5ibxPjB7"

Specifically, it has a line containing the word TRAIL and is referred to here as an uncounted licence key. Longer term uncounted licence keys must be locked to a specific computer, i.e., they will enable the software on one computer only. These licence keys include the word NODE instead of the word TRIAL above. Other types of keys may also be issued.

Once you have obtained the licence key, store the text of it in a file, say [INSTALL_DIR]/licence.lic.

For an uncounted licence, the location of the licence file must be made known to the NAG application by setting the environment variable NAG_KUSARI_FILE to the full pathname of the file before the application is invoked.

For example, in the C-shell, type:

  setenv NAG_KUSARI_FILE [INSTALL_DIR]/licence.lic
or in the Bourne shell, type:

No other actions are required to install an uncounted licence.

Further details about Kusari and how it may be configured to suit your local circumstances are included in the Kusari Licence Management documentation in the licence/doc subdirectory of the software distribution.

4.2. Documentation Installation

The documentation for NAG DMC is located in directory documents and comprises of PDF and HTML files. You are encouraged to make the documentation readily available to users.

4.3. Release to Users

The installer should ensure that the advice given to users in Sections 3.1 and 3.2 of the Users' Note (un.html) is suitable for the installation. This can be done by running a few example programs, in directory examples, following that advice. Results printed by example programs should be checked against the respective results located in directory examples/results.

The following material should also be made accessible to users:

compiled library:

include files:
example program material:
documentation files:

4.4. Example Programs

The example results distributed were generated at Release 2 of NAG DMC, using the software described in Section 2.2. These example results may not be exactly reproducible if the example programs are run in a slightly different environment (for example, a different C compiler, a different compiler library or different arithmetic hardware).

5. Support from NAG

(a) Contact with NAG

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).

(b) NAG Response Centres

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, 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 DRAI620DAL).

(c) NAG Websites

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, (in North America) or (in Japan)

(d) NAG Electronic Newsletter

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

6. User Feedback

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).

Appendix - Contact Addresses

Wilkinson House
Jordan Hill Road
OXFORD  OX2 8DR                         NAG Ltd Response Centre
United Kingdom                          email:
Tel: +44 (0)1865 511245                 Tel: +44 (0)1865 311744
Fax: +44 (0)1865 310139                 Fax: +44 (0)1865 310139
1431 Opus Place, Suite 220
Downers Grove
IL 60515-1362                           NAG Inc Response Center
USA                                     email:
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

Tel: +81 (0)3 5542 6311
Fax: +81 (0)3 5542 6312