CBL_DEBUG_STOP

Syntax:

CALL "CBL_DEBUG_STOP" using  by value    flags
                               returning status-code

Parameters:

flags cblt-os-flags.
status-code See Library Routines - Key

On Entry:

flags cblt-os-flags.
status-code See Library Routines - Key
flags Controls how animation stops. You can set the following bits:
Bit Meaning
0 Animator detaches.
1 Animator terminates.
Bit 0 Bit 1 Meaning
0 0 Execution of the calling program continues without animation until a subsequent event, such as a breakpoint, STOP RUN or CBL_DEBUG_START, is encountered. This is equivalent to pressing Z (for Zoom) in Animator.
0 1 Animator and the calling program both exit. This is equivalent to exiting Animator using the Quit option.
1 0 Animator detaches from the program and waits for a subsequent CBL_DEBUG_START with the same identifier string. Execution of the calling program continues without animation.
1 1 Animator detaches from the program and exits. Execution of the calling program continues without animation. This is equivalent to exiting Animator using the Detach option.

Comments:

If the program is being debugged when it calls CBL_DEBUG_STOP, then animation stops. The effect on Animator and the program that called CBL_DEBUG_STOP depends on the settings of bits 0 and 1 of flags:

Bit 0 Bit 1 Meaning
0 0 Execution of the calling program continues without animation until a subsequent event, such as a breakpoint, STOP RUN or CBL_DEBUG_START, is encountered. This is equivalent to pressing Z (for Zoom) in Animator.
0 1 Animator and the calling program both exit. This is equivalent to exiting Animator using the Quit option.
1 0 Animator detaches from the program and waits for a subsequent CBL_DEBUG_START with the same identifier string. Execution of the calling program continues without animation.
1 1 Animator detaches from the program and exits. Execution of the calling program continues without animation. This is equivalent to exiting Animator using the Detach option.

If the program is not being debugged when it calls CBL_DEBUG_STOP, then execution continues as if the routine had not been called.