Filter
Top Products
Preparing a Program for Debugging
Creating a COPY Source View
A COPY source view contains text from the root source member, as well as the
text of all /COPY members expanded into the text of the source. When you use the
COPY view, you can debug the root source member of the program using the root
source view and the /COPY members of the program using the COPY source view.
The view of the root source member generated by DBGVIEW(*COPY) is the same
view generated by DBGVIEW(*SOURCE). As with the root source view, a COPY
source view is not available if the source file is a DDM file.
You create a COPY source view to debug a module by using the *COPY or *ALL
option on the DBGVIEW parameter.
The compiler creates the COPY view while the module object (*MODULE) is being
compiled. The COPY view is created using references to locations of text in the
source members (both root source member and /COPY members) rather than
copying the text of the members into the view. For this reason, you should not
modify, rename, or move source members between the time the module object is
created and the debugging 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 source view of a program TEST1 that contains /COPY
members type:
CRTBNDRPG PGM(MYLIB/TEST1) SRCFILE(MYLIB/QRPGLESRC)
TEXT('ILE RPG/400 program TEST1')
DBGVIEW(*COPY)
Specifying DBGVIEW(*COPY) with either create command creates a root source
view with /COPY members for debugging module TEST1. By default, a compiler
listing is produced. The compiler listing will include /COPY members as well, since
OPTION(*SHOWCPY) is a default value.
Creating a Listing View
|A listing view contains text similar to the text in the compiler listing that is
| produced by the ILE RPG compiler. The information contained in the listing view is
| dependent on whether OPTION(*SHOWCPY), OPTION(*EXPDDS), and
| OPTION(*SRCSTMT) are specified for either create command.
| OPTION(*SHOWCPY) includes /COPY members in the listing; OPTION(*EXPDDS)
| includes externally described files. OPTION(*SRCSTMT) allows the program object
| to be debugged using the Statement Numbers instead of the Line Numbers of the
| compiler listing.
| Note: Some information that is available in the compiler listing will not appear on
| the listing view. For example, if you specify indentation in the compiler
| listing (via the INDENT parameter), the indentation will not appear in the
| listing view. If you specify OPTION(*SHOWSKP) in the compiler listing, the
| skipped statements will not appear in the listing view.
You create a listing view to debug a module by using the *LIST or *ALL options on
the DBGVIEW parameter for either the CRTRPGMOD or CRTBNDRPG commands
when you create a module.
The compiler creates the listing view while the module object (*MODULE) is being
generated. The listing view is created by copying the text of the appropriate source
168 ILE RPG for AS/400 Programmer's Guide