Compaq Visual Fortran-Installing-&-Get-Started

README.TXT File Release notes for the IMSL(R) Fortran 90 MP Library Version 4.01 This document contains release notes for the IMSL Fortran 90 MP Library version 4.01 for Microsoft Windows NT(R) and Microsoft Windows95(R). The information in this document is more up-to-date than the information in the User's Guide and in On-line Help. Copyright (c) 1999, an unpublished work by Visual Numerics, Inc. All rights reserved. The contents of these disks are subject to the accompanying software license agreement. Use of the Visual Numerics products and/or technical data by the US government or any agency thereof is subject to theRestricted Rights provisions of DFARS 252.227-7013 (c)(1)(ii) for Defense agencies, or FAR 52.227-19 for other agencies. ==========================< Contents >============================== This file has 7 parts: Part Contents ---- -------- 1 Introduction 2 Release Notes - Optional Third-Party Software - New Abilities of IMSL Fortran 90 MP Library, Version 4.01 - Documentation - Bug Fixes and Improvements 3 Installation - Validate the Installation 4 Using the IMSL Fortran 90 MP Library - Setting up the IMSL Libraries Environment - Using the Libraries from the Command Console - Using the Libraries from the Microsoft Developer Studio - On-Line Documentation - Examples 5 Miscellaneous Information - Known Problems, Limitations, and Differences - Performance Enhancements - Modules and Include Files - Using Library Functions in Mixed-Mode Programming Environment - Modifying the IMSL Fortran 90 MP Library Error Message File 6 Directory Layout and Description 7 Tables - IMSL Level 1 BLAS - IMSL Level 2 and Level 3 BLAS 8 Customer Support - =======================< Part 1: Introduction >===================== This file contains Release Notes and information about the installation and usage the the IMSL Fortran 90 MP Library. Since the "Installation" section applies to the installation of the product, it is not necessary that the user refer to this section. =====================< Part 2: Release Notes >====================== - Optional Third-Party Software o ScaLAPACK ScaLAPACK is a large-scale linear algebra computational package. Visual Numerics provides an "interface" to these routines which help with the correct usage of the ScaLAPACK subroutines. ScaLAPACK is not actually used by any Fortran 90 MP Library routines and is therefore not required unless you plan to use ScaLAPACK subroutines in your application. The version of ScaLAPACK used by Visual Numerics for testing purposes is documented in the environment specific README file. o BLACS The Basic Linear Algebra Communication Subprograms (BLACS) are required by ScaLAPACK. The IMSL Fortran 90 MP Library does not require the BLACS to run. Therefore, unless you intend to use ScaLAPACK this subroutine package is not required. The version of the BLACS used by Visual Numerics for testing purposes is documented in the environment specific README file. - New Abilities of IMSL Fortran 90 MP Library, Version 4.01 There are two new chapters, each adding major functionality to the product: * ScaLAPACK Utilities and Large-Scale Parallel Solvers * Partial Differential Equations o ScaLAPACK Utilities and Large-Scale Parallel Solvers The "ScaLAPACK Utilities" chapter describes an interface to the large-scale linear algebra computational package, ScaLAPACK. The word "interface" describes the fact that VNI Fortran 90 modules help with correct usage of the routines and provide help in arranging or distributing data for ScaLAPACK to use. VNI does not provide any ScaLAPACK routines per se. We provide a suite of I/O utilities that allow a user to send or receive a data set from a single machine or from the group. This is an intricate procedure since the ScaLAPACK suite operates on the data in block-cyclic format. There are two new linearly constrained least-squares solvers. One package solves a linear system with non-negativity constraints. The second package solves a linear system with simple bound constraints. If a user has an MPI environment, including several processors, these packages will take advantage of this resource. The packages can be run with a single processor by including the MPI dummy suite of routines mentioned elsewhere. We expect that certain users will find these codes useful as components of large-scale optimization packages or other related systems. o Partial Differential Equations, plus nine examples A moving-grid interface for systems of one-dimensional time dependent partial differential equations was added. - Documentation On-Line Documentation is now supplied in Adobe Acrobat PDF format on the distribution media. You can also view the documentation by accessing our web site http://www.vni.com/products/imsl/TechSpecs/specs.html. You can still get a hardcopy version of the manuals at extra cost by contacting your sales person. - Bug Fixes and Improvements o Performance increases to the following codes: lin_sol_gen lin_sol_self lin_eig_gen lin_sol_svd lin_svd =======================< Part 3: Installation >===================== - Validate the Installation Note: This section assumes that the environment variables required by the IMSL Fortran 90 MP Library have been set. See "Setting Environment Variables". Example programs that demonstrate the use of the IMSL Fortran 90 MP Library with Digital Visual Fortran are provided in the \IMSL directory. To verify proper installation, a batch command file VALIDATE.BAT was copied to this directory. The programs FNL.FOR and HELLO.F90 are provided to test basic IMSL Fortran 90 MP Library functions. The program FNL.FOR is written in Fortran 77 and the program HELLO.F90 is written in Fortran 90. To run both these examples, run the batch command VALIDATE.BAT by entering the following command: VALIDATE The expected output from FNL.FOR is as follows: X 1 2 3 1.000 1.500 1.000 The expected output from HELLO.F90 is as follows: A single precision NaN? T To run the example FNL.FOR enter the following commands: DF FNL.FOR %LINK_F90% FNL To run the example HELLO.F90 enter the following commands: DF HELLO.F90 %LINK_F90% HELLO Note: %LINK_F90%=imsl.lib imsls_err.lib imslmpistub.lib ============< Part 4: Using the IMSL Fortran 90 MP Library>=========== - Setting up the IMSL Libraries Environment The installation procedure creates the file F90ENV.BAT in the installation directory. This file contains the SET commands which defines the environment variables necessary to access the library from the command console. The following is a list of environment variables which are useful to the IMSL Fort