<!--$Id: env_set_verbose.so,v 10.32 2002/08/18 21:16:32 bostic Exp $--> <!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv.set_verbose</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>DbEnv.set_verbose</h1> </td> <td align=right> <a href="../../db4-devel-4.1.25/api_java/c_index.html"><img src="../../db4-4.1.25/images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../../db4-4.1.25/images/ref.gif" alt="Ref"></a> </td></tr></table> <hr size=1 noshade> <tt> <h3><pre> import com.sleepycat.db.*; <p> public void set_verbose(int which, boolean onoff); </pre></h3> <h1>Description</h1> <p>The DbEnv.set_verbose method turns additional informational and debugging messages in the Berkeley DB message output on and off. If <b>onoff</b> is set to true, the additional messages are output. <p>The <b>which</b> parameter must be set to one of the following values: <p><dl compact> <p><dt><a name="Db.DB_VERB_CHKPOINT">Db.DB_VERB_CHKPOINT</a><dd>Display checkpoint location information when searching the log for checkpoints. <p><dt><a name="Db.DB_VERB_DEADLOCK">Db.DB_VERB_DEADLOCK</a><dd>Display additional information when doing deadlock detection. <p><dt><a name="Db.DB_VERB_RECOVERY">Db.DB_VERB_RECOVERY</a><dd>Display additional information when performing recovery. <p><dt><a name="Db.DB_VERB_REPLICATION">Db.DB_VERB_REPLICATION</a><dd>Display additional information when processing replication messages. <p><dt><a name="Db.DB_VERB_WAITSFOR">Db.DB_VERB_WAITSFOR</a><dd>Display the waits-for table when doing deadlock detection. </dl> <p>The DbEnv.set_verbose method configures operations performed using the specified <a href="../../db4-devel-4.1.25/api_java/env_class.html">DbEnv</a> handle, not all operations performed on the underlying database environment. <p>The DbEnv.set_verbose interface may be called at any time during the life of the application. <p>The DbEnv.set_verbose method throws an exception that encapsulates a non-zero error value on failure. <p>The database environment's verbosity may also be set using the environment's <b>DB_CONFIG</b> file. The syntax of the entry in that file is a single line with the string "set_verbose", one or more whitespace characters, and the interface <b>which</b> argument as a string; for example, "set_verbose DB_VERB_CHKPOINT". Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time. <h1>Errors</h1> <p>The DbEnv.set_verbose method may fail and throw an exception encapsulating a non-zero error for the following conditions: <p><dl compact> <p><dt>EINVAL<dd>An invalid flag value or parameter was specified. </dl> <p>The DbEnv.set_verbose method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. If a catastrophic error has occurred, the DbEnv.set_verbose method may fail and throw a <a href="../../db4-devel-4.1.25/api_java/runrec_class.html">DbRunRecoveryException</a>, in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../../db4-devel-4.1.25/api_java/env_class.html">DbEnv</a> <h1>See Also</h1> <a href="../../db4-devel-4.1.25/api_java/env_list.html">Database Environments and Related Methods</a> </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../../db4-devel-4.1.25/api_java/c_index.html"><img src="../../db4-4.1.25/images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../../db4-4.1.25/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>