Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Advantage CA-Clipper Guide v6.11 - ax_tpscleanup() http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 AX_TPSCleanup()
 Recovers from a failed transaction
------------------------------------------------------------------------------

 Syntax

     AX_TPSCleanup( <cServerName> ) -> logical

     <cServerName>  A character string specifying the file server and
     share/volume name of server on which a failed transaction exists. Format
     of the file server and volume name must be: "\\SERVER\SHARE".

 Returns

     Returns a logical value of .T. indicating the failed transaction
     recovery was successful. A return value of .F. means the failed
     transaction recovery was unsuccessful.  If an error occurred,
     AX_Error() will return information on why the function failed.

 Description

     If a system failure occurs during the rollback of a transaction, a
     failed transaction results. The tables and index files associated
     with the transaction may be left in a temporarily unstable state.
     The application needs to recognize the error generated by the failed
     transaction and perform a failed transaction recovery.

     While the Advantage server is running, call AX_TPSCleanup() with the
     network file server and share/volume name as the only parameter if a
     failed transaction has occurred. If the failed transaction recovery is
     successful, the database will be left as it was before the transaction
     began.

     Note:  If the failed transaction recovery was unsuccessful, the
     Advantage error log, ADS_ERR.DBF, must be referenced to determine
     the error(s) that cause the failed transaction recovery to fail.

     Note:  In order for a failed transaction cleanup to be successful,
     no other applications can be accessing the tables, index files, and
     memo files involved in the transaction.

 Example

     ? AX_TPSCleanup( "SERVER1/MAIN:" )


Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson