IBM XL Fortran for AIX, V14.1
Installation Guide
Version 14.1
GC14-7335-00


IBM XL Fortran for AIX, V14.1
Installation Guide
Version 14.1
GC14-7335-00

Note
Before using this information and the product it supports, read the information in “Notices” on page 37.
First edition
This edition applies to IBM XL Fortran for AIX, V14.1 (Program 5765-J04; 5725-C74) and to all subsequent releases
and modifications until otherwise indicated in new editions. Make sure you are using the correct edition for the
level of the product.
© Copyright IBM Corporation 2003, 2012.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.

Contents
About this information . . . . . . . . v
Installing PTF updates on the PASE system.
.
. 22
Who should read this document .
.
.
.
.
.
.
. v
Updating a basic installation.
.
.
.
.
.
.
.
. 23
How to use this document.
.
.
.
.
.
.
.
.
. v
Using SMIT .
.
.
.
.
.
.
.
.
.
.
.
. 23
How this document is organized .
.
.
.
.
.
. vi
Using installp
.
.
.
.
.
.
.
.
.
.
.
. 24
Conventions .
.
.
.
.
.
.
.
.
.
.
.
.
. vi
Updating an advanced installation using xlfndi .
. 24
Related information .
.
.
.
.
.
.
.
.
.
.
. x
Product version migration
.
.
.
.
.
.
.
.
. 26
IBM XL Fortran information .
.
.
.
.
.
.
. x
Operating system migration .
.
.
.
.
.
.
.
. 26
Standards and specifications .
.
.
.
.
.
.
. xi
Other IBM information
.
.
.
.
.
.
.
.
. xii
Chapter 5. After installing XL Fortran
27
Technical support .
.
.
.
.
.
.
.
.
.
.
. xii
Checking compiler and fileset information .
.
.
. 27
How to send your comments .
.
.
.
.
.
.
. xii
Enabling utilization tracking.
.
.
.
.
.
.
.
. 28
Enabling IBM License Metric Tool (ILMT) and Tivoli
Chapter 1. Before installing XL Fortran
1
Asset Discovery for Distributed (TADd) .
.
.
.
. 28
The installation image and filesets .
.
.
.
.
.
. 1
Configuring compiler defaults .
.
.
.
.
.
.
. 29
Filesets .
.
.
.
.
.
.
.
.
.
.
.
.
.
. 1
Setting environment variables .
.
.
.
.
.
.
. 29
Preparing the electronic distribution package
.
. 4
Enabling the XL Fortran error messages .
.
.
.
. 29
National language support
.
.
.
.
.
.
.
. 4
Enabling the manual pages .
.
.
.
.
.
.
.
. 30
System prerequisites .
.
.
.
.
.
.
.
.
.
.
. 5
Creating shortcuts to the XL Fortran invocation
Previewing the installation and license agreements
. 6
commands.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 30
Accessing the local documentation
.
.
.
.
.
. 31
Chapter 2. Basic installation . . . . . . 9
Viewing the HTML documentation
.
.
.
.
. 31
Viewing the PDF documentation .
.
.
.
.
. 32
Tasks for basic installation .
.
.
.
.
.
.
.
.
. 9
Viewing the manual pages .
.
.
.
.
.
.
. 32
Using the bundle installation method.
.
.
.
.
. 10
Testing the installation.
.
.
.
.
.
.
.
.
.
. 33
Using SMIT .
.
.
.
.
.
.
.
.
.
.
.
.
. 11
Using installp
.
.
.
.
.
.
.
.
.
.
.
.
. 12
Chapter 6. Uninstalling XL Fortran . . . 35
Chapter 3. Advanced installation
. . . 15
Uninstalling a basic installation .
.
.
.
.
.
.
. 35
Uninstalling an advanced installation .
.
.
.
.
. 36
Limitations of non-default installation
.
.
.
.
. 15
Uninstalling versions of the MASS components
Tasks for advanced installation .
.
.
.
.
.
.
. 15
downloaded from the web .
.
.
.
.
.
.
.
. 36
Non-default installation procedure.
.
.
.
.
.
. 16
Uninstalling the electronic license agreement .
.
. 36
Installing on an IBM i PASE system .
.
.
.
. 18
Running XL Fortran from a non-default location .
. 19
Notices
. . . . . . . . . . . . . . 37
Chapter 4. Update installation . . . . . 21
Trademarks and service marks .
.
.
.
.
.
.
. 39
Tasks for update installation .
.
.
.
.
.
.
.
. 21
Preparing a PTF package for installation.
.
.
.
. 22
Index . . . . . . . . . . . . . . . 41
© Copyright IBM Corp. 2003, 2012
iii

iv
XL Fortran: Installation Guide

About this information
This guide provides detailed installation instructions for IBM® XL Fortran for AIX®,
V14.1. It guides you through multiple ways to perform tasks and directs you to
reference information in cases requiring atypical installations. It also shows you
how to test the installation, launch remotely-accessible HTML help, and enable and
view different types of documentation. Please read it carefully before installing.
Please also read the README file in the root directory of your installation media,
which contains current information about the compiler.
Who should read this document
This document is intended for anyone responsible for installing IBM XL Fortran for
AIX, V14.1.
The basic installation methods detailed in this document address the needs of the
majority of users. Basic examples are tailored to reflect, as much as possible, the
steps required to perform a basic installation.
The advanced installation method addresses the needs of users who require a
customized installation for various purposes, such as maintaining more than one
version of XL Fortran on a single system. These are users who are familiar with
compiler installations and with the file structures of the versions of the compiler
products installed on the system. Advanced examples are tailored to reflect, as much
as possible, the steps required to perform an advanced installation.
How to use this document
This document provides procedures for three main installation scenarios:
"Basic" installation
This scenario allows you to install a single version of XL Fortran to a
default location. This scenario is applicable to the majority of users, and is
the recommended method of installation.
For an overview of the steps that you need to follow to perform a basic
installation, refer to Chapter 2, “Basic installation,” on page 9.
"Advanced" installation
This scenario allows you to maintain multiple versions of XL Fortran on a
single system, or to install the compiler to a non-default location. This
scenario is only applicable to advanced users who have specialized needs,
and is not recommended for the majority of users.
For an overview of the steps that you need to follow to perform an
advanced installation, refer to Chapter 3, “Advanced installation,” on page
15.
"Update" installation
This scenario applies to users who have obtained a Program Temporary Fix
(PTF) package for an existing XL Fortran V14.1 installation.
For an overview of the steps required to install a PTF, refer to Chapter 4,
“Update installation,” on page 21.
© Copyright IBM Corp. 2003, 2012
v

For highly specialized installation scenarios that are outside the scope of this
document, refer to the Technotes at http://www.ibm.com/software/awdtools/
fortran/xlfortran/aix/.
How this document is organized
This book is organized to reflect the pre-installation, installation, post-installation,
and troubleshooting phases of an XL Fortran installation.
Table 1. Phases of an XL Fortran installation
Phase
Chapters
User segment
Pre-installation
Chapter 1, “Before
All users
installing XL Fortran,” on
page 1
Installation
Chapter 2, “Basic
Users who:
installation,” on page 9
v
Want to use the simplest, most direct
installation process
v
Do not have any special requirements,
such as the use of multiple versions of the
compiler.
Chapter 3, “Advanced
Users who:
installation,” on page 15
v
Want to install the compiler in a
non-default location
v
Want to have multiple versions of the
compiler on the same system
Post-installation Chapter 4, “Update
Users who want to update XL Fortran V14.1
installation,” on page 21
to the next fix level
Chapter 5, “After installing All users
XL Fortran,” on page 27
Product
Chapter 6, “Uninstalling
Any user who needs to remove an XL
removal
XL Fortran,” on page 35
Fortran compiler from the system
Conventions
Typographical conventions
The following table explains the typographical conventions used in the IBM XL
Fortran for AIX, V14.1 information.
Table 2. Typographical conventions
Typeface
Indicates
Example
bold
Lowercase commands, executable
The compiler provides basic
names, compiler options, and
invocation commands, xlf, along with
directives.
several other compiler invocation
commands to support various Fortran
language levels and compilation
environments.
italics
Parameters or variables whose
Make sure that you update the size
actual names or values are to be
parameter if you return more than
supplied by the user. Italics are
the size requested.
also used to introduce new terms.
underlining
The default setting of a parameter
nomaf | maf
of a compiler option or directive.
vi
XL Fortran: Installation Guide

Table 2. Typographical conventions (continued)
Typeface
Indicates
Example
monospace
Programming keywords and
To compile and optimize
library functions, compiler builtins, myprogram.f, enter: xlf myprogram.f
examples of program code,
-O3.
command strings, or user-defined
names.
UPPERCASE
Fortran programming keywords,
The ASSERT directive applies only to
bold
statements, directives, and intrinsic the DO loop immediately following
procedures. Uppercase letters may
the directive, and not to any nested
also be used to indicate the
DO loops.
minimum number of characters
required to invoke a compiler
option/suboption.
Qualifying elements (icons and bracket separators)
In descriptions of language elements, this information uses icons and marked
bracket separators to delineate the Fortran language standard text as follows:
Table 3. Qualifying elements
Bracket
Icon
separator text
Meaning
F2008
N/A
The text describes an IBM XL Fortran implementation of
the Fortran 2008 standard.
F2008
Fortran 2003
The text describes an IBM XL Fortran implementation of
begins / ends
the Fortran 2003 standard, and it applies to all later
standards.
IBM extension
The text describes a feature that is an IBM XL Fortran
begins / ends
extension to the standard language specifications.
Note: If the information is marked with a Fortran language standard icon or
bracket separators, it applies to this specific Fortran language standard and all later
ones. If it is not marked, it applies to all Fortran language standards.
Syntax diagrams
Throughout this information, diagrams illustrate XL Fortran syntax. This section
will help you to interpret and use those diagrams.
v
Read the syntax diagrams from left to right, from top to bottom, following the
path of the line.
The
─── symbol indicates the beginning of a command, directive, or statement.
The ─── symbol indicates that the command, directive, or statement syntax is
continued on the next line.
The ─── symbol indicates that a command, directive, or statement is continued
from the previous line.
The ───
symbol indicates the end of a command, directive, or statement.
About this information
vii

Fragments, which are diagrams of syntactical units other than complete
commands, directives, or statements, start with the │─── symbol and end with
the ───│ symbol.
IBM XL Fortran extensions are marked by a number in the syntax diagram with
an explanatory note immediately following the diagram.
Program units, procedures, constructs, interface blocks and derived-type
definitions consist of several individual statements. For such items, a box
encloses the syntax representation, and individual syntax diagrams show the
required order for the equivalent Fortran statements.
v
Required items are shown on the horizontal line (the main path):
keyword
required_argument
v
Optional items are shown below the main path:
keyword
optional_argument
Note: Optional items (not in syntax diagrams) are enclosed by square brackets ([
and ]). For example, [UNIT=]u
v
If you can choose from two or more items, they are shown vertically, in a stack.
If you must choose one of the items, one item of the stack is shown on the main
path.
keyword
required_argument1
required_argument2
If choosing one of the items is optional, the entire stack is shown below the
main path.
keyword
optional_argument1
optional_argument2
v
An arrow returning to the left above the main line (a repeat arrow) indicates
that you can make more than one choice from the stacked items or repeat an
item. The separator character, if it is other than a blank, is also indicated:
,
keyword
repeatable_argument
v
The item that is the default is shown above the main path.
default_argument
keyword
alternate_argument
v
Keywords are shown in nonitalic letters and should be entered exactly as shown.
v
Variables are shown in italicized lowercase letters. They represent user-supplied
names or values. If a variable or user-specified name ends in _list, you can
provide a list of these terms separated by commas.
viii
XL Fortran: Installation Guide

v
If punctuation marks, parentheses, arithmetic operators, or other such symbols
are shown, you must enter them as part of the syntax.
Sample syntax diagram
The following is an example of a syntax diagram with an interpretation:
,
(1)
EXAMPLE
char_constant
a
e
name_list
b
c
d
Notes:
1
IBM extension
Interpret the diagram as follows:
v
Enter the keyword EXAMPLE.
v
EXAMPLE is an IBM extension.
v
Enter a value for char_constant.
v
Enter a value for a or b, but not for both.
v
Optionally, enter a value for c or d.
v
Enter at least one value for e. If you enter more than one value, you must put a
comma between each.
v
Enter the value of at least one name for name_list. If you enter more than one value,
you must put a comma between each. (The _list syntax is equivalent to the previous
syntax for e.)
How to read syntax statements
Syntax statements are read from left to right:
v
Individual required arguments are shown with no special notation.
v
When you must make a choice between a set of alternatives, they are enclosed
by { and } symbols.
v
Optional arguments are enclosed by [ and ] symbols.
v
When you can select from a group of choices, they are separated by | characters.
v
Arguments that you can repeat are followed by ellipses (...).
Example of a syntax statement
EXAMPLE char_constant {a|b}[c|d]e[,e]... name_list{name_list}...
The following list explains the syntax statement:
v
Enter the keyword EXAMPLE.
v
Enter a value for char_constant.
v
Enter a value for a or b, but not for both.
v
Optionally, enter a value for c or d.
v
Enter at least one value for e. If you enter more than one value, you must put a
comma between each.
About this information
ix

v
Optionally, enter the value of at least one name for name_list. If you enter more
than one value, you must put a comma between each name.
Note: The same example is used in both the syntax-statement and syntax-diagram
representations.
Examples in this information
The examples in this information, except where otherwise noted, are coded in a
simple style that does not try to conserve storage, check for errors, achieve fast
performance, or demonstrate all possible methods to achieve a specific result.
The examples for installation information are labelled as either Example or Basic
example. Basic examples are intended to document a procedure as it would be
performed during a basic, or default, installation; these need little or no
modification.
Notes on the terminology used
Some of the terminology in this information is shortened as follows:
v
The term free source form format often appears as free source form.
v
The term fixed source form format often appears as fixed source form.
v
The term XL Fortran often appears as XLF.
Related information
The following sections provide related information for XL Fortran:
IBM XL Fortran information
XL Fortran provides product information in the following formats:
v
README files
README files contain late-breaking information, including changes and
corrections to the product information. README files are located by default in
the XL Fortran directory and in the root directory of the installation CD.
v
Installable man pages
Man pages are provided for the compiler invocations and all command-line
utilities provided with the product. Instructions for installing and accessing the
man pages are provided in the IBM XL Fortran for AIX, V14.1 Installation Guide.
v
Information center
The information center of searchable HTML files can be launched on a network
and accessed remotely or locally. Instructions for installing and accessing the
online information center are provided in the IBM XL Fortran for AIX, V14.1
Installation Guide.
The information center is viewable on the web at http://
publib.boulder.ibm.com/infocenter/comphelp/v121v141/index.jsp.
v
PDF documents
PDF documents are located by default in the /usr/lpp/xlf/doc/LANG/pdf/
directory, where LANG is one of en_US or ja_JP. The PDF files are also available
on the web at http://www.ibm.com/software/awdtools/fortran/xlfortran/aix/
library/.
The following files comprise the full set of XL Fortran product information:
x
XL Fortran: Installation Guide

Table 4. XL Fortran PDF files
PDF file
Document title
name
Description
IBM XL Fortran for AIX,
install.pdf
Contains information for installing XL Fortran
V14.1 Installation Guide,
and configuring your environment for basic
GC14-7335-00
compilation and program execution.
Getting Started with IBM
getstart.pdf
Contains an introduction to the XL Fortran
XL Fortran for AIX, V14.1,
product, with information on setting up and
SC14-7334-00
configuring your environment, compiling and
linking programs, and troubleshooting
compilation errors.
IBM XL Fortran for AIX,
compiler.pdf
Contains information about the various
V14.1 Compiler Reference,
compiler options and environment variables.
SC14-7336-00
IBM XL Fortran for AIX,
langref.pdf
Contains information about the Fortran
V14.1 Language Reference,
programming language as supported by IBM,
SC14-7337-00
including language extensions for portability
and conformance to nonproprietary standards,
compiler directives and intrinsic procedures.
IBM XL Fortran for AIX,
proguide.pdf Contains information on advanced
V14.1 Optimization and
programming topics, such as application
Programming Guide,
porting, interlanguage calls, floating-point
SC14-7338-00
operations, input/output, application
optimization and parallelization, and the XL
Fortran high-performance libraries.
To read a PDF file, use the Adobe Reader. If you do not have the Adobe Reader,
you can download it (subject to license terms) from the Adobe website at
http://www.adobe.com.
More information related to XL Fortran including IBM Redbooks® publications,
white papers, tutorials, and other articles, is available on the web at:
http://www.ibm.com/software/awdtools/fortran/xlfortran/aix/library/
Standards and specifications
XL Fortran is designed to support the following standards and specifications. You
can refer to these standards for precise definitions of some of the features found in
this information.
v
American National Standard Programming Language FORTRAN, ANSI X3.9-1978.
v
American National Standard Programming Language Fortran 90, ANSI X3.198-1992.
v
ANSI/IEEE Standard for Binary Floating-Point Arithmetic, ANSI/IEEE Std 754-1985.
v
Federal (USA) Information Processing Standards Publication Fortran, FIPS PUB 69-1.
v
Information technology - Programming languages - Fortran, ISO/IEC 1539-1:1991 (E).
(This information uses its informal name, Fortran 90.)
v
Information technology - Programming languages - Fortran - Part 1: Base language,
ISO/IEC 1539-1:1997. (This information uses its informal name, Fortran 95.)
v
Information technology - Programming languages - Fortran - Part 1: Base language,
ISO/IEC 1539-1:2004. (This information uses its informal name, Fortran 2003.)
v
Information technology - Programming languages - Fortran - Part 1: Base language,
ISO/IEC 1539-1:2010. (This information uses its informal name, Fortran 2008.)
About this information
xi

v
Military Standard Fortran DOD Supplement to ANSI X3.9-1978, MIL-STD-1753
(United States of America, Department of Defense standard). Note that XL
Fortran supports only those extensions documented in this standard that have
also been subsequently incorporated into the Fortran 90 standard.
v
OpenMP Application Program Interface Version 3.1, available at
http://www.openmp.org
Other IBM information
v
Parallel Environment for AIX: Operation and Use
v
The IBM Systems Information Center, at http://publib.boulder.ibm.com/
infocenter/systems/index.jsp?topic=/com.ibm.aix.doc/doc/base/aixparent.htm
is a resource for AIX information.
You can find the following books for your specific AIX system:
AIX Commands Reference, Volumes 1 - 6
Technical Reference: Base Operating System and Extensions, Volumes 1 & 2
AIX National Language Support Guide and Reference
AIX General Programming Concepts: Writing and Debugging Programs
AIX Assembler Language Reference
v
ESSL for AIX V5.1/ESSL for Linux on POWER® V5.1 Guide and Reference available
at the Engineering and Scientific Subroutine Library (ESSL) and Parallel ESSL
web page.
Technical support
Additional technical support is available from the XL Fortran Support page at
http://www.ibm.com/software/awdtools/fortran/xlfortran/aix/support/. This
page provides a portal with search capabilities to a large selection of Technotes and
other support information.
If you cannot find what you need, you can send email to compinfo@ca.ibm.com.
For the latest information about XL Fortran, visit the product information site at
http://www.ibm.com/software/awdtools/fortran/xlfortran/aix/.
How to send your comments
Your feedback is important in helping to provide accurate and high-quality
information. If you have any comments about this information or any other XL
Fortran information, send your comments by email to compinfo@ca.ibm.com.
Be sure to include the name of the information, the part number of the
information, the version of XL Fortran, and, if applicable, the specific location of
the text you are commenting on (for example, a page number or table number).
xii
XL Fortran: Installation Guide

Chapter 1. Before installing XL Fortran
Before you install IBM XL Fortran for AIX, V14.1:
v
Familiarize yourself with the installation image, which contains the installable
compiler filesets.
v
Ensure that system prerequisites such as disk space and operating system are
met.
v
Determine the tasks you need to perform, depending on your installation
requirements.
v
Become either the root user or a user with administrator privileges.
Upgrading the evaluation copy of the XL Fortran compiler
You can upgrade the evaluation version of the compiler to the licensed version by
installing the licensed product package on top of the evaluation package. By
following the Chapter 2, “Basic installation,” on page 9 or Chapter 3, “Advanced
installation,” on page 15 procedure for the licensed product package, the compiler
license can be installed. Shared filesets between the evaluation and licensed
versions that have already been installed are reported as Already installed.
Note: If the evaluation version was installed using the advanced (non-default)
installation method, and you want to install the licensed version using the same
method, you must first remove the evaluation version using rm -rf, or install the
licensed version to a different directory than the evaluation version.
The installation image and filesets
The installation image contains filesets for all the components of the compiler for
all supported language locales.
Filesets
The image includes filesets for the compiler components.
This section lists the filesets that are included in the installation image and the
default directories to which the fileset contents are installed during a basic
installation. You might optionally install all available filesets, or only the ones you
want. If you select specific filesets for installation, you might also choose to
automatically install any prerequisite filesets by using the installp -g flag.
© Copyright IBM Corp. 2003, 2012
1

XL Fortran compiler filesets
This topic lists XL Fortran compiler filesets V14.1.
Table 5. XL Fortran compiler filesets and default installation locations
Fileset name
Fileset description
Default installation locations
xlfcmp
XL Fortran compiler
/etc/
/usr/include/
/usr/lpp/xlf/bin/default_msg/
/usr/lpp/xlf/
/usr/lpp/xlf/include/
/usr/lpp/xlf/include_d7/
/usr/lpp/xlf/samples/
/usr/bin/
/usr/lpp/xlf/bin/
/usr/lpp/xlf/listings/
xlf.Bnd
XL Fortran media defined
/usr/sys/inst.data/sys_bundles/
bundles
xlf.lic
XL Fortran license files
/usr/lpp/xlf/lib/
xlf.ndi
XL Fortran non-default
/usr/lpp/xlf/bin/
installation script
xlfcmp.aix53
XL Fortran libraries for AIX
/usr/lpp/xlf/lib/aix53/
5.3, AIX 6.1, and AIX 7.1
xlfcmp.html.common
Supersede entry, not installed
Not applicable
xlfcmp.html.LANG
Supersede entry, not installed
Not applicable
LANG = [en_US, ja_JP]
xlf.man.LANG
XL Fortran compiler manual
/usr/lpp/xlf/man/LANG/man1/
pages
LANG = [en_US, EN_US,
ja_JP, JA_JP, Ja_JP]
xlfcmp.pdf.LANG
XL Fortran compiler
/usr/lpp/xlf/doc/LANG/pdf/
documentation (PDF)
LANG = [en_US, ja_JP]
xlfcmp.msg.LANG
XL Fortran compiler messages /usr/lib/nls/msg/LANG/
LANG = [en_US, EN_US,
ja_JP, JA_JP, Ja_JP]
XL Fortran runtime environment filesets
This topic lists XL Fortran runtime environment filesets V14.1.
Table 6. XL Fortran runtime environment filesets and default installation locations
Fileset name
Fileset description
Default installation
locations
xlfrte
XL Fortran runtime libraries
/usr/lib/
/usr/lpp/xlf/lib/
/usr/lpp/xlfrtemsg/
xlfrte.aix53
XL Fortran runtime environment for
/usr/lpp/xlf/lib/aix53/
AIX 5.3, AIX 6.1, and AIX 7.1
xlfrte.msg.LANG
XL Fortran runtime messages
/usr/lib/nls/msg/LANG/
LANG = [en_US, EN_US, ja_JP,
JA_JP, Ja_JP]
2
XL Fortran: Installation Guide

Runtime debug memory routine filesets
This topic lists the runtime debug memory routine filesets V5.4.
Table 7. Runtime debug memory routine filesets and default installation locations
Fileset name
Fileset description
Default installation locations
memdbg.adt
User heap/memory debug
/usr/vac/lib/
toolkit
/usr/vac/lib/profiled/
memdbg.aix53.adt
User heap/memory debug
/usr/vac/lib/aix53/
toolkit for AIX 5.3, AIX 6.1,
/usr/vac/lib/profiled/aix53/
and AIX 7.1
memdbg.msg.LANG
User heap/memory debug
/usr/lib/nls/msg/LANG
messages
LANG = [en_US, EN_US,
ja_JP, JA_JP, Ja_JP, zh_CN,
ZH_CN]
Shared-memory parallelism (SMP) runtime environment filesets
This topic lists the SMP runtime filesets V3.1.
Table 8. SMP runtime filesets and default installation locations
Fileset name
Fileset description
Default installation locations
xlsmp.rte
SMP runtime library
/usr/include/
/usr/lpp/xlsmp/default_msg/
xlsmp.msg.LANG.rte SMP runtime messages
/usr/lib/nls/msg/LANG/
LANG = [en_US, EN_US,
ja_JP, JA_JP, Ja_JP, zh_CN,
ZH_CN, Zh_CN]
xlsmp.aix53.rte
SMP runtime libraries for AIX
/usr/lpp/xlsmp/aix53/
5.3, AIX 6.1, and AIX 7.1
Mathematical Acceleration Subsystem (MASS) filesets
This topic lists the MASS filesets V7.1.
Table 9. MASS filesets and default installation locations
Fileset name
Fileset description
Default installation
locations
xlmass.adt.include
IBM MASS application development
/usr/xlmass/include/
include files
xlmass.lib
IBM MASS libraries
/usr/xlmass/lib/
xlmass.aix53.lib
IBM MASS libraries for AIX 5.3, AIX 6.1, /usr/xlmass/lib/aix53/
and AIX 7.1
Chapter 1. Before installing XL Fortran
3

Utilization reporting tool fileset
This topic lists the utilization reporting tool filesets V1.1.
Table 10. Utilization reporting tool fileset and default installation locations
Fileset
Fileset description
Default installation locations
name
urt11
Utilization reporting tool files
/opt/ibmurt/1.1/
LANG = [en_US, EN_US, ja_JP,
/opt/ibmurt/1.1/bin/
JA_JP, Ja_JP, zh_CN, ZH_CN]
/opt/ibmurt/1.1/man/LANG/man1/
/opt/ibmurt/1.1/msg/LANG/
/opt/ibmurt/1.1/config/
Note: The utilization reporting tool can be installed on the same machine as the
compiler or on a different machine. You must use installp utilities to install urt11
fileset. It typically needs to be installed only once, no matter how many compiler
installations you have. This tool is useful for those who are responsible for
monitoring the overall compiler usage within an organization. Individual
developers and build teams should not need to use this tool.
To install the utilization reporting tool, see the instructions provided in README.urt
in the root directory of the installation image.
Preparing the electronic distribution package
If you have downloaded the XL Fortran electronic distribution package,
xlf.14.1.0.aix.GM.tar.Z, follow the steps described in this topic before the
installation.
Note: You must be logged in as root user or have superuser authority.
To uncompress and unpack the file, use the command:
zcat xlf.14.1.0.aix.GM.tar.Z | tar -xvf -
The following example shows the steps to prepare the electronic distribution
package, xlf.14.1.0.aix.GM.tar.Z, located in the new directory, /compiler/install/
for installation.
cd /compiler/install
zcat xlf.14.1.0.aix.GM.tar.Z | tar -xvf -
cd usr/sys/inst.images
See “System prerequisites” on page 5 to ensure that system prerequisites are met
and use the installation methods described in either Chapter 2, “Basic installation,”
on page 9 or Chapter 3, “Advanced installation,” on page 15 to install the compiler.
National language support
When fileset names differ only by the locale code, you can choose to install only
the filesets that are relevant to your desired language and location. The LANG
environment variable determines which message catalogs are used. The en_US
(English) message catalogs are installed by default. If LANG is not defined or is
assigned an unsupported locale, en_US message catalogs are used. This topic
introduces a list of available locales.
The XL Fortran messages support the following language locales:
v
en_US (ISO8859-1)
v
EN_US (UTF-8)
v
ja_JP (IBM-eucJP)
4
XL Fortran: Installation Guide

v
JA_JP (UTF-8)
v
Ja_JP (IBM-943)
English (en_US) is the default national language. Following installation, you can
set the NLSPATH so that messages are displayed in a different language. See
“Enabling the XL Fortran error messages” on page 29.
System prerequisites
All system prerequisites must be ready on your system before XL Fortran and its
documentation can be successfully installed and run.
v
Supported operating systems:
– AIX V5.3 TL 5300-07 or later
– AIX V6.1
– AIX V7.1
– IBM i V6.1 PASE V6.1 with PTF SI30636 or later
– IBM i V7.1 PASE V7.1
Note: Additional filesets must be installed on these systems. For details, see
“Required filesets for installing XL Fortran.”
v
Required hard disk space: 250 MB
v
Required software for documentation:
– HTML browser
– PDF viewer
Verifying the amount of hard disk space available
You can use the following command to determine the amount of space available in
the default installation location (/usr/lpp/xlf/):
df -m /usr
If you plan to install the compiler to a non-default location, you can use the
following command:
df -m installation_path
In this command, installation_path represents the non-default location.
Required filesets for installing XL Fortran
The following filesets must be installed on your system in order to install IBM XL
Fortran for AIX, V14.1:
Fileset name
Fileset description
bos.adt.include
Base application development include files
bos.adt.lib
Base application development libraries
bos.adt.libm
Base application development math libraries
bos.rte
Base operating system run time
bos.rte.libc
Base application runtime library
Chapter 1. Before installing XL Fortran
5

At least one of the following locale-specific filesets must be installed on your
system:
Fileset name
Fileset description
bos.loc.LANG
Base locale support
bos.loc.pc.LANG
Base system locale PC code set
bos.loc.utf.LANG
Base system locale UTF code set
bos.loc.iso.LANG
Base system locale ISO code set
You can view information about the installed filesets by using the lslpp command.
For example, to determine if the required filesets have been installed, use the
following command:
lslpp -L bos.adt.include bos.adt.lib bos.adt.libm bos.loc.* bos.rte bos.rte.libc
Note: If one of the required filesets is missing, an error message might be
generated, for example,
MISSING REQUISITES: The following filesets are required by one or more of the selected
filesets listed above. They are not currently installed and could not be found on the
installation media.
bos.adt.libm 5.3.7.0 # Base Level Fileset
This message indicates that the bos.adt.libm fileset is required but not installed.
To install a missing fileset, use the following command:
# installp -acXgd installation_path fileset
In this command, installation_path represents the location of the fileset to be
installed. For further information, see the installation video on IBM Education
Assistant at http://publib.boulder.ibm.com/infocenter/ieduasst/rtnv1r0/topic/
com.ibm.iea.compilerfortran/compilerfortran/14.1/Installation/Prereq_installation/
libm_installation_viewlet_swf.html?dmuid=20111031122939191249.
Previewing the installation and license agreements
Before installing IBM XL Fortran for AIX, V14.1, you can verify the default
installation process, check file sizes and disk space, and preview the license
agreements using either SMIT or installp.
The terms and conditions for using XL Fortran are specified in the following PDF
files, which are located in the root directory of the distribution package:
v
LicenseAgreement.pdf
v
license.pdf
These license files can be found in the /usr/lpp/xlf/ directory after basic
installation.
Note: You can use the utilization tracking and reporting feature to ensure the
compiler usage is compliant with the number of Concurrent User licenses you
have purchased. For more information, see Tracking and reporting compiler usage
in the XL Fortran Compiler Reference.
6
XL Fortran: Installation Guide

