A stanza in the configuration file can contain the following attributes:
- acceptable_rc
- Enables you to specify a number that represents a return code
value for a program invoked by the xlc utility. The xlc utility does
not place any restriction on the value assigned to the acceptable_rc attribute. acceptable_rc can
appear as part of any stanza in the configuration file.
Note: If
the acceptable_rc attribute is not specified in the
configuration file, the xlc utility will assign the value from a c89 prefix_ACCEPTABLE_RC
environment variable, if it is exported, to the acceptable_rc,
otherwise it will default to 4. The command name used to invoke the
xlc utility determines the prefix that the xlc utility will use when
looking for a prefix_ACCEPTABLE_RC environment variable. For
example, if the xlc utility is invoked using the xlC command
name, the xlc utility will look for _CXX_ACCEPTABLE_RC and, if found,
use it. If the acceptable_rc attribute is specified
in the configuration file, the xlc utility will use the value specified
in the configuration file and will ignore an exported prefix_ACCEPTABLE_RC
environment variable.
- 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 described in the TARGET compiler option description in z/OS XL C/C++ User's Guide.
The oldest release supported is z/OS® V1R6.
- cxxsuffix
- The suffix for C++ source files. The default is C (uppercase
C).
- cxxsuffix_host
- The suffix for C++ source data sets. The default is CXX.
- exportlist
- A colon separated list of data sets with member names indicating
definition side-decks to be used to resolve symbols during
the link-editing phase. This attribute is only used for compatibility
with configuration files that are defined using the z/OS V1R6 release. Attributes with an appropriate
suffix should be used instead (see descriptions for exportlist attributes
with a suffix). The default for this attribute should match the type
of stanza for which it is specified.
Suffix-less C stanzas
do not have a default.
The default for suffix-less C++ stanzas
is:
CEE.SCEELIB(C128N):CBC.SCLBSID(IOSTREAM,COMPLEX)
The
default for C stanzas with an
_x suffix is:
CEE.SCEELIB(CELHS003,CELHS001)
The
default for C++ stanzas with an
_x suffix is:
CEE.SCEELIB(CELHS003,CELHSCPP,CELHS001,C128):CBC.SCLBSID
(IOSTREAM,COMPLEX)
The default for C stanzas with
a
_64 suffix is:
CEE.SCEELIB(CELQS003)
The
default for C++ stanzas with a
_64 suffix is:
CEE.SCEELIB(CELQS003,CELQSCPP,C64):CBC.SCLBSID(IOSQ64)
- exportlist_c
- A colon separated list of data sets with member names indicating
definition side-decks to be used to resolve symbols during the link-editing
phase of non-XPLINK C applications. The default for this attribute
is NONE.
- exportlist_cpp
- A colon separated list of data sets with member names indicating
definition side-decks to be used to resolve symbols during the link-editing
phase of non-XPLINK C++ applications. The default for this attribute
is:
CEE.SCEELIB(C128n):CBC.SCLBSID(IOSTREAM,COMPLEX)
- exportlist_c_x
- A colon separated list of data sets with member names indicating
definition side-decks to be used to resolve symbols during the link-editing
phase of XPLINK C applications. The default for this attribute is:
CEE.SCEELIB(CELHS003,CELHS001)
- exportlist_cpp_x
- A colon separated list of data sets with member names indicating
definition side-decks to be used to resolve symbols during the link-editing
phase of XPLINK C++ applications. The default for this attribute is:
CEE.SCEELIB(CELHS003,CELHSCPP,CELHS001,C128):CBC.SCLBSID
(IOSTREAM,COMPLEX)
- exportlist_c_64
- A colon separated list of data sets with member names indicating
definition side-decks to be used to resolve symbols during
the link-editing phase of 64-bit C applications. The default for this
attribute is:
CEE.SCEELIB(CELQS003)
- exportlist_cpp_64
- A colon separated list of data sets with member names indicating
definition side-decks to be used to resolve symbols during
the link-editing phase of 64-bit C++ applications. The default for
this attribute is:
CEE.SCEELIB(CELQS003,CELQSCPP,C64):CBC.SCLBSID(IOSQ64)
- isuffix
- The suffix for C preprocessed files. The default is i.
- isuffix_host
- The suffix for C preprocessed data sets. The default is CEX.
- ilsuffix
- The suffix for IPA output files. The default is I.
- ilsuffix_host
- The suffix for IPA output data sets. The default is IPA.
- ixxsuffix
- The suffix for C++ preprocessed files. The default is i.
- ixxsuffix_host
- The suffix for C++ preprocessed data sets. The default is CEX.
- ld
- The path name to be used for the binder. The default is /bin/c89.
- ld_c
- The path name to be used for the binder when only C sources appear
on the command line invoked with a C stanza. The default
is: /bin/c89.
- ld_cpp
- The path name to be used for the binder when at least one C++
source appears on the command line, or when a C++ stanza is used.
The default is: /bin/cxx.
- libraries
- libraries specifies the default libraries that
the binder is to use at bind time. The libraries are specified using
the -llibname syntax, with multiple library
specifications separated by commas. The default is empty.
- libraries2
- libraries2 specifies additional libraries that
the binder is to use at bind time. The libraries are specified using
the -llibname syntax, with multiple library
specifications separated by commas. The default is empty.
- options
- A string of option flags, separated by commas, to be processed
by the compiler as if they had been entered on the command line.
- osuffix
- The suffix for object files. The default is .o.
- osuffix_host
- The suffix for object data sets. The default is OBJ.
- psuffix
- The suffix for prelinked files. The default is p.
- psuffix_host
- The suffix for prelinked data sets. The default is CPOBJ.
- pversion
- The runtime 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.
- ssuffix
- The suffix for assembler files. The default is .s.
- ssuffix_host
- The suffix for assembler data sets. The default is ASM.
- steplib
- A colon separated list of data sets or keyword NONE used to set
the STEPLIB environment variable. The default is NONE, which causes
all programs to be loaded from LPA or linklist.
- syslib
- A colon separated list of data sets used to resolve runtime
library references. Data sets from this list are used to construct
the SYSLIB DD for the IPA Link and the binder invocation for non-XPLINK
applications. For compatibility with configuration files defined using
the z/OS V1R6 release, this
attribute is also used with XPLINK applications as a fallback when
the syslib_x attribute is not specified. When the syslib_x attribute
is not specified, the default for this attribute should match the
type of stanza for which it is specified. When the syslib_x attribute
is specified, the default for this attribute matches the default for
suffix-less stanzas.
The default for suffix-less stanzas is:
CEE.SCEELKEX:CEE.SCEELKED:CBC.SCCNOBJ:SYS1.CSSLIB
The
default for stanzas with
_x and
_64 suffixes
is:
CEE.SCEEBND2:CBC.SCCNOBJ:SYS1.CSSLIB
- syslib_x
- A colon separated list of data sets used to resolve runtime library
references. Data sets from this list are used to construct the SYSLIB
DD for the IPA Link and the binder invocation when building XPLINK
applications (31-bit and 64-bit).
The default for this attribute
is:
CEE.SCEEBND2:CBC.SCCNOBJ:SYS1.CSSLIB
- sysobj
- A colon separated list of data sets containing object files used
to resolve runtime library references. Data sets from this list are
used to construct the LIBRARY control statements and the SYSLIB DD
for the IPA Link and the binder invocation. This attribute is
ignored for XPLINK and 64-bit applications.
The default is:
CEE.SCEEOBJ:CEE.SCEECPP
- use
- Values for attributes are taken from the named stanza and from
the local stanza. For single-valued attributes, values in the use
stanza apply if no value is provided in the local, or default stanza.
For comma-separated lists, the values from the use stanza are added
to the values from the local stanza.
- usuffix
- The suffix for make dependency file names. The default make dependency
file name suffix is ".u", but it is overwritten by the value assigned
to this attribute.
There is no host version of this attribute,
because make dependency feature only applies to z/OS UNIX files.
- xlC
- The path name of the C++ compiler invocation command. The default
is /usr/lpp/cbclib/xlc/bin/xlc.
- xlCcopt
- A string of option flags, separated by commas, to be processed
when the xlc command is used for compiling a C
file.
- xsuffix
- The suffix for definition side-deck files. The default is x.
- xsuffix_host
- The suffix for definition side-deck data sets. The default is
EXP.
Note: When using the xlc utility to invoke the compiler, the compiler
uses the following list of search places to search for system header
files:
- If the -qnosearch option is not specified on
the command line or in the configuration file:
- search places defined in the customizable defaults module (CCNEDFLT)
- followed by those specified on the command line using the -I flag
option
- followed by those specified in the configuration file
- If the -qnosearch is specified only in the
configuration file:
- search places specified on the command line using the -I flag
option
- followed by those specified in the configuration file
- If the -qnosearch option is specified on the
command line:
- search places specified on the command line following the last
specified -qnosearch option
- followed by those specified in the configuration file