Using the CEDF transaction

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.

Command syntax

Read syntax diagramSkip visual syntax diagramCEDF
 
                        .-,ON--.
>>-CEDF--+-----------+--+------+-------------------------------><
         +-termid----+  '-,OFF-'
         +-sysid-----+
         '-sessionid-'
 

Command options

OFF
specifies whether the EDF screen is to be switched OFF. If you specify OFF you must enter the preceding comma, as shown in the following examples:
CEDF T33A
CEDF T33A ,OFF
CEDF ,OFF
ON
specifies whether the EDF screen is to be switched ON. The default is ON. If you specify ON you must enter the preceding comma, as shown in the following examples:
CEDF T33A
CEDF ,ON
sessionid
specifies the session identifier used to test a transaction attached across an MRO, APPC, or LU6.1 session. All CICS commands processed by the attached transaction are monitored.
sysid
specifies the system identifier used to test a transaction across an MRO or APPC session.
termid
specifies the identifier of the terminal on which the transaction to be tested is being run. If you do not provide an identifier, the terminal at which you enter the CEDF transaction is assumed.

Beginning an EDF session (single-screen mode)

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.

Figure 47. CEDF transaction: initial screen
  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

Beginning an EDF session (dual-screen mode)

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.

Monitoring remote transactions

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.

Note:
CICS supports EDF for remote transactions only when all the communicating regions are using CICS/ESA.

Invoking CEBR and CECI from CEDF

See Figure 48 for an example of the screen from which CEBR and CECI can be invoked.

Note:
If you are not authorized to use the CEBR or CECI transaction by the external security manager, a warning message will appear on the EDF panel. See the CICS RACF® Security Guide for information about security checking of transactions running under CEDF.
Figure 48. Typical EDF display from which CEBR or 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.)

Related tasks
Using CICS supplied transactions
the CICS Application Programming Guide
CEDF & CEDX -- the execution diagnostic facility
Using the CEDX transaction
[[ Contents Previous Page | Next Page Index ]]