NWTTSAbortTransaction

Aborts all transactions, explicit and implicit

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Transaction Tracking System (TTS)

Syntax

  #include <nwtts.h> 
  or 
  #include <nwcalls.h> 
   
  NWCCODE N_API  NWTTSAbortTransaction  ( 
     NWCONN_HANDLE   conn);

Delphi Syntax

  uses calwin32 
   
  Function NWTTSAbortTransaction 
    (conn : NWCONN_HANDLE 
  ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare server connection handle.

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x89FE

DIRECTORY_LOCKED

0x89FE

Transaction Restart

0x89FF

LOCK_ERROR

Remarks

When NWTTSAbortTransaction is complete, all transactions will have been successfully backed out.

If a transaction is aborted, all Writes made since the beginning of a transaction are cancelled, and all files are returned to the state they were in before the transaction began.

NWTTSAbortTransaction releases the following record locks:

  • Physical record locks generated by the NetWare server when an application tried to write an unlocked record.
  • Physical or logical locks not released because of a file Write.

0x89FE indicates more than the threshold number of logical or physical records are still locked by the application. However, the transaction is finished and any locks being held are released. When this happens, the NetWare server automatically starts a new implicit transaction.

NCP Calls

See Also

NWTTSBeginTransaction, NWTTSEndTransaction