* %Z% %M% %I% %H% %T% * * COMPONENT_NAME: (Fortran) %%_OS_XLF_%% * * FUNCTIONS: XLF README file * * ORIGINS: 27 * * IBM(R) XL Fortran for AIX(R), Version 8.1.1 5765-F70, 5765-F71 * (C) COPYRIGHT International Business Machines Corp. 1990, 2003 * All Rights Reserved * Licensed Materials - Property of IBM * * US Government Users Restricted Rights - Use, duplication or * disclosure restricted by GSA ADP Schedule Contract with IBM Corp. * AIX, IBM, and OS/400 are trademarks of IBM Corp. * Other company, product, and service names may be trademarks or service marks * of others. * This README file contains the latest information about IBM XL Fortran for AIX, Version 8.1.1 that was not available for our online help and documentation. By using IBM XL Fortran for AIX, Version 8.1.1, you agree to the terms of the license information. The License Information document is available as a PDF file and can be found in the root directory on the CD-ROM, or in the following directory after installing the product: /usr/lpp/xlf/license.pdf You will need a Portable Document Format (PDF) viewer to view the license agreement. Note: IBM XL Fortran for AIX, Version 8.1.1 is licensed based on a charge unit of one authorized user. The Program may be stored on more than one machine, provided that the Program is not in active use on more than one machine at the same time. An authorized user is an individual or specific named user authorized to have access to the program or any portion of the program. The Proof of Entitlement for this program is evidence of your authorization. Each individual or specific named user must obtain a Proof of Entitlement for each operating system on which the product is installed. This document contains the following sections: I. Viewing Documentation on AIX II. Installation Issues III. Known Limitations for IBM XL Fortran for AIX, V8.1.1 IV. Documentation Corrections V. AS-IS Functions and/or Components I. Viewing Documentation on AIX =============================== To view the documentation, you must have X-Windows working on your system. In addition, you need to have the appropriate viewers, such as a frames-capable HTML browser like Mozilla (version 1.0, or later) and a PDF viewer, such as the Adobe Acrobat Reader. II. Installation Issues ======================= Japanese Documentation on the Web --------------------------------- At the time the product CD-ROM was created, only the Japanese README.xlf and memo-to-users.txt files were available and included. The following translated publications are available for download, as compressed files, from the XL Fortran for AIX, V8.1.1 documentation download page: Publication Format File Name ----------------------------------------- ------ ------------------ IBM XL Fortran for AIX User's Guide HTML ug_jaJP_html.tar.Z PDF ug_jaJP.pdf.Z PS ug_jaJP.ps.Z IBM XL Fortran for AIX Language Reference HTML lr_jaJP_html.tar.Z PDF lr_jaJP.pdf.Z PS lr_jaJP.ps.Z From your Web browser, open the XL Fortran Support page at URL: http://www.ibm.com/software/awdtools/fortran/xlfortran/support/ Select the "Product information" link to get to the documentation download page. Create the appropriate subdirectory and download the corresponding file to this directory. Uncompress the file. Suggested directories for uncompressed files: File Uncompress in Directory ------------ ---------------------------------- *_html.tar.Z /usr/share/man/info/ja_JP/xlf/html *.pdf.Z /usr/share/man/info/ja_JP/xlf/pdf *.ps.Z /usr/share/man/info/ja_JP/xlf/ps Delete the compressed (*.Z) file. Portable Application Solutions Environment (OS/400 PASE) Support ---------------------------------------------------------------- IBM XL Fortran for AIX, V8.1.1 can be installed and operated in the OS/400(R) PASE environment. III. Known Limitations for IBM XL Fortran for AIX, V8.1.1 ========================================================= Currently none. IV. Documentation Corrections ============================= User's Guide Errata and New Information >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> The following corrections and additions apply to the IBM XL Fortran for AIX, Version 8.1.1 User's Guide: -qdirectstorage Compiler Option ------------------------------- Syntax: -qdirectstorage | -qnodirectstorage ----------------- This option informs the compiler that a given compilation unit may reference write-through-enabled or cache-inhibited storage. -qnodirectstorage is the default. Use this option with discretion. It is intended for programmers who know how the memory and cache blocks work, and how to tune their applications for optimal performance. For a program to execute correctly on all PowerPC implementations of cache organization, the programmer should assume that separate instruction and data caches exist, and should program to the separate cache model. Note: Using the -qdirectstorage option together with the CACHE_ZERO directive may cause your program to fail. -qfullpath Example ------------------ In the example for the -qfullpath compiler option, "xldb" should be "dbx". Embedding a Literal Comma in the -W String ------------------------------------------ You can use \, to embed a literal comma in the string supplied to the -W option. In the following example, the \, embeds a literal comma in the -WF string and causes three arguments, rather than four, to be supplied to the C preprocessor. $ xlf -qfree=f90 '-WF,-Dint1=1,-Dint2=2,-Dlist=3\,4' a.F $ cat a.F print *, int1 print *, int2 print *, list end XLSMPOPTS and Thread Stack Size Limits -------------------------------------- The following should be added to the stack=num information: Set stack=num so it is within the acceptable upper limit. num can be up to 256 MB for 32-bit mode, or up to the limit imposed by system resources for 64-bit mode. An application that exceeds the upper limit may cause a segmentation fault. Language Reference Errata and New Information >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> The following corrections and additions apply to the IBM XL Fortran for AIX, Version 8.1.1 Language Reference: ENTRY Statement Rules - Allocatable result variables ---------------------------------------------------- In the fourth paragraph under "Rules" on page 352, the description: Otherwise, they are storage-associated and must be all nonpointer scalars of intrinsic (noncharacter) type. should read "nonpointer, nonallocatable scalars" instead of "nonpointer scalars". RANDOM_SEED Intrinsic Procedure ------------------------------- The RANDOM_SEED(PUT) description should have the following new information added: A valid seed must be a whole number between 1.0 and 2147483647.0 (2.0**31-1) for Generator 1 and between 1.0 and 281474976710656.0 (2.0**48) for Generator 2. V. AS-IS Functions and/or Components ==================================== The IBM Distributed Debugger is provided as a technology preview with the XL Fortran for AIX product.