NWTTSEndTransaction(3nw)


NWTTSEndTransaction -- ends explicit transaction and returns transaction reference number

Synopsis

   #include <nwtts.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWTTSEndTransaction (NWCONN_HANDLE conn, pnuint32 transactionNum);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

transactionNum
(OUT) Points to the transaction reference number for the transaction being ended (optional).

Return values

0x0000
Successful

0x8801
INVALID_CONNECTION

0x89FE
Transaction Restart

0x89FF
LOCK_ERROR

Notices

The transaction number is used to verify a successful transaction completion to disk.

The transaction is not necessarily written to disk when the reference number is returned. A client must call NWTTSTransactionStatus to verify a transaction has been written to disk. If the NetWare server fails before all updates contained within the transaction have been written to disk, the transaction is backed out when the NetWare server is rebooted.

If transaction tracking is disabled, transactionNum can still determine when the transaction has been completely written to disk. Since transactionNum is optional, substitute NULL if no return values are desired.

NWTTSEndTransaction releases all physical record locks generated by the NetWare server when a Write is made to an unlocked record. In addition, physical or logical locks that were not released due to a file Write are unlocked at this time.

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. In this case, the NetWare server automatically starts a new implicit transaction.

Services

Transaction Tracking

NCP calls

0x2222 34 2 TTS End Transaction

 
 0x2222   34   2   TTS End Transaction 

References

NWTTSAbortTransaction(3nw), NWTTSBeginTransaction(3nw), NWTTSTransactionStatus(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.