BKPT - Set breakpoint; interrupt current program

General

Application areas:	Debugging aids; see "Debugging aids" Interrupting the program run; see "Starting, interrupting and terminating" Communication; see "Communication (programs, users, system)"
Macro type:	O-Type O; see "O-type macros"

Macro description

The BKPT macro serves to interrupt program execution in order to enter commands.
In interactive mode, system commands or IDA commands can be input at the terminal. The program is continued with the RESUME-PROGRAM, %RESUME or %TRACE command. In the case of batch jobs and interactive procedures, commands are processed until the next RESUME-PROGRAM, %RESUME or %TRACE command is encountered.

Macro format and description of operands

BKPT

Example

BKPT     START
         PRINT NOGEN
         BALR  3,0
         USING *,3
         WROUT MESS1,ERROR ————————————————————————————————————————————  (1) 
         BKPT —————————————————————————————————————————————————————————  (2) 
         WROUT MESS1,ERROR ————————————————————————————————————————————  (3) 
ERROR    TERM
***  Definitions   ****
MESS1    DC    Y(END-MESS1)
         DS    L2
         DC    X'01'
         DC    C'Here is BKPT'
END      EQU   *
         END

Runtime log:

/start-assembh
%  BLS0500 PROGRAM 'ASSEMBH', VERSION '<ver>' OF '<date>' LOADED
%  ASS6010 <ver> OF BS2000 ASSEMBH  READY 
//compile source=*library-element(macexmp.lib,bkpt), -
//        compiler-action=module-generation(module-format=llm), -
//        module-library=macexmp.lib, -
//        listing=parameters(output=*library-element(macexmp.lib,bkpt))
%  ASS6011 ASSEMBLY TIME: 314 MSEC
%  ASS6018 0 FLAGS, 0 PRIVILEGED FLAGS, 0 MNOTES
%  ASS6019 HIGHEST ERROR-WEIGHT: NO ERRORS
%  ASS6006 LISTING GENERATOR TIME: 80 MSEC
//end
%  ASS6012 END OF ASSEMBH
/start-executable-program library=macexmp.lib,element-or-symbol=bkpt
%  BLS0523 ELEMENT 'BKPT', VERSION '@' FROM LIBRARY
   ':2OSG:$QM212.MACEXMP.LIB' IN PROCESS
%  BLS0524 LLM 'BKPT', VERSION ' ' OF '<date> <time>' LOADED
Here is BKPT ——————————————————————————————————————————————————————————  (1) 
%  IDA0199 PROGRAM BREAK AT ADDRESS X'000014', AMODE=24 ———————————————  (2) 
/show-user-status inf=*prog
NAME      TSN TYPE        SIZE CURR-CMD
MACTEST  2QSE 3 DIALOG1      1 SHOW-USER-STATUS
              PROG::2OSG:$QM212.MACEXMP.LIB(BKPT,@,L)
/resume-program
Here is BKPT ——————————————————————————————————————————————————————————  (3) 

(1)	A message is written to SYSOUT.
(2)	The BKPT macro is encountered: program execution is interrupted. The message IDA0199 is output. Commands can now be input at the user terminal. In this example, the SHOW-USER-STATUS INF=*PROG command is input. With the RESUME-PROGRAM command the interrupted program is continued from the line after BKPT.
(3)	A message is written to SYSOUT.