Using Breakpoints › Unconditional Breakpoints › Set Unconditional Breakpoints from the Source Listing

Set Unconditional Breakpoints from the Source Listing

While you are viewing your source listing (either before execution or during a breakpoint), set unconditional breakpoints directly in your program code, or indirectly from the Procedure Names and Cross‑Reference sections of the output.

To set an unconditional breakpoint from a Source Listing or Breakpoint screen, follow these steps:

1. Enter u in position 1 of the line in the program listing where you want the breakpoint set, but do not press Enter. (You can enter more than one u at a time). Enter u next to the following:
   • A line of executable code
   • A COBOL paragraph name
   • An Assembler label
   • A PL/I label

   A breakpoint set at a paragraph name or label occurs before execution of the first verb or instruction in the paragraph.

2. Optionally, and before pressing Enter, use the Option # field and enter 12 (Bkpt Options) to access the menu for specifying breakpoint options to your unconditional breakpoints. These options let you specify:
   • If the program should stop at this breakpoint before statement execution (default) or after statement execution
   • How often the program should stop at this breakpoint (every nth time, instead of every time)
   • The terminal where breakpoints take effect
   • The terminal that receives the breakpoints
   • Indirect commands statement numbers to execute at this breakpoint
   • The user ID (or .ANY) that executes the program
3. Press Enter to set the breakpoints. CA InterTest for CICS flags each unconditional breakpoint with U.

   If you used Option # 12 to set Breakpoint Options, the Breakpoint Locations Menu appears. Using this menu specify your options for the breakpoint. Complete the menu. For details, see n later in this chapter. After completing this menu, press Enter to set the breakpoint and return to the Source Listing display or breakpoint.

The following sample screen shows how to set unconditional breakpoints.

              CA InterTest ‑ PROTSYM FILE SOURCE LISTING BREAKPOINT             
COMMAND ===>                                                                    
Program= COBDEMO  Option #       Stmt #                             Margin= 01  
                                        Search=                                 
OPTS 1 Proc div  2 Work-stor 3 Link sect 4 D-map      5 Clst/Pmap More:   + 
     6 Data xref 7 Proc xref 8 Err msgs  9 Srch fwd  10 Srch bwd            
PFKS 1 Help      2           3 Det Bkpt  4 Profile    5 Resume     6 Menu      
     7 Backward  8 Forward   9           10 001 Verb  11 Backtrace 12 Status    
‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑ 
 _ 01205     PERFORM CICS‑LOOP 50 TIMES.                                       
 _ 01206     GO TO MXS‑OPTION.                                                 
 u 01207 CICS‑LOOP.                                                            
   01208*EXEC CICS ASKTIME                                                      
   01209*          END‑EXEC.                                                   
 _ 01210      MOVE '         00849   ' TO DFHEIV0                               
 u 01211     CALL 'DFHEI1' USING DFHEIV0.                                      
   01212                                                                        
 u 01213 MXS‑OPTION.                                                           
 _ 01214     IF  TASK‑SWITCH3 EQUAL SPACE                                       
 _ 01215         MOVE 'A' TO TASK‑SWITCH3                                       
 _ 01216         MOVE 'DMAP06' TO MAPNAME                                       
 _ 01217         GO TO SEND‑REWRITE‑RETURN.                                    
   01218*EXEC CICS HANDLE CONDITION     
   01219*          NOSTG(NO‑STORAGE)  

Note: If you want to recompile your program and keep the same breakpoints in the recompiled version, set breakpoints next to paragraph names or labels, not lines of executable code. Then, use the CA InterTest for CICS New Program Copy function, explained in the chapter "Monitoring Menu Options," to transfer the breakpoints to the same paragraph names or labels in the recompiled program. If you set breakpoints at lines of executable code, New Program Copy transfers the breakpoints to the same statement numbers or offsets in the recompiled program, which might not be what you want.

If you compiled or assembled your program with the post‑processor parameter value, LISTER=ALL, you can set unconditional breakpoints using the Cross‑Reference section. This method sets breakpoints at all references to the selected data name. To use this method, follow these steps:

1. Display the Cross‑Reference section using the Option # field.
2. Enter u in column 1 next to the data name.
3. Press Enter to set the breakpoints. CA InterTest for CICS sets the breakpoints at all references to the COBOL, Assembler, or PL/I data name. Then, CA InterTest for CICS displays the U‑breakpoint indicators in the Cross‑Reference section and on the lines in the Procedure Division or CSECT where the data name is referenced.

To set breakpoints at specific paragraph names, labels, or procedure names, follow these steps:

1. Display the Cross‑Reference section using the Option # field; see the chapter "Source Listing Facility."
2. Enter a u next to the:
   • Specific paragraph name, label, or procedure name in the COBOL Cross‑Reference listing
   • Symbol line in the Cross‑Reference section of the Assembler listing
   • Specific label or procedure name in the Xref section of the PL/I listing
3. Press Enter. The breakpoints apply to the specific paragraph names, labels, or procedure names.

   The following screen shows how to set breakpoints at Procedure Names.

          CA InterTest ‑ PROTSYM FILE SOURCE LISTING DISPLAY                
COMMAND ===>                                                                    
Program= COBDEMO  Option #       Stmt #                             Margin= 01  
                                        Search=                                 
OPTS 1 Proc div  2 Work-stor 3 Link sect 4 D-map      5 Clst/Pmap More:   + 
     6 Data xref 7 Proc xref 8 Err msgs  9 Srch fwd  10 Srch bwd            
PFKS 1 Help      2           3 End       4 Profile    5 Monitor    6 Menu      
     7 Backward  8 Forward   9           10           11           12 Status    
‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑ 
 _ PROCEDURE NAMES                 DEFN     REFERENCE                           
 u AFTER‑REWRITE                   01328                                        
 _ CICS‑LOOP                       01207  01205                                 
 _ CONTINUE‑TASK                   00895  00824 00888                           
 _ DATA‑NAME                       01080                                        
 u DO‑READ‑VAR                     01099  01096                                 
 _ EXPANDED‑DEMO                   00971  00821 00892 00893                     
 _ GEN‑ERR                         01289  00802 00854 01047                     
 _ LAST‑SCREEN                     00954  00947                                 
 _ LINK‑COBDEML                    01381  01372                                 
 u LOOP‑RTN                        01204                                        
 _ MOVE‑RECORD                     01148                                        
 _ MXR‑OPTION                      01199  01372

To set breakpoints at all paragraph names, labels, or procedure names, follow these steps:

1. Display the Procedure Names section using the Option # field.
2. Enter a u next to the:
   • Procedure‑Names line in the COBOL Cross‑Reference listing
   • Symbol line in the Cross‑Reference section of the Assembler listing
   • Declare line in the Xref section of the PL/I listing
3. Press Enter.
4. When prompted, press PF3 to confirm the request for multiple breakpoints. The breakpoints apply to all paragraph names, labels, or PL/I procedures.

For more information:

Monitoring Menu Options

Source Listing Facility