Installation Guide: IBM XL C/C++ For AIX, V13.1

IBM XL C/C++ for AIX, V13.
1
Installation Guide
Version 13.1
SC27-4258-00
IBM XL C/C++ for AIX, V13.1
Installation Guide
Version 13.1
SC27-4258-00
Note
Before using this information and the product it supports, read the information in “Notices” on page 39.
First edition
This edition applies to IBM XL C/C++ for AIX, V13.1 (Program 5765-J07; 5725-C72) 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, 2014.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
About this information . . . . . . . . v Preparing a PTF package for installation. . . . . 22
Who should read this document . . . . . . . . v Installing PTF updates on the PASE system. . . 22
How to use this document. . . . . . . . . . v Updating a basic installation. . . . . . . . . 23
How this document is organized . . . . . . . vi Using SMIT . . . . . . . . . . . . . 23
Conventions . . . . . . . . . . . . . . vi Using installp . . . . . . . . . . . . 24
Related information . . . . . . . . . . . . ix Updating an advanced installation using xlCndi . . 24
IBM XL C/C++ information . . . . . . . . ix Product version migration . . . . . . . . . 26
Standards and specifications . . . . . . . . xi Operating system migration . . . . . . . . . 26
Other IBM information . . . . . . . . . xii
Other information . . . . . . . . . . . xii Chapter 5. After installing XL C/C++ . . 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 C/C++ . . 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 . . 6 Enabling the XL C/C++ error messages . . . . . 29
National language support . . . . . . . . 7 Enabling the manual pages . . . . . . . . . 30
System prerequisites . . . . . . . . . . . . 7 Creating shortcuts to the XL C/C++ invocation
Previewing the installation and license agreements . 8 commands. . . . . . . . . . . . . . . 30
Accessing the local documentation . . . . . . 31
Chapter 2. Basic installation . . . . . 11 Viewing the HTML documentation . . . . . 31
Viewing the PDF documentation . . . . . . 32
Tasks for basic installation . . . . . . . . . 11
Viewing the manual pages . . . . . . . . 33
Using the bundle installation method. . . . . . 12
Testing the installation. . . . . . . . . . . 33
Using SMIT . . . . . . . . . . . . . . 13
Using installp . . . . . . . . . . . . . 14
Chapter 6. Uninstalling XL C/C++ . . . 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 . . . . . . . . . 37
Non-default installation procedure. . . . . . . 16
Installing on an IBM i PASE system . . . . . 18
Running XL C/C++ from a non-default location . . 19 Notices . . . . . . . . . . . . . . 39
Trademarks and service marks . . . . . . . . 41
Chapter 4. Update installation . . . . . 21
Tasks for update installation . . . . . . . . . 21 Index . . . . . . . . . . . . . . . 43
© Copyright IBM Corp. 2003, 2014 iii

iv XL C/C++: Installation Guide
About this information
This guide provides detailed installation instructions for IBM® XL C/C++ for AIX®,
V13.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 C/C++ for
AIX, V13.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 C/C++ 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 C/C++ 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 11.
"Advanced" installation
This scenario allows you to maintain multiple versions of XL C/C++ 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 C/C++ V13.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, 2014 v

For highly specialized installation scenarios that are outside the scope of this
document, refer to the Technotes at http://www.ibm.com/software/products/us/
en/xlcpp-aix/ .
How this document is organized

This book is organized to reflect the pre-installation, installation, post-installation,
and troubleshooting phases of an XL C/C++ installation.
Table 1. Phases of an XL C/C++ installation
Phase Chapters User segment
Pre-installation Chapter 1, “Before All users
installing XL C/C++,” on
page 1
Installation Chapter 2, “Basic Users who:
installation,” on page 11 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 C/C++ V13.1
installation,” on page 21 to the next fix level
Chapter 5, “After installing All users
XL C/C++,” on page 27
Product Chapter 6, “Uninstalling Any user who needs to remove an XL
removal XL C/C++,” on page 35 C/C++ compiler from the system
Conventions
Typographical conventions
The following table shows the typographical conventions used in the IBM XL
C/C++ for AIX, V13.1 information.
Table 2. Typographical conventions
Typeface Indicates Example
bold Lowercase commands, executable The compiler provides basic
names, compiler options, and invocation commands, xlc and xlC
directives. (xlc++), along with several other
compiler invocation commands to
support various C/C++ 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 C/C++: Installation Guide

Table 2. Typographical conventions (continued)
Typeface Indicates Example
monospace Programming keywords and To compile and optimize
library functions, compiler builtins, myprogram.c, enter: xlc myprogram.c
examples of program code, -O3.
command strings, or user-defined
names.
Qualifying elements (icons)
Most features described in this information apply to both C and C++ languages. In
descriptions of language elements where a feature is exclusive to one language, or
where functionality differs between languages, this information uses icons to
delineate segments of text as follows:
Table 3. Qualifying elements
Qualifier/Icon Meaning
C only, or C only begins The text describes a feature that is supported in the C language
C only; or describes behavior that is specific to the C language.
C only ends
C++ only, or C++ only The text describes a feature that is supported in the C++
begins language only; or describes behavior that is specific to the C++
C++ language.
C++
C++ only ends

IBM extension, or IBM The text describes a feature that is an IBM extension to the
extension begins standard language specifications.
IBM
IBM
IBM extension ends

C11, or C11 begins The text describes a feature that is introduced into standard C
C11 as part of C11.
C11
C11 ends
C++11, or C++11 begins The text describes a feature that is introduced into standard
C++11 C++ as part of C++11.
C++11
C++11 ends
Syntax diagrams
Throughout this information, diagrams illustrate XL C/C++ syntax. This section

will help you to interpret and use those diagrams.
About this information vii

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.
Fragments, which are diagrams of syntactical units other than complete
commands, directives, or statements, start with the │─── symbol and end with
the ───│ symbol.
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
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.
v If punctuation marks, parentheses, arithmetic operators, or other such symbols
are shown, you must enter them as part of the syntax.
viii XL C/C++: Installation Guide

Sample syntax diagram
The following syntax diagram example shows the syntax for the #pragma
comment directive.
(1) (2) (3) (4) (5) (9) (10)

