DLCANCEL C-3


NAME



dlcancel - log cancelled transaction

SYNOPSIS



#include
#include

dlcancel (trid)
DLID trid;

DESCRIPTION



Dlcancel records the abnormal ending of a transaction in the log
file. Trid is the value returned by a previous call to dlbegin.
After dlcancel has been called, no further transaction calls
should be made with the same trid value.

The CANCEL transaction marker records that the given transaction
did not complete normally, but did complete abnormally.
Transactions that are cancelled are not treated differently by
the restore program. It is assumed that the calling program has
undone any changes made up to the cancelling point. The restore
program considers a cancelled transaction completed and does
nothing else special for that transaction.

SEE ALSO



dlbegin(C-3), dlcommit(C-3), dlend(C-3)
drestore(C-1)

DIAGNOSTICS



A value of -1 is returned if the transaction marker cannot be
recorded in the log file. In this case, the RMS error message is
set describing the problem.