Using SMIT
You can use the System Management Interface Tool (SMIT) to preview the basic XL
Fortran installation.
Follow the steps to install the compiler to the default location given in “Using
SMIT” on page 11. When prompted with the SMIT dialog to customize the
installation in step 3, set the Preview only? field to yes. With this setting enabled,
SMIT displays progress messages at each stage of the installation but does not
actually install the compiler on your system.
Using installp
You can also preview the command line installation process and write the output
to a log file, using the installp command. Follow the steps to install the compiler
to the default location given in “Using installp” on page 12 and specify the -p flag
to preview the process without installing the compiler.
The following example previews the installation of all the available compiler
filesets in the /cdrom/usr/sys/inst.images source directory to the default location,
/usr/lpp/xlf/ and writes an installation log file to /tmp/install.log.
Example:
installp -paXgd /cdrom/usr/sys/inst.images -e /tmp/install.log all
Chapter 1. Before installing XL Fortran
7

8
XL Fortran: Installation Guide

Chapter 2. Basic installation
You can use the basic installation procedure to install XL Fortran if the following
conditions are true:
v
You are installing IBM XL Fortran for AIX, V14.1 to the default directory,
/usr/lpp/xlf/.
v
You are maintaining a single version of XL Fortran on your system, and you
agree to remove any previously installed XL Fortran components.
If both these conditions apply, the basic installation is the easiest and fastest
method, because it can automatically uninstall previous versions of XL Fortran,
install the latest version, and configure the compiler, all through the use of a single
installation tool.
If either of these conditions does not apply, do not use basic installation. Instead,
see the procedures in Chapter 3, “Advanced installation,” on page 15.
The following basic installation methods install XL Fortran to the default directory.
If you have root access or a profile with superuser privileges, you can use the
Bundle installation method, the System Management Interface Tool (SMIT), or the
installp command to install the compiler.
You can use the basic installation methods to perform any of the following tasks:
v
Install IBM XL Fortran for AIX, V14.1 on a clean system.
v
Install IBM XL Fortran for AIX, V14.1 on a system where IBM XL C for AIX,
V12.1 or XL C/C++ for AIX, V12.1 is already installed. In this case, both
compilers will use the SMP and MASS libraries provided with XL Fortran for
AIX. (For information about installing XL C or XL C/C++ , see the IBM XL C for
AIX, V12.1 or XL C/C++ for AIX, V12.1 Installation Guide.)
v
Install an update on a system where IBM XL Fortran for AIX, V14.1 has already
been installed. In this case, use the procedure in Chapter 4, “Update
installation,” on page 21.
Installation demonstration videos are also available on IBM Education Assistant at
http://publib.boulder.ibm.com/infocenter/ieduasst/rtnv1r0/index.jsp. For basic
installation instructions and how to upgrade the evaluation copy, see
http://publib.boulder.ibm.com/infocenter/ieduasst/rtnv1r0/topic/
com.ibm.iea.compileraix/compileraix/12.1/
Installation.html?dmuid=20111028143138027594.
Tasks for basic installation
Before you perform a basic installation, you must make sure that you have a user
account with administrator privileges and that your system meets all system
requirements. After you have finished installing the compiler, you must confirm
that the installation has been successful and enable the man pages of the compiler.
The following table outlines the procedure for basic installation.
© Copyright IBM Corp. 2003, 2012
9

Table 11. Steps for basic installation: new or upgrade installation
Steps
References
Become either the root user or a user with
Documentation supplied with the
administrator privileges.
operating system.
Ensure that all system prerequisites are satisfied.
“System prerequisites” on page 5
Use the bundle installation method, SMIT, or the
“Using the bundle installation
installp command to install and configure the
method,” “Using SMIT” on page 11, or
compiler, using the default paths.
“Using installp” on page 12
Confirm that the compiler packages have been
“Checking compiler and fileset
successfully installed, and test the installation.
information” on page 27, “Testing the
installation” on page 33
Enable the compiler man pages.
“Enabling the manual pages” on page
30
If your system locale or encoding, or both are not
“Enabling the XL Fortran error
en_US, enable the compile-time error messages.
messages” on page 29
Otherwise, skip this step.
Using the bundle installation method
You can install XL Fortran using the bundle installation method. The bundle fileset
contains scripts to help install either the evaluation version or the licensed version
of the compiler.
About this task
To install the compiler using the bundle installation method, take the following
steps:
Procedure
1. As the root user, install the compiler bundle fileset xlf.Bnd, using the installp
command. You can skip this step if you are upgrading from the evaluation
version and the fileset is already installed on the system.
installp -aXd . xlf.Bnd
2. Enter the following command from the command line to start Smit easy mode:
# smitty easy_install
3. Enter the name of the installation device. It is the path in which the filesets can
be found, for example, /usr/sys/inst.images. If the filesets are in your current
directory, you can use “.” as the input device.
* INPUT device / directory for software
[.]
4. From the selection screen, select the package that you need.
v
If you are installing the evaluation version on AIX V5.3, choose
xlf-evaluation-aix53.
v
If you are installing the evaluation version on AIX V6.1 or V7.1, choose
xlf-evaluation-aix61-aix71.
v
If you are installing or upgrading to the licensed version on AIX V5.3, choose
xlf-licensed-aix53.
v
If you are installing or upgrading to the licensed version on AIX V6.1 or
V7.1, choose xlf-licensed-aix61-aix71.
5. Change the following values provided on the bundle screen as appropriate to
your situation, and press Enter to continue.
10
XL Fortran: Installation Guide

v
You can change the AUTOMATICALLY install requisite software? option to
yes to install the compiler automatically.
v
You can change the EXTEND file systems if space needed? option to yes to
extend file systems.
v
You must change the ACCEPT new license agreements? option to yes to
accept new license agreements.
6. Scroll to the end of the installation output to check the installation summary.
The output indicates whether the installation of your bundle has been
successful. Exit using Esc+0.
Note: Using the bundle installation method prevents the installation tools from
installing filesets that are not supported by your operating system. Therefore,
no failures and error messages caused by unsupported filesets are generated as
mentioned in “Using SMIT” and “Using installp” on page 12.
Using SMIT
The SMIT guides you step-by-step through the installation process.
About this task
To install the compiler using the SMIT interface, follow these steps:
Procedure
1. Enter the command smit install_latest. This command runs the SMIT, which
presents a menu-driven user interface for the installation process. You must
specify the INPUT device/directory of the software.
2. Press F4 to select from a list of suggested devices and directories, or type in the
name of the CD-ROM device or the path to the location of the packages. If you
want to install over a network you must have a network server installed, and
then specify the directory on the client that corresponds to the installation
source on the network server.
3. Press Enter. At this stage you are prompted with a list of questions that can
help you customize the compiler installation on your system. Verify the default
values, or modify them where necessary to accommodate your preferences.
Important: You must select yes next to Accept new LICENSE agreements? to
continue with the installation.
Note:
v
You can select the SOFTWARE to install field and press F4 to view the
installable filesets on the device or in the directory, then select the filesets to
install. Install the runtime libraries first, then install the other filesets in any
order. It is recommended that you keep the default setting, _all_latest, to
install all the filesets.
v
To preview the installation process without actually installing the compiler
select yes next to the Preview only? field.
4. Press Enter and then Enter again.
Notes:
v
If you use the command smit install_latest, an error message might be
generated. For example, you might encounter an error message indicating
that either xlC.aix50.rte or xlC.aix61.rte has failed to be installed. In this
Chapter 2. Basic installation
11

case, you can ignore the message. The reason for the error message is that if
you install the compiler onto a system running AIX 5.3, only xlC.aix50.rte
is required, and xlC.aix61.rte automatically fails to be installed. Likewise, if
you install the compiler onto a system running AIX 6.1, only xlC.aix61.rte
is required, and xlC.aix50.rte fails to be installed. The following message is
an example of the error message you might encounter.
Requisite Failures
------------------
SELECTED FILESETS: The following is a list of filesets that you asked to
install. They cannot be installed until all of their requisite filesets
are also installed. See subsequent lists for details of requisites.
xlC.aix61.rte 11.1.0.0 # XL C/C++ Runtime for AIX 6.1
MISSING REQUISITES: The following filesets are required by one or more
of the selected filesets listed above. They are not currently installed
and could not be found on the installation media.
bos.rte 6.0.0.0 # Base Level Fileset
bos.rte.libc 6.0.0.0 # Base Level Fileset
v
Similarly, any language specific filesets that are not supported by your
system can produce an error message and fail to install. For example, if local
support is not present for Ja_JP, you might fail when attempting to install a
Ja_JP specific language fileset for the compiler. These error messages are
normal and must be ignored.
v
The runtime libraries and compiler filesets are always required.
v
You do not need all of the compile-time and runtime message catalogs, only
those for the national languages that you need for compile-time and runtime
messages.
v
Messages are displayed as each part is successfully installed.
v
The installation log is stored in the /home/smit.log file.
Using installp
You can install XL Fortran directly from the command line using the AIX
command installp.
About this task
To install the compiler and write the installation output to a log file using the
installp command, follow these steps:
Run the command:
installp -aXYgd install_images_location -e logfile fileset_names
-
installp
-aYg
fileset_names
-p
-X
-d
install_images_location
-e
logfile
-aYg
Specifies that all the latest installable filesets available in the
install_images_location directory are applied and that the required software
license agreement is accepted.
-p
Performs a preview of the installation process by running the preinstallation
checks. See previewing the installation.
12
XL Fortran: Installation Guide

-X
Attempts to expand the file system at the default location if there is insufficient
space to complete the install.
-d install_images_location
Specifies the directory where the filesets are located. This path may also be a
mounted CD-ROM drive.
-e logfile
Specifies the name and location of the installation log file.
fileset_names
Specifies a list of names of the filesets in install_images_location that you want
to install.
Note: The keyword all can be used to indicate that all filesets should be
attempted during installation.
The following example installs all available compiler filesets in the
/cdrom/usr/sys/inst.images source directory to the default locations, as specified
in “Filesets” on page 1, and writes an installation log file to /tmp/install.log.
Example:
installp -aXYgd /cdrom/usr/sys/inst.images -e /tmp/install.log all
Notes:
v
If you use the keyword all as in this example, an error message might be
generated. For example, you might encounter an error message indicating that
either xlC.aix50.rte or xlC.aix61.rte has failed to be installed. In this case,
you can ignore the message. The reason for the error message is that if you
install the compiler onto a system running AIX 5.3, only xlC.aix50.rte is
required, and xlC.aix61.rte automatically fails to be installed. Likewise, if you
install the compiler onto a system running AIX 6.1, only xlC.aix61.rte is
required, and xlC.aix50.rte fails to be installed. The following message is an
example of the error message you might encounter.
Requisite Failures
------------------
SELECTED FILESETS: The following is a list of filesets that you asked to
install. They cannot be installed until all of their requisite filesets
are also installed. See subsequent lists for details of requisites.
xlC.aix61.rte 11.1.0.0 # XL C/C++ Runtime for AIX 6.1
MISSING REQUISITES: The following filesets are required by one or more
of the selected filesets listed above. They are not currently installed
and could not be found on the installation media.
bos.rte 6.0.0.0 # Base Level Fileset
bos.rte.libc 6.0.0.0 # Base Level Fileset
v
Similarly, any language specific filesets that are not supported by your system
will produce an error message and fail to install. For example, if locale support
is not present for Ja_JP, you will get a failure when attempting to install a Ja_JP
specific language fileset for the compiler. These error messages are normal and
should be ignored.
Chapter 2. Basic installation
13

