ILE COBOL Programmer's Guide

Using a Source View

A source view contains references to the source statements of the source member.

To use the source view with the ILE source debugger, the ILE COBOL compiler creates references to the source member while the module object (*MODULE) is being created.

Note:
The module object is created using references to locations of the source statements in the root source member instead of copying the source statements into the view. Therefore, you should not modify, rename, or move root source members between the creation of the module and the debugging of the module created from these members.

In order to debug an ILE COBOL module object using a source view, use the *SOURCE or *ALL value on the DBGVIEW parameter for either the CRTCBLMOD or CRTBNDCBL commands.

One way to create a source view, is as follows:

CRTCBLMOD MODULE(MYLIB/xxxxxxxx)
SRCFILE(MYLIB/QCBLLESRC) SRCMBR(xxxxxxxx)
TEXT('CBL Program') DBGVIEW(*SOURCE)

When you generate the source view by specifying DBGVIEW(*SOURCE) on the CRTCBLMOD or CRTBNDCBL commands, the size of the created module object is increased because of the source view but the size is smaller than that generated with the listing view. The size of the generated module object will be the same as for the statement view. The source view does not provide any expansions made by the ILE COBOL compiler when it creates the module object or program object. The source view depends on the unchanged existence of the source member. Any changes made to the source member will affect the source view.

If the source member contains multiple compilation units, the source view will contain the source code of all of the compilation units, even if only one of them can be debugged. However, any debug commands issued from the Display Module Source display will be applied only to the compilation unit being debugged.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]