z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

xlc and xlC
Setting up a configuration file
The configuration file specifies information that the compiler uses when you invoke
it. This file defines values used by the compiler to compile C or C++ programs. You
can make entries to this file to support specific compilation requirements or to
support other C or C++ compilation environments.
A configuration file is a UNIX file consisting of named topics called stanzas. Each
stanza contains keywords called configuration file attributes, which are assigned
values. The attributes are separated from their assigned value by an equal sign. A
stanza can point to a default stanza by specifying the ″use″ keyword. This allows
specifying common attributes in a default stanza and only the deltas in a specific
stanza, referred to as the local stanza.
For any of the supported attributes not found in the configuration file, the xlc utility
uses the built-in defaults. It uses the first occurrence in the configuration file of a
stanza or attribute it is looking for. Unsupported attributes, and duplicate stanzas
and attributes are not diagnosed.
Note: The difference between specifying values in the stanza and relying on the
defaults provided by the xlc utility is that the defaults provided by the xlc
utility will not override pragmas.
Configuration file attributes
A stanza in the configuration file can contain the following attributes:
as Path name to be used for the assembler. The default is /bin/c89.
asopt The list of options for the assembler and not for the compiler. These
override all normal processing by the compiler and are directed to
the assembler specified in the as attribute. Options are specified
following the c89 utility syntax.
asuffix The suffix for archive files. The default is a.
asuffix_host The suffix for archive data sets. The default is LIB.
ccomp The C compiler. The default is usr/lpp/cbclib/xlc/exe/ccndrvr.
cinc A comma separated list of directories or data set wild cards used to
search for C header files. The default for this attribute is:
-I//’CEE.SCEEH.+’. For further information on the list of search
places used by the compiler to search for system header files, see
the note at the end of this list of configuration file attributes.
classversion The USL class library version. The default matches the current
release, as described in the TARGET compiler option description in
z/OS XL C/C++ User’s Guide.
cppcomp The C++ compiler. The default is /usr/lpp/cbclib/xlc/exe/ccndrvr.
cppinc A comma separated list of directories or data set wild cards used to
search for C++ header files. The default for this attribute is:
-I//’CEE.SCEEH.+’,-I//’CBC.SCLBH.+’.For further information on the
list of search places used by the compiler to search for system
header files, see the note at the end of this list of configuration file
attributes.
csuffix The suffix for source programs. The default is c (lowercase c).
csuffix_host The suffix for C source data sets. The default is C (uppercase C).
cversion The compiler version. The default matches the current release, as
800 z/OS V1R9.0 UNIX System Services Command Reference