CEDF allows you to intercept your application programs at the program’s initiation, at each CICS command, and at the program termination. CEDF helps you to isolate and focus on problems in your application programs.
For information on how to use the CEDF transaction, see the CICS® Application Programming Guide.
You must ensure that the EDF resource definitions are installed. These resource definitions are provided in the IBM-supplied group, DFHEDF. For information about installing the resource definitions, see the CICS Resource Definition Guide.
You must also ensure that the terminal from which you run EDF is in transceive (ATI/TTI) status.
CEDF .-,ON--. >>-CEDF--+-----------+--+------+------------------------------->< +-termid----+ '-,OFF-' +-sysid-----+ '-sessionid-'
CEDF T33A
CEDF T33A ,OFF
CEDF ,OFF
CEDF T33A
CEDF ,ON
To start an EDF session with a single terminal, clear the screen and enter the transaction identifier, CEDF. The EDF inputs and outputs are interleaved with those of the transaction. This is known as single-screen mode.
CEDF
When you press ENTER, the response is:
THIS TERMINAL: EDF MODE ON
Now clear the screen and enter the name of your transaction. Figure 47 shows the initial screen for a typical transaction using EDF.
TRANSACTION: ACCT PROGRAM: ACCT00 TASK: 0000054 APPLID: 00001349 DISPLAY: 00 STATUS: PROGRAM INITIATION EIBTIME = 110343 EIBDATE = 89174 EIBTRNID = 'ACCT' EIBTASKN = 54 EIBTRMID = '025L' EIBCPOSN = 4 EIBCALEN = 0 EIBAID = X'7D' AT X'00543F1E' EIBFN = X'0000' AT X'00543F1F' EIBRCODE = X'000000000000' AT X'00543F21' EIBDS = '........' + EIBREQID = '........' ENTER: CONTINUE PF1 : UNDEFINED PF2 : SWITCH HEX/CHAR PF3 : END EDF SESSION PF4 : SUPPRESS DISPLAYS PF5 : WORKING STORAGE PF6 : USER DISPLAY PF7 : SCROLL BACK PF8 : SCROLL FORWARD PF9 : STOP CONDITIONS PF10: PREVIOUS DISPLAY PF11: UNDEFINED PF12: UNDEFINED
You can also use EDF in what is known as dual-screen mode; that is, using one terminal to monitor a transaction running at a second terminal.
This mode is started by adding the terminal identifier (termid) of the second terminal to the CEDF command at the first terminal:
CEDF tttt
The message that CEDF gives in response to this depends on whether there is already a transaction running on the second terminal. If the second terminal is not busy, the message displayed at the first terminal is:
TERMINAL tttt: EDF MODE ON
and nothing further will happen until a transaction is started on the second terminal, when the PROGRAM INITIATION display will appear.
If a transaction is already running on the second terminal, the message displayed at the first terminal is:
TERMINAL tttt: TRANSACTION RUNNING: EDF MODE ON
CEDF then picks up control at the next command processed and presents the appropriate display. At the first terminal, you can then follow the sequence of commands in the transaction running at the second terminal.
In a multiregion operation (MRO) or an intersystem communication (ISC) environment (APPC only), you can use CEDF (in single screen mode only) for transactions that are defined in the terminal owning region (TOR) as remote. CICS automatically notifies the application owning region (AOR) that the transaction is to be run in EDF mode.
When the remote application ends, if your reply is YES, the terminal remains in EDF mode as usual. However, CICS deletes all the associated temporary storage queues, and none of the previous EDF screens or options is saved: you must type these again for the next transaction. Responding NO at the termination screen ends the EDF session in all participating regions.
See Figure 48 for an example of the screen from which CEBR and CECI can be invoked.
TRANSACTION: DLID PROGRAM: DLID TASK: 0000049 APPLID: IYAHZCIB ADDRESS: 00000000 WORKING STORAGE IS NOT AVAILABLE ENTER: CURRENT DISPLAY PF1 : UNDEFINED PF2 : BROWSE TEMP STORAGE PF3 : UNDEFINED PF4 : EIB DISPLAY PF5 : INVOKE CECI PF6 : USER DISPLAY PF7 : SCROLL BACK HALF PF8 : SCROLL FORWARD HALF PF9 : UNDEFINED PF10: SCROLL BACK FULL PF11: SCROLL FORWARD FULL PF12: REMEMBER DISPLAY
To invoke the CEBR transaction from the CEDF screen, press PF2. You can then use CEBR commands to browse temporary storage queues and to delete them. (CEBR commands are described briefly in CEBR--temporary storage browse; for detailed guidance on using them, see the CICS Application Programming Guide.)
To invoke the CECI transaction from the CEDF screen, press PF5. You can then use CECI commands to display or alter resource status. (CECI commands are described briefly in CECI--command-level interpreter; for detailed guidance on using them, see the CICS Application Programming Guide.)