This section describes what this processing mode does, how it changes the application behavior, what drivers currently support this mode and what member functions use it. The following items are described:

When this mode is turned on, the execution of a query immediately returns control to the application.

The application must then be designed so as to call the function again with the very same arguments until the query completes. To test the completion status, the application calls the function IldRequest::isCompleted, which returns:

When the asynchronous processing mode is turned on, only ONE query can be active at a time for a given connection. In this case, it is impossible to use two different IldRequest objects pertaining to the same connection (an IldDbms object) simultaneously. However, it is possible to allocate several IldRequest objects for the same connection, and use any of these requests as soon as the previous operation is completed.

The function IldDbms::isAsyncSupported returns IlTrue when the driver supports the asynchronous processing mode. Currently these drivers are:

When the asynchronous processing mode is turned on, the following member functions must be checked for completion before accessing their results:

For these two classes, the returned values are significant if, and only if, the following test holds: