COMPAQ Read Before Installing or Using Compaq[R] Fortran Version 5.4 for Tru64[TM] UNIX[R] Alpha Systems AV-PW83N-TE This letter explains the Version 5.4 release of the Compaq Fortran product for Compaq Tru64 UNIX Alpha systems. Version 5.4A contains only bug fixes and no new features. Except for this online cover letter, all documentation has not changed since Version 5.4. Product Terminology This letter uses the following product name terminology: o Compaq Fortran 95/90 (previously called DIGITAL[R] 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 [R] 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.4. Product Packaging Information Compaq Fortran Version 5.4 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 4.1 (new version) Both Compaq Fortran Version 5.4 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. © 2001 Compaq Computer Corporation 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.4 compilers recognize the Product Authorization Key (PAK) for either Compaq Fortran 95/90 or Compaq Fortran 77. Installation Information Installing Compaq Fortran Version 5.4 requires the Compaq Tru64 UNIX (formerly DIGITAL UNIX[R]) 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 for Tru64 UNIX Systems. 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 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) Ver- sion 2.0 specification and many HPF Version 2.0 approved extensions. o The Compaq Extended Math Library (CXML). CXML includes a comprehensive set of mathematical subprograms provided in a serial library (specify -lcxml) and many mathematical subpro- grams provided in a parallel library (specify -lcxmlp). The parallel library routines are intended for use on symmetric multiprocessing (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.4 provides: o Upward compatibility with previous versions of Compaq Fortran 95/90 for Compaq Tru64 UNIX Systems. o The INT_PTR_KIND intrinsic, which returns the kind of an integer pointer. o An optional KIND argument is now allowed on the following intrinsic procedures: LEN, SHAPE, SIZE, UBOUND, LBOUND, MAXLOC, MINLOC, INDEX, LEN_TRIM, SCAN, and VERIFY. This allows these intrinsics to return a result that is other than default integer kind. o The %VAL and %REF built-in functions now override any mecha- nism specified in an explicit interface. o Support for I/O record larger than 2.1 Gigabytes in variable- length unformatted files. o Support for generating traceback information for severe errors. 3 Compaq Fortran Product and Release Notes Information (Cont'd) o A number of new or changed f90 command-line options, including: -annotate Provides information in a listing file about the effect of optimizations. -arch ev67 Generates code for the ev67 Alpha proces- sor (21264A chips). -assume nopro- Specifies that a copy of a constant tect_constant actual argument is to be passed, so it can be modified by the called routine (not standard-conforming). -ccdefault Specifies the type of carriage control used when a file is displayed at a termi- nal. -check arg_temp_ Displays an informational run-time mes- created sage if actual arguments are copied into temporary storage before routine calls. -hpf The -hpf option is now a synonym for -wsf. -O4 The -O4 option now includes -pipeline (previously associated with -O5). -tune ev67 Optimizes code for the ev67 Alpha proces- sor (21264A chips). o New Fortran 3f run-time jacket routines lgamma, erf, erfc, short, and long functions (in library libUfor). o Support for the environment variable FORT_BUFFERED to use buffered I/O for output to all I/O units, except those whose output is to the terminal.) o Support for reading nondelimited character strings as input for character NAMELIST items. o Other improvements to run-time support. o Corrections to problems discovered since Version 5.3 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. 4 Compaq Fortran Product and Release Notes Information (Cont'd) 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.4 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.3 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 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) contains installation subsets and related installation documentation 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[R] 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. 5 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. 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/dfa54a/kit contains the Compaq Fortran setld subsets o /mnt/dfa54a/documentation contains Compaq Fortran documentation Your media CD-ROM contains the following Compaq Fortran files: o The Compaq Fortran setld installation subsets o Compaq Fortran documentation in PostScript[R] (.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/ 6 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. 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.4 Compaq Fortran Installation Guide for AA-PW82G-TE Tru64 UNIX Systems Compaq Fortran Language Reference Manual AA-Q66SD-TK Compaq Fortran User Manual for Tru64 AA-Q66TD-TE UNIX and Linux Alpha Systems Compaq Fortran 77 Documentation Set QA-MV2AB-GZ.5.4 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_______________________________________________ 7 Contents of the Compaq Fortran Kit (Cont'd) For example, to order the complete printed Compaq Fortran (95/90) documentation set, specify the order number QA-MV2AA-GZ.5.4. 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.4, the Compaq Fortran Installation Guide for Tru64 UNIX 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. 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 _____________________________________________________________________ Compaq, DIGITAL, and the Compaq logo are registered in the United States Patent and Trademark office. AXP, Bookreader, DEC, and Tru64 are trademarks of Compaq Infor- mation Technologies, L.P. Cray is a trademark of Cray Research, Inc.; Adobe, Acrobat, and PostScript are trademarks of Adobe Systems, Inc.; OpenMP is a trademark of the OpenMP Architecture Review Board; OSF/1 is a trademark of the Open Software Foundation, Inc.; UNIX is a trade- mark of The Open Group in the United States and other countries. 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 infor- mation in this document is provided "as is" without warranty of any kind and is subject to change without notice. The war- ranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty. 8