FINDBP command

The FINDBP command provides full-screen search capability for line, statement and offset breakpoints in the source object. The FINDBP keyword cannot be abbreviated.

Read syntax diagramSkip visual syntax diagramFINDBP FIRSTLASTNEXTPREV ENABLEDDISABLED ;
FIRST
Starts at the beginning of the source object and searches forward to find the first line, statement, or offset breakpoint.
LAST
Starts at the end of the source object and searches backward to find the last line, statement, or offset breakpoint.
NEXT
Starts at the next line after the current cursor location in the Source window and searches forward to find the next line, statement, or offset breakpoint
PREV
Starts at the previous line before the current cursor location in the Source window and searches backward to find the previous line, statement, or offset breakpoint
ENABLED
Restricts the searching to enabled breakpoints. The default is to list both enabled and disabled breakpoints.
DISABLED
Restricts the searching to disabled breakpoints. The default is to list both enabled and disabled breakpoints.

Usage notes

  • If no operands are specified, a repeat FINDBP is performed. A repeat FINDBP behaves in the following ways:
    • If the previous FINDBP command that you entered specified or implied the FIRST or NEXT parameter, z/OS® Debugger uses the NEXT parameter.
    • If the previous FINDBP command that you entered specified or implied the LAST or PREV parameter, z/OS Debugger uses the PREV parameter.
    • If a repeat FINDBP immediately follows an unsuccessful FINDBP or repeat FINDBP, z/OS Debugger continues searching, wrapping from the last line to the first line. If the original direction of the FINDBP was backward to the beginning of the source object, z/OS Debugger wraps from the first line to the last line.
    • If the previous FINDBP command that you entered specified or implied the ENABLED or DISABLED parameter, z/OS Debugger uses the ENABLED or DISABLED parameter, respectively.
    • If you want to frequently use a repeat FINDBP, set a PF key (for example, PF17 or shift PF5) to FINDBP. For instructions on assigning a command to a PF key, see SET PFKEY command.
  • Searches show the following behavior:
    • If you specify FIRST, the search begins at the first line of the source object.
    • If you specify LAST, the search begins at the last line of the source object.
    • If you specify NEXT or the command defaults to NEXT and the cursor is on a source line or in its prefix or suffix area, the search begins at the line after the line the cursor is on.
    • If you specify NEXT or the command defaults to NEXT and the cursor is not on a source line or in its prefix or suffix area, the search begins at the first line in the Source window.
    • If you specify PREV or the command defaults to PREV and the cursor is on a source line or in its prefix or suffix area, the search begins at the line before the line the cursor is on.
    • If you specify PREV or the command defaults to PREV and the cursor is not on a source line or in its prefix or suffix area, the search begins at the line before the first line in the Source window. If the first line of the source object is displayed, z/OS Debugger wraps to the end of the source object and continues with the last source line.
    • If z/OS Debugger finds the breakpoint, z/OS Debugger scrolls the Source window so that you can see the breakpoint. z/OS Debugger places the cursor at the beginning of the prefix area for the source line that contains the breakpoint.
    • If z/OS Debugger does not find the breakpoint, the screen does not change and the cursor is not moved. If you specified NEXT or PREV or the command defaults to NEXT or PREV and z/OS Debugger searched only part of the source object, then z/OS Debugger displays the message Bottom of data reached or Top of data reached, as appropriate. If z/OS Debugger searched through the entire source object, then it displays the message No line, statement or offset breakpoints were found.
  • If multiple line or statement breakpoints exist on the same source line, the FINDBP command finds only one of them.
  • The FINDBP command does not find AT STATEMENT * breakpoints.
  • The FINDBP command searches only through the currently qualified compile unit, which is the compile unit visible in the Source window.
  • z/OS Debugger does not log the FINDBP command.
  • If you know the line number or statement number of the breakpoint you are looking for, the quickest way to find it is to use the SCROLL TO nnnnn or POSITION nnnnn command, which scrolls the Source window so that the line containing nnnnn in the prefix area is the first line in the Source window.

Examples

  • Search for the next line in the Source window that contains a line, statement, or offset breakpoint. 
    FINDBP
  • Search for the first line in the source object that contains a line, statement, or offset breakpoint. Then search for the next two breakpoints. 
    FINDBP FIRST
FINDBP
FINDBP

Related references