User interface to Code Debug TSO for PL/I

This section describes how to interact with Code Debug TSO in general. The screen formats, PF key assignments, command processing, and attention key processing are discussed.

Code Debug screens

Code Debug uses screens that are like ISPF/PDF, making theCode Debug menus and utility screens self-explanatory. The Source, Log, Show, and Memory screens have a similar format. The following figure displays a PL/I program in the Code Debug Source screen, and the PL/I Program Encountering an Abenddisplays a PL/I program on the same screen encountering an abend.

PL/I Program in the Source Screen

------------------------------ CODE DEBUG TSO - SOURCE ------------------------------
COMMAND ===>                                                   SCROLL===> CSR
PROGRAM: TRIMAIP1   MODULE: TRIMAIP   COMP DATE: 08/23/1995 COMP TIME: 12:15:45
        ** END **

------   ----------------------------------------- Before TRIMAIP1/AMODE 31 <>
=====> B TRIMAIP: PROC OPTIONS(MAIN);
------
000002         DCL INFILE INPUT RECORD;
000003         DCL MORE_RECORDS    BIT (1)
------
000004         DCL 1 IN_REC,
------               2 SIDES,
------                 3 SIDE_A     PIC’9’,
------                 3 SIDE_B     PIC’9’,
------                 3 SIDE_C     PIC’9’,
------               2 UNUSED       CHAR (77);
------
000005         DCL 1 WORK_REC ,
------               2 (SIDE_A, SIDE_B, SIDE_C) FIXED DEC(1);
------

The screen areas are described as:

Title

(line 1)—Identifies the screen name: Source, Log, Show, Memory, and so forth.

Command area

(line 2)—Primary command line, which can be increased to three lines using the SET CMDSIZE command.

Scroll amount

(line 2)—Indicates the current scroll amount. You can type over the current value with one of the following values:

1 to 9999	Scrolls by the number of lines or columns.
CSR or C	Scrolls based on the current position of the cursor.
DATA or D	Scrolls by one line or column less than PAGE.
HALF or H	Scrolls by a half page.
PAGE or P	Scrolls by one page.

Program

(line 3)—Identifies the CSECT currently displayed. This is an unprotected field and can be typed over with another program name.

Module

(line 3)—Displays the load module name.

Compile date

(line 3)—Displays the compile date.

Compile time

(line 3)—Displays the compile time.

PL/I Program Encountering an Abend

------------------------- CODE DEBUG TSO - SOURCE -----------------------------
COMMAND ===>                                                  SCROLL ===> CSR
   S0C7 ABEND ENCOUNTERED, USE "AA SNAP" COMMAND FOR ADDITIONAL INFORMATION
                          IN_REC @001FABC0
000011   01 WORK_REC                        > ...
000010      TRIANGLE_TYPE                   > +0                        PACKED
        ** END **

------   ------------------------------ S0C7 Abend at TRIMINP1:29/AMODE 31 <>
000028               TRIANGLE_TYPE = 0;
=====> B             CALL TRITSTP (WORK_REC,
------                            TRIANGLE_TYPE);
000030               TX = TRIANGLE_TYPE;
000031               N_CNTR(TX) = N_CNTR(TX) + 1;
000032            END;
000033         END ANALYZE_NEXT_REC;
------
000034         ENDING_PARA: PROC;
000035             CLOSE FILE(INFILE);
000036             CALL TRIRPTP (N_N_C_TABLE);
000037         END ENDING_PARA;
------
000038 A END TRIMAINP;
****************************** BOTTOM OF MODULE *******************************

Message area

(line 3 of above figure)—Displays short or informational messages. When a message is issued, it overlays the program information in line 3. Press Enter to flush the message and display the program information. Additional information can be accessed by pressing PF1 (HELP).

Keep window

(lines 4 - 8)—Automatically displays data referenced in the current statement; i.e., the statement where the execution arrow is located when the breakpoint takes effect. Explicitly kept data is also displayed. Explicitly kept items are denoted by a K in column 9 of the window.

The data in the window can be scrolled by moving the cursor to the Keep window and using the PF7 (UP) and PF8 (DOWN) keys to scroll vertically and the PF22 (DRIGHT) and PF23 (DLEFT) keys to scroll horizontally. You can also control the size of the window and, for automatic keeps, the placement of the automatically kept items. See to the SET command in Displaying Test Session Settings for additional information.

The SET AUTOKEEP ON/OFF command toggles the effect of the Automatic Keep function.

Execution status

(line 9)—Identifies the current execution point in your program. The <> shown at the end of this line indicates that the source can be scrolled to the left and/or right.

The execution status line may also display one or more of the following:

Whether execution is halted before or after the specified line
Program name
Abend code
24, 31, or 64 bit addressing mode.

Source area

