Testing Applications › Debug Trace Facility in the HE Environment › Action Diagram Trace Panel

Action Diagram Trace Panel

The Action Diagram Trace panel lets you trace the logic of your application at runtime. The Debug Trace Facility shows the action diagram for the procedure step or action block executing. The panel displays only if the procedure step or action block was generated with debug support.

-------------------------- APPLICATION DEVELOPMENT ------------- ENTER OPTION 
                            MENU Action Diagram Trace
COMMAND===>                                                   SCROLL===> HALF  
                                                                                
                  Action Block Name                 At Stmt #                   
                  --------------------------------  ---------                   
                  MENU                              DIALOG MGR                  
 ENTERING===>     ABBIL1                            35                  
                  ABBIL2                            47  

As your application executes, the corresponding action diagram statements are highlighted on the panel. The Debug Trace Facility highlights the statement about to be executed and pauses. Press Enter to continue the execution.

The Action Diagram Trace panel supports the following commands to navigate in the action diagram:

HELP, H, or ISPF Key PF1

Displays the online help

UP or ISPF Key PF7

Accepts an M parameter, or number of lines

DOWN or ISPF Key PF8

Accepts an M parameter, or number of lines

LOCATE or L

Accepts the statement number as a parameter

FIND or F

Accepts a string or enclosed in single quotes, as in 'string'

RFIND, R, or ISPF key PF5

Repeats the previously requested FIND command.

SKIP or SK

Bypasses executing the highlighted statement.

EXIT or X

Immediately returns the currently executing action block to the program that called it.

TRACE or T

Toggles the trace ON or OFF <UNTIL <GT|GE> stmt no>

When TRACE is OFF, the action diagram trace panel for this action diagram is not displayed. To resume the action diagram display, specify TRACE ON from an Action Block Call Trace Panel.

You can turn off trace until you reach a specific statement in the action diagram using the Trace Off Until Statement_number command. For example, to turn the trace off until you reach the statement number 12, use the command:

TRACE OFF UNTIL 12

To turn off trace until you reach at least statement number 15, use the command:

T OFF U GE 15

This command is useful to turn off trace, perhaps during a READ EACH, but you are not certain that statement 15 is executed. The tracing resumes on the next statement number that is 15 or greater.

Use the following commands to control the panel appearance of the panel.

HILIGHT or HI

Accepts the parameters REVERSE, BLINK, NORMAL, UNDERLINE

Highlights the statement about to execute as blinking, reverse video, underlined, or normal.

Default: reverse video.

COLOR or C

RED, BLUE, GREEN, WHITE, TURQ, PINK, YELLOW

Controls the color of the highlighted statement.

COLOR TEXT or C TEXT

RED, BLUE, GREEN, WHITE, TURQ, PINK, YELLOW

Controls the color of all statements other than the highlighted statement.