Arial;Courier New;Symbol;Times New Roman CE;Times New Roman Cyr;Times New Roman Greek;Times New Roman Tur;Times New Roman (Hebrew);Times New Roman (Arabic);Times New Roman Baltic;Times New Roman (Vietnamese);Arial CE;Arial Cyr;Arial Greek;Arial Tur;Arial (Hebrew);Arial (Arabic);Arial Baltic;Arial (Vietnamese);Courier New CE;Courier New Cyr;Courier New Greek;Courier New Tur;Courier New (Hebrew);Courier New (Arabic);Courier New Baltic;Courier New (Vietnamese);Connection Handles

Advantage Client Engine

The idea of controllable connections to Advantage servers has not been available before. This capability exposes new functionality for Advantage. A connection handle is a reference to a single communication link with the Advantage server. These Advantage connections can be controlled explicitly, but it is also possible to let the Advantage Client Engine control connections. To allow the Advantage Client Engine to control server connections, specify a zero for the connection parameter on calls to AdsOpenTable, AdsCreateTable and the transaction functions (AdsBeginTransaction, AdsCommitTransaction, AdsRollbackTransaction, and AdsInTransaction).

To control Advantage server connections explicitly, use the functions AdsConnect, AdsDisconnect, and AdsFindConnection. The availability of these functions allows an application to obtain multiple connections to the same Advantage server. Because Advantage Server transactions are performed by connection, it is now possible for an application to control multiple independent transactions at one time.

Note Although multiple transactions are now possible from one client on an Advantage Server, record visibility through the separate table handles on the separate connections is exactly as if the transactions were taking place from different client machines. Therefore, if a record in one transaction is updated, the other transaction will not see the change until it is committed.

AdsApplicationExit will close all implicit and all explicit connections. In addition, AdsDisconnect can be used to close connections explicitly.