Action Diagram Trace Panel

Testing Applications › Debug Trace Facility › Action Diagram Trace Panel

Action Diagram Trace Panel

The Action Diagram Trace panel allows you to trace the logic of your application at runtime. The Debug Trace Facility shows the action diagram for the procedure step or action block being executed. (The panel is displayed only if the procedure step or action block was generated with debug support).

    PSCUSTOM Action Diagram Trace
COMMAND ===>      SCROLL ===> HALF
STMT PAD STATEMENT
---- --------------------------------------------
00000 +-> MENU  09/27/01  15:27
00000  |     IMPORTS:   Entity View input ief_supplied
00000  |  selection    FROM output ief_supplied
00000  | Entity View input control_ account
00000  |               account number FROM output control_account
00000  |               corporate_id    FROM output control_account
00000  |     EXPORTS:   Entity View output ief_supplied
00000  |         selection
00000  |          Entity View output control_account
00000  |        account_number
00000  |       corporate_id
00000  |     PROCEDURE STATEMENTS
00001  |
00002  |     MOVE input control_account TO output control_account
00003  |

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 the Enter key to continue execution.

Several commands are available to you from the Action Diagram Trace panel. These commands let you navigate within the action diagram and are explained in the following table:

Command	Abbr.	ISPF PF Key	Parameter	Note
HELP	H	F1
UP		F7	M, or number of lines
DOWN		F8	M, or number of lines
LOCATE	L	--	statement number
FIND	F	--	string ‘r 'str’ng'
RFIND	R	F5		RFIND repeats the previously requested FIND command.
SKIP	SK			SKIP causes the execution of the highlighted statement to be bypassed.
EXIT	X			EXIT causes the currently executing action block to return immediately to the program from which it was called.
TRACE	T	--	ON or OFF <UNTIL <GT/GE> stmt no>	TRACE lets you turn the action diagram trace on and off. If TRACE is OFF, the action diagram trace panel for this action diagram is not displayed. To resume the action diagram display, you must specify TRACE ON from an Action Block Call Trace Panel. You can also request the trace be turned off 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 statement number 12, you would enter: TRACE OFF UNTIL 12. To turn trace off until you reach at least statement number 15, you could enter: T OFF U GE 15. This feature is useful when you want to turn trace off (perhaps during a READ EACH) but you are not certain that statement 15 will be executed. Tracing will resume on the next statement number that is 15 or greater.

The commands in the following table can be used to control the appearance of the panel:

Command	Abbr.	ISPF PF Key	Parameter	Note
HILIGHT	HI	--	REVERSE, BLINK, NORMAL, UNDERLINE	The statement about to be executed is highlighted (blinking, reverse video, underlined, normal) on the panel. The default is reverse video.
COLOR	C	--	RED, BLUE, GREEN, WHITE, TURQ, PINK, YELLOW	COLOR controls the color of the highlighted statement.
COLOR TEXT	C TEXT	--	RED, BLUE, GREEN, WHITE, TURQ, PINK, YELLOW	COLOR TEXT controls the color of all statements other than the highlighted statement.