CXML Release Notes and Installation Information =============================================== Please read this document before installing or using the Compaq Extended Math Library (CXML). This document contains important installation information and release notes about using CXML with Compaq Visual Fortran. The information in this document is more up-to-date than the CXML Reference Guide or other associated documentation. When installing or using CXML, please note the following: 1) To install CXML, you must specify the "custom" installation option when installing Compaq Visual Fortran. The "standard" installation option will not install CXML. Note: After you have finished installing Compaq Visual Fortran, you must run the Per-User Setup application in the Visual Fortran program folder. 2) CXML is available both as a static library and as a DLL which uses multi-threaded dynamic link libraries, e.g., DFORMD.LIB and MSVCRT.LIB. 3) Source files to build CXML module files are located in the INCLUDE directory. 4) To automatically link a program with the CXML library and obtain access to the CXML interface blocks, you should insert the following statement as the first line of the program unit: INCLUDE 'CXML_INCLUDE.F90' This allows the proper CXML library (either CXML.LIB or CXMLDLL.LIB) to be linked. Installing and Using CXML ------------------------- Refer to the following documentation for information about installing and using CXML: o Installation information - "Using Setup to Install Visual Fortran and Related Software" in Compaq Visual Fortran Getting Started o Introductory information - "CXML Libraries" in Compaq Visual Fortran Getting Started o Usage information - "Using the CXML Math Libraries" in Compaq Visual Fortran Programmer's Guide o Routine reference information - "CXML Reference Guide" New and Changed Features ------------------------ The following changes have been made to CXML for this release: o The performance of a number of CXML routines has been improved relative to the previous release of CXML. o CXML now includes a new set of routines for solving sparse matrix problems using direct methods. Documentation for the new sparse solver routines is included in the "CXML Reference Guide". o The skyline solver routines are no longer supported. They have been removed from this version of CXML. If you are currently using skyline solvers, we recommend that you switch to the new direct solver routines. o Sample files which show how to invoke the direct sparse solver routines from Fortran 90, and C are available in the CXML Samples folder: \Df98\CXML\Samples. o The interface to the following sparse iterative solvers functions has been changed: DMATVEC_SDIA DMATVEC_GENR DAPPLY_POLY_SDIA DAPPLY_POLY_GENR o The mechanism for printing messages in the iterative solvers has been changed. Users now have an option to either supply their own print routine (which is invoked by the iterative solvers to print messages) or have the messages printed out to the standard output device. A detailed description of the new functionality is provided in the "Using Iterative Solvers" section of the "CXML Reference Guide". o In the iterative solvers, the argument iounit no longer determines the kind of information to be printed. Now the argument iolevel determines the level of information to be printed. In case of a negative value for iolevel, no information is printed. Refer to the "CXML Reference Guide" for more details - examples are also provided which reflect the modifications required in the user's code for the correct use of iterative solvers. o The auxiliary LAPACK routine XLAENV is no longer supplied, or used, by CXML. The LAPACK routines DLAMCH and SLAMCH have been modified to return compile time constants instead of computing values on each call. Documentation ------------- o The "CXML Reference Guide" - available in the CXML Doc folder. o The CXML website - available at www.compaq.com/math.