# pragma comment ( compiler )
date
timestamp
(6)
copyright
user (7) (8)
, " token_sequence "
Notes:
1 This is the start of the syntax diagram.
2 The symbol # must appear first.
3 The keyword pragma must appear following the # symbol.
4 The name of the pragma comment must appear following the keyword pragma.
5 An opening parenthesis must be present.
6 The comment type must be entered only as one of the types indicated:
compiler, date, timestamp, copyright, or user.
7 A comma must appear between the comment type copyright or user, and an
optional character string.
8 A character string must follow the comma. The character string must be
enclosed in double quotation marks.
9 A closing parenthesis is required.
10 This is the end of the syntax diagram.
The following examples of the #pragma comment directive are syntactically correct
according to the diagram shown above:
#pragma comment(date)
#pragma comment(user)
#pragma comment(copyright,"This text will appear in the module")
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.
Related information
The following sections provide related information for XL C/C++:
IBM XL C/C++ information

XL C/C++ provides product information in the following formats:
v README files
About this information ix

README files contain late-breaking information, including changes and
corrections to the product information. README files are located by default in
the XL C/C++ 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 C/C++ for AIX, V13.1 Installation Guide.
v Information center
The fully searchable HTML-based documentation is viewable on the web at
http://www.ibm.com/support/knowledgecenter/SSGH3R_13.1.0/
com.ibm.compilers.aix.doc/welcome.html.
v PDF documents
PDF documents are located by default in the /opt/IBM/xlC/13.1.0/doc/LANG/
pdf/ directory, where LANG is one of en_US, zh_CN, or ja_JP. The PDF files are
also available on the web at http://www.ibm.com/support/
docview.wss?uid=swg27036618.
The following files comprise the full set of XL C/C++ product information:
Table 4. XL C/C++ PDF files
PDF file
Document title name Description
IBM XL C/C++ for AIX, install.pdf Contains information for installing XL C/C++
V13.1 Installation Guide, and configuring your environment for basic
SC27-4258-00 compilation and program execution.
Getting Started with IBM getstart.pdf Contains an introduction to the XL C/C++
XL C/C++ for AIX, V13.1, product, with information on setting up and
SC27-4257-00 configuring your environment, compiling and
linking programs, and troubleshooting
compilation errors.
IBM XL C/C++ for AIX, compiler.pdf Contains information about the various
V13.1 Compiler Reference, compiler options, pragmas, macros,
SC27-4259-00 environment variables, and built-in functions,
including those used for parallel processing.
IBM XL C/C++ for AIX, langref.pdf Contains information about the C and C++
V13.1 Language Reference, programming languages, as supported by IBM,
SC27-4260-00 including language extensions for portability
and conformance to nonproprietary standards.
IBM XL C/C++ for AIX, proguide.pdf Contains information on advanced
V13.1 Optimization and programming topics, such as application
Programming Guide, porting, interlanguage calls with Fortran code,
SC27-4261-00 library development, application optimization
and parallelization, and the XL C/C++
high-performance libraries.
Standard C++ Library standlib.pdf Contains reference information about the
Reference, SC27-4262-00 standard C++ runtime libraries and headers.
C/C++ Legacy Class legacy.pdf Contains reference information about the USL
Libraries Reference, I/O Stream Library and the Complex
SC09-7652-00 Mathematics Library.
To read a PDF file, use Adobe Reader. If you do not have Adobe Reader, you
can download it (subject to license terms) from the Adobe website at
http://www.adobe.com.
x XL C/C++: Installation Guide

More information related to XL C/C++ including IBM Redbooks® publications,
white papers, tutorials, documentation errata, and other articles, is available on the
web at:
http://www.ibm.com/support/docview.wss?uid=swg27036618
Note: Documentation errata is reflected only in the English version of the

information center.
For more information about boosting performance, productivity, and portability,

see the C/C++ café at http://www.ibm.com/software/rational/cafe/community/
ccpp.
Standards and specifications

XL C/C++ 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 Information Technology - Programming languages - C, ISO/IEC 9899:1990, also
known as C89.
known as C99.
known as C11. (Partial support)
v Information Technology - Programming languages - C++, ISO/IEC 14882:1998, also
known as C++98.
known as Standard C++.
known as C++11. (Partial support)
v Information Technology - Programming languages - Extensions for the programming
language C to support new character data types, ISO/IEC DTR 19769. This draft
technical report has been accepted by the C standards committee, and is
available at http://www.open-std.org/JTC1/SC22/WG14/www/docs/
n1040.pdf
v Draft Technical Report on C++ Library Extensions, ISO/IEC DTR 19768. This draft
technical report has been submitted to the C++ standards committee, and is
available at http://www.open-std.org/JTC1/SC22/WG21/docs/papers/2005/
n1836.pdf.
v AltiVec Technology Programming Interface Manual, Motorola Inc. This specification
for vector data types, to support vector processing technology, is available at
http://www.freescale.com/files/32bit/doc/ref_manual/ALTIVECPIM.pdf.
v Information Technology - Programming Languages - Extension for the programming
language C to support decimal floating-point arithmetic, ISO/IEC WDTR 24732. This
draft technical report has been submitted to the C standards committee, and is
available at http://www.open-std.org/JTC1/SC22/WG14/www/docs/
n1176.pdf.
v Decimal Types for C++: Draft 4 http://www.open-std.org/jtc1/sc22/wg21/docs/
papers/2006/n1977.html
v ANSI/IEEE Standard for Binary Floating-Point Arithmetic, ANSI/IEEE Std 754-1985.
v OpenMP Application Program Interface Version 4.0 (Partial support), available at
http://www.openmp.org
About this information xi

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.
Other information
v Using the GNU Compiler Collection available at http://gcc.gnu.org/onlinedocs
Technical support
Additional technical support is available from the XL C/C++ Support page at
http://www.ibm.com/support/entry/portal/Overview/Software/Rational/
XL_C~C++_for_AIX. 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 C/C++, visit the product information site at
http://www.ibm.com/software/products/us/en/xlcpp-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
C/C++ information, send your comments by email to compinfo@ca.ibm.com.
Be sure to include the name of the manual, the part number of the manual, the
version of XL C/C++, and, if applicable, the specific location of the text you are
commenting on (for example, a page number or table number).
xii XL C/C++: Installation Guide

Chapter 1. Before installing XL C/C++
Before you install IBM XL C/C++ for AIX, V13.1, do the following tasks:
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.
Coexistence with previous version compilers
Installing this version of the compiler does not remove or change previous versions
of the compiler, only the C++ runtime library and the SMP runtime library are
migrated to the new versions. This was achieved by differentiating the installation
fileset names from those of the previous versions, including the version, release
and modification level (V.R.M) in the name, and installing to new locations that
include V.R.M in the installation paths.
Upgrading the evaluation copy of the XL C/C++ 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 11 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 to the same
location, 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, 2014 1

XL C compiler filesets
This topic lists the XL C compiler filesets V13.1.
Note: The XL C compiler fileset names are xlccmp.13.1.0.*.

