script_stop

	status.i4.v = script_stop(mode.i4.v [,stop_text.i1a.r])

	This routine allows scripts to be interrupted.

	mode		(SCRIPT_ABORT -> absolute abort,
			 SCRIPT_OPTION -> let user choose to abort or continue)
	[stop_text]	optional decision window text (null terminated)

	This function returns status values as follows:

	CBS_MEMFAIL		dynamic memory allocation failure
	TRUE			aborting script
	FALSE			continuing script

	This function requires the following include files:

	cnsparam_h, cbslib_h

	Related functions:

	script_select, script_menu, script_accept, script_check, script_status,
	script_lock, script_unlock, script_get_dir, script_available,
	script_create, script_delete

	C/C++ usage:

	static const char	stop_text[] = "Exit SCRIPT due to error?";
	int	status;
	int	mode = SCRIPT_ABORT;

	status = script_stop(mode,stop_text);