Berkeley DB: DbLockNotGrantedException
Description: Berkeley DB: An embedded database programmatic toolkit.
Keywords: embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++

DbLockNotGrantedException |

`

    #include <db_cxx.h>

    class DbLockNotGrantedException : public DbException {
    public:
    	db_lockop_t get_op() const;
    	db_lockmode_t get_mode() const;
    	const Dbt* get_obj() const;
    	DbLock *get_lock() const;
    	int get_index() const;
    };

Description: DbLockNotGrantedException

This information describes the DbLockNotGrantedException class and how it is used by the various Db* classes.

A DbLockNotGrantedException is thrown when a lock requested using the DbEnv::lock_get or DbEnv::lock_vec methods, where the DB_LOCK_NOWAIT flag or lock timers were configured, could not be granted before the wait-time expired.

Additionally, DbLockNotGrantedException is thrown when a Berkeley DB Concurrent Data Store database environment configured for lock timeouts was unable to grant a lock in the allowed time.

Additionally, DbLockNotGrantedException is thrown when lock or transaction timeouts have been configured, a database operation has timed out, and the DB_TIME_NOTGRANTED configuration flag has been specified.

The DbException errno value is set to DB_LOCKNOTGRANTED.

The get_op method returns 0 when DbEnv::lock_get was called, and returns the op for the failed DB_LOCKREQ when DbEnv::lock_vec was called.

The get_mode method returns the mode parameter when DbEnv::lock_get was called, and returns the mode for the failed DB_LOCKREQ when DbEnv::lock_vec was called.

The get_obj method returns the mode parameter when returns the object parameter when DbEnv::lock_get was called, and returns the object for the failed DB_LOCKREQ when DbEnv::lock_vec was called. The Dbt pointer may or may not refer to valid memory, depending on whether the Dbt used in the call to the failed DbEnv::lock_get or DbEnv::lock_vec method is still in scope and has not been deleted.

The get_lock method returns NULL when DbEnv::lock_get was called, and returns the lock in the failed DB_LOCKREQ when DbEnv::lock_vec was called.

The get_index method returns -1 when DbEnv::lock_get was called, and returns the index of the failed DB_LOCKREQ when DbEnv::lock_vec was called.

`

Copyright (c) 1996,2008 Oracle. All rights reserved.