Documentation errata for IBM XL Fortran Advanced Edition for Blue Gene, V11.1

Preventive Service Planning


Abstract

This page contains corrections and additions to the product documentation and README shipped with IBM XL Fortran Advanced Edition for Blue Gene/P, V11.1 and IBM XL Fortran Advanced Edition for Blue Gene/L, V11.1.

Content

Using the XL Compilers for Blue Gene

The following correction applies to the IBM XL Fortran Advanced Edition for Blue Gene, V11.1 Using the XL Compilers for Blue Gene.

Chapter: Compiling and linking applications for Blue Gene
Section: Unsupported options for Blue Gene/L

The following text should be added:

-qsigtrap
The operating system of Blue Gene/L does not support this option.

Installation Guide
The following correction applies to the IBM XL Fortran Advanced Edition for Blue Gene, V11.1 Installation Guide.

Chapter: After installing IBM XL Fortran Advanced Edition for Blue Gene, V11.1

Section: Testing the installation

Topic: Basic example: Creating and running “Hello World”

3. Run the program by entering the following command:

    ./hello

The result should be "Hello World!".

should read:

3. Use the mpirun tool to run the hello program on the compute node. The result should be "Hello World!"

For information about running programs on the compute node, see the following IBM Redbooks® publications:
4. Check the exit code of the program by entering the following command:

    echo $?

The result should be 0.

should read:

4. Check if exit code is 0 in the output of mpirun.

The BG/L output should be like the following:

    BG/L job exit status = (0)

The BG/P output should be like the following:

    BG/P job exit status = (0)

5. Compile the program:
  • If Blue Gene/L short invocation commands have been set up, enter the following command:

    blrts_xlf hello.f -o hello

    If short invocation commands have not been set up, enter the following command:

    /opt/ibmcmp/xlf/bg/11.1/bin/blrts_xlf hello.f -o hello

  • If Blue Gene/P short invocation commands have been set up, enter the following command:

    bgxlf hello.f -o hello

    If short invocation commands have not been set up, enter the following command:

    /opt/ibmcmp/xlf/bg/11.1/bin/bgxlf hello.f -o hello

should be removed.

Section: Accessing the local documentation

Topic: Viewing the PDF documentation

The following text:

After default installation, the PDF documentation can be found in the /opt/ibmcmp/xlf/11.1/doc/$LANG/pdf/ directory. For non-default installations, the PDF documentation is located in the $target_dir /xlf/11.1/doc/$LANG/pdf/ directory, where target_dir is the target directory for installation specified by the -b option of the non-default installation script.

should read:

After default installation, the PDF documentation can be found in the /opt/ibmcmp/xlf/11.1/doc/$LANG/pdf/ directory. For non-default installations, the PDF documentation is located in the installation_path /xlf/11.1/$LANG/pdf/ directory.

Language Reference
The following corrections apply to the IBM XL Fortran Advanced Edition for Linux, V11.1 Language Reference. (IBM XL Fortran Advanced Edition for Linux, V11.1 Language Reference is cross referenced from IBM XL Fortran Advanced Edition for Blue Gene, V11.1 Using the IBM XL Compilers for Blue Gene.)

Statements and attributes

Table 31. Statements table
ASYNCHRONOUS 3 should read ASYNCHRONOUS 1
RECORD should read RECORD 1
VALUE 1 should read VALUE 3
WAIT 1 should read WAIT 3

Within the chapter:

ASYNCHRONOUS is incorrectly identified as a Fortran 2003 extension. It is an IBM extension.

WAIT is incorrectly identified as an IBM extension. It is a Fortran 2003 extension.

Hardware-specific directives

PROTECTED STREAM

prefetch_variable
is a variable to be prefetched. The variable must be a data object with a determinable storage address. The variable can be of any data type, including intrinsic and derived data types. The variable cannot be a procedure name, subroutine name, module name, function name, literal constant, label, zero-sized string, zero-length array, or array with a vector subscript.

prefetch_depth
is a variable to be prefetched. The variable must be a data object with a determinable storage address. The variable can be of any data type, including intrinsic and derived data types. The variable cannot be a procedure name, subroutine name, module name, function name, literal constant, label, zero-sized string, zero-length array, or array with a vector subscript.

prefetch_depth can be specified by either an integer variable or a numeric literal ranging from 0 to 7. It is a relative value with the levels defined qualitatively as follows:

should read:

prefetch_variable
is a variable to be prefetched. The variable must be a data object with a determinable storage address. The variable can be of any data type, including intrinsic and derived data types. The variable cannot be a procedure name, subroutine name, module name, function name, literal constant, label, zero-sized string, zero-length array, or array with a vector subscript.

prefetch_depth can be specified by either an integer variable or a numeric literal ranging from 0 to 7. It is a relative value with the levels defined qualitatively as follows:

Related information

README updates for XL Fortran for Blue Gene/P
README updates for XL Fortran for Blue Gene/L

Cross reference information
Segment Product Component Platform Version Edition
Software Development XL Fortran Advanced Edition for Blue Gene Documentation Blue Gene/L, Blue Gene/P 11.1 Advanced
Software Development XL Fortran for Linux Documentation Linux 11.1 Not Applicable

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

XL Fortran
Documentation

Software version:

11.1

Operating system(s):

Blue Gene, Linux

Software edition:

Advanced Edition

Reference #:

1270579

Modified date:

2007-10-04

Translate my page

Machine Translation

Content navigation