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