dlcancel - log cancelled transaction
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.
dlbegin(C-3), dlcommit(C-3), dlend(C-3)
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.