IBM AS/400 Obtaining a Dump, Obtaining an ILE RPG Formatted Dump, Using the DUMP Operation Code

Models: AS/400

1 489
Download 489 pages 47.95 Kb
Page 275
Image 275
Using the DUMP Operation Code

Using the DUMP Operation Code

Chapter 13. Obtaining a Dump

This chapter describes how to obtain an ILE RPG formatted dump and sample formatted dump.

Obtaining an ILE RPG Formatted Dump

To

obtain an ILE RPG

formatted dump

(printout

of

storage) for a pro

is

running,

you

can:

 

 

 

 

¹

Code one

or

more

DUMP operation

codes in

the

calculation specific

¹Respond to a run-time message with a D or F option. It is also automatically reply to make a dump available. Refer to the “System

discussion in CLtheProgramming

manual.

The formatted dump includes field contents, data structure contents, contents, the file information data structures, and the program status The dump is written to the file called QPPGMDMP. (A system abnormal du written to the file QPSRVDMP.)

If you respond to an ILE RPG run-time message with an F option, the includes the hexadecimal representation of the open data path (ODP, agement control block).

The dump information includes the global data associated with

the

m

Depending

on

whether

the

main procedure is active, the global

data

 

sent

the

values

assigned

during

processing

of

the

*INZSR.

If

a prog

more

than

one

procedure,

the information in the formatted

dump

also

r

mation

aboutevery procedure

that

is active

at

the

time

of

the

dump

 

procedure

is

not

active,

the

values of

variables

in automatic

storag

valid.

If

a

procedure

has not been called yet,

the

static

storag

yet. If a procedure has been called recursively, only

the

informat

recent invocation

will

be

shown.

 

 

 

 

 

 

 

 

Note: To obtain a dump of variable data, the program object must ha data. That is, it must be created with any debug view excep debug data is available, then the dump will still contain the PS information.

Using the DUMP Operation Code

You can code one or more DUMP operation codes in the calculations o source to obtain a ILE RPG formatted dump. A new QPPGMDMP spool file created whenever the DUMP operation occurs.

Note the following about the DUMP operation:

¹

The

DUMP

operation runs

(is

active) only

if

keyword DEBUG(*YES)

is

 

on the control specification. If the keyword is not specified,

 

specified, the DUMP operation is checked

for errors

and

the

sta

 

printed

on the

listing,

but

the DUMP is not processed.

 

 

¹

If

the

DUMP

operation

is

conditioned,

it

occurs only

if

the

cond

Copyright IBM Corp. 1994, 1999

251

Page 275
Image 275
IBM AS/400 manual Obtaining a Dump, Obtaining an ILE RPG Formatted Dump, Using the DUMP Operation Code