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

c89, cc, and c++
escaped. For example, some -W option-arguments contain parentheses.
Source files specified as PDS member names contain parentheses; if they are
specified as fully qualified names, they contain single quotes.
To escape these special characters, either enclose the option-argument or
operand in double quotes, or precede each character with a backslash.
3. Some c89/cc/c++ behavior applies only to hierarchical files (and not to data
sets).
v If the compile or assemble is not successful, the corresponding object file
(file.o) is always removed.
v If the DLL option is passed to the link-editing phase, and afterwards the
file.x file exists but has a size of zero, then that file is removed.
4. MVS data sets may be used as the usual place to resolve C and C++
#include directives during compilation.
Such data sets are installed with Language Environment. When it is allocated,
searching for these include files can be specified on the -I option as
//DD:SYSLIB. (See the description of environment variable prefix_CSYSLIB for
information.
When include files are MVS PDS members, z/OS XL C/C++ uses conversion
rules to transform the include (header) file name on a #include preprocessor
directive into a member name. If the "//'dataset_prefix.+'" syntax is not used for
the MVS data set which is being searched for the include file, then this
transformation strips any directory name on the #include directive, and then
takes the first 8 or fewer characters up to the first dot (.).
If the "//'dataset_prefix.+'" syntax is used for the MVS data set which is being
searched for the include file, then this transformation uses any directory name
on the #include directive, and the characters following the first dot (.), and
substitutes the "+" of the data set being searched with these qualifiers.
In both cases the data set name and member name are converted to
uppercase and underscores (_) are changed to at signs (@).
If the include (header) files provided by Language Environment are installed
into the hierarchical file system in the default location (in accordance with the
prefix_INCDIRS environment variable), then the compiler will use those files to
resolve #include directives during compilation. c89/cc/c++ by default searches
the directory /usr/include as the usual place, just before searching the data
sets just described. See the description of environment variables
prefix_CSYSLIB, prefix_INCDIRS, and prefix_INCLIBS for information on
customizing the default directories to search.
5. Feature test macros control which symbols are made visible in a source file
(typically a header file). c89/cc/c++ automatically defines the following feature
test macros along with the errno macro, according to whether or not cc was
invoked.
v Other than cc
–D "errno=(*__errno())"
–D _OPEN_DEFAULT=1
98 z/OS V1R9.0 UNIX System Services Command Reference
v cc
–D "errno=(*__errno())"
–D _OPEN_DEFAULT=0
–D _NO_PROTO=1
c89/cc/c++ add these macro definitions only after processing the command
string. Therefore, you can override these macros by specifying -D or -U
options for them on the command string.