.TH "Users'_Note" "3NAG" "19/01/98" FNSOL03DE "fl90" .SH "Name" nag_fn_un \- NAG fl90, Release 3, Users' Note .SH "Title" .B " NAG fl90, Release 3 .B " FNSOL03DE .B " Sun SPARC (Solaris), EPC Fortran 90 .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 the library object files have been installed in /usr/local/lib/fnsol03de/NAGLIB_FCE, then a user may link to NAG fl90 in the following manner: .nf i) Modify the program unit catalog list file (work.pcl) to specify the search path for the program unit catalog, called work.pc, in the NAGLIB_FCE directory. For example, work.pcl should contain: work.pc /usr/local/lib/fnsol03de/NAGLIB_FCE/work.pc and the search paths of other program units' catalogs, if any, that will be used. ii) Compile and bind the program using the command line: epcf90 -bd, driver.f90 where driver.f90 is the user's application program and is the name specified in the PROGRAM statement of the main program. .fi .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.3E+8 nag_bessel_y1 error%code = 202 if X > 1.3E+8 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.34E+8 error%code = 203 if abs(Z) or NU+N-1 > 1.15E+4 nag_bessel_j0 error%code = 201 if abs(X) > 1.3E+8 nag_bessel_j1 error%code = 201 if abs(X) > 1.3E+8 nag_bessel_j error%code = 201 if imag(Z) > 700.0 error%code = 202 if abs(Z) or NU+N-1 > 1.34E+8 error%code = 203 if abs(Z) or NU+N-1 > 1.15E+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.34E+8 error%code = 203 if abs(Z) or NU+N-1 > 1.15E+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.34E+8 error%code = 203 if abs(Z) or NU+N-1 > 1.15E+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) > 511.0 error%code = 204 if abs(Z) > 2.62E+5 nag_airy_bi error%code = 203 if abs(Z) > 511.0 error%code = 204 if abs(Z) > 2.62E+5 .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