DTK_THROW_ABORT

Set initial value of g_throwabort

WSupported on Windows

USupported on Unix

VSupported on OpenVMS

The DTK_THROW_ABORT environment variable is used by the UI Toolkit U_START routine to determine the initial value of g_throwabort (a global defined in tkctl.def).

Value

One of the following:

1

g_throwabort is set to true (1).

Any other value

g_throwabort is set to false (0).

Discussion

DTK_THROW_ABORT sets the initial value of g_throwabort, which determines the behavior of the U_ABORT subroutine. If g_throwabort is set to 0 (the default), U_ABORT performs a STOP and displays a fatal error message when invoked. The STOP has an exit status of D_EXIT_FAILURE, and U_ABORT does not return to the calling routine. If g_throwabort is set to a nonzero value, U_ABORT calls U_FINISH to shut down the Toolkit environment and then calls EXITE to throw a trappable error.

If DTK_THROW_ABORT is not defined, g_throwabort is set to false (0).

Setting location

The environment or the [synergy], [dbr], or [myprog] section of synergy.ini (where myprog is any .dbr file).

Used by

UI Toolkit

Examples

set DTK_THROW_ABORT=1