You can use the execution diagnostic facility (EDF) to test an application program online, without modifying the program or the program-preparation procedure. The CICS® execution diagnostic facility is supported by the CICS-supplied transaction, CEDF, which invokes the DFHEDFP program.
The names of your programs should not begin with the letters "DFH" because this prefix is used for CICS system modules and samples. Attempting to use EDF on a CICS-supplied transaction has no effect. However, you can use EDF with CICS sample programs and some user-replaceable modules. (For example, you can use EDF to debug DFHPEP.)
EDF intercepts the execution of CICS commands in the application program at various points, allowing you to see what is happening. Each command is displayed before execution, and most are displayed after execution is complete. Screens sent by the application program are preserved, so you can converse with the application program during testing, just as a user would on a production system.
When a transaction runs under EDF control, EDF intercepts it at the following points, allowing you to interact with it:
If you want to work through an example of EDF, see Designing and Programming CICS Applications, which guides you through a sample EDF session.
Each time EDF interrupts the execution of the application program a new CEDF task is started. Each CEDF task is short lived, lasting only long enough for the appropriate display to be processed.
The terminal that you are using for the EDF interaction must be in transceive (ATI/TTI) status and be able to send and receive data. This is the most common status for display terminals, but you can find out by asking your system programmer to check its status, or you can use CEMT.
For a transaction initiated at a terminal, you can use EDF on the same terminal as the transaction you are testing, or on a different one. On the same terminal, you must start by clearing the screen and entering the transaction code CEDF, otherwise you may get unpredictable results. The message THIS TERMINAL: EDF MODE ON is displayed at the top of an empty screen. You clear the screen again and run your transaction in the normal way.
When you are using EDF, the user task is not directly purgable. If you need to terminate the task, first forcepurge the CEDF task, then attempt to press the Enter key while the EDF screen is displayed. If pressing the Enter key brings no response, forcepurge the CEDF task a second time. CEDF will terminate, and the user transaction will receive an AED3 abend.
This chapter describes:
[[ Contents Previous Page | Next Page Index ]]