<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc on Wed Dec 03 16:22:10 EST 2003 -->
<TITLE>
DbEnv (Sleepycat Software, Inc. - Berkeley DB Java API)
</TITLE>
<META NAME="keywords" CONTENT="com.sleepycat.db.DbEnv,DbEnv class">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../style.css" TITLE="Style">
</HEAD>
<SCRIPT>
function asd()
{
parent.document.title="DbEnv (Sleepycat Software, Inc. - Berkeley DB Java API)";
}
</SCRIPT>
<BODY BGCOLOR="white" onload="asd();">
<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_top"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/DbEnv.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Berkeley DB</b><br><font size="-1"> version 4.2.52</font></EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../com/sleepycat/db/Dbc.html"><B>PREV CLASS</B></A>
<A HREF="../../../com/sleepycat/db/DbEnv.RepProcessMessage.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
<A HREF="DbEnv.html" TARGET="_top"><B>NO FRAMES</B></A>
<SCRIPT>
<!--
if(window==top) {
document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: <A HREF="#nested_class_summary">NESTED</A> | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->
<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
com.sleepycat.db</FONT>
<BR>
Class DbEnv</H2>
<PRE>
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html">java.lang.Object</A>
|
+--<B>com.sleepycat.db.DbEnv</B>
</PRE>
<HR>
<DL>
<DT>public class <B>DbEnv</B><DT>extends <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html">Object</A></DL>
<P>
The DbEnv object is the handle for a Berkeley DB environment -- a collection including support for some or all of caching, locking, logging and transaction subsystems, as well as databases and log files. Methods off the DbEnv handle are used to configure the environment as well as to operate on subsystems and databases in the environment.</p> <p>DbEnv handles are free-threaded if the <A HREF="../../../com/sleepycat/db/Db.html#DB_THREAD"><CODE>Db.DB_THREAD</CODE></A> flag is specified to the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method when the environment is opened. The DbEnv handle should not be closed while any other handle remains open that is using it as a reference (for example, <A HREF="../../../com/sleepycat/db/Db.html"><CODE>Db</CODE></A> or <A HREF="../../../com/sleepycat/db/DbTxn.html"><CODE>DbTxn</CODE></A>). Once either the <A HREF="../../../com/sleepycat/db/DbEnv.html#close(int)"><CODE>DbEnv.close</CODE></A> or <A HREF="../../../com/sleepycat/db/DbEnv.html#remove(java.lang.String, int)"><CODE>DbEnv.remove</CODE></A> methods are called, the handle may not be accessed again, regardless of the method's return.</p>
<P>
<P>
<HR>
<P>
<!-- ======== NESTED CLASS SUMMARY ======== -->
<A NAME="nested_class_summary"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Nested Class Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static class</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.RepProcessMessage.html">DbEnv.RepProcessMessage</A></B></CODE>
<BR>
</TD>
</TR>
</TABLE>
<!-- =========== FIELD SUMMARY =========== -->
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<A NAME="constructor_summary"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Constructor Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#DbEnv(int)">DbEnv</A></B>(int flags)</CODE>
<BR>
The constructor creates the DbEnv object.</TD>
</TR>
</TABLE>
<!-- ========== METHOD SUMMARY =========== -->
<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Method Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#close(int)">close</A></B>(int flags)</CODE>
<BR>
The DbEnv.close method closes the Berkeley DB environment, freeing any allocated resources and closing any underlying subsystems.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#dbremove(com.sleepycat.db.DbTxn, java.lang.String, java.lang.String, int)">dbremove</A></B>(<A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A> txnid,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> file,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> database,
int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#dbRemove(com.sleepycat.db.DbTxn, java.lang.String, java.lang.String, int)"><CODE>dbRemove(DbTxn,String,String,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#dbRemove(com.sleepycat.db.DbTxn, java.lang.String, java.lang.String, int)">dbRemove</A></B>(<A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A> txnid,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> file,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> database,
int flags)</CODE>
<BR>
The DbEnv.dbRemove method removes the database specified by the <b>file</b> and <b>database</b> parameters.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#dbrename(com.sleepycat.db.DbTxn, java.lang.String, java.lang.String, java.lang.String, int)">dbrename</A></B>(<A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A> txnid,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> file,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> database,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> newname,
int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#dbRename(com.sleepycat.db.DbTxn, java.lang.String, java.lang.String, java.lang.String, int)"><CODE>dbRename(DbTxn,String,String,String,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#dbRename(com.sleepycat.db.DbTxn, java.lang.String, java.lang.String, java.lang.String, int)">dbRename</A></B>(<A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A> txnid,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> file,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> database,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> newname,
int flags)</CODE>
<BR>
The DbEnv.dbRename method renames the database specified by the <b>file</b> and <b>database</b> parameters to <b>newname</b>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#err(int, java.lang.String)">err</A></B>(int error,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> message)</CODE>
<BR>
The DbEnv.err, DbEnv.errx, <A HREF="../../../com/sleepycat/db/Db.html#err(int, java.lang.String)"><CODE>Db.err</CODE></A> and <A HREF="../../../com/sleepycat/db/Db.html#errx(java.lang.String)"><CODE>Db.errx</CODE></A> methods provide error-messaging functionality for applications written using the Berkeley DB library.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#errx(java.lang.String)">errx</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> message)</CODE>
<BR>
The DbEnv.errx and <A HREF="../../../com/sleepycat/db/Db.html#errx(java.lang.String)"><CODE>Db.errx</CODE></A> methods perform identically to the DbEnv.err and <A HREF="../../../com/sleepycat/db/Db.html#err(int, java.lang.String)"><CODE>Db.err</CODE></A> methods, except that they do not append the final separator characters and standard error string to the error message.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_cachesize_ncache()">get_cachesize_ncache</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getCacheSizeNcache()"><CODE>getCacheSizeNcache()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> long</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_cachesize()">get_cachesize</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getCacheSize()"><CODE>getCacheSize()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A>[]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_data_dirs()">get_data_dirs</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getDataDirs()"><CODE>getDataDirs()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_encrypt_flags()">get_encrypt_flags</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getEncryptFlags()"><CODE>getEncryptFlags()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_errpfx()">get_errpfx</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getErrorPrefix()"><CODE>getErrorPrefix()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_flags()">get_flags</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getFlags()"><CODE>getFlags()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_home()">get_home</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getDbEnvHome()"><CODE>getDbEnvHome()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_lg_bsize()">get_lg_bsize</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLogBufferSize()"><CODE>getLogBufferSize()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_lg_dir()">get_lg_dir</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLogDir()"><CODE>getLogDir()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_lg_max()">get_lg_max</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLogMax()"><CODE>getLogMax()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_lg_regionmax()">get_lg_regionmax</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLogRegionMax()"><CODE>getLogRegionMax()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> byte[][]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_lk_conflicts()">get_lk_conflicts</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLockConflicts()"><CODE>getLockConflicts()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_lk_detect()">get_lk_detect</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLockDetect()"><CODE>getLockDetect()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_lk_max_lockers()">get_lk_max_lockers</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLockMaxLockers()"><CODE>getLockMaxLockers()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_lk_max_locks()">get_lk_max_locks</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLockMaxLocks()"><CODE>getLockMaxLocks()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_lk_max_objects()">get_lk_max_objects</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLockMaxObjects()"><CODE>getLockMaxObjects()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> long</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_mp_mmapsize()">get_mp_mmapsize</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getMemoryPoolMapSize()"><CODE>getMemoryPoolMapSize()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_open_flags()">get_open_flags</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getOpenFlags()"><CODE>getOpenFlags()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> long</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_rep_limit()">get_rep_limit</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getReplicationLimit()"><CODE>getReplicationLimit()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> long</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_shm_key()">get_shm_key</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getSegmentId()"><CODE>getSegmentId()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_tas_spins()">get_tas_spins</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getTestAndSetSpins()"><CODE>getTestAndSetSpins()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> long</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_timeout(int)">get_timeout</A></B>(int flag)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getTimeout(int)"><CODE>getTimeout(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_tmp_dir()">get_tmp_dir</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getTmpDir()"><CODE>getTmpDir()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_tx_max()">get_tx_max</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getTxnMax()"><CODE>getTxnMax()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> long</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_tx_timestamp()">get_tx_timestamp</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getTxnTimestamp()"><CODE>getTxnTimestamp()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_verbose(int)">get_verbose</A></B>(int which)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getVerbose(int)"><CODE>getVerbose(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_version_major()">get_version_major</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getVersionMajor()"><CODE>getVersionMajor()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_version_minor()">get_version_minor</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getVersionMinor()"><CODE>getVersionMinor()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_version_patch()">get_version_patch</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getVersionPatch()"><CODE>getVersionPatch()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#get_version_string()">get_version_string</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getVersionString()"><CODE>getVersionString()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> long</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getCacheSize()">getCacheSize</A></B>()</CODE>
<BR>
The DbEnv.getCacheSize method returns the size of the cache.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getCacheSizeNcache()">getCacheSizeNcache</A></B>()</CODE>
<BR>
The DbEnv.getCacheSizeNcache method returns the number of caches.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A>[]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getDataDirs()">getDataDirs</A></B>()</CODE>
<BR>
The DbEnv.getDataDirs method returns the array of directories.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getDbEnvHome()">getDbEnvHome</A></B>()</CODE>
<BR>
The DbEnv.getDbEnvHome method returns the database environment home directory.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getEncryptFlags()">getEncryptFlags</A></B>()</CODE>
<BR>
The DbEnv.getEncryptFlags method returns the encryption flags.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getErrorPrefix()">getErrorPrefix</A></B>()</CODE>
<BR>
The DbEnv.getErrorPrefix method returns the error prefix.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getFlags()">getFlags</A></B>()</CODE>
<BR>
The DbEnv.getFlags method returns the configuration flags.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> byte[][]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getLockConflicts()">getLockConflicts</A></B>()</CODE>
<BR>
The DbEnv.getLockConflicts method returns the conflicts array.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getLockDetect()">getLockDetect</A></B>()</CODE>
<BR>
The DbEnv.getLockDetect method returns the deadlock detector configuration.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getLockMaxLockers()">getLockMaxLockers</A></B>()</CODE>
<BR>
The DbEnv.getLockMaxLockers method returns the maximum number of lockers.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getLockMaxLocks()">getLockMaxLocks</A></B>()</CODE>
<BR>
The DbEnv.setLockMaxLocks method returns the maximum number of locks.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getLockMaxObjects()">getLockMaxObjects</A></B>()</CODE>
<BR>
The DbEnv.getLockMaxObjects method returns the maximum number of locked objects.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getLogBufferSize()">getLogBufferSize</A></B>()</CODE>
<BR>
The DbEnv.getLogBufferSize method returns the size of the log buffer, in bytes.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getLogDir()">getLogDir</A></B>()</CODE>
<BR>
The DbEnv.getLogDir method returns the log directory.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getLogMax()">getLogMax</A></B>()</CODE>
<BR>
The DbEnv.getLogMax method returns the maximum log file size.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getLogRegionMax()">getLogRegionMax</A></B>()</CODE>
<BR>
The DbEnv.getLogRegionMax method returns the size of the underlying logging subsystem region.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> long</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getMemoryPoolMapSize()">getMemoryPoolMapSize</A></B>()</CODE>
<BR>
The DbEnv.getMemoryPoolMapSize method returns the maximum file map size.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getOpenFlags()">getOpenFlags</A></B>()</CODE>
<BR>
The DbEnv.getOpenFlags method returns the open method flags.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> long</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getReplicationLimit()">getReplicationLimit</A></B>()</CODE>
<BR>
The DbEnv.getReplicationLimit method returns the transmit limit in bytes.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> long</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getSegmentId()">getSegmentId</A></B>()</CODE>
<BR>
The DbEnv.getSegmentId method returns the base segment ID.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getTestAndSetSpins()">getTestAndSetSpins</A></B>()</CODE>
<BR>
The DbEnv.getTestAndSetSpins method returns the test-and-set spin count.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> long</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getTimeout(int)">getTimeout</A></B>(int flag)</CODE>
<BR>
The DbEnv.getTimeout method returns a timeout value, in microseconds.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getTmpDir()">getTmpDir</A></B>()</CODE>
<BR>
The DbEnv.getTmpDir method returns the database environment temporary file directory.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getTxnMax()">getTxnMax</A></B>()</CODE>
<BR>
The DbEnv.getTxnMax method returns the number of active transactions.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> long</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getTxnTimestamp()">getTxnTimestamp</A></B>()</CODE>
<BR>
The DbEnv.getTxnTimestamp method returns the recovery timestamp.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getVerbose(int)">getVerbose</A></B>(int which)</CODE>
<BR>
The DbEnv.getVerbose method returns whether the specified <b>which</b> parameter is currently set or not.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getVersionMajor()">getVersionMajor</A></B>()</CODE>
<BR>
The DbEnv.getVersionMajor method returns the release major number.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getVersionMinor()">getVersionMinor</A></B>()</CODE>
<BR>
The DbEnv.getVersionMinor method returns the release minor number.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getVersionPatch()">getVersionPatch</A></B>()</CODE>
<BR>
The DbEnv.getVersionPatch method returns the release patch number.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getVersionString()">getVersionString</A></B>()</CODE>
<BR>
The DbEnv.getVersionString method returns the release verbose version information, suitable for display.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#lock_detect(int, int)">lock_detect</A></B>(int flags,
int atype)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#lockDetect(int, int)"><CODE>lockDetect(int,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbLock.html">DbLock</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#lock_get(int, int, com.sleepycat.db.Dbt, int)">lock_get</A></B>(int locker,
int flags,
<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> object,
int lock_mode)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#lockGet(int, int, com.sleepycat.db.Dbt, int)"><CODE>lockGet(int,int,Dbt,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#lock_id_free(int)">lock_id_free</A></B>(int id)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#lockIdFree(int)"><CODE>lockIdFree(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#lock_id()">lock_id</A></B>()</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#lockId()"><CODE>lockId()</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#lock_put(com.sleepycat.db.DbLock)">lock_put</A></B>(<A HREF="../../../com/sleepycat/db/DbLock.html">DbLock</A> lock)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#lockPut(com.sleepycat.db.DbLock)"><CODE>lockPut(DbLock)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbLockStat.html">DbLockStat</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#lock_stat(int)">lock_stat</A></B>(int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#lockStat(int)"><CODE>lockStat(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#lock_vec(int, int, com.sleepycat.db.DbLockRequest[], int, int)">lock_vec</A></B>(int locker,
int flags,
<A HREF="../../../com/sleepycat/db/DbLockRequest.html">DbLockRequest</A>[] list,
int offset,
int count)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#lockVector(int, int, com.sleepycat.db.DbLockRequest[], int, int)"><CODE>lockVector(int,int,DbLockRequest[],int,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#lockDetect(int, int)">lockDetect</A></B>(int flags,
int atype)</CODE>
<BR>
The DbEnv.lockDetect method runs one iteration of the deadlock detector.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbLock.html">DbLock</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#lockGet(int, int, com.sleepycat.db.Dbt, int)">lockGet</A></B>(int locker,
int flags,
<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> object,
int lock_mode)</CODE>
<BR>
The DbEnv.lockGet method acquires a lock from the lock table, returning information about it in a DbLock object.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#lockId()">lockId</A></B>()</CODE>
<BR>
The DbEnv.lockId method returns a locker ID, which is guaranteed to be unique in the specified lock table.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#lockIdFree(int)">lockIdFree</A></B>(int id)</CODE>
<BR>
The DbEnv.lockIdFree method frees a locker ID allocated by the <A HREF="../../../com/sleepycat/db/DbEnv.html#lockId()"><CODE>DbEnv.lockId</CODE></A> method.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#lockPut(com.sleepycat.db.DbLock)">lockPut</A></B>(<A HREF="../../../com/sleepycat/db/DbLock.html">DbLock</A> lock)</CODE>
<BR>
The DbEnv.lockPut method releases <b>lock</b>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbLockStat.html">DbLockStat</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#lockStat(int)">lockStat</A></B>(int flags)</CODE>
<BR>
The DbEnv.lockStat method returns the locking subsystem statistics.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#lockVector(int, int, com.sleepycat.db.DbLockRequest[], int, int)">lockVector</A></B>(int locker,
int flags,
<A HREF="../../../com/sleepycat/db/DbLockRequest.html">DbLockRequest</A>[] list,
int offset,
int count)</CODE>
<BR>
The DbEnv.lockVector method atomically obtains and releases one or more locks from the lock table.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A>[]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#log_archive(int)">log_archive</A></B>(int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#logArchive(int)"><CODE>logArchive(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#log_compare(com.sleepycat.db.DbLsn, com.sleepycat.db.DbLsn)">log_compare</A></B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn0,
<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn1)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#logCompare(com.sleepycat.db.DbLsn, com.sleepycat.db.DbLsn)"><CODE>logCompare(DbLsn,DbLsn)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbLogc.html">DbLogc</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#log_cursor(int)">log_cursor</A></B>(int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#logCursor(int)"><CODE>logCursor(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#log_file(com.sleepycat.db.DbLsn)">log_file</A></B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#logFile(com.sleepycat.db.DbLsn)"><CODE>logFile(DbLsn)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#log_flush(com.sleepycat.db.DbLsn)">log_flush</A></B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#logFlush(com.sleepycat.db.DbLsn)"><CODE>logFlush(DbLsn)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#log_put(com.sleepycat.db.DbLsn, com.sleepycat.db.Dbt, int)">log_put</A></B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn,
<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> data,
int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#logPut(com.sleepycat.db.DbLsn, com.sleepycat.db.Dbt, int)"><CODE>logPut(DbLsn,Dbt,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbLogStat.html">DbLogStat</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#log_stat(int)">log_stat</A></B>(int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#logStat(int)"><CODE>logStat(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A>[]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#logArchive(int)">logArchive</A></B>(int flags)</CODE>
<BR>
The DbEnv.logArchive method returns an array of log or database filenames.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#logCompare(com.sleepycat.db.DbLsn, com.sleepycat.db.DbLsn)">logCompare</A></B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn0,
<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn1)</CODE>
<BR>
The DbEnv.logCompare method allows the caller to compare two <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> objects, returning 0 if they are equal, 1 if <b>lsn0</b> is greater than <b>lsn1</b>, and -1 if <b>lsn0</b> is less than <b>lsn1</b>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbLogc.html">DbLogc</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#logCursor(int)">logCursor</A></B>(int flags)</CODE>
<BR>
The DbEnv.logCursor method returns a created log cursor.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#logFile(com.sleepycat.db.DbLsn)">logFile</A></B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn)</CODE>
<BR>
The DbEnv.logFile method maps <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> objects to filenames, returning the name of the file containing the record named by <b>lsn</b>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#logFlush(com.sleepycat.db.DbLsn)">logFlush</A></B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn)</CODE>
<BR>
The DbEnv.logFlush method writes log records to disk.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#logPut(com.sleepycat.db.DbLsn, com.sleepycat.db.Dbt, int)">logPut</A></B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn,
<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> data,
int flags)</CODE>
<BR>
The DbEnv.logPut method appends records to the log.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbLogStat.html">DbLogStat</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#logStat(int)">logStat</A></B>(int flags)</CODE>
<BR>
The DbEnv.logStat method returns the logging subsystem statistics.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbMpoolFStat.html">DbMpoolFStat</A>[]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#memoryPoolFileStat(int)">memoryPoolFileStat</A></B>(int flags)</CODE>
<BR>
The DbEnv.memoryPoolFileStat method creates an array of DbMpoolFStat objects containing statistics for individual files in the cache.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbMpoolStat.html">DbMpoolStat</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#memoryPoolStat(int)">memoryPoolStat</A></B>(int flags)</CODE>
<BR>
The DbEnv.memoryPoolStat method returns the memory pool (that is, the buffer cache) subsystem statistics.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#memoryPoolTrickle(int)">memoryPoolTrickle</A></B>(int percent)</CODE>
<BR>
The DbEnv.memoryPoolTrickle method ensures that a specified percent of the pages in the shared memory pool are clean, by writing dirty pages to their backing files.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbMpoolFStat.html">DbMpoolFStat</A>[]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#memp_fstat(int)">memp_fstat</A></B>(int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#memoryPoolFileStat(int)"><CODE>memoryPoolFileStat(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbMpoolStat.html">DbMpoolStat</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#memp_stat(int)">memp_stat</A></B>(int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#memoryPoolStat(int)"><CODE>memoryPoolStat(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#memp_trickle(int)">memp_trickle</A></B>(int percent)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#memoryPoolTrickle(int)"><CODE>memoryPoolTrickle(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)">open</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> db_home,
int flags,
int mode)</CODE>
<BR>
The DbEnv.open method opens a Berkeley DB environment.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#remove(java.lang.String, int)">remove</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> db_home,
int flags)</CODE>
<BR>
The DbEnv.remove method destroys a Berkeley DB environment if it is not currently in use.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#rep_elect(int, int, int)">rep_elect</A></B>(int nsites,
int priority,
int timeout)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationElect(int, int, int)"><CODE>replicationElect(int,int,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#rep_process_message(com.sleepycat.db.Dbt, com.sleepycat.db.Dbt, com.sleepycat.db.DbEnv.RepProcessMessage, com.sleepycat.db.DbLsn)">rep_process_message</A></B>(<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> control,
<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> rec,
<A HREF="../../../com/sleepycat/db/DbEnv.RepProcessMessage.html">DbEnv.RepProcessMessage</A> envid,
<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> ret_lsn)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationProcessMessage(com.sleepycat.db.Dbt, com.sleepycat.db.Dbt, com.sleepycat.db.DbEnv.RepProcessMessage, com.sleepycat.db.DbLsn)"><CODE>replicationProcessMessage(Dbt,Dbt,DbEnv.RepProcessMessage,DbLsn)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#rep_start(com.sleepycat.db.Dbt, int)">rep_start</A></B>(<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> cdata,
int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationStart(com.sleepycat.db.Dbt, int)"><CODE>replicationStart(Dbt,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbRepStat.html">DbRepStat</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#rep_stat(int)">rep_stat</A></B>(int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationStat(int)"><CODE>replicationStat(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#replicationElect(int, int, int)">replicationElect</A></B>(int nsites,
int priority,
int timeout)</CODE>
<BR>
The DbEnv.replicationElect method holds an election for the master of a replication group.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#replicationProcessMessage(com.sleepycat.db.Dbt, com.sleepycat.db.Dbt, com.sleepycat.db.DbEnv.RepProcessMessage, com.sleepycat.db.DbLsn)">replicationProcessMessage</A></B>(<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> control,
<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> rec,
<A HREF="../../../com/sleepycat/db/DbEnv.RepProcessMessage.html">DbEnv.RepProcessMessage</A> envid,
<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> ret_lsn)</CODE>
<BR>
The DbEnv.replicationProcessMessage method processes an incoming replication message sent by a member of the replication group to the local database environment.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#replicationStart(com.sleepycat.db.Dbt, int)">replicationStart</A></B>(<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> cdata,
int flags)</CODE>
<BR>
The DbEnv.replicationStart method configures the database environment as a client or master in a group of replicated database environments.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbRepStat.html">DbRepStat</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#replicationStat(int)">replicationStat</A></B>(int flags)</CODE>
<BR>
The DbEnv.replicationStat method returns the replication subsystem statistics.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_app_dispatch(com.sleepycat.db.DbAppDispatch)">set_app_dispatch</A></B>(<A HREF="../../../com/sleepycat/db/DbAppDispatch.html">DbAppDispatch</A> tx_recover)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setAppDispatch(com.sleepycat.db.DbAppDispatch)"><CODE>setAppDispatch(DbAppDispatch)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_cachesize(int, int, int)">set_cachesize</A></B>(int gbytes,
int bytes,
int ncache)</CODE>
<BR>
<B>Deprecated.</B> <I>Replaced in Berkeley DB 4.2 by <A HREF="../../../com/sleepycat/db/DbEnv.html#setCacheSize(long, int)"><CODE>setCacheSize(long,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_cachesize(long, int)">set_cachesize</A></B>(long bytes,
int ncache)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setCacheSize(long, int)"><CODE>setCacheSize(long,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_data_dir(java.lang.String)">set_data_dir</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> dir)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setDataDir(java.lang.String)"><CODE>setDataDir(String)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_encrypt(java.lang.String, int)">set_encrypt</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> passwd,
int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setEncrypted(java.lang.String, int)"><CODE>setEncrypted(String,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_errcall(com.sleepycat.db.DbErrcall)">set_errcall</A></B>(<A HREF="../../../com/sleepycat/db/DbErrcall.html">DbErrcall</A> db_errcall_fcn)</CODE>
<BR>
<B>Deprecated.</B> <I>Replaced in Berkeley DB 4.2 by <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorHandler(com.sleepycat.db.DbErrorHandler)"><CODE>setErrorHandler(DbErrorHandler)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_error_stream(java.io.OutputStream)">set_error_stream</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/io/OutputStream.html">OutputStream</A> stream)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorStream(java.io.OutputStream)"><CODE>setErrorStream(java.io.OutputStream)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_errpfx(java.lang.String)">set_errpfx</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> errpfx)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorPrefix(java.lang.String)"><CODE>setErrorPrefix(String)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_feedback(com.sleepycat.db.DbEnvFeedback)">set_feedback</A></B>(<A HREF="../../../com/sleepycat/db/DbEnvFeedback.html">DbEnvFeedback</A> feedback)</CODE>
<BR>
<B>Deprecated.</B> <I>Replaced in Berkeley DB 4.2 by <A HREF="../../../com/sleepycat/db/DbEnv.html#setFeedbackHandler(com.sleepycat.db.DbEnvFeedbackHandler)"><CODE>setFeedbackHandler(DbEnvFeedbackHandler)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_flags(int, boolean)">set_flags</A></B>(int flags,
boolean onoff)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setFlags(int, boolean)"><CODE>setFlags(int,boolean)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_lg_bsize(int)">set_lg_bsize</A></B>(int lg_bsize)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLogBufferSize(int)"><CODE>setLogBufferSize(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_lg_dir(java.lang.String)">set_lg_dir</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> dir)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLogDir(java.lang.String)"><CODE>setLogDir(String)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_lg_max(int)">set_lg_max</A></B>(int lg_max)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLogMax(int)"><CODE>setLogMax(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_lg_regionmax(int)">set_lg_regionmax</A></B>(int lg_regionmax)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLogRegionMax(int)"><CODE>setLogRegionMax(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_lk_conflicts(byte[][])">set_lk_conflicts</A></B>(byte[][] conflicts)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLockConflicts(byte[][])"><CODE>setLockConflicts(byte[][])</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_lk_detect(int)">set_lk_detect</A></B>(int detect)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLockDetect(int)"><CODE>setLockDetect(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_lk_max_lockers(int)">set_lk_max_lockers</A></B>(int max)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLockMaxLockers(int)"><CODE>setLockMaxLockers(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_lk_max_locks(int)">set_lk_max_locks</A></B>(int max)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLockMaxLocks(int)"><CODE>setLockMaxLocks(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_lk_max_objects(int)">set_lk_max_objects</A></B>(int max)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLockMaxObjects(int)"><CODE>setLockMaxObjects(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_mp_mmapsize(long)">set_mp_mmapsize</A></B>(long mp_mmapsize)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setMemoryPoolMapSize(long)"><CODE>setMemoryPoolMapSize(long)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_rep_limit(int, int)">set_rep_limit</A></B>(int gbytes,
int bytes)</CODE>
<BR>
<B>Deprecated.</B> <I>Replaced in Berkeley DB 4.2 by <A HREF="../../../com/sleepycat/db/DbEnv.html#setReplicationLimit(long)"><CODE>setReplicationLimit(long)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_rep_limit(long)">set_rep_limit</A></B>(long bytes)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setReplicationLimit(long)"><CODE>setReplicationLimit(long)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_rep_transport(int, com.sleepycat.db.DbRepTransport)">set_rep_transport</A></B>(int envid,
<A HREF="../../../com/sleepycat/db/DbRepTransport.html">DbRepTransport</A> send)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setReplicationTransport(int, com.sleepycat.db.DbRepTransport)"><CODE>setReplicationTransport(int,DbRepTransport)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_rpc_server(com.sleepycat.db.DbClient, java.lang.String, long, long, int)">set_rpc_server</A></B>(<A HREF="../../../com/sleepycat/db/DbClient.html">DbClient</A> client,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> host,
long cl_timeout,
long sv_timeout,
int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setRpcServer(com.sleepycat.db.DbClient, java.lang.String, long, long, int)"><CODE>setRpcServer(DbClient,String,long,long,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_shm_key(long)">set_shm_key</A></B>(long shm_key)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setSegmentId(long)"><CODE>setSegmentId(long)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_tas_spins(int)">set_tas_spins</A></B>(int tas_spins)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setTestAndSetSpins(int)"><CODE>setTestAndSetSpins(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_timeout(long, int)">set_timeout</A></B>(long timeout,
int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setTimeout(long, int)"><CODE>setTimeout(long,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_tmp_dir(java.lang.String)">set_tmp_dir</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> dir)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setTmpDir(java.lang.String)"><CODE>setTmpDir(String)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_tx_max(int)">set_tx_max</A></B>(int max)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setTxnMax(int)"><CODE>setTxnMax(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_tx_timestamp(java.util.Date)">set_tx_timestamp</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/util/Date.html">Date</A> timestamp)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setTxnTimestamp(java.util.Date)"><CODE>setTxnTimestamp(java.util.Date)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#set_verbose(int, boolean)">set_verbose</A></B>(int which,
boolean onoff)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setVerbose(int, boolean)"><CODE>setVerbose(int,boolean)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setAppDispatch(com.sleepycat.db.DbAppDispatch)">setAppDispatch</A></B>(<A HREF="../../../com/sleepycat/db/DbAppDispatch.html">DbAppDispatch</A> tx_recover)</CODE>
<BR>
</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setCacheSize(long, int)">setCacheSize</A></B>(long bytes,
int ncache)</CODE>
<BR>
Set the size of the shared memory buffer pool -- that is, the cache.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setDataDir(java.lang.String)">setDataDir</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> dir)</CODE>
<BR>
Set the path of a directory to be used as the location of the access method database files.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setEncrypted(java.lang.String, int)">setEncrypted</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> passwd,
int flags)</CODE>
<BR>
Set the password used by the Berkeley DB library to perform encryption and decryption.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorHandler(com.sleepycat.db.DbErrorHandler)">setErrorHandler</A></B>(<A HREF="../../../com/sleepycat/db/DbErrorHandler.html">DbErrorHandler</A> db_errcall_fcn)</CODE>
<BR>
When an error occurs in the Berkeley DB library, an exception is thrown.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorPrefix(java.lang.String)">setErrorPrefix</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> errpfx)</CODE>
<BR>
Set the prefix string that appears before error messages issued by Berkeley DB.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorStream(java.io.OutputStream)">setErrorStream</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/io/OutputStream.html">OutputStream</A> stream)</CODE>
<BR>
When an error occurs in the Berkeley DB library, an exception is thrown.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setFeedbackHandler(com.sleepycat.db.DbEnvFeedbackHandler)">setFeedbackHandler</A></B>(<A HREF="../../../com/sleepycat/db/DbEnvFeedbackHandler.html">DbEnvFeedbackHandler</A> db_feedback_fcn)</CODE>
<BR>
</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setFlags(int, boolean)">setFlags</A></B>(int flags,
boolean onoff)</CODE>
<BR>
Configure a database environment.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setLockConflicts(byte[][])">setLockConflicts</A></B>(byte[][] conflicts)</CODE>
<BR>
Set the locking conflicts matrix.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setLockDetect(int)">setLockDetect</A></B>(int detect)</CODE>
<BR>
Set if the deadlock detector is to be run whenever a lock conflict occurs, and specify what lock request(s) should be rejected.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setLockMaxLockers(int)">setLockMaxLockers</A></B>(int max)</CODE>
<BR>
Set the maximum number of locking entities supported by the Berkeley DB environment.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setLockMaxLocks(int)">setLockMaxLocks</A></B>(int max)</CODE>
<BR>
Set the maximum number of locks supported by the Berkeley DB environment.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setLockMaxObjects(int)">setLockMaxObjects</A></B>(int max)</CODE>
<BR>
Set the maximum number of locked objects supported by the Berkeley DB environment.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setLogBufferSize(int)">setLogBufferSize</A></B>(int lg_bsize)</CODE>
<BR>
Set the size of the in-memory log buffer, in bytes.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setLogDir(java.lang.String)">setLogDir</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> dir)</CODE>
<BR>
The path of a directory to be used as the location of logging files.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setLogMax(int)">setLogMax</A></B>(int lg_max)</CODE>
<BR>
Set the maximum size of a single file in the log, in bytes.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setLogRegionMax(int)">setLogRegionMax</A></B>(int lg_regionmax)</CODE>
<BR>
Set the size of the underlying logging area of the Berkeley DB environment, in bytes.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setMemoryPoolMapSize(long)">setMemoryPoolMapSize</A></B>(long mp_mmapsize)</CODE>
<BR>
Files that are opened read-only in the pool (and that satisfy a few other criteria) are, by default, mapped into the process address space instead of being copied into the local cache.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setPanicHandler(com.sleepycat.db.DbPanicHandler)">setPanicHandler</A></B>(<A HREF="../../../com/sleepycat/db/DbPanicHandler.html">DbPanicHandler</A> db_panic_fcn)</CODE>
<BR>
</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setReplicationLimit(long)">setReplicationLimit</A></B>(long bytes)</CODE>
<BR>
The DbEnv.setReplicationLimit method imposes a byte-count limit on the amount of data that will be transmitted from a site in a single call to <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationProcessMessage(com.sleepycat.db.Dbt, com.sleepycat.db.Dbt, com.sleepycat.db.DbEnv.RepProcessMessage, com.sleepycat.db.DbLsn)"><CODE>DbEnv.replicationProcessMessage</CODE></A> method.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setReplicationTransport(int, com.sleepycat.db.DbRepTransport)">setReplicationTransport</A></B>(int envid,
<A HREF="../../../com/sleepycat/db/DbRepTransport.html">DbRepTransport</A> send)</CODE>
<BR>
</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setRpcServer(com.sleepycat.db.DbClient, java.lang.String, long, long, int)">setRpcServer</A></B>(<A HREF="../../../com/sleepycat/db/DbClient.html">DbClient</A> client,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> host,
long cl_timeout,
long sv_timeout,
int flags)</CODE>
<BR>
Establishes a connection for this <b>dbenv</b> to a RPC server.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setSegmentId(long)">setSegmentId</A></B>(long shm_key)</CODE>
<BR>
Specify a base segment ID for Berkeley DB environment shared memory regions created in system memory on VxWorks or systems supporting X/Open-style shared memory interfaces; for example, UNIX systems supporting <b>shmget</b>(2) and related System V IPC interfaces.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setTestAndSetSpins(int)">setTestAndSetSpins</A></B>(int tas_spins)</CODE>
<BR>
Specify that test-and-set mutexes should spin <b>tas_spins</b> times without blocking.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setTimeout(long, int)">setTimeout</A></B>(long timeout,
int flags)</CODE>
<BR>
The DbEnv.setTimeout method sets timeout values for locks or transactions in the database environment.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setTmpDir(java.lang.String)">setTmpDir</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> dir)</CODE>
<BR>
Specify the path of a directory to be used as the location of temporary files.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setTxnMax(int)">setTxnMax</A></B>(int max)</CODE>
<BR>
Configure the Berkeley DB database environment to support at least <b>max</b> active transactions.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setTxnTimestamp(java.util.Date)">setTxnTimestamp</A></B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/util/Date.html">Date</A> timestamp)</CODE>
<BR>
Recover to the time specified by <b>timestamp</b> rather than to the most current possible date.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#setVerbose(int, boolean)">setVerbose</A></B>(int which,
boolean onoff)</CODE>
<BR>
The DbEnv.setVerbose method turns specific additional informational and debugging messages in the Berkeley DB message output on and off.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#strerror(int)">strerror</A></B>(int error)</CODE>
<BR>
The DbEnv.strerror method returns an error message string corresponding to the error number <b>error</b> parameter.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#txn_begin(com.sleepycat.db.DbTxn, int)">txn_begin</A></B>(<A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A> parent,
int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#txnBegin(com.sleepycat.db.DbTxn, int)"><CODE>txnBegin(DbTxn,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#txn_checkpoint(int, int, int)">txn_checkpoint</A></B>(int kbyte,
int min,
int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#txnCheckpoint(int, int, int)"><CODE>txnCheckpoint(int,int,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbPreplist.html">DbPreplist</A>[]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#txn_recover(int, int)">txn_recover</A></B>(int count,
int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#txnRecover(int, int)"><CODE>txnRecover(int,int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbTxnStat.html">DbTxnStat</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#txn_stat(int)">txn_stat</A></B>(int flags)</CODE>
<BR>
<B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#txnStat(int)"><CODE>txnStat(int)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#txnBegin(com.sleepycat.db.DbTxn, int)">txnBegin</A></B>(<A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A> parent,
int flags)</CODE>
<BR>
The DbEnv.txnBegin method creates a new transaction in the environment and returns a <A HREF="../../../com/sleepycat/db/DbTxn.html"><CODE>DbTxn</CODE></A> that uniquely identifies it.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#txnCheckpoint(int, int, int)">txnCheckpoint</A></B>(int kbyte,
int min,
int flags)</CODE>
<BR>
The DbEnv.txnCheckpoint method flushes the underlying memory pool, writes a checkpoint record to the log, and then flushes the log.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbPreplist.html">DbPreplist</A>[]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#txnRecover(int, int)">txnRecover</A></B>(int count,
int flags)</CODE>
<BR>
The DbEnv.txnRecover method returns a list of prepared but not yet resolved transactions.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../com/sleepycat/db/DbTxnStat.html">DbTxnStat</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#txnStat(int)">txnStat</A></B>(int flags)</CODE>
<BR>
The DbEnv.txnStat method returns the transaction subsystem statistics.</TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html">Object</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html#equals(java.lang.Object)">equals</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html#getClass()">getClass</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html#hashCode()">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html#notify()">notify</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html#toString()">toString</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html#wait()">wait</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html#wait(long)">wait</A>, <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html#wait(long, int)">wait</A></CODE></TD>
</TR>
</TABLE>
<P>
<!-- ============ FIELD DETAIL =========== -->
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>
<A NAME="DbEnv(int)"><!-- --></A><H3>
DbEnv</H3>
<PRE>
public <B>DbEnv</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The constructor creates the DbEnv object. The constructor allocates memory internally; calling the <A HREF="../../../com/sleepycat/db/DbEnv.html#close(int)"><CODE>DbEnv.close</CODE></A> or <A HREF="../../../com/sleepycat/db/DbEnv.html#remove(java.lang.String, int)"><CODE>DbEnv.remove</CODE></A> methods will free that memory.</p>
<P>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - The following <b>flags</b> value may be specified:</p> <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_RPCCLIENT"><CODE>Db.DB_RPCCLIENT</CODE></A><p>Create a client environment to connect to a server. <p>The <code>Db.DB_RPCCLIENT</code> flag indicates to the system that this environment is remote on a server. The use of this flag causes the environment methods to use functions that call a server instead of local functions. Prior to making any environment or database method calls, the application must call the <A HREF="../../../com/sleepycat/db/DbEnv.html#setRpcServer(com.sleepycat.db.DbClient, java.lang.String, long, long, int)"><CODE>DbEnv.setRpcServer</CODE></A> function to establish the connection to the server.</p> </li></ul>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
<!-- ============ METHOD DETAIL ========== -->
<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>
<A NAME="close(int)"><!-- --></A><H3>
close</H3>
<PRE>
public void <B>close</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.close method closes the Berkeley DB environment, freeing any allocated resources and closing any underlying subsystems.</p> <p>The <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle should not be closed while any other handle that refers to it is not yet closed; for example, database environment handles must not be closed while database handles remain open, or transactions in the environment have not yet been committed or aborted. Specifically, this includes <A HREF="../../../com/sleepycat/db/Db.html"><CODE>Db</CODE></A>, <A HREF="../../../com/sleepycat/db/Dbc.html"><CODE>Dbc</CODE></A>, <A HREF="../../../com/sleepycat/db/DbTxn.html"><CODE>DbTxn</CODE></A>, <A HREF="../../../com/sleepycat/db/DbLogc.html"><CODE>DbLogc</CODE></A> and <A HREF="../../../com/sleepycat/db/DbMpoolFile.html"><CODE>DbMpoolFile</CODE></A> handles.</p> <p>Where the environment was initialized with the <A HREF="../../../com/sleepycat/db/Db.html#DB_INIT_LOCK"><CODE>Db.DB_INIT_LOCK</CODE></A> flag, calling DbEnv.close does not release any locks still held by the closing process, providing functionality for long-lived locks. </p> <p>Where the environment was initialized with the <A HREF="../../../com/sleepycat/db/Db.html#DB_INIT_TXN"><CODE>Db.DB_INIT_TXN</CODE></A> flag, calling DbEnv.close aborts any unresolved transactions. Applications should not depend on this behavior for transactions involving Berkeley DB databases; all such transactions should be explicitly resolved. The problem with depending on this semantic is that aborting an unresolved transaction involving database operations requires a database handle. Because the database handles should have been closed before calling DbEnv.close, it will not be possible to abort the transaction, and recovery will have to be run on the Berkeley DB environment before further operations are done.</p> <p>Where log cursors were created using the <A HREF="../../../com/sleepycat/db/DbEnv.html#logCursor(int)"><CODE>DbEnv.logCursor</CODE></A> method, calling DbEnv.close does not imply closing those cursors.</p> <p>In multithreaded applications, only a single thread may call DbEnv.close.</p> <p>After DbEnv.close has been called, regardless of its return, the Berkeley DB environment handle may not be accessed again.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - currently unused, and must be set to 0.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="lock_vec(int, int, com.sleepycat.db.DbLockRequest[], int, int)"><!-- --></A><H3>
lock_vec</H3>
<PRE>
public void <B>lock_vec</B>(int locker,
int flags,
<A HREF="../../../com/sleepycat/db/DbLockRequest.html">DbLockRequest</A>[] list,
int offset,
int count)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#lockVector(int, int, com.sleepycat.db.DbLockRequest[], int, int)"><CODE>lockVector(int,int,DbLockRequest[],int,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="lockVector(int, int, com.sleepycat.db.DbLockRequest[], int, int)"><!-- --></A><H3>
lockVector</H3>
<PRE>
public void <B>lockVector</B>(int locker,
int flags,
<A HREF="../../../com/sleepycat/db/DbLockRequest.html">DbLockRequest</A>[] list,
int offset,
int count)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.lockVector method atomically obtains and releases one or more locks from the lock table. The DbEnv.lockVector method is intended to support acquisition or trading of multiple locks under one lock table semaphore, as is needed for lock coupling or in multigranularity locking for lock escalation.</p> <p>If any of the requested locks cannot be acquired, or any of the locks to be released cannot be released, the operations before the failing operation are guaranteed to have completed successfully, and DbEnv.lockVector throws an exception</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - must be set to 0 or the following value: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_NOWAIT"><CODE>Db.DB_LOCK_NOWAIT</CODE></A><p>If a lock cannot be granted because the requested lock conflicts with an existing lock, throw a <A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html"><CODE>DbLockNotGrantedException</CODE></A> immediately instead of waiting for the lock to become available. In this case, the index of the request that was not granted can be found by calling DbLockNotGrantedException.get_index. </li></ul><DD><CODE>locker</CODE> - an unsigned 32-bit integer quantity. It represents the entity requesting or releasing the lock.<DD><CODE>list</CODE> - The <b>list</b> array provided to DbEnv.lockVector is a set of DbLockRequest objects. Only <b>count</b> elements of <b>list</b> starting at <b>offset</b> are considered by DbEnv.lockVector. A DbLockRequest object has at least the following fields: <p>A DB_LOCKREQ structure has at least the following fields:</p> <p>The operation to be performed, which must be set to one of the following values: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_GET"><CODE>Db.DB_LOCK_GET</CODE></A><p>Get the lock defined by the values of the <b>mode</b> and <b>obj</b> structure fields, for the specified <b>locker</b>. Upon return from DbEnv.lockVector, if the <b>lock</b> field is non-null, a reference to the acquired lock is stored there. (This reference is invalidated by any call to DbEnv.lockVector or <A HREF="../../../com/sleepycat/db/DbEnv.html#lockPut(com.sleepycat.db.DbLock)"><CODE>DbEnv.lockPut</CODE></A> that releases the lock.) </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_GET_TIMEOUT"><CODE>Db.DB_LOCK_GET_TIMEOUT</CODE></A><p>Identical to <code>Db.DB_LOCK_GET</code> except that the value in the <b>timeout</b> structure field overrides any previously specified timeout value for this lock. A value of 0 turns off any previously specified timeout. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_PUT"><CODE>Db.DB_LOCK_PUT</CODE></A><p>The lock to which the <b>lock</b> structure field refers is released. The <b>locker</b> parameter, and <b>mode</b> and <b>obj</b> fields are ignored. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_PUT_ALL"><CODE>Db.DB_LOCK_PUT_ALL</CODE></A><p>All locks held by the specified <b>locker</b> are released. The <b>lock</b>, <b>mode</b>, and <b>obj</b> structure fields are ignored. Locks acquired in operations performed by the current call to DbEnv.lockVector which appear before the <code>Db.DB_LOCK_PUT_ALL</code> operation are released; those acquired in operations appearing after the <code>Db.DB_LOCK_PUT_ALL</code> operation are not released. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_PUT_OBJ"><CODE>Db.DB_LOCK_PUT_OBJ</CODE></A><p>All locks held on <b>obj</b> are released. The <b>locker</b> parameter and the <b>lock</b> and <b>mode</b> structure fields are ignored. Locks acquired in operations performed by the current call to DbEnv.lockVector that appear before the <code>Db.DB_LOCK_PUT_OBJ</code> operation are released; those acquired in operations appearing after the <code>Db.DB_LOCK_PUT_OBJ</code> operation are not released. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_TIMEOUT"><CODE>Db.DB_LOCK_TIMEOUT</CODE></A><p>Cause the specified <b>locker</b> to timeout immediately. If the database environment has not configured automatic deadlock detection, the transaction will timeout the next time deadlock detection is performed. As transactions acquire locks on behalf of a single locker ID, timing out the locker ID associated with a transaction will time out the transaction itself. </li></ul>A lock reference. <p>The lock mode, used as an index into the environment's lock conflict matrix. When using the default lock conflict matrix, <b>mode</b> must be set to one of the following values: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_READ"><CODE>Db.DB_LOCK_READ</CODE></A><p>read (shared) </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_WRITE"><CODE>Db.DB_LOCK_WRITE</CODE></A><p>write (exclusive) </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_IWRITE"><CODE>Db.DB_LOCK_IWRITE</CODE></A><p>intention to write (shared) </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_IREAD"><CODE>Db.DB_LOCK_IREAD</CODE></A><p>intention to read (shared) </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_IWR"><CODE>Db.DB_LOCK_IWR</CODE></A><p>intention to read and write (shared) </li></ul>See <A HREF="../../../com/sleepycat/db/DbEnv.html#setLockConflicts(byte[][])"><CODE>DbEnv.setLockConflicts</CODE></A> and <a href="../../../../ref/lock/stdmode.html">Standard Lock Modes</a> for more information on the lock conflict matrix.</p> <p>An untyped byte string that specifies the object to be locked or released. Applications using the locking subsystem directly while also doing locking via the Berkeley DB access methods must take care not to inadvertently lock objects that happen to be equal to the unique file IDs used to lock files. See <a href="../../../../ref/lock/am_conv.html">Access method locking conventions</a> for more information. <p>The lock timeout value.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbDeadlockException.html">DbDeadlockException</A></CODE> - If a transactional database environment operation was selected to resolve a deadlock, the DbEnv.lockVector method will fail and throw a <A HREF="../../../com/sleepycat/db/DbDeadlockException.html"><CODE>DbDeadlockException</CODE></A> exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html">DbLockNotGrantedException</A></CODE> - If a Berkeley DB Concurrent Data Store database environment configured for lock timeouts was unable to grant a lock in the allowed time, the DbEnv.lockVector method will fail and throw a <A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html"><CODE>DbLockNotGrantedException</CODE></A> exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html">DbLockNotGrantedException</A></CODE> - If the <A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_NOWAIT"><CODE>Db.DB_LOCK_NOWAIT</CODE></A> flag or lock timers were configured and the lock could not be granted before the wait-time expired, the DbEnv.lockVector method will fail and throw a <A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html"><CODE>DbLockNotGrantedException</CODE></A> exception.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.lockVector method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbMemoryException.html">DbMemoryException</A></CODE> - If the maximum number of locks has been reached, the DbEnv.lockVector method will fail and throw a <A HREF="../../../com/sleepycat/db/DbMemoryException.html"><CODE>DbMemoryException</CODE></A> exception.</DL>
</DD>
</DL>
<HR>
<A NAME="open(java.lang.String, int, int)"><!-- --></A><H3>
open</H3>
<PRE>
public void <B>open</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> db_home,
int flags,
int mode)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A>,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/io/FileNotFoundException.html">FileNotFoundException</A></PRE>
<DL>
<DD>The DbEnv.open method opens a Berkeley DB environment. It provides a structure for creating a consistent environment for processes using one or more of the features of Berkeley DB.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>db_home</CODE> - the database environment's home directory. For more information on <b>db_home</b>, and filename resolution in general, see <a href="../../../../ref/env/naming.html">Berkeley DB File Naming</a>. The environment variable <b>DB_HOME</b> may be used as the path of the database home, as described in <a href="../../../../ref/env/naming.html">Berkeley DB File Naming</a>.<DD><CODE>flags</CODE> - specifies the subsystems that are initialized and how the application's environment affects Berkeley DB file naming, among other things. The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <p>Because there are a large number of flags that can be specified, they have been grouped together by functionality. The first group of flags indicates which of the Berkeley DB subsystems should be initialized:</p> <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_JOINENV"><CODE>Db.DB_JOINENV</CODE></A><p>Join an existing environment. This option allows applications to join an existing environment without knowing which Berkeley DB subsystems the environment supports. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_INIT_CDB"><CODE>Db.DB_INIT_CDB</CODE></A><p>Initialize locking for the <a href="../../../../ref/cam/intro.html">Berkeley DB Concurrent Data Store</a> product. In this mode, Berkeley DB provides multiple reader/single writer access. The only other subsystem that should be specified with the <code>Db.DB_INIT_CDB</code> flag is <code>Db.DB_INIT_MPOOL</code>. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_INIT_LOCK"><CODE>Db.DB_INIT_LOCK</CODE></A><p>Initialize the locking subsystem. This subsystem should be used when multiple processes or threads are going to be reading and writing a Berkeley DB database, so that they do not interfere with each other. If all threads are accessing the database(s) read-only, locking is unnecessary. When the <code>Db.DB_INIT_LOCK</code> flag is specified, it is usually necessary to run a deadlock detector, as well. See <a href="../../../../utility/db_deadlock.html">db_deadlock</a> and <A HREF="../../../com/sleepycat/db/DbEnv.html#lockDetect(int, int)"><CODE>DbEnv.lockDetect</CODE></A> for more information. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_INIT_LOG"><CODE>Db.DB_INIT_LOG</CODE></A><p>Initialize the logging subsystem. This subsystem should be used when recovery from application or system failure is necessary. If the log region is being created and log files are already present, the log files are reviewed; subsequent log writes are appended to the end of the log, rather than overwriting current log entries. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_INIT_MPOOL"><CODE>Db.DB_INIT_MPOOL</CODE></A><p>Initialize the shared memory buffer pool subsystem. This subsystem should be used whenever an application is using any Berkeley DB access method. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_INIT_REP"><CODE>Db.DB_INIT_REP</CODE></A><p>Initialize the replication subsystem. This subsystem should be used whenever an application plans on using replication. The <code>Db.DB_INIT_REP</code> flag requires the <code>Db.DB_INIT_TXN</code> and <code>Db.DB_INIT_LOCK</code> flags also be configured. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_INIT_TXN"><CODE>Db.DB_INIT_TXN</CODE></A><p>Initialize the transaction subsystem. This subsystem should be used when recovery and atomicity of multiple operations are important. The <code>Db.DB_INIT_TXN</code> flag implies the <code>Db.DB_INIT_LOG</code> flag. </li></ul>The second group of flags govern what recovery, if any, is performed when the environment is initialized:</p> <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_RECOVER"><CODE>Db.DB_RECOVER</CODE></A><p>Run normal recovery on this environment before opening it for normal use. If this flag is set, the <code>Db.DB_CREATE</code> flag must also be set because the regions will be removed and re-created. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_RECOVER_FATAL"><CODE>Db.DB_RECOVER_FATAL</CODE></A><p>Run catastrophic recovery on this environment before opening it for normal use. If this flag is set, the <code>Db.DB_CREATE</code> flag must also be set because the regions will be removed and re-created. </li></ul>A standard part of the recovery process is to remove the existing Berkeley DB environment and create a new one in which to perform recovery. If the thread of control performing recovery does not specify the correct region initialization information (for example, the correct memory pool cache size), the result can be an application running in an environment with incorrect cache and other subsystem sizes. For this reason, the thread of control performing recovery should specify correct configuration information before calling the DbEnv.open method; or it should remove the environment after recovery is completed, leaving creation of the correctly sized environment to a subsequent call to DbEnv.open.</p> <p>All Berkeley DB recovery processing must be single-threaded; that is, only a single thread of control may perform recovery or access a Berkeley DB environment while recovery is being performed. Because it is not an error to specify Db.DB_RECOVER for an environment for which no recovery is required, it is reasonable programming practice for the thread of control responsible for performing recovery and creating the environment to always specify the Db.DB_CREATE and Db.DB_RECOVER flags during startup.</p> <p>The DbEnv.open function returns successfully if Db.DB_RECOVER or Db.DB_RECOVER_FATAL is specified and no log files exist, so it is necessary to ensure that all necessary log files are present before running recovery. For further information, consult <a href="../../../../utility/db_archive.html">db_archive</a> and <a href="../../../../utility/db_recover.html">db_recover</a>.</p> <p>The third group of flags govern file-naming extensions in the environment:</p> <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_USE_ENVIRON"><CODE>Db.DB_USE_ENVIRON</CODE></A><p>The Berkeley DB process' environment may be permitted to specify information to be used when naming files; see <a href="../../../../ref/env/naming.html">Berkeley DB File Naming</a>. Because permitting users to specify which files are used can create security problems, environment information will be used in file naming for all users only if the <code>Db.DB_USE_ENVIRON</code> flag is set. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_USE_ENVIRON_ROOT"><CODE>Db.DB_USE_ENVIRON_ROOT</CODE></A><p>The Berkeley DB process' environment may be permitted to specify information to be used when naming files; see <a href="../../../../ref/env/naming.html">Berkeley DB File Naming</a>. Because permitting users to specify which files are used can create security problems, if the <code>Db.DB_USE_ENVIRON_ROOT</code> flag is set, environment information will be used for file naming only for users with appropriate permissions (for example, users with a user-ID of 0 on UNIX systems). </li></ul>Finally, there are a few additional unrelated flags:</p> <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_CREATE"><CODE>Db.DB_CREATE</CODE></A><p>Cause Berkeley DB subsystems to create any underlying files, as necessary. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCKDOWN"><CODE>Db.DB_LOCKDOWN</CODE></A><p>Lock shared Berkeley DB environment files and memory-mapped databases into memory. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_PRIVATE"><CODE>Db.DB_PRIVATE</CODE></A><p>Specify that the environment will only be accessed by a single process (although that process may be multithreaded). This flag has two effects on the Berkeley DB environment. First, all underlying data structures are allocated from per-process memory instead of from shared memory that is potentially accessible to more than a single process. Second, mutexes are only configured to work between threads. <p>This flag should not be specified if more than a single process is accessing the environment because it is likely to cause database corruption and unpredictable behavior. For example, if both a server application and the Berkeley DB utility <a href="../../../../utility/db_stat.html">db_stat</a> are expected to access the environment, the <code>Db.DB_PRIVATE</code> flag should not be specified.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_SYSTEM_MEM"><CODE>Db.DB_SYSTEM_MEM</CODE></A><p>Allocate memory from system shared memory instead of from memory backed by the filesystem. See <a href="../../../../ref/env/region.html">Shared Memory Regions</a> for more information. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_THREAD"><CODE>Db.DB_THREAD</CODE></A><p>Cause the <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle returned by DbEnv.open to be <i>free-threaded</i>; that is, usable by multiple threads within a single address space. <p>Threading is always assumed in the Java API, so no special flags are required and Berkeley DB functions will always behave as if the <code>Db.DB_THREAD</code> flag was specified.</p> </li></ul><DD><CODE>mode</CODE> - On UNIX systems or in IEEE/ANSI Std 1003.1 (POSIX) environments, all files created by Berkeley DB are created with mode <b>mode</b> (as described in <b>chmod</b>(2)) and modified by the process' umask value at the time of creation (see <b>umask</b>(2)). If <b>mode</b> is 0, Berkeley DB will use a default mode of readable and writable by both owner and group. On Windows systems, the mode parameter is ignored. The group ownership of created files is based on the system and directory defaults, and is not further specified by Berkeley DB.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - The DbEnv.open method may fail and throw <A HREF="../../../com/sleepycat/db/DbException.html"><CODE>DbException</CODE></A>, encapsulating one of the following non-zero errors: <li>The shared memory region was locked and (repeatedly) unavailable. <li>HP-UX only: a previously created Berkeley DB environment for this process still exists.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.open method will fail and throw a IllegalArgumentException exception if the Db.DB_THREAD flag was specified and fast mutexes are not available for this architecture; The DB_HOME or TMPDIR environment variables were set, but empty; An incorrectly formatted <b>NAME VALUE</b> entry or line was found; or if an invalid flag value or parameter was specified.
<DD><CODE>FileNotFoundException</CODE> - If the file or directory does not exist, the DbEnv.open method will fail and throw a FileNotFoundException exception.</DL>
</DD>
</DL>
<HR>
<A NAME="remove(java.lang.String, int)"><!-- --></A><H3>
remove</H3>
<PRE>
public void <B>remove</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> db_home,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A>,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/io/FileNotFoundException.html">FileNotFoundException</A></PRE>
<DL>
<DD>The DbEnv.remove method destroys a Berkeley DB environment if it is not currently in use. The environment regions, including any backing files, are removed. Any log or database files and the environment directory are not removed.</p> <p>If there are processes that have called <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> without calling <A HREF="../../../com/sleepycat/db/DbEnv.html#close(int)"><CODE>DbEnv.close</CODE></A> (that is, there are processes currently using the environment), DbEnv.remove will fail without further action unless the <A HREF="../../../com/sleepycat/db/Db.html#DB_FORCE"><CODE>Db.DB_FORCE</CODE></A> flag is set, in which case DbEnv.remove will attempt to remove the environment, regardless of any processes still using it.</p> <p>The result of attempting to forcibly destroy the environment when it is in use is unspecified. Processes using an environment often maintain open file descriptors for shared regions within it. On UNIX systems, the environment removal will usually succeed, and processes that have already joined the region will continue to run in that region without change. However, processes attempting to join the environment will either fail or create new regions. On other systems in which the <b>unlink</b>(2) system call will fail if any process has an open file descriptor for the file (for example Windows/NT), the region removal will fail.</p> <p>Calling DbEnv.remove should not be necessary for most applications because the Berkeley DB environment is cleaned up as part of normal database recovery procedures. However, applications may want to call DbEnv.remove as part of application shut down to free up system resources. For example, if the <A HREF="../../../com/sleepycat/db/Db.html#DB_SYSTEM_MEM"><CODE>Db.DB_SYSTEM_MEM</CODE></A> flag was specified to <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A>, it may be useful to call DbEnv.remove in order to release system shared memory segments that have been allocated. Or, on architectures in which mutexes require allocation of underlying system resources, it may be useful to call DbEnv.remove in order to release those resources. Alternatively, if recovery is not required because no database state is maintained across failures, and no system resources need to be released, it is possible to clean up an environment by simply removing all the Berkeley DB files in the database environment's directories.</p> <p>In multithreaded applications, only a single thread may call DbEnv.remove.</p> <p>A <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle that has already been used to open an environment should not be used to call the DbEnv.remove method; a new <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle should be created for that purpose.</p> <p>After DbEnv.remove has been called, regardless of its return, the Berkeley DB environment handle may not be accessed again.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>db_home</CODE> - The <b>db_home</b> parameter names the database environment to be removed.<DD><CODE>flags</CODE> - must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_FORCE"><CODE>Db.DB_FORCE</CODE></A><p>If the <A HREF="../../../com/sleepycat/db/Db.html#DB_FORCE"><CODE><code>Db.DB_FORCE</code></CODE></A> flag is set, the environment is removed, regardless of any processes that may still using it, and no locks are acquired during this process. (Generally, the <A HREF="../../../com/sleepycat/db/Db.html#DB_FORCE"><CODE><code>Db.DB_FORCE</code></CODE></A> flag is specified only when applications were unable to shut down cleanly, and there is a risk that an application may have died holding a Berkeley DB lock.) </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_USE_ENVIRON"><CODE>Db.DB_USE_ENVIRON</CODE></A><p>The Berkeley DB process' environment may be permitted to specify information to be used when naming files; see <a href="../../../../ref/env/naming.html">Berkeley DB File Naming</a>. Because permitting users to specify which files are used can create security problems, environment information will be used in file naming for all users only if the <code>Db.DB_USE_ENVIRON</code> flag is set. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_USE_ENVIRON_ROOT"><CODE>Db.DB_USE_ENVIRON_ROOT</CODE></A><p>The Berkeley DB process' environment may be permitted to specify information to be used when naming files; see <a href="../../../../ref/env/naming.html">Berkeley DB File Naming</a>. Because permitting users to specify which files are used can create security problems, if the <code>Db.DB_USE_ENVIRON_ROOT</code> flag is set, environment information will be used for file naming only for users with appropriate permissions (for example, users with a user-ID of 0 on UNIX systems). </li></ul>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - The DbEnv.remove method may fail and throw <A HREF="../../../com/sleepycat/db/DbException.html"><CODE>DbException</CODE></A>, encapsulating one of the following non-zero errors: <li>The shared memory region was in use and the force flag was not set.
<DD><CODE>FileNotFoundException</CODE> - If the file or directory does not exist, the DbEnv.remove method will fail and throw a FileNotFoundException exception.</DL>
</DD>
</DL>
<HR>
<A NAME="set_cachesize(int, int, int)"><!-- --></A><H3>
set_cachesize</H3>
<PRE>
public void <B>set_cachesize</B>(int gbytes,
int bytes,
int ncache)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>Replaced in Berkeley DB 4.2 by <A HREF="../../../com/sleepycat/db/DbEnv.html#setCacheSize(long, int)"><CODE>setCacheSize(long,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="get_errpfx()"><!-- --></A><H3>
get_errpfx</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> <B>get_errpfx</B>()</PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getErrorPrefix()"><CODE>getErrorPrefix()</CODE></A></I>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="getErrorPrefix()"><!-- --></A><H3>
getErrorPrefix</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> <B>getErrorPrefix</B>()</PRE>
<DL>
<DD>The DbEnv.getErrorPrefix method returns the error prefix.</p> <p>The DbEnv.getErrorPrefix method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getErrorPrefix method returns the error prefix.</p></DL>
</DD>
</DL>
<HR>
<A NAME="set_errcall(com.sleepycat.db.DbErrcall)"><!-- --></A><H3>
set_errcall</H3>
<PRE>
public void <B>set_errcall</B>(<A HREF="../../../com/sleepycat/db/DbErrcall.html">DbErrcall</A> db_errcall_fcn)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>Replaced in Berkeley DB 4.2 by <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorHandler(com.sleepycat.db.DbErrorHandler)"><CODE>setErrorHandler(DbErrorHandler)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="set_error_stream(java.io.OutputStream)"><!-- --></A><H3>
set_error_stream</H3>
<PRE>
public void <B>set_error_stream</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/io/OutputStream.html">OutputStream</A> stream)</PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorStream(java.io.OutputStream)"><CODE>setErrorStream(java.io.OutputStream)</CODE></A></I>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="setErrorStream(java.io.OutputStream)"><!-- --></A><H3>
setErrorStream</H3>
<PRE>
public void <B>setErrorStream</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/io/OutputStream.html">OutputStream</A> stream)</PRE>
<DL>
<DD>When an error occurs in the Berkeley DB library, an exception is thrown. In some cases, however, the error information known to the Java layer may be insufficient to completely describe the cause of the error, especially during initial application debugging.</p> <p>The DbEnv.setErrorStream and <A HREF="../../../com/sleepycat/db/Db.html#setErrorStream(java.io.OutputStream)"><CODE>Db.setErrorStream</CODE></A> methods are used to enhance the mechanism for reporting error messages to the application by setting a OutputStream to be used for displaying additional Berkeley DB error messages. In some cases, when an error occurs, Berkeley DB will output an additional error message to the specified stream.</p> <p>The error message will consist of the prefix string and a colon ("<b>:</b>") (if a prefix string was previously specified using <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorPrefix(java.lang.String)"><CODE>DbEnv.setErrorPrefix</CODE></A>), an error string, and a trailing <newline> character.</p> <p>Alternatively, you can use the <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorHandler(com.sleepycat.db.DbErrorHandler)"><CODE>DbEnv.setErrorHandler</CODE></A> method to capture the additional error information in a way that does not use output streams. You should not mix these approaches. </p> <p>This error-logging enhancement does not slow performance or significantly increase application size, and may be run during normal operation as well as during application debugging.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>stream</CODE> - the application-specified output stream to be used for additional error information.</DL>
</DD>
</DL>
<HR>
<A NAME="set_errpfx(java.lang.String)"><!-- --></A><H3>
set_errpfx</H3>
<PRE>
public void <B>set_errpfx</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> errpfx)</PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorPrefix(java.lang.String)"><CODE>setErrorPrefix(String)</CODE></A></I>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="setErrorPrefix(java.lang.String)"><!-- --></A><H3>
setErrorPrefix</H3>
<PRE>
public void <B>setErrorPrefix</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> errpfx)</PRE>
<DL>
<DD>Set the prefix string that appears before error messages issued by Berkeley DB.</p> <p>The DbEnv.setErrorPrefix method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>errpfx</CODE> - the application-specified error prefix for additional error messages.</DL>
</DD>
</DL>
<HR>
<A NAME="set_feedback(com.sleepycat.db.DbEnvFeedback)"><!-- --></A><H3>
set_feedback</H3>
<PRE>
public void <B>set_feedback</B>(<A HREF="../../../com/sleepycat/db/DbEnvFeedback.html">DbEnvFeedback</A> feedback)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>Replaced in Berkeley DB 4.2 by <A HREF="../../../com/sleepycat/db/DbEnv.html#setFeedbackHandler(com.sleepycat.db.DbEnvFeedbackHandler)"><CODE>setFeedbackHandler(DbEnvFeedbackHandler)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="set_rep_limit(int, int)"><!-- --></A><H3>
set_rep_limit</H3>
<PRE>
public void <B>set_rep_limit</B>(int gbytes,
int bytes)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>Replaced in Berkeley DB 4.2 by <A HREF="../../../com/sleepycat/db/DbEnv.html#setReplicationLimit(long)"><CODE>setReplicationLimit(long)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="set_tx_timestamp(java.util.Date)"><!-- --></A><H3>
set_tx_timestamp</H3>
<PRE>
public void <B>set_tx_timestamp</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/util/Date.html">Date</A> timestamp)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setTxnTimestamp(java.util.Date)"><CODE>setTxnTimestamp(java.util.Date)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setTxnTimestamp(java.util.Date)"><!-- --></A><H3>
setTxnTimestamp</H3>
<PRE>
public void <B>setTxnTimestamp</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/util/Date.html">Date</A> timestamp)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Recover to the time specified by <b>timestamp</b> rather than to the most current possible date.</p> <p>Once a database environment has been upgraded to a new version of Berkeley DB involving a log format change (see <a href="../../../../ref/upgrade/process.html">Upgrading Berkeley DB installations</a>), it is no longer possible to recover to a specific time before that upgrade.</p> <p>The DbEnv.setTxnTimestamp method configures operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle, not all operations performed on the underlying database environment.</p> <p>The DbEnv.setTxnTimestamp method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>timestamp</CODE> - references the memory location where the recovery timestamp is located. <p>Note that only the seconds (not the milliseconds) of the <b>timestamp</b> are used</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setTxnTimestamp method will fail and throw a IllegalArgumentException exception if it is not possible to recover to the specified time using the log files currently present in the environment; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="dbremove(com.sleepycat.db.DbTxn, java.lang.String, java.lang.String, int)"><!-- --></A><H3>
dbremove</H3>
<PRE>
public void <B>dbremove</B>(<A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A> txnid,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> file,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> database,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A>,
<A HREF="../../../com/sleepycat/db/DbDeadlockException.html">DbDeadlockException</A>,
<A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html">DbLockNotGrantedException</A>,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/io/FileNotFoundException.html">FileNotFoundException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#dbRemove(com.sleepycat.db.DbTxn, java.lang.String, java.lang.String, int)"><CODE>dbRemove(DbTxn,String,String,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbDeadlockException.html">DbDeadlockException</A></CODE>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html">DbLockNotGrantedException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/io/FileNotFoundException.html">FileNotFoundException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="dbRemove(com.sleepycat.db.DbTxn, java.lang.String, java.lang.String, int)"><!-- --></A><H3>
dbRemove</H3>
<PRE>
public void <B>dbRemove</B>(<A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A> txnid,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> file,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> database,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A>,
<A HREF="../../../com/sleepycat/db/DbDeadlockException.html">DbDeadlockException</A>,
<A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html">DbLockNotGrantedException</A>,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/io/FileNotFoundException.html">FileNotFoundException</A></PRE>
<DL>
<DD>The DbEnv.dbRemove method removes the database specified by the <b>file</b> and <b>database</b> parameters. If no <b>database</b> is specified, the underlying file represented by <b>file</b> is removed, incidentally removing all of the databases it contained.</p> <p>Applications should never remove databases with open <A HREF="../../../com/sleepycat/db/Db.html"><CODE>Db</CODE></A> handles, or in the case of removing a file, when any database in the file has an open handle. For example, some architectures do not permit the removal of files with open system handles. On these architectures, attempts to remove databases currently in use by any thread of control in the system will fail.</p> <h3>Environment Variables</h3> <p>The environment variable <b>DB_HOME</b> may be used as the path of the database environment home.</p> <p>DbEnv.dbRemove is affected by any database directory specified using the <A HREF="../../../com/sleepycat/db/DbEnv.html#setDataDir(java.lang.String)"><CODE>DbEnv.setDataDir</CODE></A> method, or by setting the "set_data_dir" string in the environment's <b>DB_CONFIG</b> file.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>database</CODE> - the database to be removed.<DD><CODE>file</CODE> - the physical file which contains the database(s) to be removed.<DD><CODE>flags</CODE> - must be set to 0 or the following value: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_AUTO_COMMIT"><CODE>Db.DB_AUTO_COMMIT</CODE></A><p>Enclose the DbEnv.dbRemove call within a transaction. If the call succeeds, changes made by the operation will be recoverable. If the call fails, the operation will have made no changes. </li></ul><DD><CODE>txnid</CODE> - If the operation is to be transaction-protected, the <b>txnid</b> parameter is a transaction handle returned from <A HREF="../../../com/sleepycat/db/DbEnv.html#txnBegin(com.sleepycat.db.DbTxn, int)"><CODE>DbEnv.txnBegin</CODE></A>; otherwise, null.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - The DbEnv.dbRemove method may fail and throw <A HREF="../../../com/sleepycat/db/DbException.html"><CODE>DbException</CODE></A>, encapsulating one of the following non-zero errors: <li>An attempt was made to remove the underlying file and a database in the file was currently open.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbDeadlockException.html">DbDeadlockException</A></CODE> - If a transactional database environment operation was selected to resolve a deadlock, the DbEnv.dbRemove method will fail and throw a <A HREF="../../../com/sleepycat/db/DbDeadlockException.html"><CODE>DbDeadlockException</CODE></A> exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html">DbLockNotGrantedException</A></CODE> - If a Berkeley DB Concurrent Data Store database environment configured for lock timeouts was unable to grant a lock in the allowed time, the DbEnv.dbRemove method will fail and throw a <A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html"><CODE>DbLockNotGrantedException</CODE></A> exception.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.dbRemove method will fail and throw a IllegalArgumentException exception if DbEnv.dbRemove called before <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.
<DD><CODE>FileNotFoundException</CODE> - If the file or directory does not exist, the DbEnv.dbRemove method will fail and throw a FileNotFoundException exception.</DL>
</DD>
</DL>
<HR>
<A NAME="dbrename(com.sleepycat.db.DbTxn, java.lang.String, java.lang.String, java.lang.String, int)"><!-- --></A><H3>
dbrename</H3>
<PRE>
public void <B>dbrename</B>(<A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A> txnid,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> file,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> database,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> newname,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A>,
<A HREF="../../../com/sleepycat/db/DbDeadlockException.html">DbDeadlockException</A>,
<A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html">DbLockNotGrantedException</A>,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/io/FileNotFoundException.html">FileNotFoundException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#dbRename(com.sleepycat.db.DbTxn, java.lang.String, java.lang.String, java.lang.String, int)"><CODE>dbRename(DbTxn,String,String,String,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbDeadlockException.html">DbDeadlockException</A></CODE>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html">DbLockNotGrantedException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/io/FileNotFoundException.html">FileNotFoundException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="dbRename(com.sleepycat.db.DbTxn, java.lang.String, java.lang.String, java.lang.String, int)"><!-- --></A><H3>
dbRename</H3>
<PRE>
public void <B>dbRename</B>(<A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A> txnid,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> file,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> database,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> newname,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A>,
<A HREF="../../../com/sleepycat/db/DbDeadlockException.html">DbDeadlockException</A>,
<A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html">DbLockNotGrantedException</A>,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/io/FileNotFoundException.html">FileNotFoundException</A></PRE>
<DL>
<DD>The DbEnv.dbRename method renames the database specified by the <b>file</b> and <b>database</b> parameters to <b>newname</b>. If no <b>database</b> is specified, the underlying file represented by <b>file</b> is renamed, incidentally renaming all of the databases it contained.</p> <p>Applications should not rename databases that are currently in use. If an underlying file is being renamed and logging is currently enabled in the database environment, no database in the file may be open when the DbEnv.dbRename method is called. In particular, some architectures do not permit renaming files with open handles. On these architectures, attempts to rename databases that are currently in use by any thread of control in the system will fail.</p> <h3>Environment Variables</h3> <p>The environment variable <b>DB_HOME</b> may be used as the path of the database environment home.</p> <p>DbEnv.dbRename is affected by any database directory specified using the <A HREF="../../../com/sleepycat/db/DbEnv.html#setDataDir(java.lang.String)"><CODE>DbEnv.setDataDir</CODE></A> method, or by setting the "set_data_dir" string in the environment's <b>DB_CONFIG</b> file.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>database</CODE> - the database to be removed.<DD><CODE>file</CODE> - the physical file which contains the database(s) to be removed.<DD><CODE>flags</CODE> - must be set to 0 or the following value: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_AUTO_COMMIT"><CODE>Db.DB_AUTO_COMMIT</CODE></A><p>Enclose the DbEnv.dbRename call within a transaction. If the call succeeds, changes made by the operation will be recoverable. If the call fails, the operation will have made no changes. </li></ul><DD><CODE>newname</CODE> - the new name of the database or file.<DD><CODE>txnid</CODE> - If the operation is to be transaction-protected, the <b>txnid</b> parameter is a transaction handle returned from <A HREF="../../../com/sleepycat/db/DbEnv.html#txnBegin(com.sleepycat.db.DbTxn, int)"><CODE>DbEnv.txnBegin</CODE></A>; otherwise, null.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - The DbEnv.dbRename method may fail and throw <A HREF="../../../com/sleepycat/db/DbException.html"><CODE>DbException</CODE></A>, encapsulating one of the following non-zero errors: <li>An attempt was made to rename the underlying file and a database in the file was currently open.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbDeadlockException.html">DbDeadlockException</A></CODE> - If a transactional database environment operation was selected to resolve a deadlock, the DbEnv.dbRename method will fail and throw a <A HREF="../../../com/sleepycat/db/DbDeadlockException.html"><CODE>DbDeadlockException</CODE></A> exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html">DbLockNotGrantedException</A></CODE> - If a Berkeley DB Concurrent Data Store database environment configured for lock timeouts was unable to grant a lock in the allowed time, the DbEnv.dbRename method will fail and throw a <A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html"><CODE>DbLockNotGrantedException</CODE></A> exception.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.dbRename method will fail and throw a IllegalArgumentException exception if DbEnv.dbRename called before <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.
<DD><CODE>FileNotFoundException</CODE> - If the file or directory does not exist, the DbEnv.dbRename method will fail and throw a FileNotFoundException exception.</DL>
</DD>
</DL>
<HR>
<A NAME="err(int, java.lang.String)"><!-- --></A><H3>
err</H3>
<PRE>
public void <B>err</B>(int error,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> message)</PRE>
<DL>
<DD>The DbEnv.err, DbEnv.errx, <A HREF="../../../com/sleepycat/db/Db.html#err(int, java.lang.String)"><CODE>Db.err</CODE></A> and <A HREF="../../../com/sleepycat/db/Db.html#errx(java.lang.String)"><CODE>Db.errx</CODE></A> methods provide error-messaging functionality for applications written using the Berkeley DB library.</p> <p>The DbEnv.err method constructs an error message consisting of the following elements:</p> <blockquote> <p>If no error callback function has been set using the <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorHandler(com.sleepycat.db.DbErrorHandler)"><CODE>DbEnv.setErrorHandler</CODE></A> method, any prefix string specified using the <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorPrefix(java.lang.String)"><CODE>DbEnv.setErrorPrefix</CODE></A> method, followed by two separating characters: a colon and a <space> character. <p> <p>Two separating characters: a colon and a <space> character. <p>The standard system or Berkeley DB library error string associated with the <b>error</b> value, as returned by the <A HREF="../../../com/sleepycat/db/DbEnv.html#strerror(int)"><CODE>DbEnv.strerror</CODE></A> method. </blockquote> <p>This constructed error message is then handled as follows:</p> <blockquote><p>If an error callback function has been set (see <A HREF="../../../com/sleepycat/db/Db.html#setErrorHandler(com.sleepycat.db.DbErrorHandler)"><CODE>Db.setErrorHandler</CODE></A> and <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorHandler(com.sleepycat.db.DbErrorHandler)"><CODE>DbEnv.setErrorHandler</CODE></A>), that function is called with two parameters: any prefix string specified (see <A HREF="../../../com/sleepycat/db/Db.html#setErrorPrefix(java.lang.String)"><CODE>Db.setErrorPrefix</CODE></A> and <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorPrefix(java.lang.String)"><CODE>DbEnv.setErrorPrefix</CODE></A>) and the error message.</p> <p>If an OutputStream has been set (see <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorStream(java.io.OutputStream)"><CODE>DbEnv.setErrorStream</CODE></A> and <A HREF="../../../com/sleepycat/db/Db.html#setErrorStream(java.io.OutputStream)"><CODE>Db.setErrorStream</CODE></A>), the error message is written to that stream.</p> <p>If none of these output options has been configured, the error message is written to System.err, the standard error output stream.</p></blockquote>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>error</CODE> - the error value for which the DbEnv.err and <A HREF="../../../com/sleepycat/db/Db.html#err(int, java.lang.String)"><CODE>Db.err</CODE></A> methods will display a explanatory string.<DD><CODE>message</CODE> - an error message to display.</DL>
</DD>
</DL>
<HR>
<A NAME="errx(java.lang.String)"><!-- --></A><H3>
errx</H3>
<PRE>
public void <B>errx</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> message)</PRE>
<DL>
<DD>The DbEnv.errx and <A HREF="../../../com/sleepycat/db/Db.html#errx(java.lang.String)"><CODE>Db.errx</CODE></A> methods perform identically to the DbEnv.err and <A HREF="../../../com/sleepycat/db/Db.html#err(int, java.lang.String)"><CODE>Db.err</CODE></A> methods, except that they do not append the final separator characters and standard error string to the error message.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>message</CODE> - an error message to display.</DL>
</DD>
</DL>
<HR>
<A NAME="get_data_dirs()"><!-- --></A><H3>
get_data_dirs</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A>[] <B>get_data_dirs</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getDataDirs()"><CODE>getDataDirs()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getDataDirs()"><!-- --></A><H3>
getDataDirs</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A>[] <B>getDataDirs</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getDataDirs method returns the array of directories.</p> <p>The DbEnv.getDataDirs method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getDataDirs method returns the array of directories.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_encrypt_flags()"><!-- --></A><H3>
get_encrypt_flags</H3>
<PRE>
public int <B>get_encrypt_flags</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getEncryptFlags()"><CODE>getEncryptFlags()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getEncryptFlags()"><!-- --></A><H3>
getEncryptFlags</H3>
<PRE>
public int <B>getEncryptFlags</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getEncryptFlags method returns the encryption flags.</p> <p>The DbEnv.getEncryptFlags method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getEncryptFlags method returns the encryption flags.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_flags()"><!-- --></A><H3>
get_flags</H3>
<PRE>
public int <B>get_flags</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getFlags()"><CODE>getFlags()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getFlags()"><!-- --></A><H3>
getFlags</H3>
<PRE>
public int <B>getFlags</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getFlags method returns the configuration flags.</p> <p>The DbEnv.getFlags method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getFlags method returns the configuration flags.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_home()"><!-- --></A><H3>
get_home</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> <B>get_home</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getDbEnvHome()"><CODE>getDbEnvHome()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getDbEnvHome()"><!-- --></A><H3>
getDbEnvHome</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> <B>getDbEnvHome</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getDbEnvHome method returns the database environment home directory.</p> <p>The DbEnv.getDbEnvHome method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getDbEnvHome method returns the database environment home directory.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_open_flags()"><!-- --></A><H3>
get_open_flags</H3>
<PRE>
public int <B>get_open_flags</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getOpenFlags()"><CODE>getOpenFlags()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getOpenFlags()"><!-- --></A><H3>
getOpenFlags</H3>
<PRE>
public int <B>getOpenFlags</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getOpenFlags method returns the open method flags.</p> <p>The DbEnv.getOpenFlags method may not be called before the DbEnv.open method has been called.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getOpenFlags method returns the open method flags.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_shm_key()"><!-- --></A><H3>
get_shm_key</H3>
<PRE>
public long <B>get_shm_key</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getSegmentId()"><CODE>getSegmentId()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getSegmentId()"><!-- --></A><H3>
getSegmentId</H3>
<PRE>
public long <B>getSegmentId</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getSegmentId method returns the base segment ID.</p> <p>The DbEnv.getSegmentId method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getSegmentId method returns the base segment ID.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_tas_spins()"><!-- --></A><H3>
get_tas_spins</H3>
<PRE>
public int <B>get_tas_spins</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getTestAndSetSpins()"><CODE>getTestAndSetSpins()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getTestAndSetSpins()"><!-- --></A><H3>
getTestAndSetSpins</H3>
<PRE>
public int <B>getTestAndSetSpins</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getTestAndSetSpins method returns the test-and-set spin count.</p> <p>The DbEnv.getTestAndSetSpins method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getTestAndSetSpins method returns the test-and-set spin count.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_tmp_dir()"><!-- --></A><H3>
get_tmp_dir</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> <B>get_tmp_dir</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getTmpDir()"><CODE>getTmpDir()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getTmpDir()"><!-- --></A><H3>
getTmpDir</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> <B>getTmpDir</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getTmpDir method returns the database environment temporary file directory.</p> <p>The DbEnv.getTmpDir method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getTmpDir method returns the database environment temporary file directory.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_verbose(int)"><!-- --></A><H3>
get_verbose</H3>
<PRE>
public boolean <B>get_verbose</B>(int which)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getVerbose(int)"><CODE>getVerbose(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getVerbose(int)"><!-- --></A><H3>
getVerbose</H3>
<PRE>
public boolean <B>getVerbose</B>(int which)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getVerbose method returns whether the specified <b>which</b> parameter is currently set or not.</p> <p>The DbEnv.getVerbose method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>which</CODE> - the message value for which configuration is being checked.
<DT><B>Returns:</B><DD>The DbEnv.getVerbose method returns whether the specified <b>which</b> parameter is currently set or not.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="set_cachesize(long, int)"><!-- --></A><H3>
set_cachesize</H3>
<PRE>
public void <B>set_cachesize</B>(long bytes,
int ncache)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setCacheSize(long, int)"><CODE>setCacheSize(long,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setCacheSize(long, int)"><!-- --></A><H3>
setCacheSize</H3>
<PRE>
public void <B>setCacheSize</B>(long bytes,
int ncache)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Set the size of the shared memory buffer pool -- that is, the cache. The cache should be the size of the normal working data set of the application, with some small amount of additional memory for unusual situations. (Note: the working set is not the same as the number of pages accessed simultaneously, and is usually much larger.)</p> <p>The default cache size is 256KB, and may not be specified as less than 20KB. Any cache size less than 500MB is automatically increased by 25% to account for buffer pool overhead; cache sizes larger than 500MB are used as specified. The current maximum size of a single cache is 4GB. (All sizes are in powers-of-two, that is, 256KB is 2^32 not 256,000.) For information on tuning the Berkeley DB cache size, see <a href="../../../../ref/am_conf/cachesize.html">Selecting a cache size</a>.</p> <p>It is possible to specify caches to Berkeley DB larger than 4GB and/or large enough they cannot be allocated contiguously on some architectures. For example, some releases of Solaris limit the amount of memory that may be allocated contiguously by a process. If <b>ncache</b> is 0 or 1, the cache will be allocated contiguously in memory. If it is greater than 1, the cache will be broken up into <b>ncache</b> equally sized, separate pieces of memory.</p> <p>The database environment's cache size 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_cachesize", one or more whitespace characters, and the cache size specified in three parts: the gigabytes of cache, the additional bytes of cache, and the number of caches, also separated by whitespace characters. For example, "set_cachesize 2 524288000 3" would create a 2.5GB logical cache, split between three physical caches. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv.setCacheSize method configures a database environment, not only operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle.</p> <p>The DbEnv.setCacheSize method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. If the database environment already exists when <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> is called, the information specified to DbEnv.setCacheSize will be ignored. </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bytes</CODE> - The size of the cache in bytes.<DD><CODE>ncache</CODE> - the number of caches to create.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setCacheSize method will fail and throw a IllegalArgumentException exception if the specified cache size was impossibly small; the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_data_dir(java.lang.String)"><!-- --></A><H3>
set_data_dir</H3>
<PRE>
public void <B>set_data_dir</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> dir)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setDataDir(java.lang.String)"><CODE>setDataDir(String)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setDataDir(java.lang.String)"><!-- --></A><H3>
setDataDir</H3>
<PRE>
public void <B>setDataDir</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> dir)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Set the path of a directory to be used as the location of the access method database files. Paths specified to the <A HREF="../../../com/sleepycat/db/Db.html#open(com.sleepycat.db.DbTxn, java.lang.String, java.lang.String, int, int, int)"><CODE>Db.open</CODE></A> function will be searched relative to this path. Paths set using this method are additive, and specifying more than one will result in each specified directory being searched for database files. If any directories are specified, created database files will always be created in the first path specified.</p> <p>If no database directories are specified, database files can exist only in the environment home directory. See <a href="../../../../ref/env/naming.html">Berkeley DB File Naming</a> for more information.</p> <p>For the greatest degree of recoverability from system or application failure, database files and log files should be located on separate physical devices.</p> <p>The database environment's data directories 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_data_dir", one or more whitespace characters, and the directory name. </p> <p>The DbEnv.setDataDir method configures operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle, not all operations performed on the underlying database environment.</p> <p>The DbEnv.setDataDir method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. If the database environment already exists when <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> is called, the information specified to DbEnv.setDataDir must be consistent with the existing environment or corruption can occur.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>dir</CODE> - a directory to be used as a location for database files.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setDataDir method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_encrypt(java.lang.String, int)"><!-- --></A><H3>
set_encrypt</H3>
<PRE>
public void <B>set_encrypt</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> passwd,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setEncrypted(java.lang.String, int)"><CODE>setEncrypted(String,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setEncrypted(java.lang.String, int)"><!-- --></A><H3>
setEncrypted</H3>
<PRE>
public void <B>setEncrypted</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> passwd,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Set the password used by the Berkeley DB library to perform encryption and decryption.</p> <p>The DbEnv.setEncrypted method configures a database environment, not only operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle.</p> <p>The DbEnv.setEncrypted method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. If the database environment already exists when <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> is called, the information specified to DbEnv.setEncrypted must be consistent with the existing environment or an error will be returned. </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - must be set to 0 or the following value: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_ENCRYPT_AES"><CODE>Db.DB_ENCRYPT_AES</CODE></A><p>Use the Rijndael/AES (also known as the Advanced Encryption Standard and Federal Information Processing Standard (FIPS) 197) algorithm for encryption or decryption. </li></ul><DD><CODE>passwd</CODE> - the password used to perform encryption and decryption.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - The DbEnv.setEncrypted method may fail and throw <A HREF="../../../com/sleepycat/db/DbException.html"><CODE>DbException</CODE></A>, encapsulating one of the following non-zero errors: <li>Cryptography is not available in this Berkeley DB release.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setEncrypted method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="setErrorHandler(com.sleepycat.db.DbErrorHandler)"><!-- --></A><H3>
setErrorHandler</H3>
<PRE>
public void <B>setErrorHandler</B>(<A HREF="../../../com/sleepycat/db/DbErrorHandler.html">DbErrorHandler</A> db_errcall_fcn)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>When an error occurs in the Berkeley DB library, an exception is thrown. In some cases, however, the <b>errno</b> value may be insufficient to completely describe the cause of the error, especially during initial application debugging. <p>The DbEnv.setOnError and <A HREF="../../../com/sleepycat/db/Db.html#setErrorHandler(com.sleepycat.db.DbErrorHandler)"><CODE>Db.setErrorHandler</CODE></A> methods are used to enhance the mechanism for reporting error messages to the application. The DbEnv.setOnError and <A HREF="../../../com/sleepycat/db/Db.html#setErrorHandler(com.sleepycat.db.DbErrorHandler)"><CODE>Db.setErrorHandler</CODE></A> methods must be called with a single object parameter. The object's class must implement the DbErrorHandler interface.</p> <p>In some cases, when an error occurs, Berkeley DB will invoke the object's errcall() method with two parameters; the first is the prefix string (as previously set by <A HREF="../../../com/sleepycat/db/Db.html#setErrorPrefix(java.lang.String)"><CODE>Db.setErrorPrefix</CODE></A> or <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorPrefix(java.lang.String)"><CODE>DbEnv.setErrorPrefix</CODE></A>), the second will be an error message string. It is up to this method to display the message in an appropriate manner.</p> <p>Alternatively, you can use the <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorStream(java.io.OutputStream)"><CODE>DbEnv.setErrorStream</CODE></A> and <A HREF="../../../com/sleepycat/db/Db.html#setErrorStream(java.io.OutputStream)"><CODE>Db.setErrorStream</CODE></A> methods to display the additional information via an output stream. You should not mix these approaches.</p> <p>This error-logging enhancement does not slow performance or significantly increase application size, and may be run during normal operation as well as during application debugging.</p> <p>The DbEnv.setOnError method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>db_errcall_fcn</CODE> - the application-specified error reporting function. The function takes two parameters: <p>The <b>errpfx</b> parameter is the prefix string (as previously set by <A HREF="../../../com/sleepycat/db/Db.html#setErrorPrefix(java.lang.String)"><CODE>Db.setErrorPrefix</CODE></A> or <A HREF="../../../com/sleepycat/db/DbEnv.html#setErrorPrefix(java.lang.String)"><CODE>DbEnv.setErrorPrefix</CODE></A>). <p>The <b>msg</b> parameter is the error message string.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="set_flags(int, boolean)"><!-- --></A><H3>
set_flags</H3>
<PRE>
public void <B>set_flags</B>(int flags,
boolean onoff)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setFlags(int, boolean)"><CODE>setFlags(int,boolean)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setFlags(int, boolean)"><!-- --></A><H3>
setFlags</H3>
<PRE>
public void <B>setFlags</B>(int flags,
boolean onoff)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Configure a database environment.</p> <p>The database environment's flag values 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_flags", one or more whitespace characters, and the method flag parameter as a string; for example, "set_flags DB_TXN_NOSYNC". Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - must be set by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_AUTO_COMMIT"><CODE>Db.DB_AUTO_COMMIT</CODE></A><p>If set, operations for which no explicit transaction handle was specified, and which modify databases in the database environment, will be automatically enclosed within a transaction. If the call succeeds, changes made by the operation will be recoverable. If the call fails, the operation will have made no changes. <p>Calling DbEnv.setFlags with the <A HREF="../../../com/sleepycat/db/Db.html#DB_AUTO_COMMIT"><CODE><code>Db.DB_AUTO_COMMIT</code></CODE></A> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handles opened in the environment must either set the <A HREF="../../../com/sleepycat/db/Db.html#DB_AUTO_COMMIT"><CODE><code>Db.DB_AUTO_COMMIT</code></CODE></A> flag or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The <A HREF="../../../com/sleepycat/db/Db.html#DB_AUTO_COMMIT"><CODE><code>Db.DB_AUTO_COMMIT</code></CODE></A> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_CDB_ALLDB"><CODE>Db.DB_CDB_ALLDB</CODE></A><p>If set, Berkeley DB Concurrent Data Store applications will perform locking on an environment-wide basis rather than on a per-database basis. <p>Calling DbEnv.setFlags with the <code>Db.DB_CDB_ALLDB</code> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handles opened in the environment must either set the <code>Db.DB_CDB_ALLDB</code> flag or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The <code>Db.DB_CDB_ALLDB</code> flag may be used to configure Berkeley DB only before the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_DIRECT_DB"><CODE>Db.DB_DIRECT_DB</CODE></A><p>Turn off system buffering of Berkeley DB database files to avoid double caching. <p>Calling DbEnv.setFlags with the <code>Db.DB_DIRECT_DB</code> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handles opened in the environment must either set the <code>Db.DB_DIRECT_DB</code> flag or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The <code>Db.DB_DIRECT_DB</code> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_DIRECT_LOG"><CODE>Db.DB_DIRECT_LOG</CODE></A><p>Turn off system buffering of Berkeley DB log files to avoid double caching. <p>Calling DbEnv.setFlags with the <code>Db.DB_DIRECT_LOG</code> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handles opened in the environment must either set the <code>Db.DB_DIRECT_LOG</code> flag or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The <code>Db.DB_DIRECT_LOG</code> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOG_AUTOREMOVE"><CODE>Db.DB_LOG_AUTOREMOVE</CODE></A><p>If set, Berkeley DB will automatically remove log files that are no longer needed. Automatic log file removal is likely to make catastrophic recovery impossible. <p>Calling DbEnv.setFlags with the <code>Db.DB_LOG_AUTOREMOVE</code> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handles opened in the environment must either set the <code>Db.DB_LOG_AUTOREMOVE</code> flag or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The <code>Db.DB_LOG_AUTOREMOVE</code> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_NOLOCKING"><CODE>Db.DB_NOLOCKING</CODE></A><p>If set, Berkeley DB will grant all requested mutual exclusion mutexes and database locks without regard for their actual availability. This functionality should never be used for purposes other than debugging. <p>Calling DbEnv.setFlags with the <code>Db.DB_NOLOCKING</code> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). </p> <p>The <code>Db.DB_NOLOCKING</code> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_NOMMAP"><CODE>Db.DB_NOMMAP</CODE></A><p>If set, Berkeley DB will copy read-only database files into the local cache instead of potentially mapping them into process memory (see the description of the <A HREF="../../../com/sleepycat/db/DbEnv.html#setMemoryPoolMapSize(long)"><CODE>DbEnv.setMemoryPoolMapSize</CODE></A> method for further information). <p>Calling DbEnv.setFlags with the <code>Db.DB_NOMMAP</code> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handles opened in the environment must either set the <code>Db.DB_NOMMAP</code> flag or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The <code>Db.DB_NOMMAP</code> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_NOPANIC"><CODE>Db.DB_NOPANIC</CODE></A><p>If set, Berkeley DB will ignore any panic state in the database environment. (Database environments in a panic state normally refuse all attempts to call Berkeley DB functions, returning <a href="../../../../ref/program/errorret.html#DB_RUNRECOVERY"><code>Db.DB_RUNRECOVERY</code></a>.) This functionality should never be used for purposes other than debugging. <p>Calling DbEnv.setFlags with the <code>Db.DB_NOPANIC</code> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). </p> <p>The <code>Db.DB_NOPANIC</code> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_OVERWRITE"><CODE>Db.DB_OVERWRITE</CODE></A><p>Overwrite files stored in encrypted formats before deleting them. Berkeley DB overwrites files using alternating 0xff, 0x00 and 0xff byte patterns. For file overwriting to be effective, the underlying file must be stored on a fixed-block filesystem. Systems with journaling or logging filesystems will require operating system support and probably modification of the Berkeley DB sources. <p>Calling DbEnv.setFlags with the <code>Db.DB_OVERWRITE</code> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). </p> <p>The <code>Db.DB_OVERWRITE</code> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_PANIC_ENVIRONMENT"><CODE>Db.DB_PANIC_ENVIRONMENT</CODE></A><p>If set, Berkeley DB will set the panic state for the database environment. (Database environments in a panic state normally refuse all attempts to call Berkeley DB functions, returning <a href="../../../../ref/program/errorret.html#DB_RUNRECOVERY"><code>Db.DB_RUNRECOVERY</code></a>.) This flag may not be specified using the environment's <b>DB_CONFIG</b> file. This flag may be used to configure Berkeley DB only after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. <p>Calling DbEnv.setFlags with the <code>Db.DB_PANIC_ENVIRONMENT</code> flag affects the database environment, including all threads of control accessing the database environment.</p> <p>The <code>Db.DB_PANIC_ENVIRONMENT</code> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_REGION_INIT"><CODE>Db.DB_REGION_INIT</CODE></A><p>In some applications, the expense of page-faulting the underlying shared memory regions can affect performance. (For example, if the page-fault occurs while holding a lock, other lock requests can convoy, and overall throughput may decrease.) If set, Berkeley DB will page-fault shared regions into memory when initially creating or joining a Berkeley DB environment. In addition, Berkeley DB will write the shared regions when creating an environment, forcing the underlying virtual memory and filesystems to instantiate both the necessary memory and the necessary disk space. This can also avoid out-of-disk space failures later on. <p>Calling DbEnv.setFlags with the <code>Db.DB_REGION_INIT</code> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handles opened in the environment must either set the <code>Db.DB_REGION_INIT</code> flag or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The <code>Db.DB_REGION_INIT</code> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_TIME_NOTGRANTED"><CODE>Db.DB_TIME_NOTGRANTED</CODE></A><p>If set, database calls timing out based on lock or transaction timeout values will throw a <A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html"><CODE>DbLockNotGrantedException</CODE></A> exception instead of <A HREF="../../../com/sleepycat/db/DbDeadlockException.html"><CODE>DbDeadlockException</CODE></A>. This allows applications to distinguish between operations which have deadlocked and operations which have exceeded their time limits. <p>Calling DbEnv.setFlags with the <A HREF="../../../com/sleepycat/db/Db.html#DB_TIME_NOTGRANTED"><CODE><code>Db.DB_TIME_NOTGRANTED</code></CODE></A> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handles opened in the environment must either set the <A HREF="../../../com/sleepycat/db/Db.html#DB_TIME_NOTGRANTED"><CODE><code>Db.DB_TIME_NOTGRANTED</code></CODE></A> flag or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The <A HREF="../../../com/sleepycat/db/Db.html#DB_TIME_NOTGRANTED"><CODE><code>Db.DB_TIME_NOTGRANTED</code></CODE></A> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_TXN_NOSYNC"><CODE>Db.DB_TXN_NOSYNC</CODE></A><p>If set, Berkeley DB will not write or synchronously flush the log on transaction commit. This means that transactions exhibit the ACI (atomicity, consistency, and isolation) properties, but not D (durability); that is, database integrity will be maintained, but if the application or system fails, it is possible some number of the most recently committed transactions may be undone during recovery. The number of transactions at risk is governed by how many log updates can fit into the log buffer, how often the operating system flushes dirty buffers to disk, and how often the log is checkpointed. <p>Calling DbEnv.setFlags with the <code>Db.DB_TXN_NOSYNC</code> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handles opened in the environment must either set the <code>Db.DB_TXN_NOSYNC</code> flag or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The <code>Db.DB_TXN_NOSYNC</code> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_TXN_NOT_DURABLE"><CODE>Db.DB_TXN_NOT_DURABLE</CODE></A><p>If set, Berkeley DB will not write log records. This means that transactions exhibit the ACI (atomicity, consistency, and isolation) properties, but not D (durability); that is, database integrity will be maintained, but if the application or system fails, integrity will not persist. All database files must be verified and/or restored from backup after a failure. In order to ensure integrity after application shut down, all database handles must be closed without specifying <A HREF="../../../com/sleepycat/db/Db.html#DB_NOSYNC"><CODE><code>Db.DB_NOSYNC</code></CODE></A>, or all database changes must be flushed from the database environment cache using the <A HREF="../../../com/sleepycat/db/DbEnv.html#txnCheckpoint(int, int, int)"><CODE>DbEnv.txnCheckpoint</CODE></A> method. <p>Calling DbEnv.setFlags with the <code>Db.DB_TXN_NOT_DURABLE</code> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handles opened in the environment must either set the <code>Db.DB_TXN_NOT_DURABLE</code> flag or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The <code>Db.DB_TXN_NOT_DURABLE</code> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_TXN_WRITE_NOSYNC"><CODE>Db.DB_TXN_WRITE_NOSYNC</CODE></A><p>If set, Berkeley DB will write, but will not synchronously flush, the log on transaction commit. This means that transactions exhibit the ACI (atomicity, consistency, and isolation) properties, but not D (durability); that is, database integrity will be maintained, but if the system fails, it is possible some number of the most recently committed transactions may be undone during recovery. The number of transactions at risk is governed by how often the system flushes dirty buffers to disk and how often the log is checkpointed. <p>Calling DbEnv.setFlags with the <code>Db.DB_TXN_WRITE_NOSYNC</code> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handles opened in the environment must either set the <code>Db.DB_TXN_WRITE_NOSYNC</code> flag or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The <code>Db.DB_TXN_WRITE_NOSYNC</code> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_YIELDCPU"><CODE>Db.DB_YIELDCPU</CODE></A><p>If set, Berkeley DB will yield the processor immediately after each page or mutex acquisition. This functionality should never be used for purposes other than stress testing. <p>Calling DbEnv.setFlags with the <code>Db.DB_YIELDCPU</code> flag only affects the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle (and any other Berkeley DB handles opened within the scope of that handle). For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handles opened in the environment must either set the <code>Db.DB_YIELDCPU</code> flag or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The <code>Db.DB_YIELDCPU</code> flag may be used to configure Berkeley DB at any time during the life of the application.</p> </li></ul><DD><CODE>onoff</CODE> - If the <b>onoff</b> parameter is false, the specified flags are cleared; otherwise they are set.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setFlags method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="setFeedbackHandler(com.sleepycat.db.DbEnvFeedbackHandler)"><!-- --></A><H3>
setFeedbackHandler</H3>
<PRE>
public void <B>setFeedbackHandler</B>(<A HREF="../../../com/sleepycat/db/DbEnvFeedbackHandler.html">DbEnvFeedbackHandler</A> db_feedback_fcn)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="set_mp_mmapsize(long)"><!-- --></A><H3>
set_mp_mmapsize</H3>
<PRE>
public void <B>set_mp_mmapsize</B>(long mp_mmapsize)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setMemoryPoolMapSize(long)"><CODE>setMemoryPoolMapSize(long)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setMemoryPoolMapSize(long)"><!-- --></A><H3>
setMemoryPoolMapSize</H3>
<PRE>
public void <B>setMemoryPoolMapSize</B>(long mp_mmapsize)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Files that are opened read-only in the pool (and that satisfy a few other criteria) are, by default, mapped into the process address space instead of being copied into the local cache. This can result in better-than-usual performance because available virtual memory is normally much larger than the local cache, and page faults are faster than page copying on many systems. However, it can cause resource starvation in the presence of limited virtual memory, and it can result in immense process sizes in the presence of large databases.</p> <p>The DbEnv.getMemoryPoolMapSize method sets the maximum file size, in bytes, for a file to be mapped into the process address space. If no value is specified, it defaults to 10MB.</p> <p>The database environment's maximum mapped file size 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_mp_mmapsize", one or more whitespace characters, and the size in bytes. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv.setMemoryPoolMapSize method configures operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle, not all operations performed on the underlying database environment.</p> <p>The DbEnv.setMemoryPoolMapSize method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>mp_mmapsize</CODE> - the maximum file size, in bytes, for a file to be mapped into the process address space.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setMemoryPoolMapSize method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="setPanicHandler(com.sleepycat.db.DbPanicHandler)"><!-- --></A><H3>
setPanicHandler</H3>
<PRE>
public void <B>setPanicHandler</B>(<A HREF="../../../com/sleepycat/db/DbPanicHandler.html">DbPanicHandler</A> db_panic_fcn)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="set_rpc_server(com.sleepycat.db.DbClient, java.lang.String, long, long, int)"><!-- --></A><H3>
set_rpc_server</H3>
<PRE>
public void <B>set_rpc_server</B>(<A HREF="../../../com/sleepycat/db/DbClient.html">DbClient</A> client,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> host,
long cl_timeout,
long sv_timeout,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setRpcServer(com.sleepycat.db.DbClient, java.lang.String, long, long, int)"><CODE>setRpcServer(DbClient,String,long,long,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setRpcServer(com.sleepycat.db.DbClient, java.lang.String, long, long, int)"><!-- --></A><H3>
setRpcServer</H3>
<PRE>
public void <B>setRpcServer</B>(<A HREF="../../../com/sleepycat/db/DbClient.html">DbClient</A> client,
<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> host,
long cl_timeout,
long sv_timeout,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Establishes a connection for this <b>dbenv</b> to a RPC server.</p> The DbEnv.setRpcServer method configures operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle, not all operations performed on the underlying database environment.</p> <p>The DbEnv.setRpcServer method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>cl_timeout</CODE> - specifies the number of seconds the client should wait for results to come back from the server. Once the timeout has expired on any communication with the server, Db.DB_NOSERVER will be returned. If this value is zero, a default timeout is used.<DD><CODE>client</CODE> - reserved for future use. If it is not NULL, an exception is thrown.<DD><CODE>host</CODE> - the host to which the Berkeley DB server will connect and create a channel for communication.<DD><CODE>flags</CODE> - currently unused, and must be set to 0.<DD><CODE>sv_timeout</CODE> - specifies the number of seconds the server should allow a client connection to remain idle before assuming that the client is gone. Once that timeout has been reached, the server releases all resources associated with that client connection. Subsequent attempts by that client to communicate with the server result in Db.DB_NOSERVER_ID, indicating that an invalid identifier has been given to the server. This value can be considered a hint to the server. The server may alter this value based on its own policies or allowed values. If this value is zero, a default timeout is used.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setRpcServer method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_shm_key(long)"><!-- --></A><H3>
set_shm_key</H3>
<PRE>
public void <B>set_shm_key</B>(long shm_key)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setSegmentId(long)"><CODE>setSegmentId(long)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setSegmentId(long)"><!-- --></A><H3>
setSegmentId</H3>
<PRE>
public void <B>setSegmentId</B>(long shm_key)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Specify a base segment ID for Berkeley DB environment shared memory regions created in system memory on VxWorks or systems supporting X/Open-style shared memory interfaces; for example, UNIX systems supporting <b>shmget</b>(2) and related System V IPC interfaces.</p> <p>This base segment ID will be used when Berkeley DB shared memory regions are first created. It will be incremented a small integer value each time a new shared memory region is created; that is, if the base ID is 35, the first shared memory region created will have a segment ID of 35, and the next one will have a segment ID between 36 and 40 or so. A Berkeley DB environment always creates a master shared memory region; an additional shared memory region for each of the subsystems supported by the environment (Locking, Logging, Memory Pool and Transaction); plus an additional shared memory region for each additional memory pool cache that is supported. Already existing regions with the same segment IDs will be removed. See <a href="../../../../ref/env/region.html">Shared Memory Regions</a> for more information.</p> <p>The intent behind this method is two-fold: without it, applications have no way to ensure that two Berkeley DB applications don't attempt to use the same segment IDs when creating different Berkeley DB environments. In addition, by using the same segment IDs each time the environment is created, previously created segments will be removed, and the set of segments on the system will not grow without bound.</p> <p>The database environment's base segment ID 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_shm_key", one or more whitespace characters, and the ID. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv.setSegmentId method configures operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle, not all operations performed on the underlying database environment.</p> <p>The DbEnv.setSegmentId method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. If the database environment already exists when <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> is called, the information specified to DbEnv.setSegmentId must be consistent with the existing environment or corruption can occur.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>shm_key</CODE> - the base segment ID for the database environment.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setSegmentId method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_tas_spins(int)"><!-- --></A><H3>
set_tas_spins</H3>
<PRE>
public void <B>set_tas_spins</B>(int tas_spins)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setTestAndSetSpins(int)"><CODE>setTestAndSetSpins(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setTestAndSetSpins(int)"><!-- --></A><H3>
setTestAndSetSpins</H3>
<PRE>
public void <B>setTestAndSetSpins</B>(int tas_spins)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Specify that test-and-set mutexes should spin <b>tas_spins</b> times without blocking. The value defaults to 1 on uniprocessor systems and to 50 times the number of processors on multiprocessor systems.</p> <p>The database environment's test-and-set spin count 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_tas_spins", one or more whitespace characters, and the number of spins. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv.setTestAndSetSpins method configures operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle, not all operations performed on the underlying database environment.</p> <p>The DbEnv.setTestAndSetSpins method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>tas_spins</CODE> - the number of spins test-and-set mutexes should execute before blocking.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setTestAndSetSpins method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_timeout(long, int)"><!-- --></A><H3>
set_timeout</H3>
<PRE>
public void <B>set_timeout</B>(long timeout,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setTimeout(long, int)"><CODE>setTimeout(long,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setTimeout(long, int)"><!-- --></A><H3>
setTimeout</H3>
<PRE>
public void <B>setTimeout</B>(long timeout,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.setTimeout method sets timeout values for locks or transactions in the database environment.</p> <p>Timeouts are checked whenever a thread of control blocks on a lock or when deadlock detection is performed. (In the case of Db.DB_SET_LOCK_TIMEOUT, the lock is one requested explicitly through the Lock subsystem interfaces. In the case of Db.DB_SET_TXN_TIMEOUT, the lock is one requested on behalf of a transaction. In either case, it may be a lock requested by the database access methods underlying the application.) As timeouts are only checked when the lock request first blocks or when deadlock detection is performed, the accuracy of the timeout depends on how often deadlock detection is performed.</p> <p>Timeout values specified for the database environment may be overridden on a per-lock or per-transaction basis. See <A HREF="../../../com/sleepycat/db/DbEnv.html#lockVector(int, int, com.sleepycat.db.DbLockRequest[], int, int)"><CODE>DbEnv.lockVector</CODE></A> and <A HREF="../../../com/sleepycat/db/DbTxn.html#setTimeout(long, int)"><CODE>DbTxn.setTimeout</CODE></A> for more information.</p> <p>The DbEnv.setTimeout method configures a database environment, not only operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle.</p> <p>The DbEnv.setTimeout method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - must be set to one of the following values: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_SET_LOCK_TIMEOUT"><CODE>Db.DB_SET_LOCK_TIMEOUT</CODE></A><p>Set the timeout value for locks in this database environment. <p>The database environment's lock timeout value 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_lock_timeout", one or more whitespace characters, and the lock timeout value. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_SET_TXN_TIMEOUT"><CODE>Db.DB_SET_TXN_TIMEOUT</CODE></A><p>Set the timeout value for transactions in this database environment. <p>The database environment's transaction timeout value 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_txn_timeout", one or more whitespace characters, and the transaction timeout value. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> </li></ul><DD><CODE>timeout</CODE> - the timeout value. It must be specified as an unsigned 32-bit number of microseconds, limiting the maximum timeout to roughly 71 minutes.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setTimeout method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_tmp_dir(java.lang.String)"><!-- --></A><H3>
set_tmp_dir</H3>
<PRE>
public void <B>set_tmp_dir</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> dir)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setTmpDir(java.lang.String)"><CODE>setTmpDir(String)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setTmpDir(java.lang.String)"><!-- --></A><H3>
setTmpDir</H3>
<PRE>
public void <B>setTmpDir</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> dir)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Specify the path of a directory to be used as the location of temporary files. The files created to back in-memory access method databases will be created relative to this path. These temporary files can be quite large, depending on the size of the database.</p> <p>If no directories are specified, the following alternatives are checked in the specified order. The first existing directory path is used for all temporary files.</p> <ol> <p><li>The value of the environment variable <b>TMPDIR</b>. <li>The value of the environment variable <b>TEMP</b>. <li>The value of the environment variable <b>TMP</b>. <li>The value of the environment variable <b>TempFolder</b>. <li>The value returned by the GetTempPath interface. <li>The directory <b>/var/tmp</b>. <li>The directory <b>/usr/tmp</b>. <li>The directory <b>/temp</b>. <li>The directory <b>/tmp</b>. <li>The directory <b>C:/temp</b>. <li>The directory <b>C:/tmp</b>. </ol> <p>Note: environment variables are only checked if one of the <A HREF="../../../com/sleepycat/db/Db.html#DB_USE_ENVIRON"><CODE>Db.DB_USE_ENVIRON</CODE></A> or <A HREF="../../../com/sleepycat/db/Db.html#DB_USE_ENVIRON_ROOT"><CODE>Db.DB_USE_ENVIRON_ROOT</CODE></A> flags were specified.</p> <p>Note: the GetTempPath interface is only checked on Win/32 platforms.</p> <p>The database environment's temporary file directory 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_tmp_dir", one or more whitespace characters, and the directory name. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv.setTmpDir method configures operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle, not all operations performed on the underlying database environment.</p> <p>The DbEnv.setTmpDir method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. If the database environment already exists when <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> is called, the information specified to DbEnv.setTmpDir must be consistent with the existing environment or corruption can occur.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>dir</CODE> - the directory to be used to store temporary files.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setTmpDir method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_tx_max(int)"><!-- --></A><H3>
set_tx_max</H3>
<PRE>
public void <B>set_tx_max</B>(int max)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setTxnMax(int)"><CODE>setTxnMax(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setTxnMax(int)"><!-- --></A><H3>
setTxnMax</H3>
<PRE>
public void <B>setTxnMax</B>(int max)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Configure the Berkeley DB database environment to support at least <b>max</b> active transactions. This value bounds the size of the memory allocated for transactions. Child transactions are counted as active until they either commit or abort.</p> <p>When all of the memory available in the database environment for transactions is in use, calls to <A HREF="../../../com/sleepycat/db/DbEnv.html#txnBegin(com.sleepycat.db.DbTxn, int)"><CODE>DbEnv.txnBegin</CODE></A> will fail (until some active transactions complete). If this interface is never called, the database environment is configured to support at least 20 active transactions.</p> <p>The database environment's number of active transactions 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_tx_max", one or more whitespace characters, and the number of transactions. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv.setTxnMax method configures a database environment, not only operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle.</p> <p>The DbEnv.setTxnMax method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. If the database environment already exists when <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> is called, the information specified to DbEnv.setTxnMax will be ignored. </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>max</CODE> - The <b>max</b> parameter configures the minimum number of simultaneously active transactions supported by Berkeley DB database environment.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setTxnMax method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_app_dispatch(com.sleepycat.db.DbAppDispatch)"><!-- --></A><H3>
set_app_dispatch</H3>
<PRE>
public void <B>set_app_dispatch</B>(<A HREF="../../../com/sleepycat/db/DbAppDispatch.html">DbAppDispatch</A> tx_recover)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setAppDispatch(com.sleepycat.db.DbAppDispatch)"><CODE>setAppDispatch(DbAppDispatch)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setAppDispatch(com.sleepycat.db.DbAppDispatch)"><!-- --></A><H3>
setAppDispatch</H3>
<PRE>
public void <B>setAppDispatch</B>(<A HREF="../../../com/sleepycat/db/DbAppDispatch.html">DbAppDispatch</A> tx_recover)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="set_verbose(int, boolean)"><!-- --></A><H3>
set_verbose</H3>
<PRE>
public void <B>set_verbose</B>(int which,
boolean onoff)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setVerbose(int, boolean)"><CODE>setVerbose(int,boolean)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setVerbose(int, boolean)"><!-- --></A><H3>
setVerbose</H3>
<PRE>
public void <B>setVerbose</B>(int which,
boolean onoff)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.setVerbose method turns specific additional informational and debugging messages in the Berkeley DB message output on and off. To see the additional messages, verbose messages must also be configured for the application. For more information on verbose messages, see the <A HREF="../../../com/sleepycat/db/Db.html#setErrorStream(java.io.OutputStream)"><CODE>Db.setErrorStream</CODE></A> method.</p> <p>The database environment's messages 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 method <b>which</b> parameter 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.</p> <p>The DbEnv.setVerbose method configures operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle, not all operations performed on the underlying database environment.</p> <p>The DbEnv.setVerbose method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>onoff</CODE> - If the <b>onoff</b> parameter is set to true, the additional messages are output.<DD><CODE>which</CODE> - must be set to one of the following values: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_VERB_CHKPOINT"><CODE>Db.DB_VERB_CHKPOINT</CODE></A><p>Display checkpoint location information when searching the log for checkpoints. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_VERB_DEADLOCK"><CODE>Db.DB_VERB_DEADLOCK</CODE></A><p>Display additional information when doing deadlock detection. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_VERB_RECOVERY"><CODE>Db.DB_VERB_RECOVERY</CODE></A><p>Display additional information when performing recovery. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_VERB_REPLICATION"><CODE>Db.DB_VERB_REPLICATION</CODE></A><p>Display additional information when processing replication messages. <p>Note, to get complete replication logging when debugging replication applications, you must also configure and build the Berkeley DB library with the <a href="../../../../ref/build_unix/conf.html">--enable-diagnostic</a> configuration option as well as call the DbEnv.setVerbose method.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_VERB_WAITSFOR"><CODE>Db.DB_VERB_WAITSFOR</CODE></A><p>Display the waits-for table when doing deadlock detection. </li></ul>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setVerbose method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="get_lk_conflicts()"><!-- --></A><H3>
get_lk_conflicts</H3>
<PRE>
public byte[][] <B>get_lk_conflicts</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLockConflicts()"><CODE>getLockConflicts()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getLockConflicts()"><!-- --></A><H3>
getLockConflicts</H3>
<PRE>
public byte[][] <B>getLockConflicts</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getLockConflicts method returns the conflicts array.</p> <p>The DbEnv.getLockConflicts method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getLockConflicts method returns the conflicts array.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_lk_detect()"><!-- --></A><H3>
get_lk_detect</H3>
<PRE>
public int <B>get_lk_detect</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLockDetect()"><CODE>getLockDetect()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getLockDetect()"><!-- --></A><H3>
getLockDetect</H3>
<PRE>
public int <B>getLockDetect</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getLockDetect method returns the deadlock detector configuration.</p> <p>The DbEnv.getLockDetect method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getLockDetect method returns the deadlock detector configuration.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_lk_max_locks()"><!-- --></A><H3>
get_lk_max_locks</H3>
<PRE>
public int <B>get_lk_max_locks</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLockMaxLocks()"><CODE>getLockMaxLocks()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getLockMaxLocks()"><!-- --></A><H3>
getLockMaxLocks</H3>
<PRE>
public int <B>getLockMaxLocks</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.setLockMaxLocks method returns the maximum number of locks.</p> <p>The DbEnv.setLockMaxLocks method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.setLockMaxLocks method returns the maximum number of locks.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_lk_max_lockers()"><!-- --></A><H3>
get_lk_max_lockers</H3>
<PRE>
public int <B>get_lk_max_lockers</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLockMaxLockers()"><CODE>getLockMaxLockers()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getLockMaxLockers()"><!-- --></A><H3>
getLockMaxLockers</H3>
<PRE>
public int <B>getLockMaxLockers</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getLockMaxLockers method returns the maximum number of lockers.</p> <p>The DbEnv.getLockMaxLockers method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getLockMaxLockers method returns the maximum number of lockers.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_lk_max_objects()"><!-- --></A><H3>
get_lk_max_objects</H3>
<PRE>
public int <B>get_lk_max_objects</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLockMaxObjects()"><CODE>getLockMaxObjects()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getLockMaxObjects()"><!-- --></A><H3>
getLockMaxObjects</H3>
<PRE>
public int <B>getLockMaxObjects</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getLockMaxObjects method returns the maximum number of locked objects.</p> <p>The DbEnv.getLockMaxObjects method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getLockMaxObjects method returns the maximum number of locked objects.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="lock_detect(int, int)"><!-- --></A><H3>
lock_detect</H3>
<PRE>
public int <B>lock_detect</B>(int flags,
int atype)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#lockDetect(int, int)"><CODE>lockDetect(int,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="lockDetect(int, int)"><!-- --></A><H3>
lockDetect</H3>
<PRE>
public int <B>lockDetect</B>(int flags,
int atype)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.lockDetect method runs one iteration of the deadlock detector. The deadlock detector traverses the lock table and marks one of the participating lock requesters for rejection in each deadlock it finds.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>atype</CODE> - specifies which lock request(s) to reject. It must be set to one of the following list: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_DEFAULT"><CODE>Db.DB_LOCK_DEFAULT</CODE></A><p>Use whatever lock policy was specified when the database environment was created. If no lock policy has yet been specified, set the lock policy to <code>Db.DB_LOCK_RANDOM</code>. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_EXPIRE"><CODE>Db.DB_LOCK_EXPIRE</CODE></A><p>Reject lock requests which have timed out. No other deadlock detection is performed. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_MAXLOCKS"><CODE>Db.DB_LOCK_MAXLOCKS</CODE></A><p>Reject the lock request for the locker ID with the greatest number of locks. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_MINLOCKS"><CODE>Db.DB_LOCK_MINLOCKS</CODE></A><p>Reject the lock request for the locker ID with the fewest number of locks. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_MINWRITE"><CODE>Db.DB_LOCK_MINWRITE</CODE></A><p>Reject the lock request for the locker ID with the fewest number of write locks. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_OLDEST"><CODE>Db.DB_LOCK_OLDEST</CODE></A><p>Reject the lock request for the oldest locker ID. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_RANDOM"><CODE>Db.DB_LOCK_RANDOM</CODE></A><p>Reject the lock request for a random locker ID. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_YOUNGEST"><CODE>Db.DB_LOCK_YOUNGEST</CODE></A><p>Reject the lock request for the youngest locker ID. </li></ul><DD><CODE>flags</CODE> - currently unused, and must be set to 0.
<DT><B>Returns:</B><DD>The DbEnv.lockDetect method returns the number of lock requests that were rejected.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.lockDetect method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="lock_get(int, int, com.sleepycat.db.Dbt, int)"><!-- --></A><H3>
lock_get</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbLock.html">DbLock</A> <B>lock_get</B>(int locker,
int flags,
<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> object,
int lock_mode)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#lockGet(int, int, com.sleepycat.db.Dbt, int)"><CODE>lockGet(int,int,Dbt,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="lockGet(int, int, com.sleepycat.db.Dbt, int)"><!-- --></A><H3>
lockGet</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbLock.html">DbLock</A> <B>lockGet</B>(int locker,
int flags,
<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> object,
int lock_mode)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.lockGet method acquires a lock from the lock table, returning information about it in a DbLock object.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - must be set to 0 or the following value: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_NOWAIT"><CODE>Db.DB_LOCK_NOWAIT</CODE></A><p>If a lock cannot be granted because the requested lock conflicts with an existing lock, throw a <A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html"><CODE>DbLockNotGrantedException</CODE></A> immediately instead of waiting for the lock to become available. </li></ul><DD><CODE>lock_mode</CODE> - used as an index into the environment's lock conflict matrix. When using the default lock conflict matrix, <b>lock_mode</b> must be set to one of the following values: read (shared) write (exclusive) intention to write (shared) intention to read (shared) intention to read and write (shared) <p>See <A HREF="../../../com/sleepycat/db/DbEnv.html#setLockConflicts(byte[][])"><CODE>DbEnv.setLockConflicts</CODE></A> and <a href="../../../../ref/lock/stdmode.html">Standard Lock Modes</a> for more information on the lock conflict matrix.</p><DD><CODE>locker</CODE> - an unsigned 32-bit integer quantity. It represents the entity requesting the lock.<DD><CODE>object</CODE> - an untyped byte string that specifies the object to be locked. Applications using the locking subsystem directly while also doing locking via the Berkeley DB access methods must take care not to inadvertently lock objects that happen to be equal to the unique file IDs used to lock files. See <a href="../../../../ref/lock/am_conv.html">Access method locking conventions</a> for more information.
<DT><B>Returns:</B><DD>The DbEnv.lockGet method throws an exception that encapsulates a non-zero error value on failure. </p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbDeadlockException.html">DbDeadlockException</A></CODE> - If a transactional database environment operation was selected to resolve a deadlock, the DbEnv.lockGet method will fail and throw a <A HREF="../../../com/sleepycat/db/DbDeadlockException.html"><CODE>DbDeadlockException</CODE></A> exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html">DbLockNotGrantedException</A></CODE> - If a Berkeley DB Concurrent Data Store database environment configured for lock timeouts was unable to grant a lock in the allowed time, the DbEnv.lockGet method will fail and throw a <A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html"><CODE>DbLockNotGrantedException</CODE></A> exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html">DbLockNotGrantedException</A></CODE> - If the <A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_NOWAIT"><CODE>Db.DB_LOCK_NOWAIT</CODE></A> flag or lock timers were configured and the lock could not be granted before the wait-time expired, the DbEnv.lockGet method will fail and throw a <A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html"><CODE>DbLockNotGrantedException</CODE></A> exception.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.lockGet method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbMemoryException.html">DbMemoryException</A></CODE> - If the maximum number of locks has been reached, the DbEnv.lockGet method will fail and throw a <A HREF="../../../com/sleepycat/db/DbMemoryException.html"><CODE>DbMemoryException</CODE></A> exception.</DL>
</DD>
</DL>
<HR>
<A NAME="lock_id()"><!-- --></A><H3>
lock_id</H3>
<PRE>
public int <B>lock_id</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#lockId()"><CODE>lockId()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="lockId()"><!-- --></A><H3>
lockId</H3>
<PRE>
public int <B>lockId</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.lockId method returns a locker ID, which is guaranteed to be unique in the specified lock table.</p> <p>The <A HREF="../../../com/sleepycat/db/DbEnv.html#lockIdFree(int)"><CODE>DbEnv.lockIdFree</CODE></A> method should be called to return the locker ID to the Berkeley DB library when it is no longer needed.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.lockId method returns a locker ID which is guaranteed to be unique in the specified lock table.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="lock_id_free(int)"><!-- --></A><H3>
lock_id_free</H3>
<PRE>
public void <B>lock_id_free</B>(int id)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#lockIdFree(int)"><CODE>lockIdFree(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="lockIdFree(int)"><!-- --></A><H3>
lockIdFree</H3>
<PRE>
public void <B>lockIdFree</B>(int id)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.lockIdFree method frees a locker ID allocated by the <A HREF="../../../com/sleepycat/db/DbEnv.html#lockId()"><CODE>DbEnv.lockId</CODE></A> method.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>id</CODE> - the locker id to be freed.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.lockIdFree method will fail and throw a IllegalArgumentException exception if the locker ID is invalid or locks are still held by this locker ID; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="lock_put(com.sleepycat.db.DbLock)"><!-- --></A><H3>
lock_put</H3>
<PRE>
public void <B>lock_put</B>(<A HREF="../../../com/sleepycat/db/DbLock.html">DbLock</A> lock)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#lockPut(com.sleepycat.db.DbLock)"><CODE>lockPut(DbLock)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="lockPut(com.sleepycat.db.DbLock)"><!-- --></A><H3>
lockPut</H3>
<PRE>
public void <B>lockPut</B>(<A HREF="../../../com/sleepycat/db/DbLock.html">DbLock</A> lock)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.lockPut method releases <b>lock</b>.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>lock</CODE> - the lock to be released.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.lockPut method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="lock_stat(int)"><!-- --></A><H3>
lock_stat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbLockStat.html">DbLockStat</A> <B>lock_stat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#lockStat(int)"><CODE>lockStat(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="lockStat(int)"><!-- --></A><H3>
lockStat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbLockStat.html">DbLockStat</A> <B>lockStat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.lockStat method returns the locking subsystem statistics.</p> <p>The DbEnv.lockStat method creates a DbLockStat object encapsulating the locking subsystem statistics. The following data fields are available from the DbLockStat object:</p> For convenience, the DbLockStat class has a toString method that lists all the data fields.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - must be set to 0 or the following value: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_STAT_CLEAR"><CODE>Db.DB_STAT_CLEAR</CODE></A><p>Reset statistics after returning their values. </li></ul>
<DT><B>Returns:</B><DD>The DbEnv.lockStat method throws an exception that encapsulates a non-zero error value on failure. </p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.lockStat method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_lk_conflicts(byte[][])"><!-- --></A><H3>
set_lk_conflicts</H3>
<PRE>
public void <B>set_lk_conflicts</B>(byte[][] conflicts)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLockConflicts(byte[][])"><CODE>setLockConflicts(byte[][])</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setLockConflicts(byte[][])"><!-- --></A><H3>
setLockConflicts</H3>
<PRE>
public void <B>setLockConflicts</B>(byte[][] conflicts)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Set the locking conflicts matrix.</p> <p>If DbEnv.setLockConflicts is never called, a standard conflicts array is used; see <a href="../../../../ref/lock/stdmode.html">Standard Lock Modes</a> for more information.</p> <p>The DbEnv.setLockConflicts method configures a database environment, not only operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle.</p> <p>The DbEnv.setLockConflicts method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. If the database environment already exists when <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> is called, the information specified to DbEnv.setLockConflicts will be ignored. </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>conflicts</CODE> - the new locking conflicts matrix. A non-0 value for the array element indicates that requested_mode and held_mode conflict: <blockquote><pre>conflicts[requested_mode][held_mode]</pre></blockquote> <p>The <i>not-granted</i> mode must be represented by 0.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setLockConflicts method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbMemoryException.html">DbMemoryException</A></CODE> - If the conflicts array could not be copied, the DbEnv.setLockConflicts method will fail and throw a <A HREF="../../../com/sleepycat/db/DbMemoryException.html"><CODE>DbMemoryException</CODE></A> exception.</DL>
</DD>
</DL>
<HR>
<A NAME="set_lk_detect(int)"><!-- --></A><H3>
set_lk_detect</H3>
<PRE>
public void <B>set_lk_detect</B>(int detect)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLockDetect(int)"><CODE>setLockDetect(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setLockDetect(int)"><!-- --></A><H3>
setLockDetect</H3>
<PRE>
public void <B>setLockDetect</B>(int detect)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Set if the deadlock detector is to be run whenever a lock conflict occurs, and specify what lock request(s) should be rejected. As transactions acquire locks on behalf of a single locker ID, rejecting a lock request associated with a transaction normally requires the transaction be aborted.</p> <p>The database environment's deadlock detector configuration 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_lk_detect", one or more whitespace characters, and the method <b>detect</b> parameter as a string; for example, "set_lk_detect DB_LOCK_OLDEST". Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv.setLockDetect method configures a database environment, not only operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle.</p> <p>The DbEnv.setLockDetect method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. If the database environment already exists when <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> is called, the information specified to DbEnv.setLockDetect must be consistent with the existing environment or an error will be returned. </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>detect</CODE> - The <b>detect</b> parameter configures the deadlock detector. The specified value must be one of the following list: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_DEFAULT"><CODE>Db.DB_LOCK_DEFAULT</CODE></A><p>Use whatever lock policy was specified when the database environment was created. If no lock policy has yet been specified, set the lock policy to <code>Db.DB_LOCK_RANDOM</code>. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_EXPIRE"><CODE>Db.DB_LOCK_EXPIRE</CODE></A><p>Reject lock requests which have timed out. No other deadlock detection is performed. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_MAXLOCKS"><CODE>Db.DB_LOCK_MAXLOCKS</CODE></A><p>Reject the lock request for the locker ID with the greatest number of locks. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_MINLOCKS"><CODE>Db.DB_LOCK_MINLOCKS</CODE></A><p>Reject the lock request for the locker ID with the fewest number of locks. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_MINWRITE"><CODE>Db.DB_LOCK_MINWRITE</CODE></A><p>Reject the lock request for the locker ID with the fewest number of write locks. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_OLDEST"><CODE>Db.DB_LOCK_OLDEST</CODE></A><p>Reject the lock request for the oldest locker ID. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_RANDOM"><CODE>Db.DB_LOCK_RANDOM</CODE></A><p>Reject the lock request for a random locker ID. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_LOCK_YOUNGEST"><CODE>Db.DB_LOCK_YOUNGEST</CODE></A><p>Reject the lock request for the youngest locker ID. </li></ul>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setLockDetect method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_lk_max_lockers(int)"><!-- --></A><H3>
set_lk_max_lockers</H3>
<PRE>
public void <B>set_lk_max_lockers</B>(int max)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLockMaxLockers(int)"><CODE>setLockMaxLockers(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setLockMaxLockers(int)"><!-- --></A><H3>
setLockMaxLockers</H3>
<PRE>
public void <B>setLockMaxLockers</B>(int max)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Set the maximum number of locking entities supported by the Berkeley DB environment. This value is used by <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> to estimate how much space to allocate for various lock-table data structures. The default value is 1000 lockers. For specific information on configuring the size of the lock subsystem, see <a href="../../../../ref/lock/max.html">Configuring locking: sizing the system</a>.</p> <p>The database environment's maximum number of lockers 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_lk_max_lockers", one or more whitespace characters, and the number of lockers. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv.setLockMaxLockers method configures a database environment, not only operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle.</p> <p>The DbEnv.setLockMaxLockers method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. If the database environment already exists when <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> is called, the information specified to DbEnv.setLockMaxLockers will be ignored. </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>max</CODE> - the maximum number simultaneous locking entities supported by the Berkeley DB environment.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setLockMaxLockers method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_lk_max_locks(int)"><!-- --></A><H3>
set_lk_max_locks</H3>
<PRE>
public void <B>set_lk_max_locks</B>(int max)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLockMaxLocks(int)"><CODE>setLockMaxLocks(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setLockMaxLocks(int)"><!-- --></A><H3>
setLockMaxLocks</H3>
<PRE>
public void <B>setLockMaxLocks</B>(int max)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Set the maximum number of locks supported by the Berkeley DB environment. This value is used by <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> to estimate how much space to allocate for various lock-table data structures. The default value is 1000 locks. For specific information on configuring the size of the lock subsystem, see <a href="../../../../ref/lock/max.html">Configuring locking: sizing the system</a>.</p> <p>The database environment's maximum number of locks 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_lk_max_locks", one or more whitespace characters, and the number of locks. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv.setLockMaxLocks method configures a database environment, not only operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle.</p> <p>The DbEnv.setLockMaxLocks method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. If the database environment already exists when <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> is called, the information specified to DbEnv.setLockMaxLocks will be ignored. </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>max</CODE> - the maximum number of locks supported by the Berkeley DB environment.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setLockMaxLocks method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_lk_max_objects(int)"><!-- --></A><H3>
set_lk_max_objects</H3>
<PRE>
public void <B>set_lk_max_objects</B>(int max)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLockMaxObjects(int)"><CODE>setLockMaxObjects(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setLockMaxObjects(int)"><!-- --></A><H3>
setLockMaxObjects</H3>
<PRE>
public void <B>setLockMaxObjects</B>(int max)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Set the maximum number of locked objects supported by the Berkeley DB environment. This value is used by <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> to estimate how much space to allocate for various lock-table data structures. The default value is 1000 objects. For specific information on configuring the size of the lock subsystem, see <a href="../../../../ref/lock/max.html">Configuring locking: sizing the system</a>.</p> <p>The database environment's maximum number of objects 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_lk_max_objects", one or more whitespace characters, and the number of objects. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv.setLockMaxObjects method configures a database environment, not only operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle.</p> <p>The DbEnv.setLockMaxObjects method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. If the database environment already exists when <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> is called, the information specified to DbEnv.setLockMaxObjects will be ignored. </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>max</CODE> - the maximum number of locked objects supported by the Berkeley DB environment.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setLockMaxObjects method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="get_lg_bsize()"><!-- --></A><H3>
get_lg_bsize</H3>
<PRE>
public int <B>get_lg_bsize</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLogBufferSize()"><CODE>getLogBufferSize()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getLogBufferSize()"><!-- --></A><H3>
getLogBufferSize</H3>
<PRE>
public int <B>getLogBufferSize</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getLogBufferSize method returns the size of the log buffer, in bytes.</p> <p>The DbEnv.getLogBufferSize method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getLogBufferSize method returns the size of the log buffer, in bytes.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_lg_dir()"><!-- --></A><H3>
get_lg_dir</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> <B>get_lg_dir</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLogDir()"><CODE>getLogDir()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getLogDir()"><!-- --></A><H3>
getLogDir</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> <B>getLogDir</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getLogDir method returns the log directory.</p> <p>The DbEnv.getLogDir method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getLogDir method returns the log directory.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_lg_max()"><!-- --></A><H3>
get_lg_max</H3>
<PRE>
public int <B>get_lg_max</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLogMax()"><CODE>getLogMax()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getLogMax()"><!-- --></A><H3>
getLogMax</H3>
<PRE>
public int <B>getLogMax</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getLogMax method returns the maximum log file size.</p> <p>The DbEnv.getLogMax method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getLogMax method returns the maximum log file size.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_lg_regionmax()"><!-- --></A><H3>
get_lg_regionmax</H3>
<PRE>
public int <B>get_lg_regionmax</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getLogRegionMax()"><CODE>getLogRegionMax()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getLogRegionMax()"><!-- --></A><H3>
getLogRegionMax</H3>
<PRE>
public int <B>getLogRegionMax</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getLogRegionMax method returns the size of the underlying logging subsystem region.</p> <p>The DbEnv.getLogRegionMax method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getLogRegionMax method returns the size of the underlying logging subsystem region.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="log_archive(int)"><!-- --></A><H3>
log_archive</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A>[] <B>log_archive</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#logArchive(int)"><CODE>logArchive(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="logArchive(int)"><!-- --></A><H3>
logArchive</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A>[] <B>logArchive</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.logArchive method returns an array of log or database filenames.</p> <p>By default, DbEnv.logArchive returns the names of all of the log files that are no longer in use (for example, that are no longer involved in active transactions), and that may safely be archived for catastrophic recovery and then removed from the system. If there are no filenames to return, DbEnv.logArchive returns null.</p> <p>Log cursor handles (returned by the <A HREF="../../../com/sleepycat/db/DbEnv.html#logCursor(int)"><CODE>DbEnv.logCursor</CODE></A> method) may have open file descriptors for log files in the database environment. Also, the Berkeley DB interfaces to the database environment logging subsystem (for example, <A HREF="../../../com/sleepycat/db/DbEnv.html#logPut(com.sleepycat.db.DbLsn, com.sleepycat.db.Dbt, int)"><CODE>DbEnv.logPut</CODE></A> and <A HREF="../../../com/sleepycat/db/DbTxn.html#abort()"><CODE>DbTxn.abort</CODE></A>) may allocate log cursors and have open file descriptors for log files as well. On operating systems where filesystem related system calls (for example, rename and unlink on Windows/NT) can fail if a process has an open file descriptor for the affected file, attempting to move or remove the log files listed by DbEnv.logArchive may fail. All Berkeley DB internal use of log cursors operates on active log files only and furthermore, is short-lived in nature. So, an application seeing such a failure should be restructured to close any open log cursors it may have, and otherwise to retry the operation until it succeeds. (Although the latter is not likely to be necessary; it is hard to imagine a reason to move or rename a log file in which transactions are being logged or aborted.)</p> <p>See <a href="../../../../utility/db_archive.html">db_archive</a> for more information on database archival procedures.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_ARCH_ABS"><CODE>Db.DB_ARCH_ABS</CODE></A><p>All pathnames are returned as absolute pathnames, instead of relative to the database home directory. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_ARCH_DATA"><CODE>Db.DB_ARCH_DATA</CODE></A><p>Return the database files that need to be archived in order to recover the database from catastrophic failure. If any of the database files have not been accessed during the lifetime of the current log files, DbEnv.logArchive will not include them in this list. It is also possible that some of the files referred to by the log have since been deleted from the system. <p>The <code>Db.DB_ARCH_DATA</code> and <code>Db.DB_ARCH_LOG</code> flags are mutually exclusive.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_ARCH_LOG"><CODE>Db.DB_ARCH_LOG</CODE></A><p>Return all the log filenames, regardless of whether or not they are in use. <p>The <code>Db.DB_ARCH_DATA</code> and <code>Db.DB_ARCH_LOG</code> flags are mutually exclusive.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_ARCH_REMOVE"><CODE>Db.DB_ARCH_REMOVE</CODE></A><p>Remove log files that are no longer needed; no filenames are returned. Automatic log file removal is likely to make catastrophic recovery impossible. <p>The <code>Db.DB_ARCH_REMOVE</code> flag may not be specified with any other flag.</p> </li></ul>
<DT><B>Returns:</B><DD>The DbEnv.logArchive method throws an exception that encapsulates a non-zero error value on failure. </p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.logArchive method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="log_compare(com.sleepycat.db.DbLsn, com.sleepycat.db.DbLsn)"><!-- --></A><H3>
log_compare</H3>
<PRE>
public static int <B>log_compare</B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn0,
<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn1)</PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#logCompare(com.sleepycat.db.DbLsn, com.sleepycat.db.DbLsn)"><CODE>logCompare(DbLsn,DbLsn)</CODE></A></I>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="logCompare(com.sleepycat.db.DbLsn, com.sleepycat.db.DbLsn)"><!-- --></A><H3>
logCompare</H3>
<PRE>
public static int <B>logCompare</B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn0,
<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn1)</PRE>
<DL>
<DD>The DbEnv.logCompare method allows the caller to compare two <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> objects, returning 0 if they are equal, 1 if <b>lsn0</b> is greater than <b>lsn1</b>, and -1 if <b>lsn0</b> is less than <b>lsn1</b>.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>lsn0</CODE> - one of the <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> objects to be compared.<DD><CODE>lsn1</CODE> - one of the <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> objects to be compared.
<DT><B>Returns:</B><DD>The DbEnv.logCompare method returns 0 if the <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> object parameters are equal, 1 if <b>lsn0</b> is greater than <b>lsn1</b>, and -1 if <b>lsn0</b> is less than <b>lsn1</b>.</p></DL>
</DD>
</DL>
<HR>
<A NAME="log_cursor(int)"><!-- --></A><H3>
log_cursor</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbLogc.html">DbLogc</A> <B>log_cursor</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#logCursor(int)"><CODE>logCursor(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="logCursor(int)"><!-- --></A><H3>
logCursor</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbLogc.html">DbLogc</A> <B>logCursor</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.logCursor method returns a created log cursor.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - currently unused, and must be set to 0.
<DT><B>Returns:</B><DD>The DbEnv.logCursor method throws an exception that encapsulates a non-zero error value on failure. </p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.logCursor method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="log_file(com.sleepycat.db.DbLsn)"><!-- --></A><H3>
log_file</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> <B>log_file</B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#logFile(com.sleepycat.db.DbLsn)"><CODE>logFile(DbLsn)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="logFile(com.sleepycat.db.DbLsn)"><!-- --></A><H3>
logFile</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> <B>logFile</B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.logFile method maps <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> objects to filenames, returning the name of the file containing the record named by <b>lsn</b>.</p> <p>This mapping of <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> objects to files is needed for database administration. For example, a transaction manager typically records the earliest <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> needed for restart, and the database administrator may want to archive log files to tape when they contain only <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> entries before the earliest one needed for restart.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>lsn</CODE> - the <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> object for which a filename is wanted.
<DT><B>Returns:</B><DD>The DbEnv.logFile method throws an exception that encapsulates a non-zero error value on failure. </p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbMemoryException.html">DbMemoryException</A></CODE> - If the supplied buffer was too small to hold the log filename, the DbEnv.logFile method will fail and throw a <A HREF="../../../com/sleepycat/db/DbMemoryException.html"><CODE>DbMemoryException</CODE></A> exception.</DL>
</DD>
</DL>
<HR>
<A NAME="log_flush(com.sleepycat.db.DbLsn)"><!-- --></A><H3>
log_flush</H3>
<PRE>
public void <B>log_flush</B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#logFlush(com.sleepycat.db.DbLsn)"><CODE>logFlush(DbLsn)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="logFlush(com.sleepycat.db.DbLsn)"><!-- --></A><H3>
logFlush</H3>
<PRE>
public void <B>logFlush</B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.logFlush method writes log records to disk.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>lsn</CODE> - All log records with <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> values less than or equal to the <b>lsn</b> parameter are written to disk. If <b>lsn</b> is null, all records in the log are flushed.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.logFlush method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="log_put(com.sleepycat.db.DbLsn, com.sleepycat.db.Dbt, int)"><!-- --></A><H3>
log_put</H3>
<PRE>
public void <B>log_put</B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn,
<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> data,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#logPut(com.sleepycat.db.DbLsn, com.sleepycat.db.Dbt, int)"><CODE>logPut(DbLsn,Dbt,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="logPut(com.sleepycat.db.DbLsn, com.sleepycat.db.Dbt, int)"><!-- --></A><H3>
logPut</H3>
<PRE>
public void <B>logPut</B>(<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> lsn,
<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> data,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.logPut method appends records to the log. The <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> of the put record is returned in the <b>lsn</b> parameter.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>data</CODE> - the record to write to the log. <p>The caller is responsible for providing any necessary structure to <b>data</b>. (For example, in a write-ahead logging protocol, the application must understand what part of <b>data</b> is an operation code, what part is redo information, and what part is undo information. In addition, most transaction managers will store in <b>data</b> the <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> of the previous log record for the same transaction, to support chaining back through the transaction's log records during undo.)</p><DD><CODE>flags</CODE> - must be set to 0 or the following value: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_FLUSH"><CODE>Db.DB_FLUSH</CODE></A><p>The log is forced to disk after this record is written, guaranteeing that all records with <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> values less than or equal to the one being "put" are on disk before DbEnv.logPut returns. </li></ul><DD><CODE>lsn</CODE> - references memory into which the <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> of the put record is copied.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The <A HREF="../../../com/sleepycat/db/DbEnv.html#logFlush(com.sleepycat.db.DbLsn)"><CODE>DbEnv.logFlush</CODE></A> method will fail and throw a IllegalArgumentException exception if the record to be logged is larger than the maximum log record; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="log_stat(int)"><!-- --></A><H3>
log_stat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbLogStat.html">DbLogStat</A> <B>log_stat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#logStat(int)"><CODE>logStat(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="logStat(int)"><!-- --></A><H3>
logStat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbLogStat.html">DbLogStat</A> <B>logStat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.logStat method returns the logging subsystem statistics.</p> <p>The DbEnv.logStat method creates a DbLogStat object encapsulating the logging subsystem statistics. The following data fields are available from the DbLogStat object:</p> For convenience, the DbLogStat class has a toString method that lists all the data fields.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - must be set to 0 or the following value: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_STAT_CLEAR"><CODE>Db.DB_STAT_CLEAR</CODE></A><p>Reset statistics after returning their values. </li></ul>
<DT><B>Returns:</B><DD>The DbEnv.logStat method throws an exception that encapsulates a non-zero error value on failure. </p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.logStat method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_lg_bsize(int)"><!-- --></A><H3>
set_lg_bsize</H3>
<PRE>
public void <B>set_lg_bsize</B>(int lg_bsize)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLogBufferSize(int)"><CODE>setLogBufferSize(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setLogBufferSize(int)"><!-- --></A><H3>
setLogBufferSize</H3>
<PRE>
public void <B>setLogBufferSize</B>(int lg_bsize)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Set the size of the in-memory log buffer, in bytes. By default, or if the value is set to 0, a size of 32K is used. The size of the log file (see <A HREF="../../../com/sleepycat/db/DbEnv.html#setLogMax(int)"><CODE>DbEnv.setLogMax</CODE></A>) must be at least four times the size of the in-memory log buffer.</p> <p>Log information is stored in-memory until the storage space fills up or transaction commit forces the information to be flushed to stable storage. In the presence of long-running transactions or transactions producing large amounts of data, larger buffer sizes can increase throughput.</p> <p>The database environment's log buffer size 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_lg_bsize", one or more whitespace characters, and the size in bytes. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv.setLogBufferSize method configures a database environment, not only operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle.</p> <p>The DbEnv.setLogBufferSize method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. If the database environment already exists when <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> is called, the information specified to DbEnv.setLogBufferSize will be ignored. </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>lg_bsize</CODE> - the size of the in-memory log buffer, in bytes.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setLogBufferSize method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; The size of the log file is less than four times the size of the in-memory log buffer; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_lg_dir(java.lang.String)"><!-- --></A><H3>
set_lg_dir</H3>
<PRE>
public void <B>set_lg_dir</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> dir)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLogDir(java.lang.String)"><CODE>setLogDir(String)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setLogDir(java.lang.String)"><!-- --></A><H3>
setLogDir</H3>
<PRE>
public void <B>setLogDir</B>(<A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> dir)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The path of a directory to be used as the location of logging files. Log files created by the Log Manager subsystem will be created in this directory.</p> <p>If no logging directory is specified, log files are created in the environment home directory. See <a href="../../../../ref/env/naming.html">Berkeley DB File Naming</a> for more information.</p> <p>For the greatest degree of recoverability from system or application failure, database files and log files should be located on separate physical devices.</p> <p>The database environment's logging directory 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_lg_dir", one or more whitespace characters, and the directory name. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv.setLogDir method configures operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle, not all operations performed on the underlying database environment.</p> <p>The DbEnv.setLogDir method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. If the database environment already exists when <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> is called, the information specified to DbEnv.setLogDir must be consistent with the existing environment or corruption can occur.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>dir</CODE> - the directory used to store the logging files.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setLogDir method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_lg_max(int)"><!-- --></A><H3>
set_lg_max</H3>
<PRE>
public void <B>set_lg_max</B>(int lg_max)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLogMax(int)"><CODE>setLogMax(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setLogMax(int)"><!-- --></A><H3>
setLogMax</H3>
<PRE>
public void <B>setLogMax</B>(int lg_max)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Set the maximum size of a single file in the log, in bytes. By default, or if the <b>lg_max</b> parameter is set to 0, a size of 10MB is used. Because <A HREF="../../../com/sleepycat/db/DbLsn.html"><CODE>DbLsn</CODE></A> file offsets are unsigned four-byte values, the set value may not be larger than the maximum unsigned four-byte value. The size of the log file must be at least four times the size of the in-memory log buffer (see <A HREF="../../../com/sleepycat/db/DbEnv.html#setLogBufferSize(int)"><CODE>DbEnv.setLogBufferSize</CODE></A>).</p> <p>See <a href="../../../../ref/log/limits.html">Log File Limits</a> for more information.</p> <p>The database environment's log file size 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_lg_max", one or more whitespace characters, and the size in bytes. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv.setLogMax method configures a database environment, not only operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle.</p> <p>The DbEnv.setLogMax method may be called at any time during the life of the application.</p> If no size is specified by the application, the size last specified for the database region will be used, or if no database region previously existed, the default will be used.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>lg_max</CODE> - the size of a single log file, in bytes.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setLogMax method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; the size of the log file is less than four times the size of the in-memory log buffer; The specified log file size was too large; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_lg_regionmax(int)"><!-- --></A><H3>
set_lg_regionmax</H3>
<PRE>
public void <B>set_lg_regionmax</B>(int lg_regionmax)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setLogRegionMax(int)"><CODE>setLogRegionMax(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setLogRegionMax(int)"><!-- --></A><H3>
setLogRegionMax</H3>
<PRE>
public void <B>setLogRegionMax</B>(int lg_regionmax)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>Set the size of the underlying logging area of the Berkeley DB environment, in bytes. By default, or if the value is set to 0, the default size is 60KB. The log region is used to store filenames, and so may need to be increased in size if a large number of files will be opened and registered with the specified Berkeley DB environment's log manager.</p> <p>The database environment's log region size 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_lg_regionmax", one or more whitespace characters, and the size in bytes. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv.setLogRegionMax method configures a database environment, not only operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle.</p> <p>The DbEnv.setLogRegionMax method may not be called after the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method is called. If the database environment already exists when <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> is called, the information specified to DbEnv.setLogRegionMax will be ignored. </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>lg_regionmax</CODE> - the size of the logging area in the Berkeley DB environment, in bytes.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.setLogRegionMax method will fail and throw a IllegalArgumentException exception if the method was called after <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> was called; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="get_cachesize()"><!-- --></A><H3>
get_cachesize</H3>
<PRE>
public long <B>get_cachesize</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getCacheSize()"><CODE>getCacheSize()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getCacheSize()"><!-- --></A><H3>
getCacheSize</H3>
<PRE>
public long <B>getCacheSize</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getCacheSize method returns the size of the cache.</p> <p>The DbEnv.getCacheSize method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getCacheSize method returns the size of the cache.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_cachesize_ncache()"><!-- --></A><H3>
get_cachesize_ncache</H3>
<PRE>
public int <B>get_cachesize_ncache</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getCacheSizeNcache()"><CODE>getCacheSizeNcache()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getCacheSizeNcache()"><!-- --></A><H3>
getCacheSizeNcache</H3>
<PRE>
public int <B>getCacheSizeNcache</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getCacheSizeNcache method returns the number of caches.</p> <p>The DbEnv.getCacheSizeNcache method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getCacheSizeNcache method returns the number of caches.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_mp_mmapsize()"><!-- --></A><H3>
get_mp_mmapsize</H3>
<PRE>
public long <B>get_mp_mmapsize</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getMemoryPoolMapSize()"><CODE>getMemoryPoolMapSize()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getMemoryPoolMapSize()"><!-- --></A><H3>
getMemoryPoolMapSize</H3>
<PRE>
public long <B>getMemoryPoolMapSize</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getMemoryPoolMapSize method returns the maximum file map size.</p> <p>The DbEnv.getMemoryPoolMapSize method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getMemoryPoolMapSize method returns the maximum file map size.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="memp_stat(int)"><!-- --></A><H3>
memp_stat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbMpoolStat.html">DbMpoolStat</A> <B>memp_stat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#memoryPoolStat(int)"><CODE>memoryPoolStat(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="memoryPoolStat(int)"><!-- --></A><H3>
memoryPoolStat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbMpoolStat.html">DbMpoolStat</A> <B>memoryPoolStat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.memoryPoolStat method returns the memory pool (that is, the buffer cache) subsystem statistics.</p> <p>The DbEnv.memoryPoolStat method creates a DbMpoolStat object encapsulating memory pool (that is, the buffer cache) statistics. The following data fields are available from the DbMpoolStat object:</p> For convenience, the DbMpoolStat class has a toString method that lists all the data fields.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - must be set to 0 or the following value: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_STAT_CLEAR"><CODE>Db.DB_STAT_CLEAR</CODE></A><p>Reset statistics after returning their values. </li></ul>
<DT><B>Returns:</B><DD>The DbEnv.memoryPoolStat method throws an exception that encapsulates a non-zero error value on failure. </p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="memp_fstat(int)"><!-- --></A><H3>
memp_fstat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbMpoolFStat.html">DbMpoolFStat</A>[] <B>memp_fstat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#memoryPoolFileStat(int)"><CODE>memoryPoolFileStat(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="memoryPoolFileStat(int)"><!-- --></A><H3>
memoryPoolFileStat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbMpoolFStat.html">DbMpoolFStat</A>[] <B>memoryPoolFileStat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.memoryPoolFileStat method creates an array of DbMpoolFStat objects containing statistics for individual files in the cache. Each DbMpoolFStat object contains statistics for an individual DbMpoolFile. The following data fields are available for each DbMpoolFStat object:</p> For convenience, the DbMpoolFStat class has a toString method that lists all the data fields.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - must be set to 0 or the following value: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_STAT_CLEAR"><CODE>Db.DB_STAT_CLEAR</CODE></A><p>Reset statistics after returning their values. </li></ul>
<DT><B>Returns:</B><DD>The DbEnv.memoryPoolFileStat method throws an exception that encapsulates a non-zero error value on failure. </p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.memoryPoolStat method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="memp_trickle(int)"><!-- --></A><H3>
memp_trickle</H3>
<PRE>
public int <B>memp_trickle</B>(int percent)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#memoryPoolTrickle(int)"><CODE>memoryPoolTrickle(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="memoryPoolTrickle(int)"><!-- --></A><H3>
memoryPoolTrickle</H3>
<PRE>
public int <B>memoryPoolTrickle</B>(int percent)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.memoryPoolTrickle method ensures that a specified percent of the pages in the shared memory pool are clean, by writing dirty pages to their backing files.</p> <p>The purpose of the DbEnv.memoryPoolTrickle function is to enable a memory pool manager to ensure that a page is always available for reading in new information without having to wait for a write.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>percent</CODE> - the percent of the pages in the cache that should be clean.
<DT><B>Returns:</B><DD>The DbEnv.memoryPoolTrickle method returns the number of pages that were written to reach the specified percentage.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.memoryPoolTrickle method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="get_tx_max()"><!-- --></A><H3>
get_tx_max</H3>
<PRE>
public int <B>get_tx_max</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getTxnMax()"><CODE>getTxnMax()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getTxnMax()"><!-- --></A><H3>
getTxnMax</H3>
<PRE>
public int <B>getTxnMax</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getTxnMax method returns the number of active transactions.</p> <p>The DbEnv.getTxnMax method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getTxnMax method returns the number of active transactions.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_tx_timestamp()"><!-- --></A><H3>
get_tx_timestamp</H3>
<PRE>
public long <B>get_tx_timestamp</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getTxnTimestamp()"><CODE>getTxnTimestamp()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getTxnTimestamp()"><!-- --></A><H3>
getTxnTimestamp</H3>
<PRE>
public long <B>getTxnTimestamp</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getTxnTimestamp method returns the recovery timestamp.</p> <p>The DbEnv.getTxnTimestamp method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getTxnTimestamp method returns the recovery timestamp.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="get_timeout(int)"><!-- --></A><H3>
get_timeout</H3>
<PRE>
public long <B>get_timeout</B>(int flag)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getTimeout(int)"><CODE>getTimeout(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getTimeout(int)"><!-- --></A><H3>
getTimeout</H3>
<PRE>
public long <B>getTimeout</B>(int flag)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getTimeout method returns a timeout value, in microseconds.</p> <p>The DbEnv.getTimeout method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flag</CODE> - must be set to one of the following values: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_SET_LOCK_TIMEOUT"><CODE>Db.DB_SET_LOCK_TIMEOUT</CODE></A><p>Return the timeout value for locks in this database environment. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_SET_TXN_TIMEOUT"><CODE>Db.DB_SET_TXN_TIMEOUT</CODE></A><p>Return the timeout value for transactions in this database environment. </li></ul>
<DT><B>Returns:</B><DD>The DbEnv.getTimeout method returns a timeout value, in microseconds.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="txn_begin(com.sleepycat.db.DbTxn, int)"><!-- --></A><H3>
txn_begin</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A> <B>txn_begin</B>(<A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A> parent,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#txnBegin(com.sleepycat.db.DbTxn, int)"><CODE>txnBegin(DbTxn,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="txnBegin(com.sleepycat.db.DbTxn, int)"><!-- --></A><H3>
txnBegin</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A> <B>txnBegin</B>(<A HREF="../../../com/sleepycat/db/DbTxn.html">DbTxn</A> parent,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.txnBegin method creates a new transaction in the environment and returns a <A HREF="../../../com/sleepycat/db/DbTxn.html"><CODE>DbTxn</CODE></A> that uniquely identifies it. Calling the <A HREF="../../../com/sleepycat/db/DbTxn.html#abort()"><CODE>DbTxn.abort</CODE></A>, <A HREF="../../../com/sleepycat/db/DbTxn.html#commit(int)"><CODE>DbTxn.commit</CODE></A> or <A HREF="../../../com/sleepycat/db/DbTxn.html#discard(int)"><CODE>DbTxn.discard</CODE></A> methods will discard the returned handle.</p> <p><b>Note: Transactions may only span threads if they do so serially; that is, each transaction must be active in only a single thread of control at a time. This restriction holds for parents of nested transactions as well; not two children may be concurrently active in more than one thread of control at any one time.</b></p> <p><b>Note: Cursors may not span transactions; that is, each cursor must be opened and closed within a single transaction.</b></p> <p><b>Note: A parent transaction may not issue any Berkeley DB operations -- except for DbEnv.txnBegin, <A HREF="../../../com/sleepycat/db/DbTxn.html#abort()"><CODE>DbTxn.abort</CODE></A> and <A HREF="../../../com/sleepycat/db/DbTxn.html#commit(int)"><CODE>DbTxn.commit</CODE></A> -- while it has active child transactions (child transactions that have not yet been committed or aborted).</b></p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_DIRTY_READ"><CODE>Db.DB_DIRTY_READ</CODE></A><p>All read operations performed by the transaction may read modified but not yet committed data. Silently ignored if the <A HREF="../../../com/sleepycat/db/Db.html#DB_DIRTY_READ"><CODE><code>Db.DB_DIRTY_READ</code></CODE></A> flag was not specified when the underlying database was opened. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_TXN_NOSYNC"><CODE>Db.DB_TXN_NOSYNC</CODE></A><p>Do not synchronously flush the log when this transaction commits or prepares. This means the transaction will exhibit the ACI (atomicity, consistency, and isolation) properties, but not D (durability); that is, database integrity will be maintained but it is possible that this transaction may be undone during recovery. <p>This behavior may be set for a Berkeley DB environment using the <A HREF="../../../com/sleepycat/db/DbEnv.html#setFlags(int, boolean)"><CODE>DbEnv.setFlags</CODE></A> method. Any value specified to this method overrides that setting.</p> </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_TXN_NOWAIT"><CODE>Db.DB_TXN_NOWAIT</CODE></A><p>If a lock is unavailable for any Berkeley DB operation performed in the context of this transaction, cause the operation to throw a <A HREF="../../../com/sleepycat/db/DbDeadlockException.html"><CODE>DbDeadlockException</CODE></A> immediately instead of blocking on the lock. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_TXN_SYNC"><CODE>Db.DB_TXN_SYNC</CODE></A><p>Synchronously flush the log when this transaction commits or prepares. This means the transaction will exhibit all of the ACID (atomicity, consistency, isolation, and durability) properties. <p>This behavior is the default for Berkeley DB environments unless the <A HREF="../../../com/sleepycat/db/Db.html#DB_TXN_NOSYNC"><CODE><code>Db.DB_TXN_NOSYNC</code></CODE></A> flag was specified to the <A HREF="../../../com/sleepycat/db/DbEnv.html#setFlags(int, boolean)"><CODE>DbEnv.setFlags</CODE></A> method. Any value specified to this method overrides that setting.</p> </li></ul><DD><CODE>parent</CODE> - If the <b>parent</b> parameter is non-null, the new transaction will be a nested transaction, with the transaction indicated by <b>parent</b> as its parent. Transactions may be nested to any level. In the presence of distributed transactions and two-phase commit, only the parental transaction, that is a transaction without a <b>parent</b> specified, should be passed as an parameter to <A HREF="../../../com/sleepycat/db/DbTxn.html#prepare(byte[])"><CODE>DbTxn.prepare</CODE></A>.
<DT><B>Returns:</B><DD>The DbEnv.txnBegin method throws an exception that encapsulates a non-zero error value on failure. </p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbMemoryException.html">DbMemoryException</A></CODE> - If the maximum number of concurrent transactions has been reached, the DbEnv.txnBegin method will fail and throw a <A HREF="../../../com/sleepycat/db/DbMemoryException.html"><CODE>DbMemoryException</CODE></A> exception.</DL>
</DD>
</DL>
<HR>
<A NAME="txn_checkpoint(int, int, int)"><!-- --></A><H3>
txn_checkpoint</H3>
<PRE>
public void <B>txn_checkpoint</B>(int kbyte,
int min,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#txnCheckpoint(int, int, int)"><CODE>txnCheckpoint(int,int,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="txnCheckpoint(int, int, int)"><!-- --></A><H3>
txnCheckpoint</H3>
<PRE>
public void <B>txnCheckpoint</B>(int kbyte,
int min,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.txnCheckpoint method flushes the underlying memory pool, writes a checkpoint record to the log, and then flushes the log.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - must be set to 0 or the following value: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_FORCE"><CODE>Db.DB_FORCE</CODE></A><p>Force a checkpoint record, even if there has been no activity since the last checkpoint. </li></ul><DD><CODE>kbyte</CODE> - If the <b>kbyte</b> parameter is non-zero, a checkpoint will be done if more than <b>kbyte</b> kilobytes of log data have been written since the last checkpoint.<DD><CODE>min</CODE> - If the <b>min</b> parameter is non-zero, a checkpoint will be done if more than <b>min</b> minutes have passed since the last checkpoint.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.txnCheckpoint method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="txn_recover(int, int)"><!-- --></A><H3>
txn_recover</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbPreplist.html">DbPreplist</A>[] <B>txn_recover</B>(int count,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#txnRecover(int, int)"><CODE>txnRecover(int,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="txnRecover(int, int)"><!-- --></A><H3>
txnRecover</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbPreplist.html">DbPreplist</A>[] <B>txnRecover</B>(int count,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.txnRecover method returns a list of prepared but not yet resolved transactions. The DbEnv.txnRecover method should only be called after the environment has been recovered. Because database environment state must be preserved between recovery and the application calling DbEnv.txnRecover, applications must either call DbEnv.txnRecover using the same environment handle used when recovery is done, or the database environment must not be configured using the <A HREF="../../../com/sleepycat/db/Db.html#DB_PRIVATE"><CODE>Db.DB_PRIVATE</CODE></A> flag.</p> <p>The DbEnv.txnRecover method returns a list of transactions that must be resolved by the application (committed, aborted or discarded). The return value is an array of objects of type DbPreplist; the following DbPreplist fields will be filled in:</p> The application must call <A HREF="../../../com/sleepycat/db/DbTxn.html#abort()"><CODE>DbTxn.abort</CODE></A>, <A HREF="../../../com/sleepycat/db/DbTxn.html#commit(int)"><CODE>DbTxn.commit</CODE></A> or <A HREF="../../../com/sleepycat/db/DbTxn.html#discard(int)"><CODE>DbTxn.discard</CODE></A> on each returned <A HREF="../../../com/sleepycat/db/DbTxn.html"><CODE>DbTxn</CODE></A> handle before starting any new operations.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>count</CODE> - specifies the number of maximum size of the array that should be returned.<DD><CODE>flags</CODE> - must be set to one of the following values: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_FIRST"><CODE>Db.DB_FIRST</CODE></A><p>Begin returning a list of prepared, but not yet resolved transactions. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_NEXT"><CODE>Db.DB_NEXT</CODE></A><p>Continue returning a list of prepared, but not yet resolved transactions, starting where the last call to DbEnv.txnRecover left off. </li></ul>
<DT><B>Returns:</B><DD>The DbEnv.txnRecover method throws an exception that encapsulates a non-zero error value on failure. </p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="txn_stat(int)"><!-- --></A><H3>
txn_stat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbTxnStat.html">DbTxnStat</A> <B>txn_stat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#txnStat(int)"><CODE>txnStat(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="txnStat(int)"><!-- --></A><H3>
txnStat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbTxnStat.html">DbTxnStat</A> <B>txnStat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.txnStat method returns the transaction subsystem statistics.</p> <p>The DbEnv.txnStat method creates a DbTxnStat object encapsulating the transaction subsystem statistics. The following data fields are available from the DbTxnStat object:</p> For convenience, the DbTxnStat class has a toString method that lists all the data fields.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - must be set to 0 or the following value: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_STAT_CLEAR"><CODE>Db.DB_STAT_CLEAR</CODE></A><p>Reset statistics after returning their values. </li></ul>
<DT><B>Returns:</B><DD>The DbEnv.txnStat method throws an exception that encapsulates a non-zero error value on failure. </p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.txnStat method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="get_rep_limit()"><!-- --></A><H3>
get_rep_limit</H3>
<PRE>
public long <B>get_rep_limit</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getReplicationLimit()"><CODE>getReplicationLimit()</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getReplicationLimit()"><!-- --></A><H3>
getReplicationLimit</H3>
<PRE>
public long <B>getReplicationLimit</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.getReplicationLimit method returns the transmit limit in bytes.</p> <p>The DbEnv.getReplicationLimit method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getReplicationLimit method returns the transmit limit in bytes.</p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="rep_elect(int, int, int)"><!-- --></A><H3>
rep_elect</H3>
<PRE>
public int <B>rep_elect</B>(int nsites,
int priority,
int timeout)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationElect(int, int, int)"><CODE>replicationElect(int,int,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="replicationElect(int, int, int)"><!-- --></A><H3>
replicationElect</H3>
<PRE>
public int <B>replicationElect</B>(int nsites,
int priority,
int timeout)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.replicationElect method holds an election for the master of a replication group.</p> <p>If the election is successful, the new master's ID may be the ID of the previous master, or the ID of the current environment. The application is responsible for adjusting its usage of the other environments in the replication group, including directing all database updates to the newly selected master, in accordance with the results of this election.</p> <p>The thread of control that calls the DbEnv.replicationElect method must not be the thread of control that processes incoming messages; processing the incoming messages is necessary to successfully complete an election.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>nsites</CODE> - The <b>nsites</b> parameter indicates the number of environments that the application believes are in the replication group. This number is used by Berkeley DB to avoid having two masters active simultaneously, even in the case of a network partition. During an election, a new master cannot be elected unless more than half of <b>nsites</b> agree on the new master. Thus, in the face of a network partition, the side of the partition with more than half the environments will elect a new master and continue, while the environments communicating with fewer than half the other environments will fail to find a new master.<DD><CODE>priority</CODE> - the priority of this environment. It must be a positive integer, or 0 if this environment is not permitted to become a master (see <a href="../../../../ref/rep/pri.html">Replication environment priorities</a> for more information).<DD><CODE>timeout</CODE> - specifies a timeout period for an election. If the election has not completed after <b>timeout</b> microseconds, the election will fail.
<DT><B>Returns:</B><DD>The DbEnv.replicationElect method returns the newly elected master's ID.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - The DbEnv.replicationElect method may fail and throw <A HREF="../../../com/sleepycat/db/DbException.html"><CODE>DbException</CODE></A>, encapsulating one of the following non-zero errors: <li>The replication group was unable to elect a master, or was unable to complete the election in the specified <b>timeout</b> period.</DL>
</DD>
</DL>
<HR>
<A NAME="rep_process_message(com.sleepycat.db.Dbt, com.sleepycat.db.Dbt, com.sleepycat.db.DbEnv.RepProcessMessage, com.sleepycat.db.DbLsn)"><!-- --></A><H3>
rep_process_message</H3>
<PRE>
public int <B>rep_process_message</B>(<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> control,
<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> rec,
<A HREF="../../../com/sleepycat/db/DbEnv.RepProcessMessage.html">DbEnv.RepProcessMessage</A> envid,
<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> ret_lsn)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationProcessMessage(com.sleepycat.db.Dbt, com.sleepycat.db.Dbt, com.sleepycat.db.DbEnv.RepProcessMessage, com.sleepycat.db.DbLsn)"><CODE>replicationProcessMessage(Dbt,Dbt,DbEnv.RepProcessMessage,DbLsn)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="replicationProcessMessage(com.sleepycat.db.Dbt, com.sleepycat.db.Dbt, com.sleepycat.db.DbEnv.RepProcessMessage, com.sleepycat.db.DbLsn)"><!-- --></A><H3>
replicationProcessMessage</H3>
<PRE>
public int <B>replicationProcessMessage</B>(<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> control,
<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> rec,
<A HREF="../../../com/sleepycat/db/DbEnv.RepProcessMessage.html">DbEnv.RepProcessMessage</A> envid,
<A HREF="../../../com/sleepycat/db/DbLsn.html">DbLsn</A> ret_lsn)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.replicationProcessMessage method processes an incoming replication message sent by a member of the replication group to the local database environment.</p> <p>For implementation reasons, all incoming replication messages must be processed using the same <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle. It is not required that a single thread of control process all messages, only that all threads of control processing messages use the same handle.</p> <p>The DbEnv.replicationProcessMessage method has additional return values:</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>control</CODE> - The <b>control</b> parameter should reference a copy of the <b>control</b> parameter specified by Berkeley DB on the sending environment.<DD><CODE>envid</CODE> - The <b>envid</b> parameter should contain the local identifier that corresponds to the environment that sent the message to be processed (see <a href="../../../../ref/rep/id.html">Replication environment IDs</a> for more information).<DD><CODE>rec</CODE> - The <b>rec</b> parameter should reference a copy of the <b>rec</b> parameter specified by Berkeley DB on the sending environment.<DD><CODE>ret_lsn</CODE> - If DbEnv.replicationProcessMessage method returns Db.DB_REP_NOTPERM then the <b>ret_lsn</b> parameter will contain the log sequence number of this permanent log message that could not be written to disk. If DbEnv.replicationProcessMessage method returns Db.DB_REP_ISPERM then the <b>ret_lsn</b> parameter will contain largest log sequence number of the permanent records that are now written to disk as a result of processing this message. In all other cases the value of <b>ret_lsn</b> is undefined.
<DT><B>Returns:</B><DD><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_REP_DUPMASTER"><CODE>DB_REP_DUPMASTER</CODE></A><p>The DbEnv.replicationProcessMessage method will throw an exception that encapsulates <code>Db.DB_REP_DUPMASTER</code> if the replication group has more than one master. </li></ul>The application should reconfigure itself as a client by calling the <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationStart(com.sleepycat.db.Dbt, int)"><CODE>DbEnv.replicationStart</CODE></A> method, and then call for an election by calling <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationElect(int, int, int)"><CODE>DbEnv.replicationElect</CODE></A>. </p> <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_REP_HOLDELECTION"><CODE>DB_REP_HOLDELECTION</CODE></A><p>The DbEnv.replicationProcessMessage method will throw an exception that encapsulates <code>Db.DB_REP_HOLDELECTION</code> if an election is needed. </li></ul>The application should call for an election by calling <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationElect(int, int, int)"><CODE>DbEnv.replicationElect</CODE></A>. </p> <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_REP_ISPERM"><CODE>DB_REP_ISPERM</CODE></A><p>The DbEnv.replicationProcessMessage method will return <code>Db.DB_REP_ISPERM</code> if processing this message results in the processing of records that are permanent. </li></ul>The maximum LSN of the permanent records stored is returned. </p> <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_REP_NEWMASTER"><CODE>DB_REP_NEWMASTER</CODE></A><p>The DbEnv.replicationProcessMessage method will return <code>Db.DB_REP_NEWMASTER</code> if a new master has been elected. </li></ul>The <b>envid</b> parameter contains the environment ID of the new master. If the recipient of this error return has been made master, it is the application's responsibility to begin acting as the master environment. </p> <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_REP_NEWSITE"><CODE>DB_REP_NEWSITE</CODE></A><p>The DbEnv.replicationProcessMessage method will return <code>Db.DB_REP_NEWSITE</code> if the system received contact information from a new environment. </li></ul>The <b>rec</b> parameter contains the opaque data specified in the <b>cdata</b> parameter to the <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationStart(com.sleepycat.db.Dbt, int)"><CODE>DbEnv.replicationStart</CODE></A>. The application should take whatever action is needed to establish a communication channel with this new environment. </p> <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_REP_NOTPERM"><CODE>DB_REP_NOTPERM</CODE></A><p>The DbEnv.replicationProcessMessage method will return <code>Db.DB_REP_NOTPERM</code> if a message carrying a <A HREF="../../../com/sleepycat/db/Db.html#DB_REP_PERMANENT"><CODE><code>Db.DB_REP_PERMANENT</code></CODE></A> flag was processed successfully, but was not written to disk. </li></ul>The LSN of this record is returned. The application should take whatever action is deemed necessary to retain its recoverability characteristics. </p> <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_REP_OUTDATED"><CODE>DB_REP_OUTDATED</CODE></A><p>The DbEnv.replicationProcessMessage method will throw an exception that encapsulates <code>Db.DB_REP_OUTDATED</code> if the current environment's logs are too far out of date with respect to the master to be automatically synchronized. </li></ul>The application should copy over a hot backup of the environment, run recovery, and restart the client. </p> Unless otherwise specified, the DbEnv.replicationProcessMessage method throws an exception that encapsulates a non-zero error value on failure. </p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="rep_start(com.sleepycat.db.Dbt, int)"><!-- --></A><H3>
rep_start</H3>
<PRE>
public void <B>rep_start</B>(<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> cdata,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationStart(com.sleepycat.db.Dbt, int)"><CODE>replicationStart(Dbt,int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="replicationStart(com.sleepycat.db.Dbt, int)"><!-- --></A><H3>
replicationStart</H3>
<PRE>
public void <B>replicationStart</B>(<A HREF="../../../com/sleepycat/db/Dbt.html">Dbt</A> cdata,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.replicationStart method configures the database environment as a client or master in a group of replicated database environments. Replication master environments are the only database environments where replicated databases may be modified. Replication client environments are read-only as long as they are clients. Replication client environments may be upgraded to be replication master environments in the case that the current master fails or there is no master present.</p> <p>The enclosing database environment must already have been opened by calling the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method and must already have been configured to send replication messages by calling the <A HREF="../../../com/sleepycat/db/DbEnv.html#setReplicationTransport(int, com.sleepycat.db.DbRepTransport)"><CODE>DbEnv.setReplicationTransport</CODE></A> method.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>cdata</CODE> - an opaque data item that is sent over the communication infrastructure when the client or master comes online (see <a href="../../../../ref/rep/newsite.html">Connecting to a new site</a> for more information). If no such information is useful, <b>cdata</b> should be null.<DD><CODE>flags</CODE> - must be set to one of the following values: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_REP_CLIENT"><CODE>Db.DB_REP_CLIENT</CODE></A><p>Configure the environment as a replication client. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_REP_LOGSONLY"><CODE>Db.DB_REP_LOGSONLY</CODE></A><p>Configure the environment as a log files-only client. </li></ul><ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_REP_MASTER"><CODE>Db.DB_REP_MASTER</CODE></A><p>Configure the environment as a replication master. </li></ul>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.replicationStart method will fail and throw a IllegalArgumentException exception if the database environment was not already configured to communicate with a replication group by a call to <A HREF="../../../com/sleepycat/db/DbEnv.html#setReplicationTransport(int, com.sleepycat.db.DbRepTransport)"><CODE>DbEnv.setReplicationTransport</CODE></A>; the database environment was not already opened; or if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="rep_stat(int)"><!-- --></A><H3>
rep_stat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbRepStat.html">DbRepStat</A> <B>rep_stat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationStat(int)"><CODE>replicationStat(int)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="replicationStat(int)"><!-- --></A><H3>
replicationStat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbRepStat.html">DbRepStat</A> <B>replicationStat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.replicationStat method returns the replication subsystem statistics.</p> <p>The DbEnv.replicationStat method creates a DbRepStat object encapsulating the replication subsystem statistics. The following data fields are available from the DbRepStat object:</p> For convenience, the DbRepStat class has a toString method that lists all the data fields.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>flags</CODE> - must be set to 0 or the following value: <ul><li><A HREF="../../../com/sleepycat/db/Db.html#DB_STAT_CLEAR"><CODE>Db.DB_STAT_CLEAR</CODE></A><p>Reset statistics after returning their values. </li></ul>
<DT><B>Returns:</B><DD>The DbEnv.replicationStat method throws an exception that encapsulates a non-zero error value on failure. </p>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - The DbEnv.replicationStat method will fail and throw a IllegalArgumentException exception if an invalid flag value or parameter was specified.</DL>
</DD>
</DL>
<HR>
<A NAME="set_rep_limit(long)"><!-- --></A><H3>
set_rep_limit</H3>
<PRE>
public void <B>set_rep_limit</B>(long bytes)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setReplicationLimit(long)"><CODE>setReplicationLimit(long)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setReplicationLimit(long)"><!-- --></A><H3>
setReplicationLimit</H3>
<PRE>
public void <B>setReplicationLimit</B>(long bytes)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD>The DbEnv.setReplicationLimit method imposes a byte-count limit on the amount of data that will be transmitted from a site in a single call to <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationProcessMessage(com.sleepycat.db.Dbt, com.sleepycat.db.Dbt, com.sleepycat.db.DbEnv.RepProcessMessage, com.sleepycat.db.DbLsn)"><CODE>DbEnv.replicationProcessMessage</CODE></A> method.</p> <p>The DbEnv.setReplicationLimit method configures a database environment, not only operations performed using the specified <A HREF="../../../com/sleepycat/db/DbEnv.html"><CODE>DbEnv</CODE></A> handle.</p> <p>The DbEnv.setReplicationLimit method may not be called before the <A HREF="../../../com/sleepycat/db/DbEnv.html#open(java.lang.String, int, int)"><CODE>DbEnv.open</CODE></A> method has been called.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bytes</CODE> - specifies the maximum number of bytes that will be sent in a single call to <A HREF="../../../com/sleepycat/db/DbEnv.html#replicationProcessMessage(com.sleepycat.db.Dbt, com.sleepycat.db.Dbt, com.sleepycat.db.DbEnv.RepProcessMessage, com.sleepycat.db.DbLsn)"><CODE>DbEnv.replicationProcessMessage</CODE></A> method.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE> - Signals that an exception of some sort has occurred.</DL>
</DD>
</DL>
<HR>
<A NAME="set_rep_transport(int, com.sleepycat.db.DbRepTransport)"><!-- --></A><H3>
set_rep_transport</H3>
<PRE>
public void <B>set_rep_transport</B>(int envid,
<A HREF="../../../com/sleepycat/db/DbRepTransport.html">DbRepTransport</A> send)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#setReplicationTransport(int, com.sleepycat.db.DbRepTransport)"><CODE>setReplicationTransport(int,DbRepTransport)</CODE></A></I>
<P>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setReplicationTransport(int, com.sleepycat.db.DbRepTransport)"><!-- --></A><H3>
setReplicationTransport</H3>
<PRE>
public void <B>setReplicationTransport</B>(int envid,
<A HREF="../../../com/sleepycat/db/DbRepTransport.html">DbRepTransport</A> send)
throws <A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></PRE>
<DL>
<DD><DL>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="strerror(int)"><!-- --></A><H3>
strerror</H3>
<PRE>
public static <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> <B>strerror</B>(int error)</PRE>
<DL>
<DD>The DbEnv.strerror method returns an error message string corresponding to the error number <b>error</b> parameter.</p> <p>This function is a superset of the ANSI C X3.159-1989 (ANSI C) <b>strerror</b>(3) function. If the error number <b>error</b> is greater than or equal to 0, then the string returned by the system function <b>strerror</b>(3) is returned. If the error number is less than 0, an error string appropriate to the corresponding Berkeley DB library error is returned. See <a href="../../../../ref/program/errorret.html">Error returns to applications</a> for more information.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>error</CODE> - the error number for which an error message string is wanted.
<DT><B>Returns:</B><DD>The DbEnv.strerror method returns an error message string corresponding to the error number <b>error</b> parameter.</p></DL>
</DD>
</DL>
<HR>
<A NAME="get_version_major()"><!-- --></A><H3>
get_version_major</H3>
<PRE>
public static int <B>get_version_major</B>()</PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getVersionMajor()"><CODE>getVersionMajor()</CODE></A></I>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="getVersionMajor()"><!-- --></A><H3>
getVersionMajor</H3>
<PRE>
public static int <B>getVersionMajor</B>()</PRE>
<DL>
<DD>The DbEnv.getVersionMajor method returns the release major number.</p> <p>The DbEnv.getVersionMajor method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getVersionMajor method returns the release major number.</p></DL>
</DD>
</DL>
<HR>
<A NAME="get_version_minor()"><!-- --></A><H3>
get_version_minor</H3>
<PRE>
public static int <B>get_version_minor</B>()</PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getVersionMinor()"><CODE>getVersionMinor()</CODE></A></I>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="getVersionMinor()"><!-- --></A><H3>
getVersionMinor</H3>
<PRE>
public static int <B>getVersionMinor</B>()</PRE>
<DL>
<DD>The DbEnv.getVersionMinor method returns the release minor number.</p> <p>The DbEnv.getVersionMinor method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getVersionMinor method returns the release minor number.</p></DL>
</DD>
</DL>
<HR>
<A NAME="get_version_patch()"><!-- --></A><H3>
get_version_patch</H3>
<PRE>
public static int <B>get_version_patch</B>()</PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getVersionPatch()"><CODE>getVersionPatch()</CODE></A></I>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="getVersionPatch()"><!-- --></A><H3>
getVersionPatch</H3>
<PRE>
public static int <B>getVersionPatch</B>()</PRE>
<DL>
<DD>The DbEnv.getVersionPatch method returns the release patch number.</p> <p>The DbEnv.getVersionPatch method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getVersionPatch method returns the release patch number.</p></DL>
</DD>
</DL>
<HR>
<A NAME="get_version_string()"><!-- --></A><H3>
get_version_string</H3>
<PRE>
public static <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> <B>get_version_string</B>()</PRE>
<DL>
<DD><B>Deprecated.</B> <I>As of Berkeley DB 4.2, replaced by <A HREF="../../../com/sleepycat/db/DbEnv.html#getVersionString()"><CODE>getVersionString()</CODE></A></I>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="getVersionString()"><!-- --></A><H3>
getVersionString</H3>
<PRE>
public static <A HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/String.html">String</A> <B>getVersionString</B>()</PRE>
<DL>
<DD>The DbEnv.getVersionString method returns the release verbose version information, suitable for display.</p> <p>The DbEnv.getVersionString method may be called at any time during the life of the application.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>The DbEnv.getVersionString method returns the release verbose version information, suitable for display.</p></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>
<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/DbEnv.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Berkeley DB</b><br><font size="-1"> version 4.2.52</font></EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../com/sleepycat/db/Dbc.html"><B>PREV CLASS</B></A>
<A HREF="../../../com/sleepycat/db/DbEnv.RepProcessMessage.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
<A HREF="DbEnv.html" TARGET="_top"><B>NO FRAMES</B></A>
<SCRIPT>
<!--
if(window==top) {
document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: <A HREF="#nested_class_summary">NESTED</A> | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->
<HR>
<font size=1><a href="../../../../sleepycat/legal.html">Copyright (c) 1996-2003</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font>
</BODY>
</HTML>
distrib
>
Mandriva
>
2007.0
>
x86_64
>
media
>
main-release
>
by-pkgid
>
a4c98df40e78f6c892308fd6841f950a
>
files
>
649
