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

c89, cc, and c++
Options
utilities. See z/OS Introduction and Release Guide for further details. Also see
prefix_CLIB_PREFIX and prefix_PLIB_PREFIX in “Environment variables” on page
84 for information about the names of the z/OS XL C/C++ Optional Feature data
sets that must be made available to c89/cc/c++.
Note: The term prefix is defined in “Environment variables” on page 84.
First, c89, cc, and c++ perform the compilation phase (including preprocessing) by
compiling all source file operands (file.C, file.i, and file.c, as appropriate). For c++, if
automatic template generation is being used (which is the default), then z/OS XL
C++ source files may be created or updated in the tempinc subdirectory of the
working directory during the compilation phase (the tempinc subdirectory will be
created if it does not already exist). Then, c89, cc, and c++ perform the assemble
phase by assembling all operands of the file.s form. The result of each compile step
and each assemble step is a file.o file. If all compilations and assemblies are
successful, or if only file.o and/or file.a files are specified, c89, cc, and c++ proceed
to the link-editing phase. For c++, the link-editing phase begins with an automatic
template generation step when applicable. For IPA (Interprocedural Analysis)
optimization an additional IPA Link step comes next. The link-edit step is last. See
the environment variable prefix_STEPS under “Environment variables” on page 84
for more information about the link-editing phase steps.
In the link-editing phase, c89, cc, and c++ combine all file.o files from the
compilation phase along with any file.o files that were specified on the command
line. For c++, this is preceded by compiling all z/OS XL C++ source files in the
tempinc subdirectory of the working directory (possibly creating and updating
additional z/OS XL C++ source files during the automatic template generation step).
After compiling all the z/OS XL C++ source files, the resulting object files are
combined along with the file.o files from the compilation phase and the command
line. Any file.a files, file.x files and -l libname operands that were specified are also
used.
The usual output of the link-editing phase is an executable file. For c89, cc, and
c++ to produce an executable file, you must specify at least one operand which is
of other than -l libname form. If -r is used, the output file is not executable.
For more information about automatic template generation, see z/OS XL C/C++
User’s Guide and the information on ″Using TEMPINC or NOTEMPINC″ in z/OS XL
C/C++ Programming Guide. Note that the c++ command only supports using the
tempinc subdirectory of the working directory for automatic template generation.
IPA is further described under the -W option on page 78.
–+ Specifies that all source files are to be recognized as C++ source files. All
file.s, file.o, and file.a files will continue to be recognized as assembler
source, object, and archive files respectively. However, any C file.c or file.i
files will be processed as corresponding C++ file.C or file.i files, and any
other file suffix which would otherwise be unrecognized will be processed
as a file.C file.
This option effectively overrides the environment variable
prefix_EXTRA_ARGS. This option is only supported by the c++ command.
-C Specifies that C and C++ source comments should be retained by the
70 z/OS V1R9.0 UNIX System Services Command Reference