COMPAQ Read Before Installing or Using Compaq[TM] Fortran Version 5.5 for Tru64[TM] UNIX[R] Alpha Systems AV-PW83P-TE This letter explains the Version 5.5 release of the Compaq Fortran product for Compaq Tru64 UNIX Alpha systems. Product Terminology This letter uses the following product name terminology: o Compaq Fortran 95/90 (previously called DIGITAL[TM] Fortran 90) fully supports the Fortran 95, Fortran 90, and prior standards. It is also referred to as Compaq Fortran. o Compaq Fortran 77 (previously called DIGITAL Fortran 77 and DEC[TM] Fortran) supports the FORTRAN 77 standard. o Compaq Fortran refers to the combined packaging of Compaq Fortran and Compaq Fortran 77; it also refers to the Compaq Fortran 95/90 language. Compaq Fortran 95/90 and Compaq Fortran 77 version numbers are both Version 5.5. Product Packaging Information Compaq Fortran Version 5.5 includes: o The Compaq Fortran 95/90 compiler and associated libraries o The Compaq Fortran 77 compiler o Their shared components (such as the Compaq Fortran run-time library system) o The Compaq Extended Math Library (CXML) Version 5.1 Both Compaq Fortran Version 5.5 compilers recognize the Product Authorization Key (PAK) for either Compaq Fortran 95/90 or Compaq Fortran 77. For example, if you have a Compaq Fortran 77 PAK, you can immediately begin using the Compaq Fortran 95/90 compiler. After you install Compaq Fortran, you can use the f90 command to invoke the Compaq Fortran 95/90 compiler, whose base directory is /usr/lib/cmplrs/fort90. To invoke the Compaq Fortran 77 compiler, use the f77 -old_f77 command (base directory is /usr/lib/cmplrs/fort). While Compaq Fortran 77 currently supports a very few legacy compatibility features not supported by Compaq Fortran 95/90, Compaq Fortran 95/90 supports nearly all Compaq Fortran 77 extensions. For more information about compatibility features, see the compatibility appendix in the Compaq Fortran User Manual for Tru64 UNIX and Linux Alpha Systems. © 2002 Compaq Information Technologies Group, L.P. License Management Facility (LMF) Information Before you can install Compaq Fortran, an LMF Product Autho- rization Key (PAK) must be registered and loaded (see the Compaq Fortran Installation Guide for Tru64 UNIX Systems). Both Compaq Fortran Version 5.5 compilers recognize the Product Authorization Key (PAK) for either Compaq Fortran 95/90 or Compaq Fortran 77. Installation Information Installing Compaq Fortran Version 5.5 requires the Compaq Tru64 UNIX (formerly DIGITAL UNIX[TM]) operating system Version 4.0 or higher. To use directed parallel processing (such as the OpenMP[TM] directives) requires Compaq Tru64 UNIX (DIGITAL UNIX) Version 4.0D or higher. To install Compaq Fortran 95/90 and Compaq Fortran 77, follow the instructions in the Compaq Fortran installation guide. On systems running Compaq Tru64 UNIX Version 5.0 or later, the same version of the OTABASE subset may have been installed with the operating system programming environment. The OSFINCLUDE UNIX subset must be installed before CXML is installed. The OSFLIBAxxx subset must be installed before HPF is installed or before you use the non-shared Fortran libraries (for example, linking with -non_shared). The Compaq Fortran kit now includes the Compaq Extended Math Li- brary (CXML; formerly the DIGITAL Extended Math Library, DXML), which Compaq Fortran users no longer need to order separately. The CXML subsets have a prefix of XMD (such as XMDCOM). Starting with Version 5.1, Compaq Fortran's PSESHPF subset has been renamed to HPFLIBS. If you previously installed the PSESHPF subset and need to delete it, delete it before you install Compaq Fortran 95/90. If you delete the PSESHPF subset after you install the Compaq Fortran 90 HPFLIBS subset, you will need to reinstall the HPFLIBS subset. For information on using setld to check for and delete subsets, see Section 3.2 in the installation guide. Compaq Fortran Product and Release Notes Information Compaq Fortran 95/90 (Compaq Fortran) conforms to the Fortran 90 Standard (ISO/IEC 1539:1991(E) and ANSI X3.198-1992) and fully supports the Fortran 95 Standard (ISO/IEC 1539:1998 (E)). It also includes the following extensions: o Full support for directed parallel processing using the multi-vendor OpenMP specification (see http://www.openmp.org) on shared memory multiprocessor systems. The -omp compiler option enables parallel processing using directed decomposi- tion with the OpenMP Parallel API directives. To control the parallel run-time behavior, you can set certain environment variables and call certain parallel library routines. The parallel directives and their use are described in the Compaq Fortran User Manual for Tru64 UNIX and Linux Alpha Systems. 2 Compaq Fortran Product and Release Notes Information (Cont'd) o Support for most of the High Performance Fortran (HPF) Version 2.0 specification and many HPF Version 2.0 approved extensions. o The Compaq Extended Math Library (CXML). CXML includes a compre- hensive set of mathematical subprograms provided in a serial library (specify -lcxml) and many mathematical subprograms provided in a parallel library (specify -lcxmlp). The parallel library routines are intended for use on symmetric multi- processing (SMP) hardware and use OpenMP directives to achieve parallelization. o All but a few of the Compaq Fortran 77 extensions to the FORTRAN-77 standard. Compaq Fortran Version 5.5 provides: o Upward compatibility with previous versions of Compaq Fortran 95/90 for Compaq Tru64 UNIX Systems. o The initial work to support allocatable components of derived types. o OpenMP enhancements: support for nested OpenMP parallel regions, and added support for the num_threads clause which selects the number of threads a parallel region will use based on a run-time expression. o Improved algorithm for making inlining decisions that will tend to do more inlining, especially when many small routines are inlined into one another. o Improvements to general optimizer: prefetching, software pipelining, strength, pulling branches out of loops, allowing more existing optimizations to fire. o Modify the way that complex (and double complex) arguments are passed (and received) by value. This is an INCOMPATIBLE CHANGE. Old objects/libraries will NOT work with new. The end result is that on ALL platforms we will pass a complex (or double complex) as two real (or double) values when the user requests passing by value. o An undefined compile time variable in an expression now has the value 0. o Initialized decimal types are re-initialized at every entry point. o COUNT and ZEXT now allow optional 'KIND' argument. o The IF DEFINED directive is documented in the Compaq Fortran Language Reference Manual so that IF .NOT. DEFINED(...) is not allowed; but it is. DEFINED is like a logical function and can be part of the expr in IF (expr)... . o When -fast -std is specified (using any of the -std* op- tions), the -align options dcommon and sequence will not be set (Version 5.4A). 3 Compaq Fortran Product and Release Notes Information (Cont'd) o The preferred spelling for -wsf n is now -hpf n (Version 5.4A). o Other improvements to run-time support. o Corrections to problems discovered since Version 5.4A was released and certain run-time performance improvements. For more product information, see the Compaq Fortran online release notes and f90(1). The release notes for Compaq For- tran contain installation-related instructions and a summary of technical changes, known problems, restrictions, and in- compatibilities. The Compaq Fortran release notes also contain information about CXML and HPF. To read the release notes before installing Compaq Fortran, follow the instructions in the installation guide. You can view or print the release notes before installation once the appropriate media CD-ROM has been mounted. After installing Compaq Fortran, the Compaq Fortran release notes are located in: /usr/lib/cmplrs/fort90/relnotes90 Compaq Fortran 77 Product and Release Notes Information Compaq Fortran 77 Version 5.5 for Compaq Tru64 UNIX Alpha Sys- tems provides: o Upward compatibility with previous Compaq Fortran for Compaq Tru64 UNIX Alpha Systems versions. o Corrections to problems discovered since Version 5.4A was released and certain run-time performance improvements. The f77 command now executes the Compaq Fortran 95/90 compiler instead of the Compaq Fortran 77 compiler. Use f77 -old_f77 to execute the Compaq Fortran 77 compiler. For more product information, see the Compaq Fortran 77 online release notes and f77(1). Compaq Fortran 77 release notes con- tain a summary of new features, known problems, restrictions, incompatibilities, and installation-related instructions. To read the release notes before installing Compaq Fortran, fol- low the instructions in the installation guide. You can view or print the release notes before installation once the appropriate media CD-ROM has been mounted. After installation, the Compaq Fortran 77 release notes are located in: /usr/lib/cmplrs/fort/relnotes 4 Compaq Tru64 UNIX Software Product Library and Online Documentation CD-ROM Kits The Compaq Tru64 UNIX Software Product Library and Online Docu- mentation CD-ROM kits include: o The Software Product Library CD-ROM set The Software Product Library CD-ROM set (media CD-ROM) con- tains installation subsets and related installation documen- tation for the Compaq Tru64 UNIX Alpha software products on multiple CD-ROMs. o The Online Documentation Library CD-ROM set The online documentation CD-ROM contains documentation files in HTML, Bookreader[TM], Acrobat[TM] PDF, or other formats for Compaq Tru64 UNIX software products on CD-ROM. To allow users to read documentation on the Online Documentation Library CD-ROM, your system administrator should see the Online Documentation Library CD-ROM User's Guide. The Compaq Tru64 UNIX Software Product Library CD-ROM kit does not include the printed Compaq Fortran documentation set. Compaq Fortran for Compaq Tru64 UNIX Alpha Media Kit The Compaq Fortran for Compaq Tru64 UNIX Alpha Media Kit in- cludes one media CD-ROM that contains only the Compaq Fortran product kit (see "Contents of the Media CD-ROM" below). Contents of the Media CD-ROM The Compaq Tru64 UNIX Software Product Library CD-ROM (media CD-ROM) kit includes a set of media CD-ROMs and a CD-ROM "read first" letter. The Software Product Library CD-ROM User's Guide (media CD-ROM user guide) is provided online and describes the cdmenu utility and the media CD-ROM online files. With the Compaq Tru64 UNIX Software Product Library CD-ROM, see the media CD-ROM user's guide or the CD-ROM master index file to locate the correct media CD-ROM that contains the Compaq Fortran directories and the names of the Compaq Fortran product directories. The CD-ROM user guide and CD-ROM master index are provided as online files in the /readme directory of the first media CD-ROM. Whether you purchased the Software Product Library CD kit or the Compaq Fortran for Compaq Tru64 UNIX Alpha Media kit, a media CD is included with your kit. 5 Contents of the Media CD-ROM (Cont'd) Follow the directions in the Compaq Fortran installation guide (or CD-ROM user guide) to mount the appropriate media CD-ROM. Use an ls command to examine the files in the following Compaq Fortran directories: o /mnt/dfa55/kit contains the Compaq Fortran setld subsets o /mnt/dfa55/documentation contains Compaq Fortran documentation files Your media CD-ROM contains the following Compaq Fortran files: o The Compaq Fortran setld installation subsets o Compaq Fortran documentation in PostScript[TM] (.ps) form and ASCII (.txt) form, including: - The Compaq Fortran installation guide - The Compaq Fortran online release notes - The Compaq Fortran 77 online release notes - This cover letter - The Compaq Fortran Software Product Description (SPD) Compaq Fortran Web Pages The Compaq Fortran Web pages provide a wealth of information about Compaq Fortran products, including update kits. You can access this page by using a Web browser to open the following Internet URL: http://www.compaq.com/fortran/ Contents of the Compaq Fortran Kit o Bill of Materials Parts List Please read the Bill of Materials (parts list) enclosed in this kit and check to see that all items listed are actually in your kit. If your kit is damaged or any items are miss- ing, call your Compaq representative or the Compaq Software Manufacturing, Materials Replacement Group. o Media The media CD-ROM (such as the Compaq Tru64 UNIX Software Product Library CD-ROM kit) is ordered separately from the Compaq Fortran kit (see "Contents of the Media CD-ROM"). For information about installing Compaq Fortran, see the Compaq Fortran installation guide. 6 Contents of the Compaq Fortran Kit (Cont'd) o Compaq Fortran Documentation Depending on how you order the Compaq Fortran product, your kit may include printed copies of Compaq Fortran manuals. The Compaq Software Product Library CD-ROM kit does not include the printed Compaq Fortran documentation. The Compaq Fortran Installation Guide for Tru64 UNIX Systems and this cover letter apply to both Compaq Fortran and Compaq Fortran 77; other documents apply to either Compaq Fortran or Compaq Fortran 77. You can order the appropriate documentation set, as follows: _____________________________________________________________ Printed_Set_or_Printed_Document_Title__________Order_Number__ Compaq Fortran Documentation Set QA-MV2AA-GZ.5.5 Compaq Fortran Installation Guide for AA-PW82G-TE Tru64 UNIX Systems Compaq Fortran Language Reference AA-Q66SD-TK Manual Compaq Fortran User Manual for Tru64 AA-Q66TE-TE UNIX and Linux Alpha Systems Compaq Fortran 77 Documentation Set QA-MV2AB-GZ.5.5 Compaq Fortran Installation Guide for AA-PW82G-TE Tru64 UNIX Systems DEC Fortran Language Reference Manual AA-PU45B-TK DEC Fortran User Manual for DEC OSF/1 AA-PW81B-TK _____AXP_Systems______________________________________________ For example, to order the complete printed Compaq Fortran (95/90) documentation set, specify the order number QA-MV2AA- GZ.5.5. For Compaq Fortran customers with a service update contract, you will find Compaq Fortran 95/90 documentation that has been revised since its previous release included with your kit. For Version 5.5, the Compaq Fortran User Manual for Tru64 UNIX and Linux Alpha Systems and this letter have been revised. The Software Product Description (SPD) provides an overview of the Compaq Fortran product and the technical environment in which the product is supported. The SPD is provided online on the media CD-ROM. 7 Compaq Services A variety of service and support options are available from Compaq. For more information, contact your local Compaq sales office. Your Feedback is Appreciated Compaq appreciates your comments. If you find errors or want to make comments about a manual, please send Internet mail containing the manual's title, order number, section number, and problem description to: fortran@compaq.com _____________________________________________________________________ AXP, Bookreader, Compaq, DEC, DIGITAL, Tru64, and the Compaq logo are trademarks of Compaq Information Technologies Group, L.P. in the United States and/or other countries. Cray is a trademark of Cray Research, Inc. in the United States and/or other countries; Adobe, Acrobat, and PostScript are trademarks of Adobe Systems, Inc. in the United States and/or other countries; OpenMP is a trademark of the OpenMP Architecture Review Board in the United States and/or other countries; OSF/1 and UNIX are trademarks of The Open Group in the United States and/or other countries. All other product names mentioned herein may be trademarks of their respective companies. Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements ac- companying such products. Nothing herein should be construed as constituting an additional warranty. 8