Debugging Programs › Set and Remove Breakpoints › Set Unconditional Breakpoints on the Source Listing

Set Unconditional Breakpoints on the Source Listing

To set an unconditional breakpoint on the program source listing, perform the following task:

1. Enter u in column 1 next to the offset where you want the breakpoint.
2. Press Enter.

The following screen shows how to set a breakpoint at the CP instruction at 1A6.

CA InterTest for CICS Release 9.1.00   - PROTSYM FILE  SOURCE LISTING DISPLAY            
COMMAND ===>                                                                    
Program= ASMDEMO  Option #       Stmt #        Displacement=        Margin= 01  
                                        Search=                                 
----------+-------------------------------------------------------------------- 
     Loc  Object Code    Addr1 Addr2  Stmt        Source Statement              
                    R:9  00000        1452          USING COMAREA,R9            
 _ 00018E                             1454 CONTINUE DS    0H                    
 _ 00018E 4150 01D5            001D5  1455          LA    R5,S2LEN              
 _ 000192 4050 D1B0            001B0  1456          STH   R5,MSGLEN             
 _ 000196 FA20 D189 4AE8 00189 02AE8  1457          AP    TASKNUM,=P'1'         
 _ 00019C F920 D189 4AE9 00189 02AE9  1458          CP    TASKNUM,=P'2'         
 _ 0001A2 4720 2328            00328  1459          BH    ENDMSG                
 u 0001A6 F920 D189 4AE8 00189 02AE8  1460          CP    TASKNUM,=P'1'         
 _ 0001AC 4780 227E            0027E  1461          BE    SENDSCR4              
 _ 0001B0 47F0 2328            00328  1462          B     ENDMSG                
 _ 0001B4                             1464 RETURN   DS    0H                    
                                      1465 *        EXEC CICS SEND FROM(OUTMSG  
                                      1466          DFHECALL =X'04043000080000  
   0001B4 4110 D068            00068                      ),(FB_2,OUTLEN)       
                                      1482 *        EXEC CICS SEND FROM(SCREEN  
                                      1483          DFHECALL =X'04043000080000  
   0001DA 4110 D068            00068                      2),(FB_2,MSGLEN)      
                                      1499 *        EXEC CICS RETURN

After you set a breakpoint, CA InterTest for CICS redisplays the screen with the U in uppercase. The U remains until you remove the breakpoint.

When you execute the program, CA InterTest for CICS stops the program at the unconditional breakpoint.

You can set breakpoints at any time—before you execute the program and when the program is stopped. Although where you decide to set breakpoints depends on the specifics of your program, you may want to set breakpoints at the following points:

• At the beginning of the program, so when the program executes you can set additional breakpoints
• At labels, so you can examine the contents of variables at the start of sections
• Before a CALL, so you can dynamically control the program path
• At each location named in an EXEC CICS HANDLE CONDITION, so you can verify error handling

To remove an unconditional breakpoint, type an x over the U and press Enter, or you can enter an r next to the breakpoint's entry on the Monitoring Status display (PF12 from any Source display). You want to remove breakpoints no longer needed so that when you retest the program, you are not stopped unnecessarily.