Category
Error checking and debugging
Pragma equivalent
#pragma options (gonumber) (C only), #pragma options (nogonumber) (C only)
Purpose
Generates line number tables that correspond to the input source file for Debug Tool and CEEDUMP processing.
Defaults
- NOGONUMBER
- If DEBUG or TEST is specified, GONUMBER is the default.
Usage
The GONUMBER option is active by default when you use the DEBUG option. The DEBUG option will activate the GONUMBER option unless NOGONUMBER has been explicitly specified.
In the z/OS® UNIX System Services environment, the GONUMBER option is enforced when you use the -g flag option using the c89 or xlc commands. In another words, the -g flag option will always activate the GONUMBER option, regardless of other option specifications.
When you specify the GONUMBER option, a comment that indicates its use is generated in your object module to aid you in diagnosing your program.
IPA effects
If you specify the GONUMBER option on the IPA compile step, the compiler saves information about the source file line numbers in the IPA object file.
If you do not specify the GONUMBER option on the IPA compile step, the object file produced contains the line number information for source files that contain function begin, function end, function call, and function return statements. This is the minimum line number information that the IPA compile step produces. You can then use the TEST option on the IPA link step to generate corresponding test hooks.
On the IPA link step, the GONUMBER table will not be generated regardless of how the IPA object files are compiled, nor if the GONUMBER option is specified at the IPA link step.
For more information, see Interactions between compiler options and IPA suboptions and LIST | NOLIST.
Predefined macros
None.