.TH "Users'_Note" "3NAG" "04/02/98" "fl90"
.SH "Name"
nag_fn_un \- NAG fl90, Release 3, Users' Note
.SH "Title"
.B " NAG fl90, Release 3
.B " FNIB603D9
.B " IBM RISC System/6000, NAGWare f90
.B " Users' Note
.SH "Introduction"
This document is essential reading for every user of the NAG fl90
implementation specified in the title. It provides implementation-specific
detail that augments the information provided in the NAG fl90 Manual.
NAG recommends that users read the following minimum reference material before
calling any library procedure:
.in +5
.ti -4
(a) Essential Introduction
.ti -4
(b) Chapter Introduction
.ti -4
(c) Module Document
.ti -4
(d) Implementation-specific Users' Note
.in -5
Items (a), (b) and (c) are included in the NAG fl90 Manual; item (d) is this
document. Each NAG fl90 site is supplied with at least one copy of each of the
above.
Items (a) and (d) are provided in man page form.
.SH "General Information"
.SS "Accessing the Library"
Assuming that libnagfl90.a has been installed in /usr/local/lib or /usr/lib,
and that the module information files have been moved to
/usr/local/lib/fl90_modules, then a user may link to NAG fl90 in the
following manner:
f90 -I/usr/local/lib/fl90_modules driver.f90 -lnagfl90
where driver.f90 is the user's application program.
.SS "Example Programs"
The example programs, data and the results obtained during the preparation of
this specific implementation are supplied so you can try them yourself, or use
one as a template for your own program. Note that the example material has been
adapted, if necessary, from that printed in the NAG fl90 Manual, so that
programs are suitable for execution with this implementation.
The example programs are most easily accessed by the command nagexample,
which will provide you with a copy of an example program (and its data, if
any), compile the program and link it with the library (showing you the
compile command so that you can recompile your own version of the program).
Finally, the executable program will be run, presenting its output to
stdout. The example program concerned is specified by the argument to
nagexample, e.g.
nagexample nag_lib_support_ex01
will copy the example program into the file nag_lib_support_ex01.f90 in the
current directory and process it to produce the example program results.
Further usage details may be obtained by issuing the command nagexample
without arguments.
.SS "On-line User Documentation"
The following information is available in man page form:
.nf
Essential Introduction - nag_fn_essint
Tutorial - nag_fn_tutorial
Conversion from the NAG Fortran 77 Library - nag_fn_conversion
List of Contents - nag_fn_contents
Future Developments - nag_fn_future
Release 3 News - nag_fn_news
Users' Note - nag_fn_un
.fi
Most of the above documents are also available as HTML pages.
.SH "Special Functions"
The constants referred to in the NAG fl90 Manual have the following values in
this implementation:
.nf
nag_gamma error%code = 201 if X > 170.0
error%code = 202 if abs(X) < 2.23E-308
nag_log_gamma error%code = 201 if X > 2.55E+305
nag_erfc x(hi) = 26.6
x(low) = -6.25
nag_erf x(hi) = 6.25
nag_bessel_y0 error%code = 201 if X > 1.0E+16
nag_bessel_y1 error%code = 202 if X > 1.0E+16
error%code = 201 if 0.0 < X <= 2.23E-308
nag_bessel_y error%code = 201 if abs(Z) < 3.93E-305
error%code = 202 if abs(Z) or NU+N-1 > 1.07E+9
error%code = 203 if abs(Z) or NU+N-1 > 3.27E+4
nag_bessel_j0 error%code = 201 if abs(X) > 1.0E+16
nag_bessel_j1 error%code = 201 if abs(X) > 1.0E+16
nag_bessel_j error%code = 201 if imag(Z) > 700.0
error%code = 202 if abs(Z) or NU+N-1 > 1.07E+9
error%code = 203 if abs(Z) or NU+N-1 > 3.27E+4
nag_bessel_k1 error%code = 201 if 0.0 < X <= 2.23E-308
nag_bessel_k error%code = 201 if abs(Z) < 3.93E-305
error%code = 202 if abs(Z) or NU+N-1 > 1.07E+9
error%code = 203 if abs(Z) or NU+N-1 > 3.27E+4
nag_bessel_i0 error%code = 201 if abs(X) > 711.6
nag_bessel_i1 error%code = 201 if abs(X) > 711.6
nag_bessel_i error%code = 201 if real(Z) > 700.0
error%code = 202 if abs(Z) or NU+N-1 > 1.07E+9
error%code = 203 if abs(Z) or NU+N-1 > 3.27E+4
nag_ell_rd error%code = 201 if an argument < 1.579E-205
nag_ell_rj error%code = 201 if an argument < 2.820E-103
nag_airy_ai error%code = 203 if abs(Z) > 1.02E+3
error%code = 204 if abs(Z) > 1.04E+6
nag_airy_bi error%code = 203 if abs(Z) > 1.02E+3
error%code = 204 if abs(Z) > 1.04E+6
.fi
.SH "Additional Services from NAG"
.ti -4
(a) Documentation
Each NAG fl90 site is provided with a printed copy of the NAG fl90 Manual.
Additional manuals are available at prices published in the NAG
documentation order form.
NAG fl90 TextWare, a hypertext version of the full manual, is bundled with
this implementation. For a list of supported platforms, see the Installers'
Note for the TextWare product.
.SH "Support from NAG"
.ti -4
(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 write to NAG directly, at one of the supplied
addresses. Users subscribing to the support service are encouraged to contact
one of the NAG Response Centres (see below).
.ti -4
(b) NAG Response Centres
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 user reference and NAG
product code.
.ti -4
(c) Network
Network, NAG's newsletter, is produced periodically and sent free of charge to
sites with a supported product or service.
.ti -4
(d) NAG Website
The NAG Website is an information service providing items of interest to users
and prospective users of NAG products and services. The information is
regularly updated and reviewed and includes implementation availability,
descriptions of products, downloadable software and technical reports. The NAG
Website can be accessed at
.nf
http://www.nag.co.uk/ or
http://www.nag.com/ (in the USA)
.fi
.SH "NAG Users Association"
NAGUA, the NAG Users Association, is a self-financing, non-profitmaking body.
It exists to promote communications between NAG and users of its products and
services. It provides information to NAG on the requirements of users, who are
in turn kept informed of developments in services. Membership is available to
any institution or individual holding a licence for any NAG product or service.
Members receive discounts on the registration fees at conferences and
workshops.
For an information pack and membership application form, please contact NAGUA
at the supplied address.
.SH "Appendix - supplied addresses"
.nf
NAG Ltd
Wilkinson House
Jordan Hill Road
OXFORD OX2 8DR NAG Ltd Response Centre
United Kingdom email: support@nag.co.uk
Tel: +44 1865 511245 Tel: +44 1865 311744
Fax: +44 1865 310139 Fax: +44 1865 310139
NAG Inc
1400 Opus Place, Suite 200
Downers Grove
IL 60515-5702 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 2346
NAG Users Association
PO Box 426
OXFORD OX2 8SD
United Kingdom
email: nagua@nag.co.uk
Tel: +44 1865 311102