Configuration file attributes
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 theacceptable_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 theacceptable_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 theacceptable_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. For more information on the prefix_ACCEPTABLE_RC environment variable, see Environment variables. - as
- Path name to be used for the assembler. The default is /bin/c89.
- asmlib
- Specifies assembler macro libraries to be used when assembling the assembler source code.
- 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 TARGET.
- 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 TARGET. The oldest release supported is z/OS® V1R12.
- 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 TARGET.
- 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 thesyslib_x
attribute is not specified, the default for this attribute should match the type of stanza for which it is specified. When thesyslib_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 -qnosearch is specified in the configuration file, it turns off all search places specified on the command line or in the default module and the only search places are those specified in the configuration file following the last -qnosearch option.
- 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