Compile Panel

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

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.

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.

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.

Generate Object
If this checkbox is selected, all phases of the compilation process are carried out.

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.

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.

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.