Execution diagnostic facility (EDF)

When you use the CICS® command-level programming interface, you can use the execution diagnostic facility (EDF) to step through the CICS commands of an application program. This program can be part of a local or remote transaction. At each step, you can check the validity of each command and make temporary modifications to the program.

Design overview

Application programmers can use EDF to test a command-level application program online without making any modifications to the source program or the program preparation procedure. EDF intercepts execution of the application program at certain points and displays relevant information about the program at these points.

The EDF can be called at the following points in the EXEC interface program (DFHEIP or DFHEIG):
  • When program initialization has completed, just before control is passed to the application entry point
  • During program termination, just after control is been received from the application
  • Before a normal EXEC command is passed to its processor module
  • When a normal EXEC command returns to DFHEIP or DFHEIG

Modules

Module Function
DFHEDFBR You can use the temporary-storage browse transaction (CEBR) to browse, copy, or delete items in a queue. CEBR calls DFHEDFBR to run the required action.
DFHEDFD EDF display program that provides the user interaction.
DFHEDFM EDF map set that consists of three maps: DFHEDFM, DFHEDFN, and DFHEDFP.
DFHEDFP EDF control program that provides the CEDF transaction for starting EDF. It controls the debugging task and sets debug mode on or off.
DFHEDFR EDF response table that is used by DFHEDFD to interpret the responses obtained by EXEC commands.
DFHEDFX EDF task switch program that attaches the debugging task, providing all required information about the status of the user task. It also suspends the user task until the debugging task allows it to resume.

Exits

No global user exit points are provided for this function.

Trace

No trace points are provided for this function.