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

Syntax

N_TROLLBACK()


Returns

A numeric transaction ID number (TID). If no transaction was active, 
the function will return zero.


Description

Directs the server to return the file to the state it was in when the 
transaction began. The function returns a transaction ID number that 
can be used with N_TSTATUS() to determine if the file server has 
finished rolling back the transaction.

N_TROLLBACK() will clear the buffer before restoring the transaction to 
its original state.

It is not necessary to wait for the rollback to complete before 
beginning another transaction.

Transaction rollback causes a large drain on system resources and 
should therefore be used only when absolutely necessary, as in an 
unavoidable deadlock.

Note  If a component of the network should fail, NetWare will 
automatically rollback any incomplete transactions. (This is true even 
if the file server goes down during a transaction.) Thus you do not 
need to include rollback in error-handling routines for most types of 
file I/O errors.


Example

N_ONQUIT('AbEnd')
.
.
.
PROCEDURE AbEnd
   N_TROLLBACK()
   CLOSE ALL
   RETURN