Click above to get retro games delivered to your door ever month!

 TTSStatus()
------------------------------------------------------------------------------
 Purpose:
 Get the status of the last transaction on the workstation.

 Syntax:
 bStatus = TTSStatus(dwTransID )

 Parameters:
 dwTransID The transaction ID number returned by TTSEnd().

 Returns:
 A boolean value (TRUE or FALSE).

 The CA-Clipper name for this function is:
 TTSStatus()

 Description:
 TTSStatus() returns TRUE if the transaction specified by its ID number
 dwTransID has been successfully committed to disk. When a transaction
 is ended by TTSEnd(), TTSEnd() returns an ID number in its parameter
 lpdwTransID. This ID number identifies the specific transaction.

 Although TTSEnd() may have returned TRUE signifying that the transaction
 has ended, the file server may still be holding tracked data in its cache,
 hence the transaction is not yet committed. TTSStatus() should be called in
 a continual do while loop until it returns TRUE, signifying that the
 transaction is now committed.

 Example:
 // To end the current transaction and ensure it is written to disk:
 dwTransID = 0
 if ( !TTSEnd( dwTransID ) )
    if NWErrorGet() >= 253
       ? "Ignoring information codes"
    else
       ? "An error occurred ending the transaction"
    endif
 endif
 do while ( !TTSStatus( dwTransID ) )
 enddo

 Notes:
 CA-Clipper / CA-Visual Objects:

 Read Chapter 13, Transaction Tracking Functions before using this function
 to understand the compatability issues between xBase file formats and TTS.