|
NERSC Announcements Message Archive
Select:
[all-announcements]
[users]
[franklin]
[bassi]
[jacquard]
[davinci]
[nug]
[managers]
[ Back ]
Subject: |
xlf to be upgraded 7/30/03 |
Author: |
Michael Stewart <pmstewart_at_lbl.gov> |
Date: |
2003-07-24 10:45:07 |
The default version of xlf on seaborg will be upgraded to version
8.1.1.0 on Wednesday, July 30, 2003. This version contains several
fixes to bugs that NERSC has reported as well as a few new features
described in the attached README.FIRST file.
Version 8.1.1.0 is currently on seaborg in the xlf module.
--
Michael Stewart
NERSC Consultant
510-486-6648
pmstewart@lbl.gov
* @(#) 01 1.2.13.9 6/4/03 18:17:48
*
* COMPONENT_NAME: (Fortran) AIX XL Fortran Compiler
*
* 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.
|
|