IBM AS/400 manual a Listing View, Creating a COPY Source, Preparing a Program for Debugging

Models: AS/400

1 489
Download 489 pages 47.95 Kb
Page 192
Image 192

Preparing a Program for Debugging

Creating a COPY Source

 

View

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

A COPY

source

view

 

contains

text

from

the root

source

 

member,

as

well

a

text

of

all

/COPY

members

expanded

into the text of the source. Whe

COPY view, you can debug the root

source member

of

the

program

using

source

view

and

 

the

/COPY

members

of

the

program

using

the

COPY

 

source

The

view

of the root source member

generated by

DBGVIEW(*COPY)

 

is

th

view generated by DBGVIEW(*SOURCE).

As with the root source view, a C

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

option

on

the

DBGVIEW

parameter.

 

 

 

 

 

 

 

 

 

 

 

 

 

The compiler creates the COPY view

while

the

module

 

object

(*MODULE)

is

compiled. The COPY view is created

using references to locations of t

source members (both root source

member and /COPY members) rather than

copying the text of the members into the view. For

this

reason,

you

modify, rename, or move source members between the

 

time

 

the module

ob

created

and

the

debugging of

the

module

created

from

these

members.

the

views

for

these

source

members

may

not

be

usable.

 

 

 

 

 

For example, to create a source view of a program TEST1 that contains 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 sou

view with

/COPY

members

for

debugging module TEST1. By default, a compil

listing is

produced. The compiler listing will include /COPY members as w

OPTION(*SHOWCPY) is

a default

value.

Creating

a Listing View

 

 

 

 

 

 

 

 

 

 

 

 

 

A listing view contains

text

similar to the

text in the compiler listing th

produced by the ILE RPG compiler. The information contained in the lis

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

ob

to be debugged using the Statement Numbers instead

of

the

Line

Numbe

compiler

listing.

 

 

 

 

 

 

 

 

 

 

 

 

Note:

Some

information

that

is available

in

the

compiler

listing

will

not

a

 

the listing view. For example, if

you

specify

indentation in

the

 

listing (via the INDENT parameter),

the indentation will not appear

 

listing view. If you specify OPTION(*SHOWSKP) in

the

compiler

listin

 

skipped statements will not appear

in the

listing

view.

 

 

 

 

You

create a listing view to debug a

module by using the *LIST or *A

 

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) generated. The listing view is created by copying the text of the

168 ILE RPG for AS/400 Programmer's Guide

Page 192
Image 192
IBM AS/400 manual a Listing View, Creating a COPY Source, Preparing a Program for Debugging