14
XL Fortran: Installation Guide

Chapter 3. Advanced installation
You must use the advanced installation procedure if any of the following are true:
v
You are maintaining multiple versions of the same product on a single system.
v
You are installing the product to a non-default location.
v
You are installing on an IBM i V6.1 PASE system.
v
You are installing on an IBM i V7.1 PASE system.
To perform an advanced installation, you need to use the xlfndi Perl script
provided with the installation image, to install XL Fortran to a non-default
directory and run multiple versions of XL Fortran on a single system. The script is
packaged in the xlf.ndi fileset. To avoid unexpected behavior during installation,
do not modify this script.
Limitations of non-default installation
Although non-default installation gives you more freedom to choose how many
versions of XL Fortran to keep on your system and where to install them, in many
ways a non-default installation is also more restrictive, demanding to implement,
and difficult to maintain than a basic installation.
v
The recommended method for installing XL Fortran is installing to the default
location. You must only use the xlfndi script to install XL Fortran if you are an
expert user familiar with the compiler and the standard installation process.
v
The xlfndi script does not check whether prerequisite packages are installed.
v
You cannot use this script to install the product filesets individually.
v
You cannot use AIX tools (such as lslpp) to uninstall or to query installed
filesets for version or release level information.
v
Service refreshes of the compiler assume a default installation path. For a
non-default compiler installation, the xlfndi script must be used to apply
service packages.
v
To run xlfndi, you must have Perl version 5.5.3 or higher, runtime environment
perl.rte, installed on your system. This fileset is shipped with the AIX base
operating system.
v
The xlfndi script requires that the original filesets not be renamed. This means
that you cannot install the compiler using filesets that have been copied by the
SMIT sub-option "Copy Software to Hard Disk for Future Installation" because
the version number of the compiler is appended to the filesets when they are
copied.
v
The xlfndi tool requires you to install the PTF xlf.ndi fileset before the tool can
be used to install the PTF to a non-default location.
Tasks for advanced installation
Before you perform an advanced installation, you must make sure that you have a
user account with administrator privileges and that your system meets all system
requirements. You might also want to uninstall any previous versions of XL
Fortran on your system. After you have finished installing the compiler you must
confirm that the installation has been successful and enable the man pages of the
compiler.
© Copyright IBM Corp. 2003, 2012
15

The recommended procedure for advanced installation is outlined in the following
table:
Table 12. Steps for advanced installation: new or upgrade installation
Task
For more information, see . . .
Become either the root user or a user with
Documentation supplied with the
administrator privileges.
operating system.
Ensure that all system prerequisites are satisfied.
“System prerequisites” on page 5
If you do not need to maintain multiple versions
Chapter 6, “Uninstalling XL Fortran,”
of the product on your system, remove any
on page 35
existing versions of XL Fortran for AIX.
Use the non-default installation script to install
“Non-default installation procedure”
the compiler.
“Installing on an IBM i PASE system”
If you are installing the compiler on an IBM PASE on page 18
system, use the non-default installation method.
Confirm that the compiler packages have been
“Checking compiler and fileset
successfully installed, and test the installation.
information” on page 27, “Testing the
installation” on page 33
Enable the compiler man pages.
“Enabling the manual pages” on page
30
If your system locale or encoding, or both are not
“Enabling the XL Fortran error
en_US, enable the compile-time error messages.
messages” on page 29
Otherwise, you can skip this step.
Non-default installation procedure
To install XL Fortran to a non-default location, first use installp to install the xlf.ndi
fileset, then use the xlfndi Perl script included in that fileset to install the
compiler.
About this task
Follow these steps to install XL Fortran to an alternate location:
Procedure
1. First use the installp command to install the xlf.ndi fileset. Run the command:
installp -aYgd install_images_location -e logfile xlf.ndi xlf.licAgreement
-
installp
-aYg
xlf.ndi
xlf.licAgreement
-p
-X
-d
install_images_location
-e
logfile
-aYg
Specifies that all the latest installable filesets available in the
install_images_location directory are applied and that the required software
license agreement is accepted.
-d install_images_location
Specifies the directory where the filesets are located. This path might also
be a mounted CD-ROM drive.
-e logfile
Specifies the name and location of the installation log file. By default, the
installation log file xlfndi.log will be stored in your working directory.
16
XL Fortran: Installation Guide

-p
Performs a preview of the installation process by running the
preinstallation checks. See “Previewing the installation and license
agreements” on page 6.
-X
Attempts to expand the file system at the default location if there is
insufficient space to complete the install.
Example:
installp -aYgd /cdrom/usr/sys/inst.images -e /tmp/install.log xlf.ndi \
xlf.licAgreement
Note: This command automatically installs and accepts the license agreement
fileset, xlf.licAgreement, required to install xlf.ndi.
2. Install any available updates to the xlf.ndi fileset. You can download the latest
compiler updates from the support website: http://www.ibm.com/software/
awdtools/fortran/xlfortran/aix/support/
To check the version number of the xlf.ndi fileset currently installed on your
system, use the following command:
lslpp -l xlf.ndi
To install a new version of the xlf.ndi fileset, use the following command:
installp -aYgd ptf_images_location -e logfile xlf.ndi
3. Install XL Fortran by entering the following command:
perl
/usr/lpp/xlf/bin/xlfndi
-d
source_path
-e
logfile
-b
target_dir
-rte
-eval
-version
perl /usr/lpp/xlf/bin/xlfndi -d source_path [-e logfile] [-b target_dir] [-rte]
[-eval] [-version]
where:
-d source_path
Specifies the directory where the filesets are located. This path may also be
a mounted CD-ROM drive.
-e logfile
Specifies the name and location of the installation log file. By default, the
installation log file xlfndi.log is stored in your working directory.
-b target_dir
Specifies the location where the filesets should be copied and expanded. By
default, the files are copied to the xlfndi directory in your working
directory. If the directory exists already, you will receive an error message
and the installation will stop.
-rte
Specifies that only the runtime component should be installed.
-eval
Specifies that the installation is for the evaluation version of XL Fortran.
-version
Displays the version of the non-default installation tool.
Chapter 3. Advanced installation
17

The following example uses the xlfndi Perl script to install all available
compiler filesets in the /cdrom/usr/sys/inst.images source directory to the
non-default location, /compiler/xlf/ and writes the installation log file to
/tmp/xlf.ndi.inst.log.
Example:
perl /usr/lpp/xlf/bin/xlfndi -d /cdrom/usr/sys/inst.images -b /compiler/xlf/
-e /tmp/xlf.ndi.inst.log
Results
IBM XL Fortran for AIX is installed into the chosen location.
Installing on an IBM i PASE system
About this task
Users installing XL Fortran on an IBM i PASE system must use the non-default
installation method because the AIX SMIT and installp utilities are not supported.
If, during installation, the xlfndi script determines that you are installing the
compiler onto a PASE system, it modifies the name of the XL Fortran configuration
file and one of its variables, oslevel, to match the version of PASE you are running.
For example, if the compiler has been installed on a system running IBM i V6.1
PASE V6.1, xlf.cfg.53 is renamed xlf.cfg.61 and the value of oslevel is changed from
5.3 to 6.1. If the compiler has been installed on a system running IBM i V7.1 PASE
V7.1, xlf.cfg.61 is renamed xlf.cfg.71 and the value of oslevel is changed from 6.1 to
7.1.
To install the XL Fortran compiler on i PASE, follow these steps:
1. Start the installation by inserting the compiler product installation CD into the
CD drive, or using the electronic distribution package.
Note: If you use the electronic image, you must extract the distribution
package into a case sensitive file system, such as /QOpenSys/. The non-default
installation option -i can only be used if you install the compiler using the CD.
2. Sign on to the system with a user profile that has *ALLOBJ authority. The
compiler product files are owned by this user profile.
3. Start an interactive i PASE terminal session by entering this CL command.
call qp2term
4. Restore the appropriate compiler installation script.
v
If you use the electronic distribution package, run the following commands:
cd /QOpenSys/home/user
zcat xlf.14.1.0.aix.GM.tar | tar -xvf -
restore -qf usr/sys/inst.images/xlf.ndi ./usr/lpp/xlf/bin/xlfndi
v
If you use the installation CD, run the following commands:
cd /QOpenSys/home/user
restore -qf /QOPT/CDROM/USR/SYS/INST.IMA/XLF.NDI ./usr/lpp/xlf/bin/xlfndi
5. Run the installation script to install the compiler. The destination directory for
the compiler is specified by the -b option in the command. The preferred
directory names for the compilers are used in the following commands. If you
choose a different directory, the directory is in the /QOpenSys tree to allow for
case-sensitive file names.
v
If you use the electronic distribution package, run the following commands:
18
XL Fortran: Installation Guide

/QIBM/ProdData/DeveloperTools/pase/bin/perl ./usr/lpp/xlf/bin/xlfndi -d \
./usr/sys/inst.images -b /QOpenSys/xlf
v
If you use the installation CD, run the following commands:
/QIBM/ProdData/DeveloperTools/pase/bin/perl ./usr/lpp/xlf/bin/xlfndi -i -d \
/QOPT/CDROM/USR/SYS/INST.IMA -b /QOpenSys/xlf
After the XL Fortran compiler is installed for use in i PASE,
v
The XL Fortran compiler commands, for example, xlf can be found in directory
/QOpenSys/xlf/usr/bin/.
v
The XL Fortran compiler documentation (in PDF) can be found in directory
/QOpenSys/xlf/usr/lpp/xlf/doc/en_US/pdf.
Note: You can add the directory that contains the compiler commands to the
$PATH environment variable. The $PATH environment variable specifies the
directories to be searched to find a command. For example, if you have installed
XL C/C++ compiler, you can change the $PATH environment variable as follows to
avoid specifying the command path when you use the compiler commands:
export $PATH=$PATH:/QOpenSys/xlf/usr/bin
For information about installing PTFs for compiler installation updates on the
PASE system, see “Installing PTF updates on the PASE system” on page 22.
For more information about the IBM i V7.1 PASE system, see IBM PASE for i. For
more information about the IBM i V6.1 PASE system, see i5/OS® PASE, or see the
PDF version of System i®: Programming IBM PASE for i.
Running XL Fortran from a non-default location
The compiler invocation commands are installed to /target_dir/usr//bin/, where
target_dir is the location of the compiler as set by the -b flag during the
non-default installation.
About this task
For example, if you installed XL Fortran to the /compiler/xlf directory, you can
run the compiler using:
/compiler/xlf/usr/bin/xlf -o hello_f hello.f
Alternatively, you can create a shortcut to the compiler invocations, as described in
“Creating shortcuts to the XL Fortran invocation commands” on page 30.
Chapter 3. Advanced installation
19

