IBM CICS Transaction Server for OS/390 SC33-1686-02 - Manual (Page 59)

CEDF—execution diagnostic facility
Chapter 10. CEDF & CEDX — the execution diagnostic facility
The CICS execution diagnostic facility (EDF) provides two
transactions that you can use for testing application
programs. These transactions—CEDF and CEDX—enable
you to test application programs interactively without having
to supply special program testing procedures.
CEDF
Use CEDF to invoke EDF for testing application
programs that are associated with user transactions
initiated from a terminal.
CEDX
Use CEDX to invoke EDF for testing application
programs that are associated with non-terminal
transactions.
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
┌ ┐ ─,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 35 shows the initial screen for a typical
transaction using EDF.
TRANSACTION: ACCT PROGRAM: ACCT TASK: 54 APPLID: 1349 DISPLAY:
STATUS: PROGRAM INITIATION
EIBTIME = 11 343
EIBDATE = 89174
EIBTRNID = 'ACCT'
EIBTASKN = 54
EIBTRMID = ' 25L'
EIBCPOSN = 4
EIBCALEN =
EIBAID = X'7D' AT X' 543F1E'
EIBFN = X' ' AT X' 543F1F'
EIBRCODE = X' ' AT X' 543F21'
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
PF1 : PREVIOUS DISPLAY PF11: UNDEFINED PF12: UNDEFINED
Figure 35. CEDF transaction: initial screen
 Copyright IBM Corp. 1982, 1999 41