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

Table 35. Compiler option conflict resolution (continued)
-qpath -B| -t -qpath overrides -B and -t
In general, if more than one variation of the same option is specified (with the
exception of xref and attr), the compiler uses the setting of the last one specified.
Compiler options specified on the command line must appear in the order you want
the compiler to process them.
If a command-line flag is valid for more than one compiler program (for example -B,
-W, or -I applied to the compiler, binder, and assembler program names), you must
specify it in options, or asopt in the configuration file. The command-line flags must
appear in the order that they are to be directed to the appropriate compiler
program.
Three exceptions to the rules of conflicting options are the -Idirectory or
-I//dataset_name, -llibrary, and -Ldirectory options, which have cumulative effects
when they are specified more than once.
Specifying compiler options on the command line
There are two kinds of command-line options:
v -qoption_keyword (compiler-specific)
v Flag options (available to z/OS XL C/C++ compilers in z/OS UNIX System
Service environment)
Command-line options in the -q option_keyword format are similar to on and off
switches. For most -q options, if a given option is specified more than once, the last
appearance of that option on the command line is the one recognized by the
compiler. For example, qsource turns on the source option to produce a compiler
listing, and -qnosource turns off the source option so that no source listing is
produced.
Example: The following example would produce a source listing for both
MyNewProg.C and MyFirstProg.C because the last source option specified
(-qsource) takes precedence:
xlC -qnosource MyFirstProg.C -qsource MyNewProg.C
You can have multiple -q option_keyword instances in the same command line, but
they must be separated by blanks. Option keywords can appear in mixed case, but
you must specify the -q in lowercase.
Example: You can specify any -q option_keyword before or after the file name:
xlC -qLIST -qnomaf file.c
xlC file.c -qxref -qsource
xlc and xlC
Some options have suboptions. You specify these with an equal sign following the
-qoption. If the option permits more than one suboption, a colon (:) must separate
each suboption from the next.
Example: The following example compiles the C source file file.c using the option
-qipa to specify the inter procedural analysis options. The suboption level=2 tells
the compiler to use the full inter procedural data flow and alias analysis, map tells
the compiler to produce a report, and the noobj tells the compiler to produce only
an IPA object without a regular object. The option -qattr with suboption full will
produce an attribute listing of all identifiers in the program.
Chapter 2. Shell command descriptions 813