20
XL Fortran: Installation Guide

Chapter 4. Update installation
A program temporary fix (PTF) is an update to XL Fortran that provides a fix or
multiple fixes to the product.
You can download the latest compiler updates from the support website:
http://www.ibm.com/software/awdtools/fortran/xlfortran/aix/support/. You
can also find the instructions on Fix Central.
Tasks for update installation
If you are installing an update to XL Fortran, you must first determine whether the
compiler has been installed to a default or non-default directory, and then follow
the recommended steps for updating that installation type.
If the compiler has been installed to the default directory, /usr/lpp/xlf/, you must
follow the steps outlined in the following table, Table 13.
Table 13. Steps for basic installation: update installation
Task
For more information, see . . .
Become either the root user or a user with
Documentation supplied with the
administrator privileges.
operating system.
Ensure that all the system prerequisites are met.
“System prerequisites” on page 5
Download, uncompress, and unpack the PTF
“Preparing a PTF package for
package.
installation” on page 22
Generate a .toc file.
“Preparing a PTF package for
installation” on page 22
Use SMIT or the installp command to install
“Using SMIT” on page 23 or
PTFs, using the default paths.
“Using installp” on page 24
Confirm that the compiler packages were
“Checking compiler and fileset
successfully installed, and test the installation.
information” on page 27, “Testing the
installation” on page 33
If the compiler has been installed to any directory other than /usr/lpp/xlf/, you
must follow the steps outlined in the following table, Table 14.
Table 14. Steps for advanced installation: update installation
Task
For more information, see . . .
Become either the root user or a user with
Documentation supplied with the
administrator privileges.
operating system.
Ensure that all system prerequisites are met.
“System prerequisites” on page 5
Download, uncompress, and unpack the PTF
“Preparing a PTF package for
package.
installation” on page 22
Generate a .toc file.
“Preparing a PTF package for
installation” on page 22
Install any PTF updates to the xlf.ndi fileset using
“Using SMIT” on page 23 or
SMIT or installp.
“Using installp” on page 24
Use the non-default installation script to install
“Updating an advanced installation
further updates.
using xlfndi” on page 24
© Copyright IBM Corp. 2003, 2012
21

Table 14. Steps for advanced installation: update installation (continued)
Task
For more information, see . . .
Confirm that the compiler packages were
“Checking compiler and fileset
successfully installed, and test the installation.
information” on page 27, “Testing the
installation” on page 33
Preparing a PTF package for installation
Updates to the compiler are supplied as PTF packages. Before these PTF packages
can be used to update the compiler, they must be downloaded and uncompressed,
and a .toc file must be generated.
Use the following instructions to prepare the update package for installation:
Note: You must be logged in as root or have superuser authority.
1. Download the PTF package that you want(for example
xlf.141.aix.mthyear.ptf.tar.Z) into an empty directory.
2. Restore the compressed file and extract the PTF filesets from the downloaded
package. To uncompress and unpack the tar file, use the following command:
zcat package_name.tar.Z | tar -xvf -
3. Use the command inutoc directory_name to generate a .toc file in the same
directory as the unpacked filesets.
The following example shows the steps to prepare the package,
xlf.141.aix.mthyear.ptf.tar.Z, located in the new directory, /compiler/update/
for installation.
cd /compiler/update
zcat xlf.141.aix.mthyear.ptf.tar.Z | tar -xvf -
inutoc .
Installing PTF updates on the PASE system
This section describes the steps to install PTFs for the XL Fortran compiler on the
PASE system.
Before installing the PTFs, you must have already installed the compilers on the
PASE system using the steps in “Installing on an IBM i PASE system” on page 18.
To install PTFs for the XL Fortran compiler on i PASE, follow these steps:
1. Obtain the PTF package files to be installed.
2. Uncompress and then untar the PTF package files. If you have downloaded the
compressed TAR images to the /QOpenSys/vacptf/ directory, you can use the
following commands from a QP2TERM command line:
cd /QOpenSys/ptf
uncompress <filename.tar.Z>
tar -xvf <filename.tar>
3. Create a file containing a list of the PTF packages to be installed. To do so, use
the following commands on a QP2TERM command line:
cd /QOpenSys/ptf
ls *.bff > ptflist.txt
4. Check and update, if necessary, the non-default installation (NDI) tool itself.
The updated version of the NDI tool needs to be restored first in order to use
the updated version to install the rest of the PTF package. To do so, use the
following commands:
22
XL Fortran: Installation Guide

cd /
ls /QOpenSys/ptf/xlf.ndi.*
restore -qf xlf.ndi.V.R.M.F.bff ./usr/lpp/xlf/bin/xlfndi
Note:
v
If the ls command returns an error message indicating the file does not exist,
it means the NDI tool is not updated by the PTF package. Skip this
command and continue with the next step in the instructions.
v
If the ls command does return a file name, make a note of this file name and
use that file name in the restore command. For example, if the file name
returned is xlf.ndi.14.01.0000.0006.bff, then replacing the
xlf.ndi.V.R.M.F.bff file name shown in the restore command with the
actual name returned results in the following restore command:
restore -qf xlf.ndi.14.01.0000.0006.bff ./usr/lpp/xlf/bin/xlfndi
5. Run the installation script to install the PTFs. Enter the following command
from the QP2TERM command line:
/QIBM/ProdData/DeveloperTools/pase/bin/perl /usr/lpp/xlf/bin/xlfndi \
/QOpenSys/ptf -b /QOpenSys/xlf -u /QOpenSys/ptf/ptflist.txt
The installation script creates a compressed TAR backup of the compiler files that
exist before the PTF update. If you use the directories as shown in these
instructions, this file is named /QOpensys/xlf.backup.tar.Z. If a problem is
encountered with the installation of the PTF update or with the PTF update itself,
you can restore from this backup to uninstall the PTF update.
Updating a basic installation
If you used a basic installation process to install XL Fortran to a default location, it
is recommended that you use SMIT or the installp command to install PTFs.
Using SMIT
About this task
To install a PTF using the SMIT interface, follow these steps:
Procedure
1. Run the command: smit install_all. This command invokes the SMIT, which
presents a menu-driven user interface for the installation process.
2. When asked to, specify the INPUT device/directory of the software, enter the
path of the directory where the PTF filesets and .toc are located.
3. Press Enter.
At this stage, you are prompted with a list of questions that will help you
customize the compiler installation on your system. Verify the default values,
or modify them where necessary, to accommodate your preferences.
4. Press Enter and then Enter again.
Messages are displayed as each part is successfully installed, and the
installation log is stored to /home/smit.log.
What to do next
Note: PTF packages often ship base level filesets as prerequisites. If the command
smit update_all is used, then those packages will not install, which may cause
Chapter 4. Update installation
23

requisite failures. For this reason we recommend that you use smit install_all,
which will install the prerequisites and commit the updates.
Using installp
About this task
To install a PTF by using the installp command and write the output to a log file,
follow these steps:
Run the command:
-
installp
-ag
fileset_names
-p
-X
-d
PTF_filesets_location
-e
logfile
installp -aXgd PTF_filesets_location -e logfile fileset_names
-ag
Specifies that all the latest installable filesets available in the
PTF_filesets_location directory are applied.
-p
Performs a preview of the installation process by running the preinstallation
checks. See “Previewing the installation and license agreements” on page 6.
-X
Attempts to expand the file system at the default location if there is insufficient
space to complete the install.
-d PTF_filesets_location
Specifies the directory where the filesets are located. This path might also be a
mounted CD-ROM drive.
-e logfile
Specifies the name and location of the installation log file.
fileset_names
Specifies a list of names of the filesets in PTF_filesets_location that you want to
install.
Note: The keyword all can be used to indicate that all filesets must be
attempted during installation.
The following example installs all available PTF filesets in the /compiler/update/
source directory to the default locations, as specified in “Filesets” on page 1, and
writes an installation log file to /tmp/install.log.
Example:
installp -aXgd /compiler/update/ -e /tmp/install.log all
Updating an advanced installation using xlfndi
If the XL Fortran compiler has been installed to a non-default directory, you must
use xlfndi to install PTFs.
About this task
Note: The xlfndi tool enforces that you install the PTF xlf.ndi fileset before using
the tool to install the PTF to a non-default location.
24
XL Fortran: Installation Guide

