NAG Fortran SMP Library, Release 1.1 FSNTI11DD Windows NT Digital Visual Fortran 90, Double Precision Installer's Note Contents 1. Introduction 2. Applicability 3. Distribution Medium 3.1. Recording Details 3.2. Contents 3.3. File Sizes 4. Library Installation 4.1. Installation from CD 4.2. Installation and Configuration 4.3. Checking Accessibility 4.4. Release to Users 5. Library Derivation 6. Additional Services from NAG 7. Support from NAG 8. NAG Users Association 1. Introduction This document is essential reading for the NAG Site Contact responsible for installation and maintenance of the NAG Fortran SMP Library Implementation specified in the title. The installer will be supplied with a printed copy of this document. Both this and the Users' Note are supplied on the distribution medium. Whenever the NAG Fortran SMP 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 7). 2. Applicability This implementation is a compiled, tested, ready-to-use version of the NAG Fortran SMP Library that is considered suitable for operation on the computer systems detailed below: hardware: PC compatible systems operating system: Windows NT 4.0 or above Fortran compiler: Digital Visual Fortran version 5.0 For information about implementations of the NAG Fortran SMP Library for use on other computer systems please contact NAG. 3. Distribution Medium 3.1. Recording Details The implementation is distributed on CD-ROM, unless otherwise indicated on the medium and accompanying despatch note. For further details, refer to other documentation supplied or contact NAG (see Section 7). 3.2. Contents The following describes the materials as they will be installed. The fsnti11da\ directory contains: naglibsmp.lib - compiled library The fsnti11da\doc directory contains: in.txt - Installer's Note un.txt - Users' Note, plain text form essint - Essential Introduction to the NAG Fortran Library summary - brief summary of routines blas_lapack_to_nag - BLAS/F06, LAPACK/F07 and LAPACK/F08 listing nag_to_blas_lapack - F06/BLAS, F07/LAPACK and F08/LAPACK listing calls - a list of routines called by each Library routine and example program called - for each Library routine, a list of routines and examples programs which call it SMP.html - HTML page describing the NAG Fortran SMP Library *.html - HTML pages *.gif - image files for HTML pages The fsnti11da\interface_blocks directory contains: *.mod - modules which allow the Fortran 90 compiler to check that NAG Fortran SMP Library routines are called correctly The fsnti11da\examples directory contains: source\*.for - example program source data\*.dat - example program data results\*.res - example program results The fsnti11da\batch directory contains: nagex.bat - batch file to run example programs 3.3. File Sizes The files sizes are given below. The actual disk space used is dependent on the hard disk allocation unit (cluster) size (this information is supplied by the DOS command CHKDSK): compiled library: 12.0 Mb interface blocks: 1.8 Mb example program material: 4.2 Mb documentation files: 2.3 Mb 4. Library Installation 4.1. Installation from CD The CD should autorun on Windows 95 and NT 4.0 systems, and will then lead you to a dialogue for installation. If you wish to install the product from the NAG PCCD (multi-product CD) but the autorun facility does not operate, please see the instructions printed on the CD for further guidance. If you are installing from a single-product CD and the autorun facility does not operate, then double click on the setup.exe file on the CD using Windows Explorer. Any continuing difficulties indicate a problem which should be reported to the NAG Response Centre (see Section 7). Please note that administrator privileges are required if you wish to install this product on a Windows NT system. 4.2. Installation and Configuration The installation program will ask you for the drive and directory where you would like to install the library materials. You will also be asked which parts of the materials you want to install. The installation program may be used to install all the materials from CD-ROM or just some part of it, for example the library. This is useful if some files have become corrupt. After installation you should ensure that the software described in Section 3.2 is present and accessible. An uninstall facility is provided. This will remove the product from the user's disk. It will also undo the registry entries made during installation. If a re-installation is performed, for example to add a component that wasn't originally installed, the uninstall facility will remove only the most recently added files. (However, it will still remove all the registry entries associated with this software.) The uninstaller will not remove files created since the installation was completed (although it will remove original files that have been modified), so the user may have to delete these files to complete the removal. The NAG Fortran Library Interface Blocks define the type and arguments of each user callable NAG Fortran Library routine. These are not essential to calling the NAG Fortran Library from Fortran 90 programs. Their purpose is to allow the Fortran 90 compiler to check that NAG Fortran Library routines are called correctly. The interface block files (interface_blocks\*.mod) are supplied in pre-compiled module form. They should be made accessible to the user. The batch file nagex.bat requires the setting of the environment variable nagsmpdir. It should be set to the root directory of the NAG materials. This can be done by setting the value in the Control Panel | System Properties dialog. If the default location is used, set the variable to nagsmpdir and the value to c:\fsnti11d The batch file should be made accessible to the user (for example, copying the file to a directory in the user's path, e.g. c:\utils). 4.3. Checking Accessibility The installer should ensure that the advice given to users in Section 2.1 of the Users' Note is suitable for the installation. This can be done by running a few example programs following that advice; a suitable sample would be A02AAF, F08FEF, G05FFF and X03AAF. The installation can also be tested by using the nagex.bat batch file. This batch file will copy an example program and its data, compile it, link it with the library and run it. To run an example program, create, for example, the directory c:\test. Make c:\test the current directory, copy the file nagex.bat to it and then give, for example, the command: nagex c06eaf 4.4. Release to Users The supplied Users' Note should be checked and amended as necessary (particularly Section 2.1). It can then be made available to users directly, or be absorbed into local access information. The Users' Note is provided in plain text form in un.txt. The following material should also be made accessible to users: documentation files: doc\essint doc\summary doc\calls doc\called doc\*.html doc\*.gif compiled library: naglibsmp.a interface block files: interface_blocks\*.mod example program material: examples\source\*.for examples\data\*.dat examples\results\*.res batch\nagex.bat Note that the example material has been adapted, if necessary, from that supplied in the NAG Fortran SMP Library on-line documentation (TextWare) and in the NAG Fortran SMP Library Manual, so that programs are suitable for execution with this implementation with no further changes. Making the supplied example material directly available to users provides them with easily adaptable templates for their own problems. 5. Library Derivation This implementation was produced at NAG Ltd., Oxford on the computing system detailed below: hardware: Compaq 4 processor, Pentium Pro System operating system: Windows NT 4.0 Fortran compiler: Digital Visual Fortran version 5.0 utilities: Intel MKL library version 2.1 Kuck & Associates KAP/Pro Guide package version 3.5 The entire NAG Fortran SMP Library, Release 1.1, was compiled with optimization (optimize:4), except for the following routines, which had to be compiled at lesser optimization levels: g01haf g03caf g07dcf The following routines were compiled with the compiler flags: /recursive /fast /threads c06fff c06fkf c06fpf c06fph c06fpj c06fpn c06fpp c06fqf c06fqh c06fqj c06frf c06frn c06frp c06fuf c06fuk c06ful c06fum c06fun c06fux c06fuy c06fxf c06haf c06hbf c06hcf c06hdf c06ncq c06ncs c06nct c06ncu c06ncv c06ncw c06nxs c06nxt c06nxu c06nxv c06paf c06paq c06paz c06pcf c06pcq c06pcy c06pcz c06pff c06pfw c06pfx c06pfy c06pfz c06pjf c06pjq c06pjr c06pjs c06pjt c06pju c06pjv c06pjw c06pjx c06pjy c06pjz c06pkf c06pkq c06pkx c06pky c06ppf c06ppp c06ppq c06ppt c06ppu c06ppv c06ppw c06ppx c06ppy c06ppz c06prf c06prh c06prj c06prk c06prl c06prn c06prp c06prq c06prz c06puf c06puj c06puk c06pul c06pum c06pun c06pup c06puq c06puu c06puv c06puw c06pux c06pxf c06pxk c06pxl c06pxm c06pxn c06pxp c06pxq c06pxr c06pxs c06pxt c06pxu c06pxv c06pxw c06pxx c06pxy c06pxz c06raf c06rbf c06rcf c06rdf c06zav c06zaw c06zax c06zay c06zaz f07adf f07ads f07adt f07adu f07adv f07adw f07adx f07aef f07aez f07fdf f07fdy f07fef f08aef f08aeq f08aer f08aes f08aet f08aeu f08aff f08afy f08agf f08fef f08fes f08fet f08feu f08fev f08few f08fex f08fff f08ffy f08ffz f08jef f08jek f08jel f08jem f08jen f08jep f08jeq f08jer f08jes f08jet f08jeu In addition the following routines were compiled using Guide with the following options: -WG,-roundoff=1,-o=0 c06fff c06fkf c06fph c06fqh c06frp c06fuy c06fxf c06haf c06hbf c06hcf c06hdf c06pfw c06pfx c06pjq c06pjr c06pjs c06pjt c06pju c06pjv c06pjw c06pjx c06pjy c06pjz c06pkx c06pky c06ppu c06ppx c06prh c06prj c06prl c06puj c06pup c06puu c06puv c06puw c06pux c06pxk c06pxl c06zax f07adf f07aef f07fdf f07fdy f07fef f08aef f08aff f08agf f08fef f08ffz f08jef In the naglibsmp.lib library, calls to all the Basic Linear Algebra Subprograms (BLAS) are implemented by calls to the Intel MKL Library. 6. Additional Services from NAG (a) Documentation The Windows 95/NT version of NAG Fortran Library TextWare, a hypertext version of the full Fortran Library manual, is bundled with this implementation. Note: SMP-specific documentation is included as a separate "chapter" at the end of the "book". Each NAG Fortran SMP Library site is provided with a printed copy of the NAG Fortran SMP Library Manual (which supplements the full NAG Fortran Library Manual). Additional SMP manuals and printed copies of the full Fortran Library manual are available at prices published in the NAG documentation order form. 7. 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 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). (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. (c) Network Network, NAG's newsletter, is produced periodically and sent free of charge to sites with a supported product or service. (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 http://www.nag.co.uk/ or http://www.nag.com/ (in the USA) 8. 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. Appendix - supplied addresses 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 [NP3309/IN]