NAGWare Fortran Tools, Release 4.0 NQW3240NA Windows 95/98/NT/2000 Installer's Note Contents 1. Introduction 2. Implementation Provided 2.1. Applicability 2.2. Derivation 3. Distribution Medium 3.1. Recording Details 3.2. Contents 3.3. File Sizes 4. Installation 4.1. Installing the NAGWare Fortran Tools 4.2. License Management 4.3. Testing the Installation 5. Support from NAG 6. User Feedback Appendix - Contact Addresses 1. Introduction This document is essential reading for the NAG Site Contact responsible for installation and maintenance of the NAGWare Fortran Tools Implementation specified in the title. The installer will be provided with a printed copy of this document which is also supplied on the distribution medium. 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 5). 2. Implementation Provided 2.1. Applicability This implementation is a compiled, tested, ready-to-use version of the NAGWare Fortran Tools that is considered suitable for operation on the computer systems detailed below: hardware: Intel compatible PC operating system: Windows 95, 98, NT and 2000 display: At least an 800x600 pixel display, 1024x768 is recommended For information about implementations of the NAGWare Fortran Tools for use on other computer systems please contact NAG. 2.2. Derivation This implementation was produced at NAG Ltd., Oxford on the computing system detailed below: hardware: Dell Pentium II system operating system: Windows NT 4.0 C compiler: Microsoft Visual C++ 4.0 Fortran compiler: Compaq Visual Fortran 6.1 Tcl/Tk: 8.2.2 The entire NAGWare Fortran Tools suite, Release 4.0, was compiled with full optimisation. 3. Distribution Medium 3.1. Recording Details This 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 5). 3.2. Contents The following shows the directory organisation of the materials as they will be installed. |-- bin | |-- demo | |-- doc | |-- f77_tools |-- examples --| NAGWare --| |-- f95_tools |-- f77_tools | |-- f95_tools | |-- license | |-- tk_lib | |-- tutorial NAGWare\bin contains the NAGWare Fortran Tools, GUI executables and DLLs. The key file in this directory is: run_nag_tools.exe - the interface to run the NAGWare Fortran Tools GUI NAGWare\demo contains a self-running demonstration of the tools. NAGWare\doc\in.txt is this Installer's Note. NAGWare\doc\license.txt contains further license management information. NAGWare\examples contains the example program fragments from the NAGWare Fortran Tools Tutorials in two subdirectories. NAGWare\f77_tools contains the NAGWare f77 Tool executables. NAGWare\f95_tools contains the NAGWare f95 Tool executables. NAGWare\license contains the FLEXlm license management software referred to in Section 4.2. NAGWare\tk_lib contains the GUI support files, including help files. NAGWare\tutorial contains tutorials for both f77 and f95 Tools in HTML format. 3.3. File Sizes The file 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). tool and GUI executables: 17.9 Mb GUI support files: 269 kb documentation files: 91 kb example program material: 25 kb demonstration files: 39 kb In addition the FLEXlm files require approximately 15.8 Mb disk space, but most of this can be deleted after installation. 4. Installation 4.1. Installing the NAGWare Fortran Tools The CD should autorun and will then lead you to a dialogue for installation. If the autorun facility does not operate, then double click on the setup.exe file on the CD using Windows Explorer. The installation program will suggest a default location for the tools, c:\NAGWare. This can be changed to a different drive and directory if required. After the installation has completed, a shortcut to the tools labelled "NAGWare Fortran Tools" should be present on your desktop. On Windows 95/98 systems, if this is not the case, drag the shortcut from the Windows\Desktop directory to your desktop. 4.2 License Management The use of the NAGWare Fortran Tools is controlled by the FLEXlm network license management system. FLEXlm is a registered trademark of Globetrotter Software Inc. Most users will want to run NAGWare Fortran Tools on a single PC and this section describes in detail the mechanism for licensing in this environment. For more information on license types and license software please refer to the file NAGWare\doc\license.txt. NAGWare Fortran Tools can also be licensed to run from any PC on a network; however the mechanism is more complex and may require the assistance of the local systems administrator. If you want to install NAGWare Fortran Tools on a number of machines on a network please refer to the file NAGWare\doc\license.txt. A license for a single PC is called an uncounted license and is bound to a PC through the volume serial number of the PC's Windows drive (where the Windows directory is installed); this will normally be the C drive. To obtain the volume serial number, type "vol" in an MS-DOS window while accessing the appropriate drive. To obtain the appropriate license key, contact the NAG Response Centre quoting the volume serial number of your machine and specify that you wish to obtain an uncounted PC license for NAGWare Fortran Tools. You will then receive your license information, usually by email or fax. The information that you receive from NAG contains a FEATURE line describing the product being licensed. This line has to be inserted into a license file (say c:\flexlm\naglm\license.dat). The license file is a text file (usually created using a text editor, for example EDIT) and the FEATURE line must occupy a single record; none of the characters in the FEATURE line may be modified or the license will be invalid. The format of the FEATURE line of a NAGWare Fortran Tools license is as follows: FEATURE NAGWareFtools NAG 4.000 01-jan-0000 0 2CE45AEB6D064ACEBE61 "W32," \ DISK_SERIAL_NUM=b0d85e5b This enables the use of version 4.0 of the application NAGWareFTools with no time limit on the system with the specified volume serial number. Note that the line is continued by escaping the newline character with "\". To activate the license, the location of this file must be made known to NAGWare Fortran Tools. This is done by setting the environment variable LM_LICENSE_FILE to the full pathname of the license file. Using the license file described above as an example, under Windows 95/98 this can be done by adding the line set LM_LICENSE_FILE=c:\flexlm\naglm\license.dat to the autoexec.bat file and then rebooting the system. Under Windows NT/2000, LM_LICENSE_FILE can be added as a system or user environment variable using the Control Panel | System Properties dialog. 4.3. Testing the Installation Create a directory (folder) in a suitable place for testing. Set the working directory of the NAGWare Fortran Tools shortcut to this directory (click on the icon with the right mouse button, then select Properties, followed by Shortcut and edit the 'Start in' directory). Copy the example programs from NAGWare\examples\f77_tools and NAGWare\examples\f95_tools to separate subdirectories of this directory. Now start the GUI by double clicking on the NAGWare Fortran Tools icon. Test the help system by clicking on the Help menu button. Select NAGWare f95 Tools from the menu which should display the nagware_f95_tools.help file. Check that the hypertext links cause the appropriate help files to be displayed in separate windows. If all is working dismiss the help windows. f77 Tools Select "Select file" from the "File" menu. The directory browser will display the subdirectories that you created. Double click on the directory name containing the f77 Tools examples and then double click on the file "untidy.f". From the "Tools" menu select "f77 Polisher". Follow the instructions in the Tutorial which may be found in NAGWare\tutorial\f77_tutorial.html to execute the tool. Further examples from the Tutorial may be used to test the f77 Tools thoroughly. f95 Tools Select "Select file" from the "File" menu and double click on ".." to go back to the parent directory. Double click on the directory name containing the f95 Tools examples and then double click on the file "untidy.f90". From the "Tools" menu select "f95 Polisher". Follow the instructions in the Tutorial which may be found in NAGWare\tutorial\f95_tutorial.html to execute the tool. Further examples from the Tutorial may be used to test the f95 Tools thoroughly. Additionally the self-running demonstration may be used to run a subset of the tools. 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 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 site reference and NAG product code (in this case NQW3240NA). (c) NAG Websites The NAG websites are an information service providing items of interest to users and prospective users of NAG products and services. The information is reviewed and updated regularly and includes implementation availability, descriptions of products, downloadable software, product documentation and technical reports. The NAG websites can be accessed at http://www.nag.co.uk/ or http://www.nag.com/ (in North America) or http://www.nag-j.co.jp/ (in Japan) (d) NAG Electronic Newsletter If you would like to be kept up to date with news from NAG you may want to register to receive our electronic newsletter, which will alert you to special offers, announcements about new products or product/service enhancements, case studies and NAG's event diary. To register visit one of our websites or contact us at nagnews@nag.co.uk. 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. We have provided a short survey on our website at www.nag.co.uk/local/feedback to enable you to provide this feedback. Alternatively feel free to contact the appropriate NAG Response Centre who will be happy either to record your comments or to send you a printed copy of the survey. Appendix - Contact Addresses 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 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 Nihon NAG KK Yaesu Nagaoka Building No. 6 1-9-8 Minato Chuo-ku Tokyo Japan email: help@nag-j.co.jp Tel: +81 (0)3 5542 6311 Fax: +81 (0)3 5542 6312 [NP3541/IN]