To update a non-default installation, do the following:
Procedure
1. Begin by installing the xlf.ndi fileset included in the PTF. This fileset must be
installed first, so that the xlfndi script inside it can be used to correctly install
the remaining filesets.
To determine the version number of the xlf.ndi fileset currently installed on
your system, run the command:
lslpp -l xlf.ndi
To install a new version of the xlf.ndi fileset, run the command:
installp -aYgd ptf_images_location -e logfile xlf.ndi
2. Create a text file listing the PTF filesets you want to install. This text file must
contain the name of a single PTF file on each line. You can use the ls command
to do this: ls source_path > ptf_names_file.
For example:
ls /compiler/update/*.bff > /home/user/update.list
update.list contains all the updated fileset names, one for each line. For
example:
xlf.man.EN_US.14.01.0000.0001.bff
3. Use the perl command to run the xlfndi script:
perl
/usr/lpp/xlf/bin/xlfndi
-d
source_path
-u
ptf_names_file
-e
logfile
-b
target_dir
-rte
-version
perl /usr/lpp/xlf/bin/xlfndi -d source_path -u ptf_names_file [-e logfile]
-b [target_dir]
where:
-d source_path
Specifies the directory where the filesets are located. This path might also
be a mounted CD-ROM drive.
-u ptf_names_file
Specifies the text file containing the names of PTF filesets you want to
install.
-e logfile
Specifies the name and location of the installation log file. By default, the
installation log file xlfndi.log will be stored in your working directory.
-b target_dir
Specifies the location where the filesets should be copied and expanded. By
default, the files are copied to the xlfndi directory in your working
directory. If the directory exists already, an error message is produced and
the installation stops.
-rte
Specifies that only the runtime component is installed.
-version
Displays the version of the non-default installation tool.
Chapter 4. Update installation
25

Note: The installation script creates a compressed TAR backup of the
compiler files that exist before the PTF update. If a problem is encountered
with the installation of the PTF update or with the PTF update itself, you
can restore from this backup file target_dir.tar.Z to uninstall the PTF
update.
The following example uses the xlfndi Perl script to install all available PTF
filesets in the /compiler/update/ source directory to the non-default location,
/compiler/xlf/ and writes the installation log file to /tmp/xlf.ndi.inst.log.
Example:
perl /usr/lpp/xlf/bin/xlfndi -d /compiler/update/ -u /compiler/update/ptflist
-b /compiler/xlf/ -e /tmp/xlf.ndi.inst.log
Product version migration
If you have a previous version of the compiler, you can replace it with the current
version. You can also maintain multiple versions of the compiler on your system.
Before installing IBM XL Fortran for AIX, V14.1, any previously installed versions
of the compiler should be uninstalled. If you intend to maintain multiple versions
of XL Fortran on your system, refer to Chapter 3, “Advanced installation,” on page
15, otherwise see Chapter 6, “Uninstalling XL Fortran,” on page 35.
If you are upgrading to XL Fortran V14.1 using a basic installation, any previous
versions of the filesets already installed on your system are automatically detected
and migrated to the current version.
Once IBM XL Fortran for AIX, V14.1 is installed, older compiler versions cannot be
installed unless V14.1 is uninstalled first.
Operating system migration
If you have the compiler installed on AIX 5.3 or AIX 6.1, you might want to
migrate the operating system to AIX 7.1.
The compiler filesets are not OS specific and do not require migration if XL Fortran
V14.1 is installed on AIX 5.3 and the operating system is migrated to AIX 6.1 or
higher. If an OS specific fileset is required in the future for a higher level of AIX, it
will be identified in a Tech Note tied to the PTF that adds support for that version
of AIX.
26
XL Fortran: Installation Guide

Chapter 5. After installing XL Fortran
There are optional setup and verification procedures that you can use after you
have installed the compiler. You might also want to use the product
documentation.
These are documented in the following sections:
v
“Checking compiler and fileset information”
v
“Enabling utilization tracking” on page 28
v
“Enabling IBM License Metric Tool (ILMT) and Tivoli Asset Discovery for
Distributed (TADd)” on page 28
v
“Configuring compiler defaults” on page 29
v
“Setting environment variables” on page 29
v
“Enabling the XL Fortran error messages” on page 29
v
“Enabling the manual pages” on page 30
v
“Creating shortcuts to the XL Fortran invocation commands” on page 30
v
“Accessing the local documentation” on page 31
v
“Testing the installation” on page 33
Checking compiler and fileset information
You can check the versions of the compiler and individual filesets installed by
using the lslpp command, the -qversion compiler option, or by viewing the
.vrmf_history file.
Using lslpp
You can view information on the installed filesets by using the lslpp command:
lslpp option_string
where option_string can be:
-L fileset
Displays the version and state of the fileset specified
-f fileset
Displays the files and symbolic links associated with the fileset specified
-w filename
Indicates which fileset the specified file (filename) belongs to
Note: lslpp detects only filesets that have been installed using the SMIT or installp
methods.
Using -qversion
To get more details about the version, release, and PTF levels of the compiler, you
can use the -qversion compiler option. For more information, see the XL Fortran
Compiler Reference.
© Copyright IBM Corp. 2003, 2012
27

Viewing the .vrmf_history file
If you have installed XL Fortran to a non-default location, you can view the
version information for each fileset installed by viewing the .vrmf_history text file
which is installed in the compiler's main directory.
Note: You must not edit this file because it might cause unexpected behavior of
the xlfndi script.
Enabling utilization tracking
Utilization tracking can be used to detect whether the compiler usage exceeds your
entitlement based on the number of Concurrent User licenses you have purchased.
Utilization tracking is disabled by default. You can enable it by modifying the
entry -qnoenabletracking to -qenabletracking in the utilization tracking
configuration file, urtxlf1401aix.cfg. Various other aspects of utilization tracking can
also be specified in this file. In each installation of the compiler, there is a symlink
named urt_client.cfg that points to the utilization tracking configuration file. You
might need to change the symlink if you use a copy of the utilization tracking
configuration file in a different location or if you use multiple copies of the file. For
more information about utilization tracking, see Configuring utilization tracking in
the XL Fortran Compiler Reference.
Enabling IBM License Metric Tool (ILMT) and Tivoli Asset Discovery for
Distributed (TADd)
IBM License Metric Tool (ILMT) and Tivoli® Asset Discovery for Distributed
(TADd) can help you manage software usage metering and license allocation
services on supported systems. In general, ILMT and TADd recognize and monitor
the products that are installed and in use on your system.
ILMT and TADd are enabled for IBM XL Fortran for AIX, V14.1 for inventory
support only, which means that ILMT and TADd are able to detect product
installation of XL Fortran, but not its usage.
Note: ILMT and TADd are not a part of the XL Fortran compiler offering, and
must be purchased and installed separately.
Once installed and activated, ILMT and TADd scan your system for product
inventory signatures that indicate whether a given product is installed on your
system. ILMT and TADd also identify the version, release, and modification levels
of the product. Inventory signature files are not updated after PTF installation.
If XL Fortran is installed in the default location, the signature files are in the
/usr/lpp/xlf/ directory. Otherwise, if XL Fortran is installed in a non-default
location, the signature files are in the /target_dir/usr/lpp/xlf/ directory, where
target_dir is the target directory for installation specified by the -b option of the
non-default installation script.
For more information, see IBM License Metric Tool and Tivoli Asset Discovery for
Distributed.
28
XL Fortran: Installation Guide

Configuring compiler defaults
You can change some of the default settings of the compiler for your specific
needs.
If you have installed XL Fortran onto a system running AIX 5.3, the configuration
file is /etc/xlf.cfg.53, and if you have installed the compiler onto a system running
AIX 6.1, the configuration file is /etc/xlf.cfg.61.
For more information about how to change the XL Fortran compiler's settings, see
Customizing the configuration file in the XL Fortran Compiler Reference.
Setting environment variables
Before using the compiler, verify that the environment variables LANG,
MANPATH, NLSPATH, and PATH are set.
You can use the echo command to determine the current setting of these variables:
echo "\n $LANG \n\n $NLSPATH \n\n $MANPATH \n\n $PATH"
LANG
Specifies the national language for message and help files. See
“National language support” on page 4.
The LANG environment variable can be set to any of the locales
provided on the system. See the description of locales in AIX
General Programming Concepts for more information.
The national language code for United States English is en_US. If
the appropriate message catalogs have been installed on your
system, any other valid national language code can be
substituted for en_US.
MANPATH
Optionally specifies the directory search path for finding man
pages. MANPATH must contain /usr/lpp/xlf/man/$LANG before
the default man path.
NLSPATH
Specifies the path name of the message and help files.
PATH
Specifies the directory search path for the executable files of the
compiler.
Note: The LANG and NLSPATH environment variables are initialized when the
operating system is installed, and might differ from the ones you want to use.
Enabling the XL Fortran error messages
If your system uses the en_US locale and encoding, the compiler message catalogs
are automatically configured to display correctly, whether you used the basic or
advanced method of installation and configuration. However, if your system uses
any other supported locale, you must set the NLSPATH environment variable so
that the compiler and runtime functions can find the appropriate message catalogs
following installation.
For example, to specify the Japanese locale with the IBM_eucJP code page, use the
following commands:
Chapter 5. After installing XL Fortran
29

LANG=ja_JP
NLSPATH=/usr/lib/nls/msg/%L/%N:/usr/lib/nls/msg/prime/%N
export LANG NLSPATH
Substitute any valid national language code for ja_JP, provided the associated
message catalogs are installed.
See “National language support” on page 4 for a list of supported language
locales.
Enabling the manual pages
Manual pages are provided for the compiler invocation commands and other
compiler utilities.
Before you can view the manual pages, you must add the manual page directory
to the MANPATH environment variable by entering the following on the
command line:
export MANPATH=$MANPATH:/usr/lpp/xlf/man/LANG
where LANG may be any one of:
v
en_US
v
EN_US
v
ja_JP
v
JA_JP
v
Ja_JP
For example, to set the language of the manual pages to English, run the
commands:
MANPATH=$MANPATH:/usr/lpp/xlf/man/en_US
export MANPATH
Alternatively, to set the language of the manual pages to one of the other
supported languages, run the command:
MANPATH=$MANPATH:/usr/lpp/xlf/man/$LANG
export MANPATH
where $LANG is set to any of the language locales listed above.
To test whether the manual pages have been successfully installed, open one or
more of the manual pages, as described in “Viewing the manual pages” on page
32.
Creating shortcuts to the XL Fortran invocation commands
If you performed a default installation, the invocation commands are automatically
installed in /usr/bin/, and there is no need for you to create shortcuts to the
invocation commands. However, if you performed a non-default installation, the
commands are not installed in /usr/bin/. To invoke the compiler without
specifying the full path, you will need to create a shortcut to the invocation
commands.
When you perform a non-default installation, the invocation commands are
installed to /target_dir/usr/bin where target_dir is the target directory for
installation specified by the -b option of the non-default installation script. You can
30
XL Fortran: Installation Guide

create a shortcut to the invocation commands of a non-default installation by
adding the location of the compiler invocations, /target_dir/usr/bin/, to the
PATH environment variable.
For example, if you installed XL Fortran to the /compiler/xlf directory, you would
run the commands:
PATH=$PATH:/compiler/xlf/usr/bin/
export PATH
Accessing the local documentation
Help using IBM XL Fortran for AIX, V14.1 is available in both HTML and PDF
formats. Manual pages for the compiler invocation commands and other command
utilities are also included.
Viewing the HTML documentation
The product documentation is available in a fully searchable HTML-based
information center.
The information center is viewable on the web at http://publib.boulder.ibm.com/
infocenter/comphelp/v121v141/index.jsp. You can also download a version of this
information center containing the product documentation for IBM XL C for AIX,
V12.1, IBM XL C/C++ for AIX, V12.1 and IBM XL Fortran for AIX, V14.1. This
information center can be installed on any AIX 5.3, AIX 6.1 ,or AIX 7.1 system
running in 64-bit mode. It can be accessed with a web browser from the machine
on which it is installed or from other computers on the same network.
Notes:
v
You must have root access to launch and shut down the information center.
v
Before you run the information center, you must ensure the machine is running
in the 64–bit mode. It must display 64 when you run the following command:
bootinfo -K
v
The compiler installation does not remove the information center installed from
previous versions of the product. To remove the previously installed information
center, run the following command:
installp -u xlhelp.\*
v
The compressed information center package file is approximately 160 MB, and
220 MB when it is uncompressed.
Follow these steps to download the help system:
1. Go to the XL Fortran compiler library page at http://www.ibm.com/software/
awdtools/fortran/xlfortran/aix/library/. Download the information center
package file XLHelp-v121-v141-AIX-64bit.tar.Z from the download link on this
page.
2. Extract the package on your machine. Run the following command to extract
the files to a new directory at ./xlhelp:
zcat XLHelp-v121-v141-AIX64.tar.Z | tar -xf -
3. Enter the new directory.
cd ./xlhelp
4. You can review the licence information in the following two files:
v
LicenseAgreement.pdf
v
LicenseInformation.pdf
Chapter 5. After installing XL Fortran
31

5. Start the information center by running the following command:
./xlhelp &
6. You can access the information center either locally or remotely. You need to
have a web browser installed on your machine to view the information center.
v
To access the information center locally, use this URL:
http://localhost:1214/help/index.jsp
v
To access the information center remotely, use this URL:
http://machine_name:1214/help/index.jsp
where machine_name is the name of the computer on which the Eclipse server
has been launched.
7. To stop the information center, run this command:
./xlhelp_end
8. To remove the information center, you must first stop the information center,
and remove the extracted directory .xlhelp using the following command:
rm -r ./xlhelp
Viewing the PDF documentation
PDF versions of the XL Fortran product manuals are available in the
/doc/LANG/pdf/ directory of the installation media (either product CD or electronic
package).
After default installation, the PDF documentation can be found in the
/usr/lpp/xlf/doc/LANG/pdf/ directory. For non-default installations, the PDF
documentation is located in the /target_dir/usr/lpp/xlf/doc/LANG/pdf/ directory,
where target_dir is the target directory for installation specified by the -b option of
the non-default installation script.
LANG can be en_US or ja_JP .
See “Related information” on page x for a list of IBM XL Fortran publications and
descriptions of the PDF files available with the product.
Viewing the manual pages
Man pages are included for all compiler invocation commands and utilities.
For instructions about how to enable the man pages for viewing, see “Enabling the
manual pages” on page 30.
To invoke a manual page, run the command:
man command
where command is any XL Fortran invocation or utility command.
Example:
man xlf
32
XL Fortran: Installation Guide

Testing the installation
To test the product installation and the critical search paths, try building,
compiling, and running a simple program.
For example:
1. Create the following Fortran program:
[hello.f]
PRINT *, "Hello World!"
END
2. Compile the test program. For example:
xlf hello.f -o hello
Note: To use shortcuts to the compiler invocation commands, see “Creating
shortcuts to the XL Fortran invocation commands” on page 30. Otherwise,
include the full path to the commands to compile the program.
3. Run the program:
./hello
The expected result is that "Hello World!" is displayed on the screen.
4. Check the exit code of the program:
echo $?
The result is zero.
Chapter 5. After installing XL Fortran
33

34
XL Fortran: Installation Guide

Chapter 6. Uninstalling XL Fortran
This section outlines the steps required to uninstall both basic and advanced
installations of XL Fortran.
Note:
1. You must have root user access to uninstall XL Fortran.
2. Some filesets might not be uninstalled if they are required by other installed
products. See “Filesets” on page 1 for details about filesets included with IBM
XL Fortran for AIX, V14.1.
3. Because automatically uninstalling dependent packages might cause problems,
it is recommended that you preview uninstallation to ensure that all dependent
filesets are no longer required.
Uninstalling a basic installation
To uninstall the compiler from the default location, you can use either SMIT or
installp to remove the compiler filesets.
If you attempt to remove a fileset that is required by another installed fileset, the
selected fileset will not be removed unless its dependents are also being removed.
Using SMIT
The following steps illustrate how to uninstall IBM XL Fortran for AIX, V14.1 using
the SMIT interface:
v
Run the command:
smit remove
v
In the SOFTWARE name field, enter the fileset names (wildcards accepted)
separated by a space. If you have XL C or XL C/C++ installed in its default
location, you must not remove any filesets which are shared between the
compilers. In this case, enter the following name in the field:
xlf.* xlfcmp.*
Otherwise, enter the following name in the field:
xlf.* xlfcmp.* memdbg.* xlhelp.* xlmass.* xlsmp.*
In the REMOVE dependent software? field, select yes.
Note: To preview the uninstallation, set the PREVIEW only? value to yes.
Using installp
To uninstall IBM XL Fortran for AIX, V14.1 using the installp command, enter the
following command on the command line:
installp -ug filesets
where filesets is the list of filesets (wildcards accepted) to uninstall.
If you have XL C or XL C/C++ installed in its default location, you must not
remove any filesets which are shared between the compilers. In this case, filesets
should be:
© Copyright IBM Corp. 2003, 2012
35

xlf.\* xlfcmp.\*
Otherwise, filesets are:
xlf.\* xlfcmp.\* memdbg.\* xlmass.\* xlsmp.\*
Uninstalling an advanced installation
If the compiler is installed to a non-default location, you have to remove the
filesets yourself.
About this task
To uninstall the XL Fortran compiler installed to a non-default location, delete the
compiler directory.
To determine which version of each fileset is installed, see “Checking compiler and
fileset information” on page 27.
To delete the compiler directory, enter the following command on the command
line:
rm -rf target_dir
where target_dir is the target directory for installation specified by the -b option of
the non-default installation script.
Uninstalling versions of the MASS components downloaded from the
web
If you have previously installed the MASS libraries on the system on which you
are installing the IBM XL Fortran for AIX, V14.1, it is recommended that you
uninstall the libraries by removing the directory in which they have been installed.
About this task
To remove the MASS directory, enter:
rm -rf mass_directory
where mass_directory is the location of the MASS libraries. If you have created
symbolic links in the /usr/lib/ directory to the libraries in the MASS directory,
you must delete them as well. The compiler installation automatically handles the
creation of the necessary symbolic links.
Uninstalling the electronic license agreement
The license agreement text file remains on the system after the license fileset has
been uninstalled, so that you do not have to accept the product license again if you
reinstall XL Fortran.
About this task
To remove the license agreement text file, run the following commands:
ODMDIR=/usr/lib/objrepos; odmdelete -o lag -q "fileset=xlf.licAgreement"
rm -rf /usr/swlag/xlf/141
36
XL Fortran: Installation Guide

Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this statement may not apply
to you.
This information could include technical inaccuracies or typographical errors.
Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM websites are provided for
convenience only and do not in any manner serve as an endorsement of those
websites. The materials at those websites are not part of the materials for this IBM
product and use of those websites is at your own risk.
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
© Copyright IBM Corp. 2003, 2012
37

Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:
Lab Director
IBM Canada Ltd. Laboratory
8200 Warden Avenue
Markham, Ontario L6G 1C7
Canada
Such information may be available, subject to appropriate terms and conditions,
including in some cases, payment of a fee.
The licensed program described in this document and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement or any equivalent agreement
between us.
Any performance data contained herein was determined in a controlled
environment. Therefore, the results obtained in other operating environments may
vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be the same on
generally available systems. Furthermore, some measurements may have been
estimated through extrapolation. Actual results may vary. Users of this document
should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of
those products, their published announcements or other publicly available sources.
IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.
All statements regarding IBM's future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which
illustrates programming techniques on various operating platforms. You may copy,
modify, and distribute these sample programs in any form without payment to
IBM, for the purposes of developing, using, marketing or distributing application
programs conforming to the application programming interface for the operating
platform for which the sample programs are written. These examples have not
been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or
imply reliability, serviceability, or function of these programs. You may copy,
modify, and distribute these sample programs in any form without payment to
IBM for the purposes of developing, using, marketing, or distributing application
programs conforming to IBM's application programming interfaces.
38
XL Fortran: Installation Guide

Each copy or any portion of these sample programs or any derivative work, must
include a copyright notice as follows:
© (your company name) (year). Portions of this code are derived from IBM Corp.
Sample Programs. © Copyright IBM Corp. 1998, 2012. All rights reserved.
This software and documentation are based in part on the Fourth Berkeley
Software Distribution under license from the Regents of the University of
California. We acknowledge the following institution for its role in this product's
development: the Electrical Engineering and Computer Sciences Department at the
Berkeley campus.
Trademarks and service marks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of
International Business Machines Corp., registered in many jurisdictions worldwide.
Other product and service names might be trademarks of IBM or other companies.
A current list of IBM trademarks is available on the web at “Copyright and
trademark information” at http://www.ibm.com/legal/copytrade.shtml.
Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered
trademarks or trademarks of Adobe Systems Incorporated in the United States,
other countries, or both.
Linux is a registered trademark of Linus Torvalds in the United States, other
countries, or both.
Microsoft and Windows are trademarks of Microsoft Corporation in the United
States, other countries, or both.
Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the
United States, other countries, or both and is used under license therefrom.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Other company, product, or service names may be trademarks or service marks of
others.
Notices
39

40
XL Fortran: Installation Guide

Index
Special characters
H
product version
migration 26
installp
hard disk space available
PTF 21
compiler installation 12
determining 5
compiler uninstallation 35
required 5
preview installation 7
help files 31
S
update installation 24
lslpp
5, 27
SMIT
I
compiler installation 11
compiler uninstallation 35
A
IBM License Metric Tool 28
preview installation 7
ILMT 28
update installation 23
advanced installation 16
installation CD 1
compiler invocation commands 19
installation image 1
instructions 15
invocation commands
T
limitations 15
advanced installation 19
overview 16
creating shortcuts 30
TADd 28
procedure 16
testing the installation 33
testing 33
Tivoli Asset Discovery for
uninstallation 36
L
Distributed 28
update 24
languages
advanced user, described v
environment variables 29
U
locale-specific filesets 5
uninstallation 35
B
man pages 30
supported 4
advanced 36
basic example, described x
license agreement
basic 35
basic installation
previewing 6
electronic license agreement 36
instructions 9
uninstallation 36
MASS libraries 36
overview 9
locales, supported 4
update installation 21
testing 33
advanced 24
uninstallation 35
basic 23
update 23
M
overview 21
basic user, described v
preparing 22
man pages 30
enabling 30
C
viewing 32
migration 26
compiler defaults, configuring 29
operating system 26
configuration file 29
product version 26
D
N
default installation 9
national language support 4
documentation 31
non-default installation 15
HTML 31
man pages 32
PDF 32
O
operating system
E
migration 26
required 5
electronic distribution package 4
environment variables, setting 29
error messages, enabling 29
P
PASE 18
F
post-installation 27
pre-installation 1
filesets
prerequisites 5
checking 27
previewing 6
required 5
installation 6
license agreements 6
© Copyright IBM Corp. 2003, 2012
41

42
XL Fortran: Installation Guide


Product Number: 5765-J04; 5725-C74
Printed in USA
GC14-7335-00

Document Outline