The installation image and filesets

The installation image contains filesets for all the components of the compiler for all supported language locales.

The installation image for XL C/C++ is available physically on an installation CD and electronically in the xlcpp.11.1.0.aix.GM.tar.Z installation package, in the /usr/sys/inst.images directory.

The image includes filesets for the following compiler components:

XL C compiler filesets 11.1
XL C++ compiler filesets 11.1
XL C++ runtime environment filesets 11.1
Runtime debug memory routine filesets 5.4
Shared-memory parallelism (SMP) runtime environment filesets 2.1
Mathematical Acceleration Subsystem (MASS) filesets 6.1
IBM Debugger filesets 7.1
Utilization reporting tool filesets 1.1

Filesets

The following tables list the filesets included in the installation image and the default directories to which the fileset contents are installed during a basic installation. You may optionally install all available filesets, or only the ones you want. If you select specific filesets for installation, you may also choose to automatically install any prerequisite filesets required by your selections by using the installp -g flag.

When fileset names differ only by the locale code, you can choose to install only the filesets relevant to your desired language and location. The LANG environment variable determines which message catalogs are used. The en_US (English) message catalogs are installed by default. If LANG is not defined or is assigned an unsupported locale, en_US message catalogs are used. See National language support for a list of available locales.

XL C compiler filesets 11.1

Table 1. XL C compiler filesets and default installation locations
Fileset name	Fileset description	Default installation locations
vac.C	XL C compiler	/etc/ /usr/vac/ /usr/vac/bin/ /usr/vac/exe/
vac.Bnd	XL C media defined bundles	/usr/sys/inst.data/sys_bundles/
vac.include	XL C compiler include files	/usr/vac/include/
vac.aix53	XL C libraries for AIX® 5.3 and AIX 6.1	/usr/vac/lib/aix53/
vac.html.LANG	Supersede entry, not installed LANG = [en_US, ja_JP, zh_CN]	/usr/vac/eclipse/plugins/
vac.html.common	Supersede entry, not installed	/usr/vac/bin/
vac.lic	XL C license files	/usr/vac/lib/
vac.man.LANG	XL C compiler manual pages LANG = [en_US, EN_US, ja_JP, JA_JP, Ja_JP, zh_CN, ZH_CN, Zh_CN]	/usr/vac/man/LANG/man1/
vac.pdf.LANG.C	XL C compiler documentation (PDF) LANG = [en_US, ja_JP, zh_CN]	/usr/vac/doc/LANG/pdf/
vac.msg.LANG	XL C compiler messages LANG = [en_US, EN_US, ja_JP, JA_JP, Ja_JP, zh_CN, ZH_CN]	/usr/lib/nls/msg/LANG/
vac.ndi	XL C non-default installation script	/usr/vac/bin/

Note: All of the filesets required for the XL C compiler, except vac.ndi, are also required for the XL C/C++ compiler.

XL C++ compiler filesets 11.1

Table 2. XL C/C++ compiler filesets and default installation locations
Fileset name	Fileset description	Default installation locations
vacpp.cmp.core	XL C++ compiler	/usr/vacpp/ /usr/vacpp/bin/ /usr/vacpp/exe/
vacpp.Bnd	XL C++ media defined bundles	/usr/sys/inst.data/sys_bundles/
vacpp.cmp.include	XL C++ compiler include files	/usr/vacpp/include/
vacpp.cmp.lib	XL C++ libraries	/usr/vacpp/lib/
vacpp.cmp.tools	XL C++ tools	/usr/vacpp/bin/ /usr/vacpp/exe/aix53/
vacpp.cmp.rte	XL C++ compiler application run time	/usr/vacpp/lib/ /usr/vacpp/lib/profiled/
vacpp.cmp.aix53.lib	XL C++ libraries for AIX 5.3 and AIX 6.1	/usr/vacpp/lib/aix53/ /usr/vacpp/lib/profiled/aix53/
vacpp.cmp.aix53.tools	XL C++ tools for AIX 5.3 and AIX 6.1	/usr/vacpp/ /usr/vacpp/exe/
vacpp.html.LANG	Supersede entry, not installed LANG = [en_US, ja_JP, zh_CN]	/usr/vacpp/eclipse/plugins/
vacpp.html.common	Supersede entry, not installed	/usr/vacpp/bin/
vacpp.lic	XL C++ license files	/usr/vacpp/lib/
vacpp.man.LANG	XL C++ compiler manual pages LANG = [en_US, EN_US, ja_JP, JA_JP, Ja_JP, zh_CN, ZH_CN, Zh_CN]	/usr/vacpp/man/LANG/man1/
vacpp.pdf.LANG	XL C++ compiler documentation (PDF) LANG = [en_US, ja_JP, zh_CN]	/usr/vacpp/doc/LANG/pdf/
vacpp.memdbg.lib	XL C++ user heap/memory debug static libraries	/usr/vacpp/lib/
vacpp.memdbg.rte	XL C++ user heap/memory debug runtime libraries	/usr/vacpp/lib/ /usr/vacpp/lib/profiled/
vacpp.memdbg.aix53.lib	XL C++ user heap/memory debug for AIX 5.3 and AIX 6.1 libraries	/usr/vacpp/lib/aix53/ /usr/vacpp/lib/profiled/aix53/
vacpp.memdbg.aix53.rte	XL C++ user heap/memory debug for AIX 5.3 and AIX 6.1 runtime libraries	/usr/vacpp/lib/aix53/ /usr/vacpp/lib/profiled/aix53/
vacpp.msg.LANG.cmp.core	XL C++ compiler messages LANG = [en_US, EN_US, ja_JP, JA_JP, Ja_JP, zh_CN, ZH_CN, Zh_CN]	/usr/lib/nls/msg/LANG/
vacpp.msg.LANG.cmp.tools	XL C++ tools messages LANG = [en_US, EN_US, ja_JP, JA_JP, Ja_JP, zh_CN, ZH_CN, Zh_CN]	/usr/lib/nls/msg/LANG/
vacpp.ndi	XL C++ non-default installation script	/usr/vacpp/bin/
vacpp.samples	ANSI class library samples	/usr/vacpp/samples/

