DIGITAL Read Before Installing or Using DIGITAL[TM] Fortran Version 5.2 for DIGITAL UNIX[R] Alpha Systems AV-PW83L-TE This letter explains the Version 5.2 release of the DIGITAL Fortran product. Starting with Version 5.2, DIGITAL Fortran includes the DIGITAL Extended Math Library (DXML). Product Terminology This letter uses the following product name terminology: o DIGITAL Fortran 90 (previously called DEC[TM] Fortran[TM] 90) fully supports the Fortran 95, Fortran 90, and prior standards. o DIGITAL Fortran 77 (previously called DEC Fortran) supports the FORTRAN 77 standard. o DIGITAL Fortran refers to the combined packaging of DIGITAL Fortran 90 and DIGITAL Fortran 77. DIGITAL Fortran 90 and DIGITAL Fortran 77 version numbers are now the same. Product Packaging Information DIGITAL Fortran Version 5.2 includes: o The DIGITAL Fortran 90 compiler o The DIGITAL Fortran 77 compiler o Their shared components (such as the DIGITAL Fortran run-time library system) o The DIGITAL Extended Math Library (DXML) Both DIGITAL Fortran Version 5.2 compilers recognize the Product Authorization Key (PAK) for either DIGITAL Fortran 90 or DIGITAL Fortran 77. For example, if you have a DIGITAL Fortran 77 PAK, you can immediately begin using the DIGITAL Fortran 90 compiler. After you install DIGITAL Fortran, the commands and main direc- tories are as follows: ________________________________________________________________ Features________DIGITAL_Fortran_90______DIGITAL_Fortran_77______ Command Name f90 f77 Base Direc- /usr/lib/cmplrs /usr/lib/cmplrs/fort tory____________/fort90_________________________________________ While DIGITAL Fortran 77 currently supports a very few legacy compatibility features not yet supported by DIGITAL Fortran 90, DIGITAL Fortran 90 supports nearly all DIGITAL Fortran 77 exten- sions. For more information about DIGITAL Fortran compatibility features, see the compatibility appendix in the DIGITAL Fortran 90 User Manual for DIGITAL UNIX Systems. © Digital Equipment Corporation. 1998. All Rights Reserved. 2 License Management Facility (LMF) Information Before you can install DIGITAL Fortran, an LMF Product Au- thorization Key (PAK) must be registered and loaded (see the DIGITAL Fortran Installation Guide for DIGITAL UNIX Systems). Both DIGITAL Fortran Version 5.2 compilers recognize the Product Authorization Key (PAK) for either DIGITAL Fortran 90 or DIGITAL Fortran 77. Installation Information Installing DIGITAL Fortran Version 5.2 requires the DIGITAL UNIX (formerly DEC OSF/1[R]) operating system Version 4.0 or higher. To use directed parallel processing (such as the OpenMP[TM] directives) requires DIGITAL UNIX Version 4.0D or higher. To install DIGITAL Fortran 90 and DIGITAL Fortran 77, follow the instructions in the DIGITAL Fortran Installation Guide for DIGITAL UNIX Systems. The DIGITAL Fortran kit now includes the DIGITAL Extended Math Library (DXML), which DIGITAL Fortran users no longer need to order separately. The DXML subsets are XMDLOA (serial archive library and serial shared library), XMDMAN (DXML manpages), XMDSCI (SCIPORT Cray[R] compatibility library and manpages), and XMDPLL (parallel DXML shared library). Starting with Version 5.1, DIGITAL 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 DIGITAL Fortran 90. If you delete the PSESHPF subset after you install the DIGITAL 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. DIGITAL Fortran 90 Product and Release Notes Information DIGITAL Fortran 90 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 decom- position with the OpenMP Parallel API directives. Certain environment variables control the run-time behavior and a set of parallel library routines are provided. The parallel directives and their use are described in the DIGITAL Fortran 90 User Manual for DIGITAL UNIX Systems. o Support for most of the High Performance Fortran (HPF) Ver- sion 2.0 specification and many HPF Version 2.0 approved extensions. 3 o The DIGITAL Extended Math Library (DXML). DXML includes a comprehensive set of mathematical subprograms provided in a serial library (specify -ldxml) and many mathematical subpro- grams provided in a parallel library (specify -ldxmlp). 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 DIGITAL Fortran 77 extensions to the FORTRAN-77 standard. 4 DIGITAL Fortran 90 Product and Release Notes Information (Cont'd) DIGITAL Fortran 90 Version 5.2 provides: o Upward compatibility with previous versions of DIGITAL For- tran 90 for DIGITAL UNIX Systems. o Access to the DIGITAL Extended Math Library (DXML) routines. o A number of new f90 command-line options, including: -assume gfull- Includes the full source file path in the path debug information. The default is -assume nogfullpath. -assume Selects the kind of locking used for an [no]pthreads_ unnamed critical section, when parallel lock processing is requested with -mp or -omp. Using the default, -assume nopthreads_ lock, provides the fastest performance by providing a single lock for all unnamed critical sections, but does not lock out other process threads. -arch ev6 Generates instructions for ev6 processors (21264 chips). This option permits the compiler to generate any EV6 instruction, including the following extensions to the base Alpha instruction set: BWX (Byte /Word manipulation) and MAX (Multimedia) instructions, square root and floating- point convert instructions, and count instructions. Applications compiled with this option may incur software emulation overhead on ev4, ev5, ev56, and pca56 processors, but will still run correctly. o The f90 compiler now issues "uninitialized variable" warnings at optimization levels lower than -O4. o The Run-Time Library (RTL) now has support for handling units *, 5 and 6 as separate units. For example, if you were to connect unit 6 to a file, and then write to unit *, that write would produce output to the console (or stdout device) instead the same file connected to unit 6. This new feature requires both RTL and compiler support. For programs that perform such I/O, if you use the latest version of the compiler, you must also link with or use a shareable RTL that implements the support. Older existing images will continue to work with the newer RTL. o Corrections to problems discovered since Version 5.1 was released and certain run-time performance improvements. 5 For more product information, see the DIGITAL Fortran 90 online release notes and f90(1). The release notes for DIGITAL Fortran 90 contain installation-related instructions and a summary of technical changes, known problems, restrictions, and incompat- ibilities. The DIGITAL Fortran 90 release notes also contain information about DXML and HPF. To read the release notes before installing DIGITAL 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 DIGITAL Fortran, the DIGITAL Fortran 90 release notes are located in: /usr/lib/cmplrs/fort90/relnotes90 6 DIGITAL Fortran 77 Product and Release Notes Information DIGITAL Fortran 77 Version 5.2 for DIGITAL UNIX Alpha Systems provides: o Upward compatibility with previous DIGITAL Fortran for DIGI- TAL UNIX Alpha Systems versions. o Corrections to problems discovered since Version 5.1 was released and certain run-time performance improvements. o Access to the DIGITAL Extended Math Library (DXML) routines. For more product information, see the DIGITAL Fortran 77 online release notes and f77(1). DIGITAL Fortran 77 release notes contain a summary of new features, known problems, restrictions, incompatibilities, and installation-related instructions. To read the release notes before installing DIGITAL 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 installation, the DIGITAL Fortran 77 release notes are located in: /usr/lib/cmplrs/fort/relnotes DIGITAL UNIX Software Product Library and Online Documentation CD-ROM Kits The DIGITAL UNIX Software Product Library and Online Documenta- tion 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 docu- mentation for the DIGITAL 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 DIGITAL 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 DIGITAL UNIX Software Product Library CD-ROM kit does not include the printed DIGITAL Fortran documentation set (you can order the documentation set or individual documents). DIGITAL Fortran for DIGITAL UNIX Alpha Media Kit The DIGITAL Fortran for DIGITAL UNIX Alpha Media Kit (order number QA-MV2AA-H8) includes one media CD-ROM that contains only the DIGITAL Fortran product kit and certain online DIGITAL Fortran documentation (see "Contents of the Media CD-ROM") below). 7 The DIGITAL Fortran for DIGITAL UNIX Alpha Media Kit includes the printed DIGITAL Fortran 90 documentation set, but does not include DIGITAL Fortran documentation files in HTML or other formats. Contents of the Media CD-ROM Whether you purchased the Software Product Library CD kit or the Digital Fortran for DIGITAL UNIX Alpha Media kit, a media CD is included with your kit. The DIGITAL 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. 8 Contents of the Media CD-ROM (Cont'd) With the DIGITAL 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 DIGITAL Fortran directories and the names of the DIGITAL 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. Follow the directions in the DIGITAL 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 DIGITAL Fortran directories: o /mnt/dfa520/kit contains the DIGITAL Fortran setld subsets o /mnt/dfa520/documentation contains DIGITAL Fortran documenta- tion files Your media CD-ROM contains the following DIGITAL Fortran files: o The DIGITAL Fortran setld installation subsets o DIGITAL Fortran documentation in PostScript[R] (.ps) form and ASCII (.txt) form, including: - The DIGITAL Fortran installation guide - The DIGITAL Fortran 90 online release notes - The DIGITAL Fortran 77 online release notes - This cover letter - The DIGITAL Fortran Software Product Description (SPD) Contents of the DIGITAL 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 missing, call your DIGITAL representative or the DIGITAL Software Manufacturing, Materials Replacement Group. o Media The media CD-ROM (such as the DIGITAL UNIX Software Product Library CD-ROM kit) is ordered separately from the DIGITAL Fortran kit (see "Contents of the Media CD-ROM"). For in- formation about installing DIGITAL Fortran, see the Digital Fortran installation guide. o DIGITAL Fortran Documentation Depending on how you order the DIGITAL Fortran product, your kit may include printed copies of DIGITAL Fortran manuals. The DIGITAL Software Product Library CD-ROM kit does not include the printed DIGITAL Fortran documentation. 9 The DIGITAL Fortran Installation Guide for DIGITAL UNIX Systems and this cover letter apply to both DIGITAL Fortran 90 and DIGITAL Fortran 77; other documents apply to either DIGITAL Fortran 90 or DIGITAL Fortran 77. 10 Contents of the DIGITAL Fortran Kit (Cont'd) You can order an entire documentation set or order individual documents (except this cover letter) separately, as follows: _____________________________________________________________ Printed_Set_or_Printed_Document_Title__________Order_Number__ DIGITAL Fortran 90 Documentation Set QA-MV2AA- GZ.5.2 DIGITAL Fortran Installation Guide for AA-PW82E- DIGITAL UNIX Systems TE DIGITAL Fortran Language Reference AA-Q66SC- Manual TK DIGITAL Fortran 90 User Manual for AA-Q66TC- DIGITAL UNIX Systems TE DIGITAL Extended Mathametics Library AA-RFTPA- Reference Guide TE DIGITAL Fortran 77 Documentation Set QA-MV2AB- GZ.5.2 DIGITAL Fortran Installation Guide for AA-PW82E- DIGITAL UNIX Systems TE DEC Fortran Language Reference Manual AA-PU45B- TK DEC Fortran User Manual for DEC OSF/1 AA-PW81B- _____AXP_Systems____________________________________TK_______ For example, to order the complete printed DIGITAL Fortran 90 documentation set, specify the order number QA-MV2AA-GZ.5.2. For DIGITAL Fortran customers with a service update contract, you will find DIGITAL Fortran 90 documentation that has been revised since its previous release included with your kit. For Version 5.2, the DIGITAL Fortran Installation Guide for DIGITAL UNIX Systems, the DIGITAL Extended Mathametics Library Reference Guide, and this letter have been revised. The Software Product Description (SPD) provides an overview of the DIGITAL Fortran product and the technical environment in which the product is supported. The SPD is provided online on the media CD-ROM. DIGITAL Fortran Home Page The DIGITAL Fortran home page provides information about DIGI- TAL Fortran products. You can access this page by using a Web browser to open the following Internet URL: http://www.digital.com/fortran/ DIGITAL Services A variety of service and support options are available from DIGITAL. For more information, contact your local DIGITAL sales office. 11 Your Feedback is Appreciated DIGITAL 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: o Internet electronic mail: fortran_docs@zko.mts.dec.com ___________________ [TM] AXP, Bookreader, DEC, DEC Fortran, DIGITAL, and the DIGITAL logo are trademarks of Digital Equipment Corporation, a Compaq[TM] company; Compaq is a trademark of Compaq Computer Corporation; OpenMP is a trademark of the OpenMP Architecture Review Board [R] Cray is a registered trademark of Cray Research, Inc.; Adobe, Ac- robat, and PostScript are a registered trademark of Adobe Systems, Inc.; OSF/1 is a registered trademark of the Open Software Foun- dation, Inc.; UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Ltd. 12