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.