<!--$Id: lockng_class.html,v 1.1.1.1 2003/02/15 04:55:53 zarzycki Exp $--> <!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbLockNotGrantedException</title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++"> </head> <body bgcolor=white> <a name="2"><!--meow--></a> <table width="100%"><tr valign=top> <td> <h1>DbLockNotGrantedException</h1> </td> <td align=right> <a href="../api_java/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> <hr size=1 noshade> <tt> <h3><pre> import com.sleepycat.db.*; <p> public class DbLockNotGrantedException extends DbException { public int get_op(); public int get_mode(); public Dbt get_obj(); public DbLock get_lock(); public int get_index(); } </pre></h3> <h1>Description</h1> <p>This manual page describes the DbLockNotGrantedException class and how it is used by the various Db* classes. <p>A DbLockNotGrantedException is thrown when a lock, requested using the <a href="../api_java/lock_get.html">DbEnv.lock_get</a> or <a href="../api_java/lock_vec.html">DbEnv.lock_vec</a> methods (where the <a href="../api_java/lock_vec.html#DB_LOCK_NOWAIT">Db.DB_LOCK_NOWAIT</a> option was specified), or by any <a href="../api_java/db_class.html">Db</a> operation performed in the context of a transaction begun using the <a href="../api_java/txn_begin.html#DB_TXN_NOWAIT">Db.DB_TXN_NOWAIT</a> option, is unable to be granted immediately. <p>The <b>get_op</b> method returns 0 when <a href="../api_java/lock_get.html">DbEnv.lock_get</a> was called, and returns the <b>op</b> for the failed DbLockRequest when <a href="../api_java/lock_vec.html">DbEnv.lock_vec</a> was called. <p>The <b>get_mode</b> method returns the <b>mode</b> argument when <a href="../api_java/lock_get.html">DbEnv.lock_get</a> was called, and returns the <b>mode</b> for the failed DbLockRequest when <a href="../api_java/lock_vec.html">DbEnv.lock_vec</a> was called. <p>The <b>get_obj</b> method returns the <b>obj</b> argument when <a href="../api_java/lock_get.html">DbEnv.lock_get</a> was called, and returns the <b>obj</b> for the failed DbLockRequest when <a href="../api_java/lock_vec.html">DbEnv.lock_vec</a> was called. <p>The <b>get_lock</b> method returns null when <a href="../api_java/lock_get.html">DbEnv.lock_get</a> was called, and returns the <b>lock</b> in the failed DbLockRequest when <a href="../api_java/lock_vec.html">DbEnv.lock_vec</a> was called. <p>The <b>get_index</b> method returns -1 when <a href="../api_java/lock_get.html">DbEnv.lock_get</a> was called, and returns the index of the failed DbLockRequest when <a href="../api_java/lock_vec.html">DbEnv.lock_vec</a> was called. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_java/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> <p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font> </body> </html>