#include <db_cxx.h>

int
DbTxn::set_name(const char *name); 

The DbTxn::set_name() method associates the specified string with the transaction. The string is returned by DbEnv::txn_stat() and displayed by DbEnv::txn_stat_print().

If the database environment has been configured for logging and the Berkeley DB library was configured with --enable-diagnostic, a debugging log record is written including the transaction ID and the name.

The DbTxn::set_name() method may be called at any time during the life of the application.

The DbTxn::set_name() method either returns a non-zero error value or throws an exception that encapsulates a non-zero error value on failure, and returns 0 on success.