<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.6.0_18) on Thu Dec 02 16:59:41 UTC 2010 -->
<TITLE>
DbEnv
</TITLE>
<META NAME="date" CONTENT="2010-12-02">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="DbEnv";
}
}
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<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="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>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../com/sleepycat/db/DbDupCompare.html" title="interface in com.sleepycat.db"><B>PREV CLASS</B></A>
<A HREF="../../../com/sleepycat/db/DbEnv.RepProcessMessage.html" title="class in com.sleepycat.db"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html?com/sleepycat/db/DbEnv.html" target="_top"><B>FRAMES</B></A>
<A HREF="DbEnv.html" target="_top"><B>NO FRAMES</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../allclasses-noframe.html"><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> | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->
<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
com.sleepycat.db</FONT>
<BR>
Class DbEnv</H2>
<PRE>
java.lang.Object
<IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>com.sleepycat.db.DbEnv</B>
</PRE>
<HR>
<DL>
<DT><PRE>public class <B>DbEnv</B><DT>extends java.lang.Object</DL>
</PRE>
<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" title="class in com.sleepycat.db"><CODE>Db</CODE></A> or <A HREF="../../../com/sleepycat/db/DbTxn.html" title="class in com.sleepycat.db"><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" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Nested Class Summary</B></FONT></TH>
</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" title="class in com.sleepycat.db">DbEnv.RepProcessMessage</A></B></CODE>
<BR>
</TD>
</TR>
</TABLE>
<!-- =========== FIELD SUMMARY =========== -->
<A NAME="field_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Field Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#swigCMemOwn">swigCMemOwn</A></B></CODE>
<BR>
</TD>
</TR>
</TABLE>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<A NAME="constructor_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Constructor Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected </CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#DbEnv()">DbEnv</A></B>()</CODE>
<BR>
</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> </CODE></FONT></TD>
<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>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected </CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#DbEnv(long, boolean)">DbEnv</A></B>(long cPtr,
boolean cMemoryOwn)</CODE>
<BR>
</TD>
</TR>
</TABLE>
<!-- ========== METHOD SUMMARY =========== -->
<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Method Summary</B></FONT></TH>
</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" title="class in com.sleepycat.db">DbTxn</A> txnid,
java.lang.String file,
java.lang.String 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" title="class in com.sleepycat.db">DbTxn</A> txnid,
java.lang.String file,
java.lang.String 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" title="class in com.sleepycat.db">DbTxn</A> txnid,
java.lang.String file,
java.lang.String database,
java.lang.String 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" title="class in com.sleepycat.db">DbTxn</A> txnid,
java.lang.String file,
java.lang.String database,
java.lang.String 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>protected void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#delete()">delete</A></B>()</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#err(int, java.lang.String)">err</A></B>(int error,
java.lang.String 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>(java.lang.String 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> java.lang.String[]</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> java.lang.String</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> java.lang.String</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> java.lang.String</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> java.lang.String</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 java.lang.String</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>protected static long</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/sleepycat/db/DbEnv.html#getCPtr(com.sleepycat.db.DbEnv)">getCPtr</A></B>(<A HREF="../../../com/sleepycat/db/DbEnv.html" title="class in com.sleepycat.db">DbEnv</A> obj)</CODE>
<BR>
</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> java.lang.String[]</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> java.lang.String</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> java.lang.String</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> java.lang.String</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> java.lang.String</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 java.lang.String</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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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> java.lang.String[]</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" title="class in com.sleepycat.db">DbLsn</A> lsn0,
<A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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> java.lang.String</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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbLsn</A> lsn,
<A HREF="../../../com/sleepycat/db/Dbt.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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> java.lang.String[]</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" title="class in com.sleepycat.db">DbLsn</A> lsn0,
<A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db">DbLsn</A> lsn1)</CODE>
<BR>
The DbEnv.logCompare method allows the caller to compare two
<A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">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> java.lang.String</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" title="class in com.sleepycat.db">DbLsn</A> lsn)</CODE>
<BR>
The DbEnv.logFile method maps <A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbLsn</A> lsn,
<A HREF="../../../com/sleepycat/db/Dbt.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>(java.lang.String 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>(java.lang.String 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" title="class in com.sleepycat.db">Dbt</A> control,
<A HREF="../../../com/sleepycat/db/Dbt.html" title="class in com.sleepycat.db">Dbt</A> rec,
<A HREF="../../../com/sleepycat/db/DbEnv.RepProcessMessage.html" title="class in com.sleepycat.db">DbEnv.RepProcessMessage</A> envid,
<A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">Dbt</A> control,
<A HREF="../../../com/sleepycat/db/Dbt.html" title="class in com.sleepycat.db">Dbt</A> rec,
<A HREF="../../../com/sleepycat/db/DbEnv.RepProcessMessage.html" title="class in com.sleepycat.db">DbEnv.RepProcessMessage</A> envid,
<A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="interface in com.sleepycat.db">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>(java.lang.String 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>(java.lang.String 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" title="interface in com.sleepycat.db">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>(java.io.OutputStream 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>(java.lang.String 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" title="interface in com.sleepycat.db">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>(java.lang.String 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" title="interface in com.sleepycat.db">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" title="interface in com.sleepycat.db">DbClient</A> client,
java.lang.String 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>(java.lang.String 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>(java.util.Date 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" title="interface in com.sleepycat.db">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>(java.lang.String 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>(java.lang.String 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" title="interface in com.sleepycat.db">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>(java.lang.String 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>(java.io.OutputStream 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" title="interface in com.sleepycat.db">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>(java.lang.String 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" title="interface in com.sleepycat.db">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" title="interface in com.sleepycat.db">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" title="interface in com.sleepycat.db">DbClient</A> client,
java.lang.String 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>(java.lang.String 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>(java.util.Date 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 java.lang.String</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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
<P>
<!-- ============ FIELD DETAIL =========== -->
<A NAME="field_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Field Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="swigCMemOwn"><!-- --></A><H3>
swigCMemOwn</H3>
<PRE>
protected boolean <B>swigCMemOwn</B></PRE>
<DL>
<DL>
</DL>
</DL>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="DbEnv(long, boolean)"><!-- --></A><H3>
DbEnv</H3>
<PRE>
protected <B>DbEnv</B>(long cPtr,
boolean cMemoryOwn)</PRE>
<DL>
</DL>
<HR>
<A NAME="DbEnv()"><!-- --></A><H3>
DbEnv</H3>
<PRE>
protected <B>DbEnv</B>()</PRE>
<DL>
</DL>
<HR>
<A NAME="DbEnv(int)"><!-- --></A><H3>
DbEnv</H3>
<PRE>
public <B>DbEnv</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DL>
<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" title="class in com.sleepycat.db">DbException</A></CODE> - Signals that an exception of some sort
has occurred.</DL>
</DL>
<!-- ============ METHOD DETAIL ========== -->
<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="delete()"><!-- --></A><H3>
delete</H3>
<PRE>
protected void <B>delete</B>()</PRE>
<DL>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="getCPtr(com.sleepycat.db.DbEnv)"><!-- --></A><H3>
getCPtr</H3>
<PRE>
protected static long <B>getCPtr</B>(<A HREF="../../../com/sleepycat/db/DbEnv.html" title="class in com.sleepycat.db">DbEnv</A> obj)</PRE>
<DL>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="close(int)"><!-- --></A><H3>
close</H3>
<PRE>
public void <B>close</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><CODE>Db</CODE></A>,
<A HREF="../../../com/sleepycat/db/Dbc.html" title="class in com.sleepycat.db"><CODE>Dbc</CODE></A>, <A HREF="../../../com/sleepycat/db/DbTxn.html" title="class in com.sleepycat.db"><CODE>DbTxn</CODE></A>, <A HREF="../../../com/sleepycat/db/DbLogc.html" title="class in com.sleepycat.db"><CODE>DbLogc</CODE></A> and <A HREF="../../../com/sleepycat/db/DbMpoolFile.html" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbLockRequest</A>[] list,
int offset,
int count)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbLockRequest</A>[] list,
int offset,
int count)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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/DbDeadlockException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbDeadlockException</CODE></A>
exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbLockNotGrantedException</CODE></A> exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbLockNotGrantedException</CODE></A> exception.
<DD><CODE>java.lang.IllegalArgumentException</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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbMemoryException</CODE></A> exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="open(java.lang.String, int, int)"><!-- --></A><H3>
open</H3>
<PRE>
public void <B>open</B>(java.lang.String db_home,
int flags,
int mode)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A>,
java.io.FileNotFoundException</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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">DbException</A></CODE> - The DbEnv.open method may
fail and throw <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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>(java.lang.String db_home,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A>,
java.io.FileNotFoundException</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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">DbException</A></CODE> - The DbEnv.remove method may
fail and throw <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="get_errpfx()"><!-- --></A><H3>
get_errpfx</H3>
<PRE>
public java.lang.String <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 java.lang.String <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" title="interface in com.sleepycat.db">DbErrcall</A> db_errcall_fcn)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>(java.io.OutputStream 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>(java.io.OutputStream 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>(java.lang.String 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>(java.lang.String 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" title="interface in com.sleepycat.db">DbEnvFeedback</A> feedback)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>(java.util.Date timestamp)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setTxnTimestamp(java.util.Date)"><!-- --></A><H3>
setTxnTimestamp</H3>
<PRE>
public void <B>setTxnTimestamp</B>(java.util.Date timestamp)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</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" title="class in com.sleepycat.db">DbTxn</A> txnid,
java.lang.String file,
java.lang.String database,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A>,
<A HREF="../../../com/sleepycat/db/DbDeadlockException.html" title="class in com.sleepycat.db">DbDeadlockException</A>,
<A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html" title="class in com.sleepycat.db">DbLockNotGrantedException</A>,
java.io.FileNotFoundException</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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbDeadlockException.html" title="class in com.sleepycat.db">DbDeadlockException</A></CODE>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html" title="class in com.sleepycat.db">DbLockNotGrantedException</A></CODE>
<DD><CODE>java.io.FileNotFoundException</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" title="class in com.sleepycat.db">DbTxn</A> txnid,
java.lang.String file,
java.lang.String database,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A>,
<A HREF="../../../com/sleepycat/db/DbDeadlockException.html" title="class in com.sleepycat.db">DbDeadlockException</A>,
<A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html" title="class in com.sleepycat.db">DbLockNotGrantedException</A>,
java.io.FileNotFoundException</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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">DbException</A></CODE> - The DbEnv.dbRemove method
may fail and throw <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbDeadlockException</CODE></A>
exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbLockNotGrantedException</CODE></A> exception.
<DD><CODE>java.lang.IllegalArgumentException</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" title="class in com.sleepycat.db">DbTxn</A> txnid,
java.lang.String file,
java.lang.String database,
java.lang.String newname,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A>,
<A HREF="../../../com/sleepycat/db/DbDeadlockException.html" title="class in com.sleepycat.db">DbDeadlockException</A>,
<A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html" title="class in com.sleepycat.db">DbLockNotGrantedException</A>,
java.io.FileNotFoundException</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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbDeadlockException.html" title="class in com.sleepycat.db">DbDeadlockException</A></CODE>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html" title="class in com.sleepycat.db">DbLockNotGrantedException</A></CODE>
<DD><CODE>java.io.FileNotFoundException</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" title="class in com.sleepycat.db">DbTxn</A> txnid,
java.lang.String file,
java.lang.String database,
java.lang.String newname,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A>,
<A HREF="../../../com/sleepycat/db/DbDeadlockException.html" title="class in com.sleepycat.db">DbDeadlockException</A>,
<A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html" title="class in com.sleepycat.db">DbLockNotGrantedException</A>,
java.io.FileNotFoundException</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" title="class in com.sleepycat.db">DbException</A></CODE> - The DbEnv.dbRename method
may fail and throw <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbDeadlockException</CODE></A>
exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbLockNotGrantedException</CODE></A> exception.
<DD><CODE>java.lang.IllegalArgumentException</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,
java.lang.String 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>(java.lang.String 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>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="get_data_dirs()"><!-- --></A><H3>
get_data_dirs</H3>
<PRE>
public java.lang.String[] <B>get_data_dirs</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getDataDirs()"><!-- --></A><H3>
getDataDirs</H3>
<PRE>
public java.lang.String[] <B>getDataDirs</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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 java.lang.String <B>get_home</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getDbEnvHome()"><!-- --></A><H3>
getDbEnvHome</H3>
<PRE>
public java.lang.String <B>getDbEnvHome</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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 java.lang.String <B>get_tmp_dir</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getTmpDir()"><!-- --></A><H3>
getTmpDir</H3>
<PRE>
public java.lang.String <B>getTmpDir</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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>(java.lang.String dir)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setDataDir(java.lang.String)"><!-- --></A><H3>
setDataDir</H3>
<PRE>
public void <B>setDataDir</B>(java.lang.String dir)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="set_encrypt(java.lang.String, int)"><!-- --></A><H3>
set_encrypt</H3>
<PRE>
public void <B>set_encrypt</B>(java.lang.String passwd,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setEncrypted(java.lang.String, int)"><!-- --></A><H3>
setEncrypted</H3>
<PRE>
public void <B>setEncrypted</B>(java.lang.String passwd,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">DbException</A></CODE> - The DbEnv.setEncrypted
method may fail and throw <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db"><CODE>DbException</CODE></A>, encapsulating
one of the following non-zero errors:
<li> Cryptography is not available in this Berkeley DB
release.
<DD><CODE>java.lang.IllegalArgumentException</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" title="interface in com.sleepycat.db">DbErrorHandler</A> db_errcall_fcn)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><CODE>DbLockNotGrantedException</CODE></A> exception instead of <A HREF="../../../com/sleepycat/db/DbDeadlockException.html" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</CODE> - The DbEnv.setFlags method
will fail and throw a IllegalArgumentException exception
if an invalid flag value or parameter was specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="interface in com.sleepycat.db">DbEnvFeedbackHandler</A> db_feedback_fcn)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></PRE>
<DL>
<DD><DL>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="interface in com.sleepycat.db">DbPanicHandler</A> db_panic_fcn)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></PRE>
<DL>
<DD><DL>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="interface in com.sleepycat.db">DbClient</A> client,
java.lang.String host,
long cl_timeout,
long sv_timeout,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="interface in com.sleepycat.db">DbClient</A> client,
java.lang.String host,
long cl_timeout,
long sv_timeout,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</CODE> - The DbEnv.setRpcServer
method will fail and throw a IllegalArgumentException
exception if an invalid flag value or parameter was
specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</CODE> - The DbEnv.setTestAndSetSpins
method will fail and throw a IllegalArgumentException
exception if an invalid flag value or parameter was
specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</CODE> - The DbEnv.setTimeout method
will fail and throw a IllegalArgumentException exception
if an invalid flag value or parameter was specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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>(java.lang.String dir)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setTmpDir(java.lang.String)"><!-- --></A><H3>
setTmpDir</H3>
<PRE>
public void <B>setTmpDir</B>(java.lang.String dir)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="interface in com.sleepycat.db">DbAppDispatch</A> tx_recover)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="interface in com.sleepycat.db">DbAppDispatch</A> tx_recover)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></PRE>
<DL>
<DD><DL>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</CODE> - The DbEnv.setVerbose method
will fail and throw a IllegalArgumentException exception
if an invalid flag value or parameter was specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>java.lang.IllegalArgumentException</CODE> - The DbEnv.lockDetect method
will fail and throw a IllegalArgumentException exception
if an invalid flag value or parameter was specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">DbLock</A> <B>lock_get</B>(int locker,
int flags,
<A HREF="../../../com/sleepycat/db/Dbt.html" title="class in com.sleepycat.db">Dbt</A> object,
int lock_mode)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbLock</A> <B>lockGet</B>(int locker,
int flags,
<A HREF="../../../com/sleepycat/db/Dbt.html" title="class in com.sleepycat.db">Dbt</A> object,
int lock_mode)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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/DbDeadlockException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbDeadlockException</CODE></A>
exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbLockNotGrantedException</CODE></A> exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbLockNotGrantedException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbLockNotGrantedException</CODE></A> exception.
<DD><CODE>java.lang.IllegalArgumentException</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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbMemoryException</CODE></A> exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">DbLock</A> lock)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbLock</A> lock)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>java.lang.IllegalArgumentException</CODE> - The DbEnv.lockPut method
will fail and throw a IllegalArgumentException exception
if an invalid flag value or parameter was specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="lock_stat(int)"><!-- --></A><H3>
lock_stat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbLockStat.html" title="class in com.sleepycat.db">DbLockStat</A> <B>lock_stat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="lockStat(int)"><!-- --></A><H3>
lockStat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbLockStat.html" title="class in com.sleepycat.db">DbLockStat</A> <B>lockStat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>java.lang.IllegalArgumentException</CODE> - The DbEnv.lockStat method
will fail and throw a IllegalArgumentException exception
if an invalid flag value or parameter was specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbMemoryException</CODE></A> exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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 java.lang.String <B>get_lg_dir</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getLogDir()"><!-- --></A><H3>
getLogDir</H3>
<PRE>
public java.lang.String <B>getLogDir</B>()
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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 java.lang.String[] <B>log_archive</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="logArchive(int)"><!-- --></A><H3>
logArchive</H3>
<PRE>
public java.lang.String[] <B>logArchive</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>java.lang.IllegalArgumentException</CODE> - The DbEnv.logArchive method
will fail and throw a IllegalArgumentException exception
if an invalid flag value or parameter was specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">DbLsn</A> lsn0,
<A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbLsn</A> lsn0,
<A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db">DbLsn</A> lsn1)</PRE>
<DL>
<DD>The DbEnv.logCompare method allows the caller to compare two
<A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><CODE>DbLsn</CODE></A>
objects to be compared.<DD><CODE>lsn1</CODE> - one of the <A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">DbLogc</A> <B>log_cursor</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="logCursor(int)"><!-- --></A><H3>
logCursor</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbLogc.html" title="class in com.sleepycat.db">DbLogc</A> <B>logCursor</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>java.lang.IllegalArgumentException</CODE> - The DbEnv.logCursor method
will fail and throw a IllegalArgumentException exception
if an invalid flag value or parameter was specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="log_file(com.sleepycat.db.DbLsn)"><!-- --></A><H3>
log_file</H3>
<PRE>
public java.lang.String <B>log_file</B>(<A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db">DbLsn</A> lsn)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="logFile(com.sleepycat.db.DbLsn)"><!-- --></A><H3>
logFile</H3>
<PRE>
public java.lang.String <B>logFile</B>(<A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db">DbLsn</A> lsn)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></PRE>
<DL>
<DD>The DbEnv.logFile method maps <A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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/DbMemoryException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbMemoryException</CODE></A>
exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">DbLsn</A> lsn)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbLsn</A> lsn)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</CODE> - The DbEnv.logFlush method
will fail and throw a IllegalArgumentException exception
if an invalid flag value or parameter was specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">DbLsn</A> lsn,
<A HREF="../../../com/sleepycat/db/Dbt.html" title="class in com.sleepycat.db">Dbt</A> data,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbLsn</A> lsn,
<A HREF="../../../com/sleepycat/db/Dbt.html" title="class in com.sleepycat.db">Dbt</A> data,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></PRE>
<DL>
<DD>The DbEnv.logPut method appends records to the log. The <A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><CODE>DbLsn</CODE></A> of the put record
is copied.
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="log_stat(int)"><!-- --></A><H3>
log_stat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbLogStat.html" title="class in com.sleepycat.db">DbLogStat</A> <B>log_stat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="logStat(int)"><!-- --></A><H3>
logStat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbLogStat.html" title="class in com.sleepycat.db">DbLogStat</A> <B>logStat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>java.lang.IllegalArgumentException</CODE> - The DbEnv.logStat method
will fail and throw a IllegalArgumentException exception
if an invalid flag value or parameter was specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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>(java.lang.String dir)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setLogDir(java.lang.String)"><!-- --></A><H3>
setLogDir</H3>
<PRE>
public void <B>setLogDir</B>(java.lang.String dir)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbMpoolStat</A> <B>memp_stat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="memoryPoolStat(int)"><!-- --></A><H3>
memoryPoolStat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbMpoolStat.html" title="class in com.sleepycat.db">DbMpoolStat</A> <B>memoryPoolStat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbMpoolFStat</A>[] <B>memp_fstat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="memoryPoolFileStat(int)"><!-- --></A><H3>
memoryPoolFileStat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbMpoolFStat.html" title="class in com.sleepycat.db">DbMpoolFStat</A>[] <B>memoryPoolFileStat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>java.lang.IllegalArgumentException</CODE> - The DbEnv.memoryPoolStat
method will fail and throw a IllegalArgumentException
exception if an invalid flag value or parameter was
specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>nwrotep</CODE> - references memory into which
the number of pages written to reach the specified
percentage is copied.<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>java.lang.IllegalArgumentException</CODE> - The DbEnv.memoryPoolTrickle
method will fail and throw a IllegalArgumentException
exception if an invalid flag value or parameter was
specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbTxn</A> <B>txn_begin</B>(<A HREF="../../../com/sleepycat/db/DbTxn.html" title="class in com.sleepycat.db">DbTxn</A> parent,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbTxn</A> <B>txnBegin</B>(<A HREF="../../../com/sleepycat/db/DbTxn.html" title="class in com.sleepycat.db">DbTxn</A> parent,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db"><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/DbMemoryException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><CODE>DbMemoryException</CODE></A>
exception.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>java.lang.IllegalArgumentException</CODE> - The DbEnv.txnCheckpoint
method will fail and throw a IllegalArgumentException
exception if an invalid flag value or parameter was
specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="txn_recover(int, int)"><!-- --></A><H3>
txn_recover</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbPreplist.html" title="class in com.sleepycat.db">DbPreplist</A>[] <B>txn_recover</B>(int count,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbPreplist</A>[] <B>txnRecover</B>(int count,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbTxnStat</A> <B>txn_stat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="txnStat(int)"><!-- --></A><H3>
txnStat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbTxnStat.html" title="class in com.sleepycat.db">DbTxnStat</A> <B>txnStat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>java.lang.IllegalArgumentException</CODE> - The DbEnv.txnStat method
will fail and throw a IllegalArgumentException exception
if an invalid flag value or parameter was specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">DbException</A></CODE> - The DbEnv.replicationElect method may
fail and throw <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">Dbt</A> control,
<A HREF="../../../com/sleepycat/db/Dbt.html" title="class in com.sleepycat.db">Dbt</A> rec,
<A HREF="../../../com/sleepycat/db/DbEnv.RepProcessMessage.html" title="class in com.sleepycat.db">DbEnv.RepProcessMessage</A> envid,
<A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db">DbLsn</A> ret_lsn)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">Dbt</A> control,
<A HREF="../../../com/sleepycat/db/Dbt.html" title="class in com.sleepycat.db">Dbt</A> rec,
<A HREF="../../../com/sleepycat/db/DbEnv.RepProcessMessage.html" title="class in com.sleepycat.db">DbEnv.RepProcessMessage</A> envid,
<A HREF="../../../com/sleepycat/db/DbLsn.html" title="class in com.sleepycat.db">DbLsn</A> ret_lsn)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">Dbt</A> cdata,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">Dbt</A> cdata,
int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>java.lang.IllegalArgumentException</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.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="rep_stat(int)"><!-- --></A><H3>
rep_stat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbRepStat.html" title="class in com.sleepycat.db">DbRepStat</A> <B>rep_stat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="replicationStat(int)"><!-- --></A><H3>
replicationStat</H3>
<PRE>
public <A HREF="../../../com/sleepycat/db/DbRepStat.html" title="class in com.sleepycat.db">DbRepStat</A> <B>replicationStat</B>(int flags)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>java.lang.IllegalArgumentException</CODE> - The DbEnv.replicationStat
method will fail and throw a IllegalArgumentException
exception if an invalid flag value or parameter was
specified.
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></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" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db">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" title="class in com.sleepycat.db"><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" title="class in com.sleepycat.db">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" title="interface in com.sleepycat.db">DbRepTransport</A> send)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">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" title="interface in com.sleepycat.db">DbRepTransport</A> send)
throws <A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></PRE>
<DL>
<DD><DL>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../com/sleepycat/db/DbException.html" title="class in com.sleepycat.db">DbException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="strerror(int)"><!-- --></A><H3>
strerror</H3>
<PRE>
public static java.lang.String <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 java.lang.String <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 java.lang.String <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 BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<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="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>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../com/sleepycat/db/DbDupCompare.html" title="interface in com.sleepycat.db"><B>PREV CLASS</B></A>
<A HREF="../../../com/sleepycat/db/DbEnv.RepProcessMessage.html" title="class in com.sleepycat.db"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html?com/sleepycat/db/DbEnv.html" target="_top"><B>FRAMES</B></A>
<A HREF="DbEnv.html" target="_top"><B>NO FRAMES</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../allclasses-noframe.html"><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> | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<HR>
</BODY>
</HTML>
