This document is essential reading for whoever is responsible for the installation of the NAG C Library implementation specified in the title. The installer will be supplied with a printed copy of this document. Both this document and the Users' Note are supplied on the distribution medium in plain text form (IN.TXT and UN.TXT) and HTML form (IN.HTML and UN.HTML).
Whenever the NAG C 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. 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 C Library that is considered suitable for operation on the computer systems detailed below:
hardware: all systems in the DEC Alpha AXP range operating system: Alpha AXP OpenVMS V6.1 and compatible C compiler: DEC C Version 4.1 and compatible
For information about implementations of the NAG C Library for use on other computer systems please contact NAG.
This implementation was produced at NAG Ltd., Oxford on the computing system detailed below:
hardware: DEC 3000 AXP model 500 operating system: Alpha AXP OpenVMS V6.1 C compiler: DEC C Version 4.1
The entire NAG C Library, Mark 6, was compiled with full optimization which, in this case, is the default optimization and is equivalent to:
OPTIMIZE = (INLINE=AUTOMATIC,LEVEL=4,UNROLL=0)
The library was also compiled with the following options:
STANDARD=ANSI89 PREFIX_LIBRARY_ENTRIES=ALL_ENTRIES PRECISION=DOUBLE
The compiler option 'PRECISION=DOUBLE' is necessary for the compiler to use double precision because the default precision for the compiler option 'STANDARD=ANSI89' is 'PRECISION=SINGLE'.
The use of the compiler option 'PREFIX_LIBRARY_ENTRIES=ALL_ENTRIES' automatically makes available, at link time, the DEC C Run-Time Library (RTL) shareable image DECC$SHR.EXE in the ALPHA$LIBRARY directory, thus substantially simplifying the linking of a C program to the DEC C RTL.
The implementation is distributed on CD-ROM, labelled CLDAV06DA with save set name CLDAV06DA.BCK, unless otherwise indicated on the medium and accompanying despatch note.
For further details, refer to other documentation supplied or contact
NAG (see Section 6).
The following shows the directory/file organization of the library materials as they will be installed.
|-- in.html |-- in.txt |-- doc --|-- un.html | |-- un.txt cldav06da --| |-- calls.txt | |-- libnagc06.olb | |-- include --|-- *.h | | |-- source ---|-- %%%%%%e.c |-- examples --|-- data -----|-- %%%%%%e.d |-- results --|-- %%%%%%e.rLocated within the NAG C root directory is the following file:
LIBNAGC06.OLB - the NAG C Library, Mark 6, object module formLocated within the sub-directory [.DOC] are the following files:
IN.HTML - the Installer's Note for this implementation (html format) IN.TXT - the Installer's Note for this implementation (text format) UN.HTML - the Users' Note for this implementation (html format) UN.TXT - the Users' Note for this implementation (text format) CALLS.TXT - the NAG C Library, Mark 6 calls fileLocated within the sub-directory [.INCLUDE] are the following files:
*.H - the NAG C include filesThese could be kept in the include sub-directory under the CLDAV06DA directory as supplied. Alternatively, these header files could be moved to a location in the system area, usually SYS$SYSROOT:[SYSLIB], where other system include files are, as indicated in Section 4.1, so long as the logical symbol pointing to that location is appropriately set up.
Located within the sub-directory [.EXAMPLES.SOURCE] are the following files:
*.C - the C source text of the example programs associated with the functionsLocated within the sub-directory [.EXAMPLES.DATA] are the following files:
*.D - the data required to run the example programsLocated within the sub-directory [.EXAMPLES.RESULTS] are the following files:
*.R - the results produced by the examples programs
compiled library: 25200 blocks include files: 2100 blocks example program material: 5300 blocks documentation files: 400 blocksAll of these should be made permanently available on disk.
$ SET FILE/ATTRIBUTE=(LRL:8192,RFM:FIX) CLDAV06DA.BCKTo install the materials from CD-ROM, the backup save set must first be copied to the hard disk.
$ MOUNT/MEDIA=CDROM/UNDEFINED_FAT=fixed:none:8192 DKA400: CLDAV06DA
$ COPY DKA400:[000000]CLDAV06DA.BCK []
$ BACKUP CLDAV06DA.BCK/SAV/SELECT=[MIKEG...]*.* [...]
$ DISMOUNT DKA400:
$ SET PROTECTION=W:RE USER1:[SYSTEM.SYSLIB.CLDAV06DA]LIBNAGC06.OLB
$ DEFINE/JOB LNK$LIBRARY ALPHA$LIBRARY:LIBNAGC06.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 installer 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, e.g. by linking explicitly with the library in each LINK command.
$ USER1:[SYSTEM.SYSLIB.CLDAV06DA.INCLUDE]It is recommended that the NAG-supplied include files be moved to a location under the system directory, usually SYS$SYSROOT:[SYSLIB], and a logical symbol be set up as follows:
$ DEFINE/JOB DECC$SYSTEM_INCLUDE SYS$SYSROOT:[SYSLIB]If the installer has sufficient privileges, the JOB qualifier may be replaced with the GROUP or the SYSTEM qualifier. The advantage of this is that it would not be necessary to specify the NAG include directory when compiling any of the source files supplied.
The installer should ensure that the advice given to users in Section 3.1 of the Users' Note ([.DOC]UN.TXT and [.DOC]UN.HTML) is suitable for the installation. This can be done by running a few example programs following that advice; a suitable sample would be A02BAC, G05FFC and S17AKC.
The following material should also be made accessible to users:
compiled library: LIBNAGC06.OLB documentation files: [.DOC]CALLS.TXT include files: [INCLUDE]*.H example program material: [.EXAMPLES.SOURCE]%%%%%%E.C [.EXAMPLES.DATA]%%%%%%E.D [.EXAMPLES.RESULTS]%%%%%%E.R
Note that the example material has been adapted, if necessary, from that printed in the NAG C Library Manual, so that programs are suitable for execution with this implementation with no further changes. Making the example material directly available to users provides them with easily adaptable templates for their own problems.
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 CLDAV06DA).
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/ (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 NAG Inc 1431 Opus Place, Suite 220 Downers Grove IL 60515-1362 NAG Inc Response Center USA email: infodesk@nag.com Tel: +1 630 971 2337 Tel: +1 630 971 2345 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: help@nag-j.co.jp Tel: +81 (0)3 5542 6311 Fax: +81 (0)3 5542 6312