Restriction: This routine is not supported in JVM COBOL.
Syntax:
call "CBL_DEBUGBREAK"
Parameters:
None.
Comments:
You can use this call to invoke
Animator. If the program is not being debugged when it calls CBL_DEBUGBREAK, it starts
Animator and then comes to a halt, as if you had been debugging it already and then pressed the
interrupt key.
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
interrupt key.
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 Animator. If the program is not being debugged when it calls CBL_DEBUGBREAK, it starts Animator and then comes to a halt, as if you had been debugging it already and then pressed the interrupt key.
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 interrupt key.
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.