XL C++ runtime environment filesets 11.1

Table 3. XL C++ runtime environment filesets and default installation locations
Fileset name	Fileset description	Default installation locations
xlC.adt.include	XL C++ application development toolkit	/usr/include/
xlC.rte	XL C++ runtime libraries	/usr/lpp/xlC/lib/ /usr/lpp/xlC/lib/profiled/
xlC.aix50.rte	XL C++ runtime environment for AIX 5.3 libraries	/usr/lpp/xlC/lib/aix53/ /usr/lpp/xlC/lib/profiled/aix53/
xlC.aix61.rte	XL C++ runtime environment for AIX 6.1 libraries	/usr/lpp/xlC/lib/aix61/ /usr/lpp/xlC/lib/profiled/aix61/
xlC.msg.LANG.rte	XL C++ runtime messages LANG = [en_US, ja_JP, Ja_JP]	/usr/lib/nls/msg/LANG/

Runtime debug memory routine filesets 5.4

Table 4. Runtime debug memory routine filesets and default installation locations
Fileset name	Fileset description	Default installation locations
memdbg.adt	User heap/memory debug toolkit	/usr/vac/lib/ /usr/vac/lib/profiled/
memdbg.aix53.adt	User heap/memory debug toolkit for AIX 5.3 and AIX 6.1	/usr/vac/lib/aix53/ /usr/vac/lib/profiled/aix53/
memdbg.msg.LANG	User heap/memory debug messages LANG = [en_US, EN_US, ja_JP, JA_JP, Ja_JP, zh_CN, ZH_CN]	/usr/lib/nls/msg/LANG

Shared-memory parallelism (SMP) runtime environment filesets 2.1

Table 5. SMP runtime filesets and default installation locations
Fileset name	Fileset description	Default installation locations
xlsmp.rte	SMP runtime library	/usr/include/ /usr/lpp/xlsmp/default_msg/
xlsmp.msg.LANG.rte	SMP runtime messages LANG = [en_US, EN_US, ja_JP, JA_JP, Ja_JP, zh_CN, ZH_CN, Zh_CN]	/usr/lib/nls/msg/LANG/
xlsmp.aix53.rte	SMP runtime libraries for AIX 5.3 and AIX 6.1	/usr/lpp/xlsmp/aix53/

Mathematical Acceleration Subsystem (MASS) filesets 6.1

Table 6. MASS filesets and default installation locations
Fileset name	Fileset description	Default installation locations
xlmass.adt.include	IBM® MASS application development include files	/usr/xlmass/include/
xlmass.lib	IBM MASS libraries	/usr/xlmass/lib/
xlmass.aix53.lib	IBM MASS libraries for AIX 5.3 and AIX 6.1	/usr/xlmass/lib/aix53/

IBM Debugger filesets 7.1

Table 7. 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 Eclipse-based IBM Debugger for AIX, V7.1 is included with the XL C/C++ installation image, and adds source-level debugging to your development environment. In addition, a Windows® version of the Debugger UI is included with the installer, which allows you to remotely debug AIX applications from a Windows platform.

Note:

IBM Debugger for AIX, V7.1 supersedes 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, V7.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.
To install IBM Debugger and the Windows remote debug interface, see "README.debug" in the root directory of the installation image.

Utilization reporting tool fileset 1.1

Table 8. Utilization reporting tool fileset and default installation locations
Fileset name	Fileset description	Default installation locations
urt11	Utilization reporting tool files LANG = [en_US, EN_US, ja_JP, JA_JP, Ja_JP, zh_CN, ZH_CN]	/opt/ibmurt/1.1/ /opt/ibmurt/1.1/bin/ /opt/ibmurt/1.1/man/LANG/man1/ /opt/ibmurt/1.1/msg/LANG/ /opt/ibmurt/1.1/config/

Note: The utilization reporting tool can be installed on the same machine as the compiler or on a different machine. You must use installp utilities to install urt11 fileset. It typically needs to be installed only once, no matter how many compiler installations you have. This tool is useful for those who are responsible for monitoring the overall compiler usage within an organization. Individual developers and build teams should not need to use this tool.

To install the utilization reporting tool, see the instructions provided in README.urt in the root directory of the installation image.

Preparing the electronic distribution package

If you have downloaded the XL C/C++ electronic distribution package, xlcpp.11.1.0.aix.GM.tar.Z, follow these steps before attempting to install:

Note: You must be logged in as root user or have superuser authority.

To uncompress and unpack the file, use the command:
```
zcat xlcpp.11.1.0.aix.GM.tar.Z | tar -xvf -
```
Use the command inutoc directory_name to generate a .toc file in the specified directory.

The following example shows the steps to prepare the electronic distribution package, xlcpp.11.1.0.aix.GM.tar.Z, located in the new directory, /compiler/install/ for installation.

cd /compiler/install
zcat xlcpp.11.1.0.aix.GM.tar.Z | tar -xvf -
cd usr/sys/inst.images
inutoc .

Refer to System prerequisites to ensure that system prerequisites are met and use the installation methods described in either Basic installation or Advanced installation to install the compiler.

National language support

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

en_US (ISO8859-1)
EN_US (UTF-8)
ja_JP (IBM-eucJP)
JA_JP (UTF-8)
Ja_JP (IBM-943)
zh_CN (IBM-eucCN)
ZH_CN (UTF-8)
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.