Filter
Top Products
Preparing a Program for Debugging
Table 13. Debug Views
Debug View Debug Data DBGVIEW Param-
eter Value
None No debug data *NONE
Statement view
(default)
No source displayed (use statement
numbers in source section of compiler
listing)
*STMT
Root source
view
Root source member information *SOURCE
COPY source
view
Root source member and /COPY members
information
*COPY
Listing view Compiler listing (dependent on OPTION
parameter)
*LIST
All Data from root source, COPY source, and
listing views
*ALL
Creating a Root Source View
A root source view contains text from the root source member. This view does not
contain any /COPY members. Furthermore, it is not available if the root source
member is a DDM file.
You create a root source view to debug a module by using the *SOURCE, *COPY
or *ALL options on the DBGVIEW parameter for either the CRTRPGMOD or
CRTBNDRPG commands when you create the module.
The compiler creates the root source view while the module object (*MODULE) is
being compiled. The root source view is created using references to locations of
text in the root source member rather than copying the text of the member into the
module object. For this reason, you should not modify, rename, or move root
source members between the module creation of these members and the debug-
ging of the module created from these members. If you do, the views for these
source members may not be usable.
For example, to create a root source view for a program DEBUGEX when using
CRTBNDRPG, type:
CRTBNDRPG PGM(MYLIB/DEBUGEX) SRCFILE(MYLIB/QRPGLESRC)
TEXT('ILE RPG/400 program DEBUGEX')
DBGVIEW(*SOURCE)
To create a root source view for a module DBGEX when using CRTRPGMOD,
type:
CRTRPGMOD MODULE(MYLIB/DBGEX) SRCFILE(MYLIB/QRPGLESRC)
TEXT('Entry module for program DEBUGEX')
DBGVIEW(*SOURCE)
Specifying DBGVIEW(*SOURCE) with either create command creates a root source
view for debugging module DBGEX. By default, a compiler listing with /COPY
members and expanded DDS, as well as other additional information is produced.
Chapter 11. Debugging Programs 167