Options on this panel specify compiler options to use when the source code
is being compiled.
See General Dialog Help for information on *CMDDFT settings, checkbox
usage, and pushbutton help.
- Compile options
-
- Generate Object
- If this checkbox is selected, all phases of the compilation process are
carried out.
- Log messages
- If this checkbox is selected, the compiler copies compilation messages
into the job log. Additionally:
- If you select this option together with the Flagging severity
option on the Debug options panel, messages with selected severity or higher
are also copied into the job log.
- If you select this option together with the Message limit
option on the Debug options panel, compilation stops when the number of
messages with selected severity or higher have been copied into the job
log.
- Run preprocessor only
- If this checkbox is selected, the preprocessor is run and its output saved
to source file QACZEXPAND in library QTEMP. The member-name is the same
as the name specified the Module field in the Module options
panel. The rest of the compilation sequence is not run.
- Struct or union variables
- If this checkbox is selected, the compiler generates an aggregate
structure map in the compiler listing. This map shows the layout of all
structures in the source program, and shows whether variables are padded or
not.
- Note:
- To view the structure map, you must also instruct the compiler to produce a
compiler listing. To do so, select the Source listing
options checkbox in the Listing compiler options panel.
- Expanded macros
- If this checkbox is selected, the compiler will expand macros in the
source part of the listing or in the debug listing view.
- Note:
- To view the expanded macros, you must also instruct the compiler to produce a
compiler listing or debug listing. To do so, select the Source
listing options checkbox in the Listing compiler options panel, or set
the Debugger view selection in the Debug compiler options panel to
either *LIST or *ALL.
- Second level messages
- If this checkbox is selected, the compiler generates second-level message
text in the compiler listing.
- Note:
- You must also instruct the compiler to produce a compiler listing. To
do so, select the Output checkbox in the Generation compiler
options panel.
- Show all statements
- If this checkbox is selected, the compiler includes all statements in the
source listing or debug listing, regardless of whether or not the preprocessor
has skipped them.
- Note:
- You must also instruct the compiler to produce a compiler listing or debug
listing. To do so, select the Source listing options
checkbox in the Listing compiler options panel, or set the Debugger
view selection in the Debug compiler options panel to either
*LIST or *ALL.
- Cross-reference identifiers
- If this checkbox is selected, the compiler will generate a cross-reference
listing containing the list of identifiers in the program source code together
with the line number on which they appear.
- Note:
- You must also instruct the compiler to produce a compiler listing. To
do so, select the Source listing options checkbox in the Listing
compiler options panel.
- Digraphs usage
- If this checkbox is selected, digraph character sequences can be used to
represent characters not found on some keyboards. Digraph character
sequences appearing in character or string literals are not replaced during
preprocessing.
- Listing options
- If this checkbox is selected, all listing options are turned on.
- Note:
- To actually view a listing, you must also instruct the compiler to produce a
compiler listing. To do so, select the Source listing
options checkbox in the Listing compiler options panel.
- Include INCDIR parameters first
- If this checkbox is selected, the compiler first searches for user include
files in the directory specified by the INCDIR parameter.
- Search system header files
- If this checkbox is selected, the compiler includes the default include
path (/QIBM/include for IFS source stream files; QSYSINC for data
management source file members) at the end of the search order.
- Compilation Message to stdout
- If this checkbox is selected, compiler messages will be sent to
stdout.
- Referenced struct or union variables
- If this checkbox is selected, the compiler includes the layout of all
referenced struct or union variables in the listing file.
- Note:
- To view this layout, you must also instruct the compiler to produce a
compiler listing. To do so, select the Source listing
options checkbox in the Listing compiler options panel.
- System include path
- If this checkbox is selected, the search path of user includes changes to
the system include search path. This is equilvalent to changing the
double-quotes in the user #include directive (#include "file_name") to angle
brackets (#include <file_name>).
- Cross-reference referenced identifiers
- If this checkbox is selected, the compiler produces a cross-reference
table of referenced variables, structures, and function names in the listing
file. The table also shows the line numbers where identifiers are
declared.
- Note:
- You must also instruct the compiler to produce a compiler listing. To
do so, select the Source listing options checkbox on the Listing
compiler options panel.
- Expand include files
- Specifies how the compiler will treat include files in the compiler and
debug listings. You can select one of the following values in this
field:
- *CMDDFT
- Refers to the include file treatment currently set as default for your
system.
- *SHOWINC
- Expands both user-include files and system-include files in the source
part of the compiler listing or debug listing.
- *NOSHOWINC
- Does not expand the user-include files or system-include files in the
source listing or debug listing.
- *SHOWUSR
- Expands user-include files in the source part of the compiler listing or
debug listing. User-include files are those enclosed in
double-quotation marks (" ") on an #include directive. Use
this option to print the typedef that is generated when you use the
#pragma mapinc in your program source to process
externally-described files.
- *SHOWSRC
- Shows the source statements in the source listing or in the debug listing
view.
- *NOSHOWSRC
- Does not show the source statements in the source listing or in the debug
listing view.
- *SHOWSYS
- Expands system-include files in the source part of the compiler listing or
debug listing. System-include files are those enclosed in angle
brackets (< >) on an #include directive.
- *NOSHOWSYS
- Does not expand the system include files on an #include
directive in the source listing or in the debug listing view.
- Note:
- To view the expanded macros, you must also instruct the compiler to produce a
compiler listing or debug listing. To do so, select the Source
listing options checkbox in the Listing compiler options panel, or set
the Debugger view selection in the Debug compiler options panel to
either *ALL, *SOURCE, or *LIST.
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.