Table 5. XL C compiler filesets and default installation locations
Fileset name Fileset description Default installation locations
xlccmp.13.1.0 XL C compiler /opt/IBM/xlc/13.1.0/
/opt/IBM/xlc/13.1.0/bin/
/opt/IBM/xlc/13.1.0/exe/
/opt/IBM/xlc/13.1.0/listings/
/opt/IBM/xlc/13.1.0/etc/
/opt/IBM/xlc/13.1.0/lib/
/opt/IBM/xlc/13.1.0/include/
/opt/IBM/xlc/13.1.0/man/
/opt/IBM/xlc/13.1.0/doc/
/opt/IBM/xlc/13.1.0/msg/
xlccmp.13.1.0.bundle XL C media defined bundles /usr/sys/inst.data/
sys_bundles/
xlccmp.13.1.0.lib XL C libraries for AIX 6.1 and /opt/IBM/xlc/13.1.0/lib/
AIX 7.1
xlccmp.13.1.0.license XL C license files /opt/IBM/xlc/13.1.0/
xlccmp.13.1.0.ndi XL C non-default installation /opt/IBM/xlc/13.1.0/bin
script
Note: All of the filesets required for the XL C compiler, except xlccmp.13.1.0.ndi,
are also required for the XL C/C++ compiler.
XL C++ compiler filesets

This topic lists the XL C/C++ compiler filesets V13.1.
Note: The XL C/C++ compiler fileset names are xlCcmp.13.1.0.*.

Table 6. XL C/C++ compiler filesets and default installation locations
xlCcmp.13.1.0 XL C++ compiler /opt/IBM/xlC/13.1.0/
/opt/IBM/xlC/13.1.0/bin/
/opt/IBM/xlC/13.1.0/exe/
/opt/IBM/xlC/13.1.0/listings/
/opt/IBM/xlC/13.1.0/etc/
/opt/IBM/xlC/13.1.0/lib/
/opt/IBM/xlC/13.1.0/include/
/opt/IBM/xlC/13.1.0/man/
/opt/IBM/xlC/13.1.0/samples/
/opt/IBM/xlC/13.1.0/doc/
/opt/IBM/xlC/13.1.0/msg/
xlCcmp.13.1.0.bundle XL C++ media defined /usr/sys/inst.data/sys_bundles/
bundles
xlCcmp.13.1.0.lib XL C++ libraries /opt/IBM/xlC/13.1.0/lib/
xlCcmp.13.1.0.tools XL C++ tools /opt/IBM/xlC/13.1.0/bin/
/opt/IBM/xlC/13.1.0/exe/aix61/
xlCcmp.13.1.0.license1 XL C++ license files for the /opt/IBM/xlC/13.1.0/lib/
XL C/C++
2 XL C/C++: Installation Guide

Table 6. XL C/C++ compiler filesets and default installation locations (continued)
2
xlCcmp.13.1.0.evaluation XL C++ license files for the /opt/IBM/xlC/13.1.0/
evaluation copy
xlCcmp.13.1.0.ndi XL C++ non-default /opt/IBM/xlC/13.1.0/bin/
installation script
Notes:
1. Only included in XL C/C++ for AIX, V13.1.
2. Only included in the evaluation copy of the XL C/C++ for AIX compiler.
XL C++ runtime environment filesets

This topic lists the XL C++ runtime environment V13.1 filesets, and usage notes for
installing and using the runtime environment.
Table 7. XL C++ runtime environment filesets and default installation locations
xlC.adt.include XL C++ application development /usr/include/
toolkit
xlC.rte XL C++ runtime libraries /usr/lpp/xlC/lib/
/usr/lpp/xlC/lib/profiled/
xlC.aix61.rte XL C++ runtime environment for /usr/lpp/xlC/lib/aix61/
AIX 6.1 and AIX 7.1 /usr/lpp/xlC/lib/profiled/aix61/
xlC.msg.LANG.rte XL C++ runtime messages /usr/lib/nls/msg/LANG/
LANG = [en_US, ja_JP, Ja_JP]
Note: The XL C++ runtime environment fileset names are xlC.*.
Versions of the XL C++ runtime environment
The version of the compiler and the version of the installed XL C++ runtime
environment might be different. When a new version of the XL C/C++ for AIX
compiler is released, the version of the XL C++ runtime environment it provides
becomes the standard supported version on all platforms supported by the new
compiler. Fix packs for AIX, and PTFs for the compiler and XL C++ runtime
environment all have the potential to upgrade the XL C++ runtime version to a
later version than the version of the installed compiler. For example, the XL C++
runtime environment V11.1.0.2 was included in the May 2011 PTF for XL C/C++
for AIX, V10.1, because the XL C++ runtime environment V11.1 was the latest
version at the time.
Applications compiled with the XL C++ compiler must be run on a system with an
installed XL C++ runtime environment at the same or higher VRMF level (Version,
Release, Modification, Fix level) than on the system the application was compiled
on. For example, an older application compiled on a system with xlC.rte VRMF
10.1.0.7 installed is supported to run on a system with xlC.rte VRMF 11.1.0.3
installed, but not on a system with xlC.rte VRMF 10.1.0.3 installed.
Applications built on a lower AIX operating system version are supported on later
AIX versions, provided that the XL C++ runtime environment VRMF level
requirement is met. Downward compatibility to AIX versions lower than the
system that the application was built on is not supported. For example, an
application built on an AIX 7.1 system with xlC.rte VRMF 13.1.0.1 is supported on
Chapter 1. Before installing XL C/C++ 3

an AIX 7.1 system with the xlC.rte VRMF 13.1.0.1 (or later) runtime environment
installed, but is not supported on an AIX 6.1 system, and is also not supported on
any AIX version if the xlC.rte VRMF is lower than 13.1.0.1.
Using the XL C++ runtime environment in an upgraded operating

system
When upgrading an operating system from AIX 5.3 to AIX 6.1 or AIX 7.1, ensure
that the XL C++ runtime environment on the upgraded system matches or exceeds
the version that was previously installed on the AIX 5.3 system.
The procedure to upgrade AIX 5.3 to AIX 6.1 or AIX 7.1 involves automatic
uninstallation of the xlC.aix50.rte fileset, and installing the xlC.aix61.rte fileset
packaged in the operating system upgrade. In some cases, this packaged fileset can
have a lower XL C++ runtime version than the previously installed version on AIX
5.3. Applications used or developed with the previous, higher C++ runtime level
might encounter errors if a lower C++ runtime level is used.
You can check the version of the installed XL C++ runtime environment using the
lslpp -l xlC\* command. If the version is lower than the previously installed
version on AIX 5.3, you can download the latest runtime updates from Fix Central,
or from Latest updates for supported IBM C and C++ compilers. For information
about operating system migration, see “Operating system migration” on page 26.
Related information:
For more information about how to determine the current supported IBM XL C++
runtime environment, see Determining the currently supported IBM XL C++
Runtime Environment for a given AIX OS level.
Runtime debug memory routine filesets

