dlbegin - log beginning of transaction
DLID dlbegin (comment)
Dlbegin records the beginning of a transaction in a log file. The
string comment is recorded in the log file along with the
transaction marker. If a comment is not desired, comment should
be a NULL pointer.
Transaction markers bracket a set of changes that must be done as
a unit. What actually constitutes a "transaction" is defined by
the calling program. If a transaction has a BEGIN marker, but not
an END or CANCEL marker, it is considered incomplete. The restore
program drestore(C-1) does not restore incomplete transactions.
The value returned by dlbegin is used in subsequent calls to
identify the transaction.
dlcommit(C-3), dlcancel(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.