NWTTSBeginTransaction(3nw)


NWTTSBeginTransaction -- begins an explicit transaction

Synopsis

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

NWCCODE N_API NWTTSBeginTransaction (NWCONN_HANDLE conn);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

Return values

0x0000
Successful

0x8801
INVALID_CONNECTION

Notices

NWTTSBeginTransaction tracks all transactional files currently open, and those opened during the transaction.

When data is written to a transaction file during a transaction, the NetWare server automatically generates a physical record lock for the region being written. If a lock already exists, no additional lock is generated. This automatic locking can be disabled by calling NWTTSSetControlFlags.

Any closing and unlocking of transaction files is delayed until either NWTTSEndTransaction or NWTTSAbortTransaction is executed. Logical and physical records are not unlocked until the end of the transaction if file writes are performed while the lock is in force.

Services

Transaction Tracking

NCP calls

0x2222 34 1 TTS Begin Transaction

 
 0x2222   34   1   TTS Begin Transaction 

References

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