IBM AS/400 manual Creating a Root Source View, for Debugging, CRTRPGMOD or

Preparing

a

Program

for Debugging

Table

13. Debug Views

Debug View

Debug

Data

DBGVIEW

Param-

eter

Value

None

No

debug

data

*NONE

Statement view

No source displayed (use statement

*STMT

(default)

numbers in source section of compiler

listing)

Root

source

Root

source member information

*SOURCE

view

COPY

source

Root source member and /COPY members*COPY

view

information

Listing view

Compiler listing

(dependent

on

OPTION *LIST

parameter)

All

Data

from

root

source,

COPY

source,*ALL and

listing

views

Creating a Root Source View

A root source view contains text from the root source member. This view contain any /COPY members. Furthermore, it is not available if the roo member is a DDM file.

You

create a

root

source

view

to

debug a module

by using

the

*SO

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

being

compiled.

The

root

source

view is created using references

t

text in the root source member

rather

than

copying

the

text

of

th

module

object.

For this reason, you should not modify, rename, or

mov

source

members

between

the

module

creation

of these

members

and

th

ging of the module created from

these

members.

If

you

do,

the

vi

source

members

may

not be

usable.

For example, to create a root source view for a program DEBUGEX wh 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 view for debugging module DBGEX. By default, a compiler listing with members and expanded DDS, as well as other additional information is

Chapter 11. Debugging Programs167