Restrictions when using EDF

User application programs that are to be debugged using EDF must be assembled (or compiled) with the translator option EDF, which is the default. If you specify NOEDF, the program cannot be debugged using EDF. There is no performance advantage in specifying NOEDF, but the option can be useful to prevent commands in well debugged subprograms appearing on EDF displays.

Start of changeApplication programs that are to be debugged using EDF must also have the attribute CEDF(YES) in their resource definition, which is the default. If a program is defined with CEDF(YES) and compiled with the translator option EDF, EDF diagnostic screens are displayed for the program. If the program is defined with CEDF(YES) but compiled with the translator option NOEDF, only the program initiation and termination screens are displayed. If CEDF(NO) is specified, no EDF screens are displayed.End of change

Start of changeIf a program with the attribute CEDF(NO) links to a program with the attribute CEDF(YES), it might not be possible to use EDF for the transaction. For example, if the CICSPlex SM dynamic transaction routing program EYU9XLOP is defined with the attribute CEDF(NO), and the user-replaceable program EYU9WRAM (for workload management processing) is defined with the attribute CEDF(YES), you cannot use EDF to debug EYU9WRAM. For successful debugging of multiple programs within a transaction, ensure that all the programs are defined with CEDF(YES).End of change

There are some restrictions on the use of EDF that make it preferable or even necessary to use one particular screen mode:

Other restrictions apply to both screen modes:

Start of change

OPEN TCBs and EDF

Even if your program would normally run using an OPEN TCB (L8, L9, X8, or X9) CEDF forces the program to run on the QR TCB, because CEDF itself is not threadsafe.

End of change

Parameter list stacking

CEDF only has one level of stacking for its copies of the EXEC CICS parameter list. This means that if an application calls an EXEC-capable global user exit or user-replaceable module (URM), the parameter list for the EXEC CICS commands issued by the global user exit or URM may overlay the parameter list for EXEC CICS commands issued by the main program.

Security considerations

EDF is such a powerful tool that your installation may restrict its use with attach-time security. (The external security manager used by your installation defines the security attributes for the EDF transaction.) If this has been done, and you are not authorized to use CEDF, you cannot initiate the transaction.

For guidance on using security, see your system programmer or the CICS RACF Security Guide.

[[ Contents Previous Page | Next Page Index ]]