SET ASSEMBLER STEPOVER command

Specifies how z/OS® Debugger processes STEP OVER commands in assembler compile units. When EXTONLY is in effect, z/OS Debugger only steps over calls to external subroutines. When EXTINT is in effect, z/OS Debugger steps over calls to external and internal subroutines. External subroutines are subroutines that are outside the current compile unit; internal subroutines are subroutines that are inside the current compile unit.

z/OS Debugger returns control to you the next time it runs any instruction in the current compile unit (CSECT) when either of the following situations occur:
  • EXTONLY is in effect
  • EXTINT is in effect and the assembler program calls an external subroutine
z/OS Debugger assumes that the subroutine you want to step over returns to the instruction that follows the call to that subroutine when all of the following situations occur:
  • EXTINT is in effect
  • The function is an internal subroutine
  • The address that immediately follows the instruction where you are currently stopped contains an executable instruction (not data)
z/OS Debugger assumes that you use one of the following instructions to call internal subroutines:
  • BAL
  • BAS
  • BRAS
  • BALR
  • BASR
  • BASSM
  • BRASL
Read syntax diagramSkip visual syntax diagramSETASSEMBLERSTEPOVER EXTONLYEXTINT ;
EXTONLY
Specifies that z/OS Debugger steps over external subroutines and steps through internal subroutines.
EXTINT
Specifies that z/OS Debugger steps over external and internal subroutines.

Usage notes

  • If EXTINT is in effect and an internal subroutine does not return to the instruction that immediately follows the call to that subroutine, one of the following situations might occur:
    • z/OS Debugger might not regain control
    • z/OS Debugger might regain control only when another breakpoint is run
    • z/OS Debugger might regain control only when an external event occurs
    • z/OS Debugger might not regain control and the program runs until it terminates
  • You can use this command in remote debug mode.

Refer to the following topics for more information related to the material discussed in this topic.