Documentation errata for IBM XL Fortran for Blue Gene/Q, V14.1

Preventive Service Planning


Abstract

This page contains corrections and additions to the product documentation shipped with IBM XL Fortran for Blue Gene/Q, V14.1.

Content

All documentation

The following correction applies to all documentation of IBM XL Fortran for Blue Gene/Q, V14.1:

Section: IBM XL Fortran information

The library page address in any statement:
http://www.ibm.com/software/awdtools/fortran/xlfortran/features/bg/library/

should read:

http://www.ibm.com/software/rational/products/fortran/bluegeneq/library/

man pages:
The following correction applies to all man pages of IBM XL Fortran for Blue Gene/Q, V14.1:

For more information, refer to the following Web sites:
http://www.ibm.com/software/awdtools/fortran/xlfortran/features/bg/library/.

should read:

For more information, refer to the following Web sites:
http://www.ibm.com/software/rational/products/fortran/bluegeneq/library/.


Option: -qlistfmt

The following statements about profile directed feedback (PDF) are removed (PDF or the -qpdf options are not supported by the BG/Q compilers.):

    pdf | nopdf
      Produce profile-directed feedback information.
    When used with the option that enables profiling, -qpdf, the report contains information about call and block counts and cache misses.



Installation Guide
The following corrections and additions apply to the IBM XL Fortran for Blue Gene/Q, V14.1 Installation Guide:

Chapter: Before installing IBM XL Fortran for Blue Gene/Q, V14.1

Upgrading the evaluation copy of the XL Fortran compiler

Install only the xlf.bg.lic RPM packages for the full product version of the XL Fortran compiler and run xlf_configure to re-configure the compiler.

should read:

1. Install the  xlf.bg.lic RPM packages.
2. Install the xlf.bg.cmp RPM package using the --replacepkgs --replacefiles options. For example:
rpm -ivh xlf.bg.cmp-14.1.0.0-120505a.ppc64.rpm --replacepkgs --replacefiles
3. Run  new_install or xlf_configure to re-configure the compiler.


Language Reference
The following corrections apply to the IBM XL Fortran for Blue Gene/Q, V14.1 Language Reference:

Chapter: Intrinsic procedures

Section: Detailed descriptions of intrinsic procedures

Topic: ABS(A)

The following paragraph should be removed:

Given that X is a complex number in the form a + bi, where i = (-1) ½:
    1. abs(b) must be less than or equal to 88.7228; a is any real value.
    2. abs(b) must be less than or equal to 709.7827; a is any real value.


Chapter: Vector intrinsic procedures (IBM extension)

Topic: VEC_XXCPNMADD(ARG1, ARG2, ARG3)

Formula
    Result[0] = ( ( ARG1[1] × ARG2[1] ) + ARG3[0] )
    Result[1] = - ( ( ARG1[0] × ARG2[1] ) + ARG3[1] )
    Result[2] = ( ( ARG1[3] × ARG2[3] ) + ARG3[2] )
    Result[3] = - ( ( ARG1[2] × ARG2[3] ) + ARG3[3] )

Example
    ARG1 = ( 1.0, 2.0, 3.0, 4.0)
    ARG2 = ( 0.0, 10.0, 0.0, 20.0)
    ARG3 = ( 10.0, 10.0, 10.0, 10.0)
    Result: ( 30.0, -20.0, 90.0, -70.0)

should read:

Formula
    Result[0] = ( ( ARG1[1] × ARG2[1] ) + ARG3[0] )
    Result[1] = - ( ( ARG1[0] × ARG2[1] ) - ARG3[1] )
    Result[2] = ( ( ARG1[3] × ARG2[3] ) + ARG3[2] )
    Result[3] = - ( ( ARG1[2] × ARG2[3] ) - ARG3[3] )

Example
    ARG1 = ( 1.0, 2.0, 3.0, 4.0)
    ARG2 = ( 0.0, 10.0, 0.0, 20.0)
    ARG3 = ( 10.0, 10.0, 10.0, 10.0)
    Result = ( 30.0, -0.0, 90.0, -50.0)

Topic: VEC_XXNPMADD(ARG1, ARG2, ARG3)

Formula
    Result[0] = - ( ( ARG1[1] × ARG2[1] ) + ARG3[0] )
    Result[1] = ( ( ARG1[0] × ARG2[1] ) + ARG3[1] )
    Result[2] = - ( ( ARG1[3] × ARG2[3] ) + ARG3[2] )
    Result[3] = ( ( ARG1[2] × ARG2[3] ) + ARG3[3] )

Example
    ARG1 = ( 1.0, 2.0, 3.0, 4.0)
    ARG2 = ( 0.0, 10.0, 0.0, 20.0)
    ARG3 = ( 10.0, 10.0, 10.0, 10.0)
    Result: ( -30.0, 20.0, -90.0, 70.0)

should read:

Formula
    Result[0] = - ( ( ARG1[1] × ARG2[1] ) - ARG3[0] )
    Result[1] = ( ( ARG1[0] × ARG2[1] ) + ARG3[1] )
    Result[2] = - ( ( ARG1[3] × ARG2[3] ) - ARG3[2] )
    Result[3] = ( ( ARG1[2] × ARG2[3] ) + ARG3[3] )

Example
    ARG1 = ( 1.0, 2.0, 3.0, 4.0)
    ARG2 = ( 0.0, 10.0, 0.0, 20.0)
    ARG3 = ( 10.0, 10.0, 10.0, 10.0)
    Result = ( -10.0, 20.0, -70.0, 70.0)

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

XL Fortran Advanced Edition for Blue Gene
Documentation

Software version:

14.1

Operating system(s):

Blue Gene/Q

Reference #:

1599256

Modified date:

2013-11-21

Translate my page

Machine Translation

Content navigation