This topic lists the runtime debug memory routine filesets V5.5.
Table 8. Runtime debug memory routine filesets and default installation locations
memdbg.adt User heap/memory debug /usr/vac/lib/
toolkit /usr/vac/lib/profiled/
memdbg.aix53 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 V4.1.
Table 9. SMP runtime filesets and default installation locations
xlsmp.rte SMP runtime library /usr/include/
/usr/lpp/xlsmp/default_msg/

Table 9. SMP runtime filesets and default installation locations (continued)
xlsmp.msg.LANG.rte SMP runtime messages /usr/lib/nls/msg/LANG/
ZH_CN, Zh_CN]
xlsmp.aix61.rte SMP runtime libraries for AIX /usr/lpp/xlsmp/aix61/
6.1 and AIX 7.1
Mathematical Acceleration Subsystem (MASS) filesets

This topic lists the MASS filesets V8.1.
Table 10. MASS filesets and default installation locations
xlmass.8.1.0 IBM MASS files /opt/IBM/xlmass/8.1.0/
/opt/IBM/xlmass/8.1.0/include/
/opt/IBM/xlmass/8.1.0/lib/
IBM Debugger filesets

This topic lists the IBM Debugger filesets V13.1.
Table 11. IBM Debugger filesets
Fileset name Fileset description
ibmdebugger IBM Debugger for AIX
ibmdebugger.engine IBM Debugger for AIX Compiled Languages Engine
ibmdebugger.engine.msg.LANG IBM Debugger messages
LANG = [de_DE, en_US, en_ES, fr_FR, it_IT, ja_JP,
ko_KR, pt_BR, zh_CN, zh_TW]
ibmdebugger.jre Supersede entry, not installed
ibmdebugger.ui Supersede entry, not installed
The IBM Debugger for AIX, V13.1 is included with the XL C/C++ installation
image. This source-level debugger uses a client/server model:
v The debug engine is a server component that is installed on AIX.
v The debug client is a graphical user interface that is installed on Windows
workstations.
The installation file, idebug.install_8.0.0.zip, of the Windows debug client is in

the IBMdebugger/windows/ directory of the installation image.
Notes:
v The IBM Debugger for AIX, V13.1 supersedes the IBM Distributed Debugger. If
the IBM Distributed Debugger, V9.2 is installed on your system, it will be
removed upon installation of the IBM Debugger for AIX, V13.1. The
post-installation script then modifies the idebug fileset levels in the Object Data
Manager (ODM) database to 99.99.9999.9999 to prevent future installations of
idebug.* filesets.
v The AIX client of the IBM Debugger for AIX is discontinued.

v The IBM Debugger for AIX, V13.1 debug engine filesets, ibmdebugger.*, are
automatically installed during a basic compiler installation. To install the
Windows debug client of the IBM Debugger, see the README file included in
idebug.install_8.0.0.zip.
Utilization reporting tool fileset

This topic lists the utilization reporting tool filesets V1.2.
Table 12. Utilization reporting tool fileset and default installation locations
urt12 Utilization reporting tool files /opt/ibmurt/1.2/
/opt/ibmurt/1.2/bin/
/opt/ibmurt/1.2/config/
urt12.man.LANG Utilization reporting tool /opt/ibmurt/1.2/man/LANG/man1/
manual page files

ZH_CN]
urt12.msg.LANG Utilization reporting tool /opt/ibmurt/1.2/msg/LANG/
message files

ZH_CN]
Note: The utilization reporting tool can be installed on the same machine as the
compiler or on a different machine. You must use the installp command to install
the urt12 fileset. The utilization reporting tool 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 do not need to use this tool.
To install the utilization reporting tool, see the instructions provided in the
README.LANG files found in the urt/ directory, which is located in the root directory
of the installation image.
Preparing the electronic distribution package

If you have downloaded the XL C/C++ electronic distribution package,
IBM_XL_C_CPP_V13.1.0.0_AIX.tar.Z, follow the steps described in this topic before
the installation.
Note: You must be logged in as the root user or have superuser authority.
To uncompress and unpack the file, use the command:
zcat IBM_XL_C_CPP_V13.1.0.0_AIX.tar.Z | tar -xvf -
The following example shows the steps to prepare the electronic distribution
package, IBM_XL_C_CPP_V13.1.0.0_AIX.tar.Z, located in the /compiler/install/
directory for installation.
cd /compiler/install
cd usr/sys/inst.images

See “System prerequisites” to ensure that system prerequisites are met and use the
installation methods described in either Chapter 2, “Basic installation,” on page 11
or Chapter 3, “Advanced installation,” on page 15 to install the compiler.
National language support

The LANG environment variable determines which message catalogs are used. All
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 C/C++ messages support the following language locales:

v en_US (ISO8859-1)
v EN_US (UTF-8)
v ja_JP (IBM-eucJP)
v JA_JP (UTF-8)
v Ja_JP (IBM-943)
v zh_CN (IBM-eucCN)
v ZH_CN (UTF-8)
v Zh_CN (GB18030)
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 C/C++ error messages” on page 29.
System prerequisites
All system prerequisites must be ready on your system before XL C/C++ and its
documentation can be successfully installed and run.
v Supported operating systems:
– AIX V6.1 TL 2 Service Pack 5 or later
– AIX V7.1
– IBM i V7.1 PASE V7.1
Note: Additional filesets must be installed on these systems. For details, see
“Required filesets for installing XL C/C++” on page 8.
v Required hard disk space: 500 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 (/opt/IBM/xlC/13.1.0/):
df -m /opt
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 C/C++
The following filesets must be installed on your system to install IBM XL C/C++
for AIX, V13.1:

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
At least one of the following locale-specific filesets must be installed on your

system:

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 6.1.5.1 # Base Level Fileset
This message indicates that the bos.adt.libm fileset is required but not installed.
You can find the required bos.* filesets on your AIX OS installation image.
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.
Previewing the installation and license agreements

Before installing IBM XL C/C++ for AIX, V13.1, you can verify the default
installation process, check file sizes and disk space, and preview the license
agreements using either the System Management Interface Tool (SMIT) or the
installp command.

