CBL_ABORT_RUN_UNIT

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.