Software Timeouts

The Software Timeouts feature provides support for timeouts in Omnidex. When the TIMEOUT option is used, a signal will be sent when the specified amount of time (in seconds) has elapsed.

Similar to the Software Interrupt feature, a flag is set that is checked at various points in each OmniAccess routine. When the flag is detected, the routine immediately exits with a status condition indicating an interrupt has occurred.

The TIMEOUT option is supported by QUALFY, JOIN, SELECT, FETCH, FETCHKEYS, EXPORT and oaexecsql.

The TIMEOUT option is also supported on OPENCURSOR, indicating that the timeout should apply to all routines described above that occur on this cursor.

If the TIMEOUT option is specified on both the OPENCURSOR and any of the other routines mentioned above, the timeout on the latter routine takes precedence.

Syntax:

TIMEOUT=n

Example:

TIMEOUT=45

Not all of the underlying databases and services called by Omnidex support signal interrupts. As a result, an interrupt may be delayed a significant amount of time while waiting for the underlying service to complete.

Top