The terms and conditions for using XL C/C++ are specified in the following PDF
files, which are located in the root directory of the distribution package:
v LicenseAgreement.pdf
v license.pdf
Note: For the evaluation copy of the XL C/C++ for AIX compiler, the license files
are LicenseAgreement.EVAL.pdf and license.EVAL.pdf.
These license files can be found in the /opt/IBM/xlC/13.1.0/ 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 C/C++ Compiler Reference.
Using SMIT
You can use the System Management Interface Tool (SMIT) to preview the basic XL
C/C++ installation.
Follow the steps to install the compiler to the default location given in “Using
SMIT” on page 13. 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 14 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 and writes an
installation log file to /tmp/install.log.
Example:
installp -paXgd /cdrom/usr/sys/inst.images -e /tmp/install.log all

Chapter 2. Basic installation
You can use the basic installation procedure to install XL C/C++ if you are
installing IBM XL C/C++ for AIX, V13.1 to the default directory,
/opt/IBM/xlC/13.1.0/.
The basic installation is the easiest and fastest method because it can install the
latest version and configure the compiler, all through the use of a single
installation tool.
If you are using the basic installation to install IBM XL C/C++ for AIX, V13.1, any
previous version of the XL compiler will not be uninstalled. However, the C++
runtime library and the shared-memory parallelism (SMP) runtime library will be
migrated to the new versions.
If you are not installing IBM XL C/C++ for AIX, V13.1 to the default directory, do
not use basic installation. Instead, see the procedures in Chapter 3, “Advanced
installation,” on page 15.
The following basic installation methods install XL C/C++ to the default directory.
If you have the root access or an account 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 C/C++ for AIX, V13.1 on a clean system.
v Install IBM XL C/C++ for AIX, V13.1 on a system that has a previous version of
the XL compiler installed. In this case, both compilers will use the C++ runtime
library and the SMP runtime library provided with IBM XL C/C++ for AIX,
V13.1.
v Install IBM XL C/C++ for AIX, V13.1 on a system where IBM XL Fortran for
AIX, V15.1 is already installed. In this case, both compilers will use the SMP and
MASS libraries provided with XL C/C++ for AIX. (For information about
installing XL Fortran, see the IBM XL Fortran for AIX, V15.1 Installation Guide.)
v Install an update on a system where IBM XL C/C++ for AIX, V13.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.
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.

Table 13. 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 7
Use the bundle installation method, SMIT, or the “Using the bundle installation
installp command to install and configure the method,” “Using SMIT” on page 13, or
compiler, using the default paths. “Using installp” on page 14
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 C/C++ 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 C/C++ 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 xlCcmp.13.1.0.bundle,
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 . xlCcmp.13.1.0.bundle
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 V6.1 or V7.1, choose
xlCcmp.13.1.0-evaluation.
v If you are installing or upgrading to the licensed version on AIX V6.1 or
V7.1, choose xlCcmp.13.1.0-licensed.
5. Change the following values provided on the bundle screen as appropriate to
your situation, and press Enter to continue.
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 14.
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 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.
Chapter 2. Basic installation 13

Using installp
You can install XL C/C++ 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.
-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
For information about return codes of the installp command, see "installp
Command" in the IBM AIX documentation at http://www.ibm.com/systems/
power/software/aix/resources.html.

Chapter 3. Advanced installation
You must use the advanced installation procedure if any of the following is true:
v You are maintaining multiple fix levels of the compiler on a single system.
v You do not wish to alter the system runtimes with the compiler installation.
v You are installing the product to a non-default location.
v You are installing the product on an IBM i V7.1 PASE system.
To perform an advanced installation, you need to use the xlCndi Perl script
provided with the installation image, to install XL C/C++ to a non-default
directory and run multiple versions of XL C/C++ on a single system. The script is
packaged in the xlCcmp.13.1.0.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 C/C++ 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 It is recommended that you install XL C/C++ to the default location. Use the
xlCndi script to install XL C/C++ only if you are an expert user who is familiar
with the compiler and the standard installation process.
v The xlCndi 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 xlCndi script must be used to apply
service packages.
v To run xlCndi, 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 xlCndi script requires that the original filesets are not 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 xlCndi tool requires you to install the current PTF version of the
xlCcmp.13.1.0.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 C/C++
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.

The recommended procedure for advanced installation is outlined in the following
table:
Table 14. Steps for advanced installation: new or upgrade installation
Task For more information, see . . .
Ensure that all system prerequisites are satisfied. “System prerequisites” on page 7
If you do not need to maintain multiple versions Chapter 6, “Uninstalling XL C/C++,”
of the product on your system, remove any on page 35
existing versions of XL C/C++ 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
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 C/C++ 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 C/C++ to a non-default location, first use installp to install the
xlCcmp.13.1.0.ndi fileset, then use the xlCndi Perl script included in that fileset to
install the compiler.
About this task
Follow these steps to install XL C/C++ to an alternate location:
Procedure
1. First use the installp command to install the xlCcmp.13.1.0.ndi fileset. Run the
command:
installp -aYXgd install_images_location -e logfile xlCcmp.13.1.0.ndi
xlCcmp.13.1.0.license
- installp -aYg xlCcmp.13.1.0.ndi xlCcmp.13.1.0.license

-p -X -d install_images_location -e logfile
-aYg
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 xlCndi.log is stored in your working directory.
-p
Performs a preview of the installation process by running the
preinstallation checks. See “Previewing the installation and license
agreements” on page 8.
-X
Attempts to expand the file system at the default location if there is not
enough space to complete the install.
Example:
installp -aYgd /cdrom/usr/sys/inst.images -e /tmp/install.log xlCcmp.13.1.0.ndi \
xlCcmp.13.1.0.license
Note: This command automatically installs and accepts the license agreement
fileset, xlCcmp.13.1.0.license, required to install xlCcmp.13.1.0.ndi.
2. Install any available updates to the xlCcmp.13.1.0.ndi fileset. You can download
the latest compiler updates from the support website: http://www.ibm.com/
support/entry/portal/Overview/Software/Rational/XL_C~C++_for_AIX
To check the version number of the xlCcmp.13.1.0.ndi fileset currently installed
on your system, use the following command:
lslpp -l xlCcmp.13.1.0.ndi
To install a new version of the xlCcmp.13.1.0.ndi fileset, use the following
command:
installp -aYgd ptf_images_location -e logfile xlCcmp.13.1.0.ndi
3. Install XL C/C++ by entering the following command:
perl /opt/IBM/xlC/13.1.0/bin/xlCndi -d source_path

-e logfile

