z/OS XL C and C++ programs

The following table shows various compiler options that can be used to prepare z/OS XL C and C++ programs for use with the IBM Problem Determination Tools products (Debug Tool for z/OS, Fault Analyzer for z/OS and Application Performance Analyzer for z/OS). The methods suggested in the following table indicate if the load module produced is suitable for a production environment. Load modules suitable for a production environments have no significant run-time overhead.

Table 1. Examples of compiler options and source information files supported by IBM Problem Determination Tools products for C++
Compiler options Output produced Is the load module production ready? Options supported and suggested for Debug Tool for z/OS Options supported and suggested for Fault Analyzer for z/OS Options supported and suggested for Application Performance Analyzer for z/OS
Preprocess (1st stage) to expand source, In compile (2nd stage): TEST, ATTRIBUTE(FULL), NOIPA, LIST, NESTINC(255), NOOFFSET, NOOPT, SOURCE, XREF Expanded source file used by Debug Tool for z/OS, compiler listing used by Fault Analyzer for z/OS and Application Performance Analyzer for z/OS No Suggested for test. (Using Debug Tool in production for this compiler is not recommended.) Supported Supported
Expanded source file used by Debug Tool for z/OS, LANGX file used by Fault Analyzer for z/OS and Application Performance Analyzer for z/OS No Supported Supported Supported
NOTEST, ATTRIBUTE(FULL), NOIPA, LIST, NESTINC(255), NOOFFSET, NOOPT, SOURCE, XREF Compiler listing Yes N/A Suggested for production and test Suggested for production and test
LANGX file Yes N/A Supported Supported
Preprocess (1st stage) to expand source. In compile (2nd stage): DEBUG(FORMAT (DWARF), HOOK(LINE, NOBLOCK, PATH), SYMBOL, FILE(location)) Expanded source file and DWARF file No Supported. (Using Debug Tool in production for this compiler is not recommended.) N/A N/A
Note:
  1. The highlighted row or rows in the table above indicate the suggested compiler options and source information file types for each product.
  2. The FORMAT(DWARF) option is supported for z/OS Version 1.6 and higher.
Table 2. Examples of compiler options and source information files supported by IBM Problem Determination Tools products for C
Compiler options Output produced Is the load module production ready? Options supported and suggested for Debug Tool for z/OS Options supported and suggested for Fault Analyzer for z/OS Options supported and suggested for Application Performance Analyzer for z/OS
Preprocess (1st stage) to expand source, In compile (2nd stage): TEST(ALL), AGGREGATE, NOIPA, LIST, NESTINC(255), NOOFFSET, NOOPT, SOURCE, XREF Expanded source file used by Debug Tool for z/OS, compiler listing used by Fault Analyzer for z/OS and Application Performance Analyzer for z/OS No Suggested for test. (Using Debug Tool in production for this compiler is not recommended.) Supported Supported
Expanded source file used by Debug Tool for z/OS, LANGX file used by Fault Analyzer for z/OS and Application Performance Analyzer for z/OS No Supported Supported Supported
NOTEST, AGGREGATE, NOIPA, LIST, NESTINC(255), NOOFFSET, NOOPT, SOURCE, XREF Compiler listing Yes N/A Suggested for production and test Suggested for production and test
LANGX file Yes N/A Supported Supported
Preprocess (1st stage) to expand source. In compile (2nd stage): DEBUG(FORMAT (DWARF), HOOK(LINE, NOBLOCK, PATH), SYMBOL, FILE(location)) Expanded source file and DWARF file No Supported. (Using Debug Tool in production for this compiler is not recommended.) N/A N/A
Note:
  1. The highlighted row or rows in the table above indicate the suggested compiler options and source information file types for each product.
  2. The FORMAT(DWARF) option is supported for z/OS Version 1.6 and higher.