Aborts the current run unit irrespective of the state of existing threads.
Syntax:
call 'CBL_ABORT_RUN_UNIT' using by value ret-value
Parameters:
Using call prototype (see
Key)
Picture
ret-value
cblt-x4-comp5
pic x(4) comp-5.
On Entry:
ret-value
Return-code to be returned to the operating system by this run unit when it terminates.
Comments:
In a single-threaded application or run-time system this call is equivalent to the following syntax:
stop run returning ret-value
In a multi-threaded application STOP RUN waits for all existing threads to exit before terminating the run unit. CBL_ABORT_RUN_UNIT,
however, does not wait for any existing thread to exit. It cancels all running threads and then terminates the run unit, returning
control to the operating system.
Note: We recommend that you use this call only when a serious problem has been detected in the application. Calling this routine
in a multi-threaded application could cause severe problems, as threads might be terminated in the middle of critical file
operations.
Comments:
In a single-threaded application or run-time system this call is equivalent to the following syntax:
In a multi-threaded application STOP RUN waits for all existing threads to exit before terminating the run unit. CBL_ABORT_RUN_UNIT, however, does not wait for any existing thread to exit. It cancels all running threads and then terminates the run unit, returning control to the operating system.