You can use this call to invoke
the debugger. If the program is not being debugged when it calls CBL_DEBUGBREAK, it starts
the debugger and then comes to a halt, as if you had been debugging it already and then pressed the
Stop button on the toolbar.
If the program was already being debugged when it called CBL_DEBUGBREAK, then debugging comes to a halt in that debugger, as if you had pressed the
Stop button.
The routine returns a value in RETURN-CODE of 0 if the call was successful, or non-zero if it tried to invoke a debugger but failed.
Comments:
You can use this call to invoke the debugger. If the program is not being debugged when it calls CBL_DEBUGBREAK, it starts the debugger and then comes to a halt, as if you had been debugging it already and then pressed the Stop button on the toolbar.
If the program was already being debugged when it called CBL_DEBUGBREAK, then debugging comes to a halt in that debugger, as if you had pressed the Stop button.
The routine returns a value in RETURN-CODE of 0 if the call was successful, or non-zero if it tried to invoke a debugger but failed.