As shown in both the above figures, the source area begins on line 10 and displays 68 to 70 bytes of the source code on the screen at a time. The source can be scrolled vertically using the PF7 (UP) and PF8 (DOWN) keys and horizontally using the PF10 (RIGHT) and PF11 (LEFT) keys. When an Automatic Keep window is visible, the data in the window can also be scrolled vertically using the PF7 and PF8 keys and horizontally using the PF22 and PF23 keys.

The After, Before, Onetime, Peek, and Skip indicators are displayed on the left side of the source in column 9. A 7-digit counter set by the COUNT command is displayed on the right side beginning at column 74.

PF Keys

The default settings for the 24 Code Debug PF keys are listed as follows. These values are valid during the Code Debug TSO session. ISPF PF keys are not affected. The ISPF KEYS command or the SET PFn command can be used to override the defaults.

Default Program Function (PF) Keys

PF Key	Default Setting	Description of Function
PF1/PF13	HELP	Elaborates a Code Debug TSO message and invokes the context-sensitive tutorial facility.
PF2	PEEK CSR	Displays the contents of the data name defined by the current cursor position. The cursor must be in the Source window under a valid data name.
PF14	FIND CSR	Finds the character string located under the cursor position.
PF3/PF15	END	Returns you to the previous menu if you are in the Log, Help, Browse, or Show functions.
PF4/PF16	EXIT	Ends the current Code Debug TSO session.
PF5	FIND	Repeats the action of the previous FIND command.
PF17	FIND IND	Scrolls the source display to successive levels of indirect references related to a previously entered FIND INDIRECT command.
PF6/PF18	LOCATE *	Scrolls the source display to the current location where execution was suspended.
PF7/PF19	UP	Scrolls the source or data in the Keep window up, or toward the top of the file.
PF8/PF20	DOWN	Scrolls the source or data in the Keep window down, or toward the bottom of the file.
PF9/PF21	GO 1	Executes the next logical instruction in your program, then pauses.
PF10	LEFT	Scrolls the source display to the left.
PF11	RIGHT	Scrolls the source display to the right.
PF12/PF24	GO	Starts or resumes execution of your program.
PF22	DLEFT	Scrolls data in an Automatic Keep, Keep, or Peek window to the left.
PF23	DRIGHT	Scrolls data in an Automatic Keep, Keep, or Peek window to the right.

Command processing

In interactive mode, the results of command execution are immediately visible on the source display.

Code Debug TSO commands can be entered in three ways:

Type the command in the primary command area and press Enter. Command stacking, delimited by a semicolon (;), is allowed.
The primary command area can be extended up to three lines by using the SET CMDSIZE command. The previous primary command can be recalled by entering a question mark (?).
Press the PF key that was assigned to the desired command. See to the above table for list of the PF key assignments.
Type over the 6-digit compiler-generated statement number with a valid line command and press Enter.

Code Debug TSO records the line command in the session log in the same manner as the primary command.

Lowercase Conversion

By default, commands entered in lowercase are converted to uppercase. To override the default, use the SET CAPS OFF command. Also, to display lowercase data, use the SET LOWCASE ASIS command.

Attention Key Processing

When you press the attention key while Code Debug or your application is executing, the message

ENTER ATTENTION OPTION OR HELP FOR LIST OF OPTIONS

is displayed. If you enter HELP, a screen containing information is displayed. Enter the option you want to perform.

Attention Key Processing Options

ENTER:
       PAUSE              TO DYNAMICALLY INVOKE THE PAUSE COMMAND
       EXIT               TO TERMINATE THE TEST SESSION
       LOG                TO DISPLAY THE LOG PRIOR TO TERMINATION
       PSW                TO DISPLAY THE CURRENT PSW ADDRESS
       GPREGS             TO DISPLAY THE CURRENT GENERAL PURPOSE REGISTERS
       STORAGE <address> TO DISPLAY STORAGE AT THE SPECIFIED ADDRESS
       WHERE              TO DISPLAY THE CURRENT MODULE AND OFFSET
       WHERE    <address> TO DISPLAY THE MODULE AND OFFSET OF <address>
       WHERE    <module> TO DISPLAY THE ADDRESS OF THE SPECIFIED MODULE
       GO                 TO RESUME TEST EXECUTION (or PRESS ENTER)

Important

The options listed on the screen will be different for MPP programs.

If pressing the Attention key interrupts an IMS Fast Path test and you then enter the EXIT command, Code Debug IMS will detach your IMS region and an S33E system abend will be reported as you return to the starting test panel. Message XPD1202 records the abend in the Code Debug session log.

Warning

In Code Debug IMS, do not press the attention key twice. When you do this, the session is terminated with the TSO default, and you are returned either to ISPF or native TSO. In addition, Code Debug IMS is not terminated normally; i.e., your data sets cannot be closed safely.

When you press the attention key while Code Debug is waiting for input (e.g., stopped at a breakpoint), the message

ATTENTION IGNORED - WAITING FOR TERMINAL INPUT

is displayed. If you press the attention key again, the message

ENTER ATTENTION TO TERMINATE OR ENTER TO CONTINUE

is displayed. Pressing attention again will take you to the READY prompt.