The function keys that you can use at each point are displayed in a menu at the bottom of every EDF display.
Functions that apply to all displays are always assigned to the same key, but definitions of some keys depend on the display and the intercept point. To select an option, press the indicated function key. Where a terminal has 24 function keys, EDF treats PF13 through PF24 as duplicates of PF1 through PF12. If your terminal has no PF keys, place the cursor under the option you want and press the ENTER key.
Abend codes that start with the character A are reserved for use by CICS®. Using a CICS abend code might cause unpredictable results.
You cannot use this function if an abend is already in progress, or the task is terminating.
In some cases, when a second program check occurs in the region before EDF has captured the values of the registers, this function does not appear on the menu of the abend display. If this situation occurs, a second test run might provide more information.
TRANSACTION: UT PROGRAM: ASRA31 TASK: 0000487 APPLID: IYK2ZKE1 DISPLAY: 00
ADDRESS: 0006F010
0006F010 000000 00000000 00000090 00000000 0010003C ................ 1
0006F020 000010 00000000 00041800 00000000 AE410028 ................ 1
0006F030 000020 00000000 2C2E35A8 00000000 00000000 .......y........ 1
0006F040 000030 00000000 2C2D7800 00000000 7F2C9918 ............".r. 1
0006F050 000040 00000000 2E410000 00000000 2C2D7818 ................ 1
0006F060 000050 00000000 00100008 00000000 00100100 ................ 1
0006F070 000060 00000000 009AF000 00000000 00100690 ......0......... 1
0006F080 000070 00000000 AE410158 00000000 00100690 ................ 1
0006F090 000080 079D0000 80000000 00000000 2E410178 ................ 2
0006F0A0 000090 00040004 00000000 00000000 00000000 ................
0006F0B0 0000A0 00000000 00000000 00000000 00000000 ................
0006F0C0 0000B0 00000000 00000000 00000000 00000000 ................
0006F0D0 0000C0 00000000 00000000 00000000 00000000 ................
0006F0E0 0000D0 00000000 00000000 D4F0F0F0 F0F4F8F9 ........M0000489
0006F0F0 0000E0 D4F0F0F0 F0F4F8F9 00000000 00000000 M0000489........
0006F100 0000F0 00000000 000000E4 E3404000 00F00000 .......UT ..0..
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
TRANSACTION: AC20 PROGRAM: DFH0VT1 TASK: 0086 APPLID: 1234567 DISPLAY: 00
DISPLAY ON CONDITION:-
COMMAND: EXEC CICS
OFFSET: X'......'
LINE NUMBER:
CICS EXCEPTION CONDITION: ERROR
ANY CICS CONDITION NO
TRANSACTION ABEND YES
NORMAL TASK TERMINATION YES
ABNORMAL TASK TERMINATION YES
DLI ERROR STATUS:
ANY DLI ERROR STATUS
ENTER: CURRENT DISPLAY
PF1 : UNDEFINED PF2 : UNDEFINED PF3 : UNDEFINED
PF4 : SUPPRESS DISPLAYS PF5 : WORKING STORAGE PF6 : USER DISPLAY
PF7 : UNDEFINED PF8 : UNDEFINED PF9 : UNDEFINED
PF10: UNDEFINED PF11: UNDEFINED PF12: REMEMBER DISPLAY
If you specify YES for ANY CICS CONDITION, EDF overrides the CICS exception conditions and redisplays a screen whenever any command results in a non-zero EIBRESP value such as NOTOPEN, EOF, or QBUSY.
When you use an offset for STOP CONDITIONS, you must specify the offset of the BALR instruction corresponding to a command. The offset can be determined from the code listing produced by the compiler or assembler. In COBOL, C, C++, or PL/I, you must use the compiler option that produces the assembler listing to determine the relevant BALR instruction.
When you use a line number, you must specify it exactly as it appears on the listing, including leading zeros, and it must be the line on which a command starts. If you have used the NUM or the SEQUENCE translator options, the translator uses your line numbers as they appear in the source. Otherwise, the translator assigns line numbers.
Line numbers can be found in the translator listing (SYSPRINT in the translator step) if you have used either the SOURCE or VBREF translator options. If you have used the DEBUG translator option, as you must to use line numbers for STOP CONDITIONS, the line number also appears in your compilation (assembly) listing, embedded in the translated form of the command, as a parameter in the CALL statement.
You can specify that EDF resumes displays at DL/I commands as well as at CICS commands. Type over the CICS qualifier on the command line with DLI and enter the type of DL/I command at which you want display suppression to stop. You must be running a DL/I program or have executed one earlier in the same task. You can suppress DL/I commands as early as the program initiation panel.
You can also stop display suppression when a particular DL/I status code occurs. For information about the status codes that you can use, see the list of codes in the DL/I interface block (DIB) in IMS: Application programming for EXEC DLI.
In DL/I command displays that contain the WHERE option, only the key values (the expressions that follow each comparison operator) can be converted to hexadecimal.
This function does not support 64-bit storage.
TRANSACTION: AC20 PROGRAM: DFH0VT1 TASK: 00030 APPLID: 1234567 DISPLAY:00
ADDRESS: 035493F0 WORKING STORAGE
035493F0 000000 E3F14040 00000000 00010000 00000000 T1 ...........
03549400 000010 00000000 00000000 F1000000 00000000 ........1.......
03549410 000020 F0000000 00000000 F0000000 00000000 0.......0.......
03549420 000030 F0000000 00000000 F0000000 00000000 0.......0.......
03549430 000040 00000000 00000000 00000000 00000000 ................
03549440 000050 D7C1D5D3 00000000 D9C5C3C4 00000000 PANL....RECD....
03549450 000060 D3C9E2E3 00000000 C8C5D3D7 00000000 LIST....HELP....
03549460 000070 84000000 00000000 A4000000 00000000 d.......u.......
03549470 000080 82000000 00000000 C4000000 00000000 b.......D.......
03549480 000090 E4000000 00000000 C2000000 00000000 U.......B.......
03549490 0000A0 D5000000 00000000 E2000000 00000000 N.......S.......
035494A0 0000B0 7B000000 00000000 6C000000 00000000 #.......%.......
035494B0 0000C0 4A000000 00000000 F1000000 00000000 ¢.......1.......
035494C0 0000D0 F2000000 00000000 F3000000 00000000 2.......3.......
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
The working storage contents are displayed in a form like that of a dump listing; that is, in both hexadecimal and character representation. The address of working storage is displayed at the top of the screen. You can browse through the entire area using the scroll commands, or you can enter a new address at the top of the screen. This address can be anywhere in the CICS region. The working storage display provides two additional scrolling keys, and a key to display the EIB (the DIB if the command is a DL/I command).
The meaning of working storage depends on the programming language of the application program, as follows:
Assembler language programs do not always acquire working storage; for example, it might not be required if the program does not issue CICS commands. When you LINK to such a program, the following message might be issued: Register 13 does not address DFHEISTG. This message does not necessarily mean an error, but there is no working storage to look at.
Except for COBOL programs, working storage starts with a 72 byte standard format save area; that is, registers 14 to 12 begin at offset 12, and register 13 is stored at offset 4. For AMODE(64) programs, working storage starts with a format 4 save area (F4SA); registers 14 to 12 begin at offset 8, and register 13 is stored at offset 128.
Working storage can be changed at the screen; ou can use either the hexadecimal section or the character section. You can type over the ADDRESS field at the head of the display with a hexadecimal address; storage starting at that address is then displayed when you press ENTER. You can examine any location in the address space. For more information, see Using EDF to change information.
If you are examining program storage that is not part of the working storage of the program currently running, which is unique to the particular transaction under test, the corresponding field on the screen is protected to prevent you from overwriting storage that might belong to or affect another task.
If the initial part of a working storage display line is blank, the blank portion is not part of working storage. This situation can occur because the display is doubleword aligned.
At the beginning and end of a task, working storage is not available. In these circumstances, EDF generates a blank storage display so that you can still examine any storage area in the region by typing over the address field.
If you terminate a PL/I or Language Environment® program with an ordinary non-CICS return, EDF does not intercept the return, and you cannot see working storage. If you use a RETURN command instead, you get an EDF display before execution and at program termination.
If you are using a Language Environment-enabled program, working storage is freed at program termination if the program is terminated using a non-CICS return. In this case, working storage is not available for display.