-b target_dir -rte -version
perl /opt/IBM/xlC/13.1.0/bin/xlCndi -d source_path [-e logfile] [-b target_dir]

[-rte][-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
installation log file xlCndi.log is stored in your working directory.
-b target_dir
Specifies the location where the filesets to be copied and expanded. By
default, the files are copied to the xlCndi 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 components should be installed.
Chapter 3. Advanced installation 17

-version
Displays the version of the non-default installation tool.
Note: The -eval option is deprecated and has no effect. The xlCndi Perl script
automatically determines the type of installation that is happening.
The following example uses the xlCndi Perl script to install all available
compiler filesets in the /cdrom/usr/sys/inst.images source directory to the
non-default location, /compiler/xlcpp/ and writes the installation log file to
/tmp/xlcpp.ndi.inst.log.
Example:
perl /opt/IBM/xlC/13.1.0/bin/xlCndi -d /cdrom/usr/sys/inst.images
-b /compiler/xlcpp/ -e /tmp/xlcpp.ndi.inst.log
Results
IBM XL C/C++ for AIX is installed into the chosen location.
The xlCndi Perl script returns 0 if the installation is successful, or 1 if the

installation fails.
Installing on an IBM i PASE system

About this task
Users installing XL C/C++ 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 xlCndi script determines that you are installing the
compiler onto a PASE system, it modifies the name of the XL C/C++ 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 V7.1
PASE V7.1, xlc.cfg.61 is renamed xlc.cfg.71 and the value of OS level is changed
from 6.1 to 7.1.
To install the XL C/C++ 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
restore -qf usr/sys/inst.images/xlCcmp.13.1.0.ndi ./opt/IBM/xlC/13.1.0/bin/xlCndi
v If you use the installation CD, run the following commands:
restore -qf /QOPT/CDROM/USR/SYS/INST.IMA/XLC.NDI ./opt/IBM/xlC/13.1.0/bin/xlCndi

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:
/QIBM/ProdData/DeveloperTools/pase/bin/perl ./opt/IBM/xlC/13.1.0/bin/xlCndi -d \
./usr/sys/inst.images -b /QOpenSys/xlcpp
v If you use the installation CD, run the following commands:
/QIBM/ProdData/DeveloperTools/pase/bin/perl ./opt/IBM/xlC/13.1.0/bin/xlCndi -i -d \
/QOPT/CDROM/USR/SYS/INST.IMA -b /QOpenSys/xlcpp
After the XL C/C++ compiler is installed for use in i PASE,

v The XL C/C++ compiler commands, for example, xlc can be found in directory
/QOpenSys/xlcpp/opt/IBM/xlC/13.1.0/bin/.
v The XL C/C++ compiler documentation (in PDF) can be found in directory
/QOpenSys/xlcpp/opt/IBM/xlC/13.1.0/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/xlcpp/opt/IBM/xlC/13.1.0/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.
Running XL C/C++ from a non-default location

The compiler invocation commands are installed to /target_dir/opt/IBM/xlC/
13.1.0/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 C/C++ to the /compiler/xlcpp directory, you can
run the compiler by using this command:
/compiler/xlcpp/opt/IBM/xlC/13.1.0/bin/xlC -o hello_C hello.C
Alternatively, you can create a shortcut to the compiler invocations, as described in

“Creating shortcuts to the XL C/C++ invocation commands” on page 30.
Chapter 3. Advanced installation 19

Chapter 4. Update installation
A program temporary fix (PTF) is an update to XL C/C++ 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/support/entry/portal/Overview/Software/Rational/
XL_C~C++_for_AIX . You can also find the instructions on Fix Central.
Tasks for update installation

If you are installing an update to XL C/C++, 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, /opt/IBM/xlC/13.1.0/,

you must follow the steps outlined in the following table, Table 15.
Table 15. Steps for basic installation: update installation
Ensure that all the system prerequisites are met. “System prerequisites” on page 7
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
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
If the compiler has been installed to any directory other than /opt/IBM/xlC/
13.1.0/, you must follow the steps outlined in the following table, Table 16.
Table 16. Steps for advanced installation: update installation
Ensure that all system prerequisites are met. “System prerequisites” on page 7
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
Install any PTF updates to the xlCcmp.13.1.0.ndi “Using SMIT” on page 23 or
fileset using SMIT or installp. “Using installp” on page 24
Use the non-default installation script to install “Updating an advanced installation
further updates. using xlCndi” on page 24

Table 16. Steps for advanced installation: update installation (continued)
Confirm that the compiler packages were “Checking compiler and fileset
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 log in as root or have superuser authority.

1. Download the PTF package that you want (for example 13.1.0.1-Rational-
xlCcmp-AIX-FP001.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,

13.1.0.1-Rational-xlCcmp-AIX-FP001.tar.Z, located in the new directory,
/compiler/update/ for installation.
cd /compiler/update
zcat 13.1.0.1-Rational-xlCcmp-AIX-FP001.tar.Z | tar -xvf -
inutoc .
Installing PTF updates on the PASE system

This section describes the steps to install PTFs for the XL C/C++ 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 C/C++ 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/ptf/ 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:

ls /QOpenSys/ptf/xlCcmp.13.1.0.ndi.*
restore -qf xlCcmp.13.1.0.ndi.V.R.M.F.bff ./opt/IBM/xlC/13.1.0/bin/xlCndi
Notes:
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 xlCcmp.13.1.0.ndi.0000.0006.bff, then replace the
xlCcmp.13.1.0.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 xlCcmp.13.1.0.ndi.V.R.M.F.bff ./opt/IBM/xlC/13.1.0/bin/xlCndi
5. Run the installation script to install the PTFs. Enter the following command
from the QP2TERM command line:
/QIBM/ProdData/DeveloperTools/pase/bin/perl ./opt/IBM/xlC/13.1.0/bin/xlCndi \
/QOpenSys/ptf -b /QOpenSys/xlcpp -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/xlcpp.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 C/C++ 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 update_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. Do not
modify the value in the "SOFTWARE to install" field.
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.
Note: If you have migrated your system to a new operating system version,
use smit install_all to ensure all filesets related to this operating system
version are installed.
Chapter 4. Update installation 23

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
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 8.
-X
Attempts to expand the file system at the default location if there is not
enough 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 xlCndi

If the XL C/C++ compiler has been installed to a non-default directory, you must
use xlCndi to install PTFs.
About this task
Note: The xlCndi tool enforces that you install the PTF xlCcmp.13.1.0.ndi fileset
before using the tool to install the PTF to a non-default location.
To update a non-default installation, take the following steps:

Procedure
1. Begin by installing the xlCcmp.13.1.0.ndi fileset included in the PTF. This fileset
must be installed first, so that the xlCndi script inside it can be used to
correctly install the remaining filesets.
To determine the version number of the xlCcmp.13.1.0.ndi fileset currently
installed on your system, run the command:
lslpp -l xlCcmp.13.1.0.ndi
To install a new version of the xlCcmp.13.1.0.ndi fileset, run the command:
installp -aXgd ptf_images_location -e logfile xlCcmp.13.1.0.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:
xlccmp.13.1.0.1.bff
3. Use the perl command to run the xlCndi script:
perl /opt/IBM/xlC/13.1.0/bin/xlCndi -d source_path -u ptf_names_file

-e logfile -b target_dir -rte -version
perl /opt/IBM/xlC/13.1.0/bin/xlCndi -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
installation log file xlCndi.log will be stored in your working directory.
-b target_dir
Specifies the directory where the compiler you are updating is installed.
-rte
Specifies that only the runtime component is installed.
-version
Displays the version of the non-default installation tool.
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.
Chapter 4. Update installation 25

The following example uses the xlCndi Perl script to install all available PTF
filesets in the /compiler/update/ source directory to the non-default location,
/compiler/xlcpp/ and writes the installation log file to /tmp/
xlcpp.ndi.inst.log.
Example:
perl /opt/IBM/xlC/13.1.0/bin/xlCndi -d /compiler/update/ -u /compiler/update/ptflist
-b /compiler/xlcpp/ -e /tmp/xlcpp.ndi.inst.log
Product version migration

If you have a previous version of the compiler, it will not be removed when you
are installing this version, only the C++ runtime library and the SMP runtime
library will be migrated to the new versions. You can maintain multiple versions of
the compiler on your system.
If you intend to maintain multiple versions of XL C/C++ on your system, refer to

Chapter 3, “Advanced installation,” on page 15.
Operating system migration

If you have the compiler installed on 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 C/C++
V13.1 is installed on AIX 6.1 and the operating system is migrated to AIX 7.1. 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.

Chapter 5. After installing XL C/C++
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 C/C++ error messages” on page 29
v “Enabling the manual pages” on page 30
v “Creating shortcuts to the XL C/C++ 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 "-qversion" in the
XL C/C++ Compiler Reference.

Viewing the .vrmf_history file
If you have installed XL C/C++ to a non-default location, you can view the
version information for each fileset installed by viewing the .vrmf_history text file
that is installed in the compiler's main directory.
Note: You must not edit this file because it might cause unexpected behavior of
the xlCndi 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, urt_client.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 C/C++ 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 C/C++ for AIX, V13.1 for inventory
support only, which means that ILMT and TADd can detect product installation of
XL C/C++ but not its usage.
Note: ILMT and TADd are not a part of the XL C/C++ 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 C/C++ is installed in the default location, the signature files are in the
/opt/IBM/xlC/13.1.0/ directory. Otherwise, if XL C/C++ is installed in a
non-default location, the signature files are in the /target_dir/opt/IBM/xlC/
13.1.0/ 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.

Configuring compiler defaults
You can change some of the default settings of the compiler for your specific
needs.
If you are using XL C/C++ on a system running AIX 6.1, the configuration file is
/opt/IBM/xlc/13.1.0/etc/xlc.cfg.61, and if you are on a system running AIX 7.1,
the configuration file is /opt/IBM/xlc/13.1.0/etc/xlc.cfg.71. The GCC options
configuration file is gxlc.cfg.
For more information about how to change the XL C/C++ compiler's settings, see
Customizing the configuration file and Configuring the gxlc or gxlc++ option
mapping in the XL C/C++ 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 -e "\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 7.
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 /opt/IBM/xlC/13.1.0/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 C/C++ 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.
Chapter 5. After installing XL C/C++ 29

For example, to specify the Japanese locale with the IBM_eucJP code page, use the
following commands:
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 7 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 command:
export MANPATH=$MANPATH:/opt/IBM/xlC/13.1.0/man/LANG
where LANG might be any of the following language locales:

v en_US
v EN_US
v ja_JP
v JA_JP
v Ja_JP
v zh_CN
v ZH_CN
v Zh_CN
For example, to set the language of the manual pages to English, run the
commands:
MANPATH=$MANPATH:/opt/IBM/xlC/13.1.0/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:/opt/IBM/xlC/13.1.0/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
33.
Creating shortcuts to the XL C/C++ invocation commands

The compiler invocation commands are not automatically installed in /usr/bin/.
To invoke the compiler without having to specify the full path, create a shortcut to
the invocation commands.

To create a shortcut to the XL C/C++ invocation commands, do one of the
following:
Either
v Create symbolic links for the specific drivers from /opt/IBM/xlc/13.1.0/bin/
and /opt/IBM/xlC/13.1.0/bin/ to /usr/bin/.
Example:
ln -s /opt/IBM/xlC/13.1.0/bin/xlc /usr/bin/xlc
or
v Add /opt/IBM/xlc/13.1.0/bin/ and /opt/IBM/xlC/13.1.0/bin/ to your PATH
environment variable.
Example:
PATH=$PATH:/opt/IBM/xlC/13.1.0/bin/
export PATH
Note: If XL C/C++ resides in a non-default location, the invocation commands are

installed to /target_dir/opt/IBM/xlC/13.1.0/bin where target_dir is the target
directory for installation specified by the -b option of the non-default installation
script. You can create a shortcut to the invocation commands of a non-default
installation by adding the location of the compiler invocations,
target_dir/opt/IBM/xlC/13.1.0/bin/, to the PATH environment variable.
For example, if you installed XL C/C++ to the /compiler/xlcpp directory, you

would run the commands:
PATH=$PATH:/compiler/xlcpp/opt/IBM/xlC/13.1.0/bin/
export PATH
Accessing the local documentation

Help using IBM XL C/C++ for AIX, V13.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
Knowledge Center.
The Knowledge Center is viewable on the web at http://www.ibm.com/support/

knowledgecenter/SSGH3R_13.1.0/com.ibm.compilers.aix.doc/welcome.html. You
can also download a version of this information center containing the product
documentation for IBM XL C for AIX, V13.1, IBM XL C/C++ for AIX, V13.1 and
IBM XL Fortran for AIX, V15.1. This information center can be installed on any
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 the 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 about 160 MB, and 220 MB
when it is uncompressed.
Follow these steps to download the help system:

1. Go to the XL C/C++ compiler library page at http://www.ibm.com/support/
docview.wss?uid=swg27036618. Download the information center package file
XLHelp-v131-v151-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-v131-v151-AIX-64bit.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
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:1315/help/index.jsp
v To access the information center remotely, use this URL:
http://machine_name:1315/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
Note: The downloaded information center does not contain the documentation for
IBM Debugger for AIX, V13.1. You can access the debugger documentation, which
consists of HTML online help and additional HTML documents, from its graphical
user interface.
Viewing the PDF documentation

PDF versions of the XL C/C++ 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

/opt/IBM/xlC/13.1.0/doc/LANG/pdf/ directory. For non-default installations, the
PDF documentation is located in the /target_dir/opt/IBM/xlC/13.1.0/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, ja_JP or zh_CN.
See “Related information” on page ix for a list of IBM XL C/C++ 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 C/C++ invocation or utility command.
Example:
man xlc
Testing the installation

To test the product installation and the critical search paths, try building,
compiling, and running a couple of simple programs.
For example:
1. Create the following C and C++ programs:
[hello.c]
#include <stdio.h>
int main(void)
{
printf("Hello World!\n");
return 0;
}
[hello.cpp]
#include <iostream>
int main()
{
std::cout << "Hello World!\n" << std::endl;
return 0;
}
2. Compile the test programs. For example:
xlc hello.c -o hello
xlc++ hello.cpp -o hello
Note: To use shortcuts to the compiler invocation commands, see “Creating

shortcuts to the XL C/C++ 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 6. Uninstalling XL C/C++
This section outlines the steps required to uninstall both basic and advanced
installations of XL C/C++.
Notes:
1. You must have the root access to uninstall XL C/C++.
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 C/C++ for AIX, V13.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 C/C++ for AIX, V13.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 Fortran 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:
xlccmp.13.1.0* xlCcmp.13.1.0*
Otherwise, enter the following name in the field:

xlccmp.13.1.0* xlCcmp.13.1.0* xlmass.8.1.0 memdbg.*
If you also want to uninstall the SMP library, enter the following name in the
field. (Generally, you are not recommended to do this, because you might have
applications that are dependent on this runtime library.)
xlsmp.*
To uninstall IBM Debugger for AIX, V13.1, you also need to enter the following
name in the field:
ibmdebugger
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 C/C++ for AIX, V13.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 Fortran installed in its default location, you must not remove any
filesets which are shared between the compilers. In this case, filesets should be:
xlccmp.13.1.0\* xlCcmp.13.1.0\*
Otherwise, filesets are:

xlccmp.13.1.0\* xlCcmp.13.1.0\* xlmass.8.1.0 memdbg.\*
If you also want to uninstall the SMP library, enter the following name in the field.
(Generally, you are not recommended to do this, because you might have
applications that are dependent on this runtime library.)
xlsmp.\*
To uninstall IBM Debugger for AIX, V13.1, enter the following command:
installp -ug ibmdebugger
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 C/C++ compiler installed to a non-default location, delete the

compiler directory, and uninstall the xlCcmp.13.1.0.ndi fileset and the license
agreement fileset.
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:

rm -rf target_dir
where target_dir is the target directory for installation specified by the -b option of
the non-default installation script.
To uninstall the xlCcmp.13.1.0.ndi and the license agreement filesets, enter the
following command:
installp -u xlCcmp.13.1.0.ndi xlCcmp.13.1.0.license
If you are uninstalling an evaluation version of the compiler, enter the following
command to uninstall the xlCcmp.13.1.0.ndi and the xlCcmp.13.1.0.evaluation
filesets:
installp -u xlCcmp.13.1.0.ndi xlCcmp.13.1.0.evaluation

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 C/C++ for AIX, V13.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.
Chapter 6. Uninstalling XL C/C++ 37

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.

Licensees of this program who want 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.

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, 2014.
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 and the Adobe 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.
Windows and the Windows logo are trademarks of Microsoft Corporation in the
United States, other countries, or both.
Notices 41
Index
Special characters H PTF 21
installp hard disk space available

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


Product Number: 5765-J07; 5725-C72
Printed in USA
SC27-4258-00

Installation Guide: IBM XL C/C++ For AIX, V13.1

Uploaded by

Copyright:

Available Formats

Installation Guide: IBM XL C/C++ For AIX, V13.1

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Installation Guide: IBM XL C/C++ For AIX, V13.1

Uploaded by

Copyright:

Available Formats

IBM XL C/C++ for AIX, V13.

© Copyright IBM Corp. 2003, 2014 iii

Who should read this document

How to use this document

© Copyright IBM Corp. 2003, 2014 v

How this document is organized

vi XL C/C++: Installation Guide

Qualifying elements (icons)

C++ only ends

IBM extension ends

Throughout this information, diagrams illustrate XL C/C++ syntax. This section

About this information vii

v Optional items are shown below the main path:

viii XL C/C++: Installation Guide

(1) (2) (3) (4) (5) (9) (10)

Examples in this information

IBM XL C/C++ information

About this information ix

x XL C/C++: Installation Guide

Note: Documentation errata is reflected only in the English version of the

For more information about boosting performance, productivity, and portability,

Standards and specifications

About this information xi

How to send your comments

xii XL C/C++: Installation Guide

Coexistence with previous version compilers

Upgrading the evaluation copy of the XL C/C++ compiler

The installation image and filesets

© Copyright IBM Corp. 2003, 2014 1

Note: The XL C compiler fileset names are xlccmp.13.1.0.*.

XL C++ compiler filesets

Note: The XL C/C++ compiler fileset names are xlCcmp.13.1.0.*.

2 XL C/C++: Installation Guide

XL C++ runtime environment filesets

Note: The XL C++ runtime environment fileset names are xlC.*.

Versions of the XL C++ runtime environment

Chapter 1. Before installing XL C/C++ 3

Using the XL C++ runtime environment in an upgraded operating

Runtime debug memory routine filesets

Shared-memory parallelism (SMP) runtime environment filesets

4 XL C/C++: Installation Guide

Mathematical Acceleration Subsystem (MASS) filesets

IBM Debugger filesets

The installation file, idebug.install_8.0.0.zip, of the Windows debug client is in

Chapter 1. Before installing XL C/C++ 5

Utilization reporting tool fileset

LANG = [en_US, EN_US,

LANG = [en_US, EN_US,

Preparing the electronic distribution package

6 XL C/C++: Installation Guide

National language support

The XL C/C++ messages support the following language locales:

Verifying the amount of hard disk space available

Chapter 1. Before installing XL C/C++ 7

Required filesets for installing XL C/C++

Fileset name Fileset description

At least one of the following locale-specific filesets must be installed on your

Fileset name Fileset description

Note: If one of the required filesets is missing, an error message might be