1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<!--NewPage--> 3<HTML> 4<HEAD> 5<!-- Generated by javadoc (build 1.5.0) on Thu May 15 17:17:31 EDT 2008 --> 6<TITLE> 7EnvironmentConfig (Oracle - Berkeley DB Java API) 8</TITLE> 9 10<META NAME="keywords" CONTENT="com.sleepycat.db.EnvironmentConfig class"> 11 12<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../style.css" TITLE="Style"> 13 14<SCRIPT type="text/javascript"> 15function windowTitle() 16{ 17 parent.document.title="EnvironmentConfig (Oracle - Berkeley DB Java API)"; 18} 19</SCRIPT> 20<NOSCRIPT> 21</NOSCRIPT> 22 23</HEAD> 24 25<BODY BGCOLOR="white" onload="windowTitle();"> 26 27 28<!-- ========= START OF TOP NAVBAR ======= --> 29<A NAME="navbar_top"><!-- --></A> 30<A HREF="#skip-navbar_top" title="Skip navigation links"></A> 31<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 32<TR> 33<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 34<A NAME="navbar_top_firstrow"><!-- --></A> 35<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 36 <TR ALIGN="center" VALIGN="top"> 37 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 38 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> 39 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> 40 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/EnvironmentConfig.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 41 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 42 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 43 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 44 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 45 </TR> 46</TABLE> 47</TD> 48<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 49<b>Berkeley DB</b><br><font size="-1"> version 4.7.25</font></EM> 50</TD> 51</TR> 52 53<TR> 54<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 55 <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><B>PREV CLASS</B></A> 56 <A HREF="../../../com/sleepycat/db/ErrorHandler.html" title="interface in com.sleepycat.db"><B>NEXT CLASS</B></A></FONT></TD> 57<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 58 <A HREF="../../../index.html?com/sleepycat/db/EnvironmentConfig.html" target="_top"><B>FRAMES</B></A> 59 <A HREF="EnvironmentConfig.html" target="_top"><B>NO FRAMES</B></A> 60 <SCRIPT type="text/javascript"> 61 <!-- 62 if(window==top) { 63 document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>'); 64 } 65 //--> 66</SCRIPT> 67<NOSCRIPT> 68 <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A> 69</NOSCRIPT> 70 71 72</FONT></TD> 73</TR> 74<TR> 75<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 76 SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> 77<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 78DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> 79</TR> 80</TABLE> 81<A NAME="skip-navbar_top"></A> 82<!-- ========= END OF TOP NAVBAR ========= --> 83 84<HR> 85<!-- ======== START OF CLASS DATA ======== --> 86<H2> 87<FONT SIZE="-1"> 88com.sleepycat.db</FONT> 89<BR> 90Class EnvironmentConfig</H2> 91<PRE> 92<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">java.lang.Object</A> 93 <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>com.sleepycat.db.EnvironmentConfig</B> 94</PRE> 95<DL> 96<DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Cloneable.html" title="class or interface in java.lang">Cloneable</A></DD> 97</DL> 98<HR> 99<DL> 100<DT><PRE>public class <B>EnvironmentConfig</B><DT>extends <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A><DT>implements <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Cloneable.html" title="class or interface in java.lang">Cloneable</A></DL> 101</PRE> 102 103<P> 104Specifies the attributes of an environment. 105<p> 106To change the default settings for a database environment, an application 107creates a configuration object, customizes settings and uses it for 108environment construction. The set methods of this class validate the 109configuration values when the method is invoked. An 110IllegalArgumentException is thrown if the value is not valid for that 111attribute. 112<p> 113All commonly used environment attributes have convenience setter/getter 114methods defined in this class. For example, to change the default 115transaction timeout setting for an environment, the application should 116do the following: 117<p> 118<blockquote><pre> 119 // customize an environment configuration 120 EnvironmentConfig envConfig = new EnvironmentConfig(); 121 envConfig.setTxnTimeout(10000); // will throw if timeout value is invalid 122 // Open the environment. 123 Environment myEnvironment = new Environment(home, envConfig); 124</pre></blockquote> 125<p> 126Additional parameters are described in the example.properties file found at 127the top level of the distribution package. These additional parameters 128will not be needed by most applications. This category of 129properties can be specified for the EnvironmentConfig object through a 130Properties object read by EnvironmentConfig(Properties), or 131individually through EnvironmentConfig.setConfigParam(). 132<p> 133For example, an application can change the default btree node size with: 134<blockquote><pre> 135 envConfig.setConfigParam("je.nodeMaxEntries", "256"); 136</pre></blockquote> 137<p> 138Environment configuration follows this order of precedence: 139<ol> 140<li>Configuration parameters specified in <environment 141home>/je.properties take first precedence. 142<li>Configuration parameters set in the EnvironmentConfig object used 143at Environment construction are next. 144<li>Any configuration parameters not set by the application are set to 145system defaults, described in the example.properties file. 146</ol> 147<p> 148An EnvironmentConfig can be used to specify both mutable and immutable 149environment properties. Immutable properties may be specified when the 150first Environment handle (instance) is opened for a given physical 151environment. When more handles are opened for the same environment, the 152following rules apply: 153<p> 154<ol> 155<li>Immutable properties must equal the original values specified when 156constructing an Environment handle for an already open environment. When a 157mismatch occurs, an exception is thrown. 158<li>Mutable properties are ignored when constructing an Environment 159handle for an already open environment. 160</ol> 161<p> 162After an Environment has been constructed, its mutable properties may 163be changed using 164<A HREF="../../../com/sleepycat/db/Environment.html#setConfig(com.sleepycat.db.EnvironmentConfig)"><CODE>Environment.setConfig(com.sleepycat.db.EnvironmentConfig)</CODE></A>. 165<p> 166<P> 167 168<P> 169<HR> 170 171<P> 172<!-- =========== FIELD SUMMARY =========== --> 173 174<A NAME="field_summary"><!-- --></A> 175<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 176<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 177<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 178<B>Field Summary</B></FONT></TH> 179</TR> 180<TR BGCOLOR="white" CLASS="TableRowColor"> 181<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 182<CODE>static <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html" title="class in com.sleepycat.db">EnvironmentConfig</A></CODE></FONT></TD> 183<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#DEFAULT">DEFAULT</A></B></CODE> 184 185<BR> 186 </TD> 187</TR> 188</TABLE> 189 190<!-- ======== CONSTRUCTOR SUMMARY ======== --> 191 192<A NAME="constructor_summary"><!-- --></A> 193<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 194<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 195<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 196<B>Constructor Summary</B></FONT></TH> 197</TR> 198<TR BGCOLOR="white" CLASS="TableRowColor"> 199<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#EnvironmentConfig()">EnvironmentConfig</A></B>()</CODE> 200 201<BR> 202 Create an EnvironmentConfig initialized with the system default settings.</TD> 203</TR> 204</TABLE> 205 206<!-- ========== METHOD SUMMARY =========== --> 207 208<A NAME="method_summary"><!-- --></A> 209<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 210<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 211<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 212<B>Method Summary</B></FONT></TH> 213</TR> 214<TR BGCOLOR="white" CLASS="TableRowColor"> 215<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 216<CODE> void</CODE></FONT></TD> 217<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#addDataDir(java.io.File)">addDataDir</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/File.html" title="class or interface in java.io">File</A> dataDir)</CODE> 218 219<BR> 220 Set the path of a directory to be used as the location of the access 221 method database files.</TD> 222</TR> 223<TR BGCOLOR="white" CLASS="TableRowColor"> 224<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 225<CODE> void</CODE></FONT></TD> 226<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#addDataDir(java.lang.String)">addDataDir</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> dataDir)</CODE> 227 228<BR> 229 <B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#addDataDir(java.io.File)"><CODE>addDataDir(java.io.File)</CODE></A></I></TD> 230</TR> 231<TR BGCOLOR="white" CLASS="TableRowColor"> 232<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 233<CODE> boolean</CODE></FONT></TD> 234<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getAllowCreate()">getAllowCreate</A></B>()</CODE> 235 236<BR> 237 Return true if the database environment is configured to create any 238 underlying files, as necessary.</TD> 239</TR> 240<TR BGCOLOR="white" CLASS="TableRowColor"> 241<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 242<CODE> int</CODE></FONT></TD> 243<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getCacheCount()">getCacheCount</A></B>()</CODE> 244 245<BR> 246 Return the number of shared memory buffer pools, that is, the number 247 of cache regions.</TD> 248</TR> 249<TR BGCOLOR="white" CLASS="TableRowColor"> 250<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 251<CODE> long</CODE></FONT></TD> 252<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getCacheMax()">getCacheMax</A></B>()</CODE> 253 254<BR> 255 Return the maximum size of the cache.</TD> 256</TR> 257<TR BGCOLOR="white" CLASS="TableRowColor"> 258<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 259<CODE> long</CODE></FONT></TD> 260<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getCacheSize()">getCacheSize</A></B>()</CODE> 261 262<BR> 263 Return the size of the shared memory buffer pool, that is, the cache.</TD> 264</TR> 265<TR BGCOLOR="white" CLASS="TableRowColor"> 266<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 267<CODE> boolean</CODE></FONT></TD> 268<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getCDBLockAllDatabases()">getCDBLockAllDatabases</A></B>()</CODE> 269 270<BR> 271 Return true if the Concurrent Data Store applications are configured to 272 perform locking on an environment-wide basis rather than on a 273 per-database basis.</TD> 274</TR> 275<TR BGCOLOR="white" CLASS="TableRowColor"> 276<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 277<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/File.html" title="class or interface in java.io">File</A>[]</CODE></FONT></TD> 278<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getDataDirs()">getDataDirs</A></B>()</CODE> 279 280<BR> 281 Return the array of data directories.</TD> 282</TR> 283<TR BGCOLOR="white" CLASS="TableRowColor"> 284<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 285<CODE> boolean</CODE></FONT></TD> 286<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getDirectDatabaseIO()">getDirectDatabaseIO</A></B>()</CODE> 287 288<BR> 289 Return true if the database environment has been configured to not buffer 290 database files.</TD> 291</TR> 292<TR BGCOLOR="white" CLASS="TableRowColor"> 293<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 294<CODE> boolean</CODE></FONT></TD> 295<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getDirectLogIO()">getDirectLogIO</A></B>()</CODE> 296 297<BR> 298 Return true if the database environment has been configured to not buffer 299 log files.</TD> 300</TR> 301<TR BGCOLOR="white" CLASS="TableRowColor"> 302<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 303<CODE> boolean</CODE></FONT></TD> 304<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getDsyncDatabases()">getDsyncDatabases</A></B>()</CODE> 305 306<BR> 307 Return true if the database environment has been configured to flush database 308 writes to the backing disk before returning from the write system call.</TD> 309</TR> 310<TR BGCOLOR="white" CLASS="TableRowColor"> 311<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 312<CODE> boolean</CODE></FONT></TD> 313<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getDsyncLog()">getDsyncLog</A></B>()</CODE> 314 315<BR> 316 Return true if the database environment has been configured to flush log 317 writes to the backing disk before returning from the write system 318 call.</TD> 319</TR> 320<TR BGCOLOR="white" CLASS="TableRowColor"> 321<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 322<CODE> boolean</CODE></FONT></TD> 323<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getEncrypted()">getEncrypted</A></B>()</CODE> 324 325<BR> 326 Return the database environment has been configured to perform 327 encryption.</TD> 328</TR> 329<TR BGCOLOR="white" CLASS="TableRowColor"> 330<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 331<CODE> <A HREF="../../../com/sleepycat/db/ErrorHandler.html" title="interface in com.sleepycat.db">ErrorHandler</A></CODE></FONT></TD> 332<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getErrorHandler()">getErrorHandler</A></B>()</CODE> 333 334<BR> 335 Return the function to be called if an error occurs.</TD> 336</TR> 337<TR BGCOLOR="white" CLASS="TableRowColor"> 338<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 339<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD> 340<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getErrorPrefix()">getErrorPrefix</A></B>()</CODE> 341 342<BR> 343 Return the prefix string that appears before error messages.</TD> 344</TR> 345<TR BGCOLOR="white" CLASS="TableRowColor"> 346<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 347<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/OutputStream.html" title="class or interface in java.io">OutputStream</A></CODE></FONT></TD> 348<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getErrorStream()">getErrorStream</A></B>()</CODE> 349 350<BR> 351 Return the an OutputStream for displaying error messages.</TD> 352</TR> 353<TR BGCOLOR="white" CLASS="TableRowColor"> 354<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 355<CODE> <A HREF="../../../com/sleepycat/db/EventHandler.html" title="interface in com.sleepycat.db">EventHandler</A></CODE></FONT></TD> 356<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getEventHandler()">getEventHandler</A></B>()</CODE> 357 358<BR> 359 Return the object's methods to be called when a triggered event occurs.</TD> 360</TR> 361<TR BGCOLOR="white" CLASS="TableRowColor"> 362<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 363<CODE> <A HREF="../../../com/sleepycat/db/FeedbackHandler.html" title="interface in com.sleepycat.db">FeedbackHandler</A></CODE></FONT></TD> 364<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getFeedbackHandler()">getFeedbackHandler</A></B>()</CODE> 365 366<BR> 367 Return the object's methods to be called to provide feedback.</TD> 368</TR> 369<TR BGCOLOR="white" CLASS="TableRowColor"> 370<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 371<CODE> boolean</CODE></FONT></TD> 372<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getInitializeCache()">getInitializeCache</A></B>()</CODE> 373 374<BR> 375 Return true if the database environment is configured with a shared 376 memory buffer pool.</TD> 377</TR> 378<TR BGCOLOR="white" CLASS="TableRowColor"> 379<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 380<CODE> boolean</CODE></FONT></TD> 381<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getInitializeCDB()">getInitializeCDB</A></B>()</CODE> 382 383<BR> 384 Return true if the database environment is configured for the Concurrent 385 Data Store product.</TD> 386</TR> 387<TR BGCOLOR="white" CLASS="TableRowColor"> 388<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 389<CODE> boolean</CODE></FONT></TD> 390<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getInitializeLocking()">getInitializeLocking</A></B>()</CODE> 391 392<BR> 393 Return true if the database environment is configured for locking.</TD> 394</TR> 395<TR BGCOLOR="white" CLASS="TableRowColor"> 396<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 397<CODE> boolean</CODE></FONT></TD> 398<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getInitializeLogging()">getInitializeLogging</A></B>()</CODE> 399 400<BR> 401 Return true if the database environment is configured for logging.</TD> 402</TR> 403<TR BGCOLOR="white" CLASS="TableRowColor"> 404<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 405<CODE> boolean</CODE></FONT></TD> 406<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getInitializeRegions()">getInitializeRegions</A></B>()</CODE> 407 408<BR> 409 Return true if the database environment has been configured to page-fault 410 shared regions into memory when initially creating or joining a 411 database environment.</TD> 412</TR> 413<TR BGCOLOR="white" CLASS="TableRowColor"> 414<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 415<CODE> boolean</CODE></FONT></TD> 416<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getInitializeReplication()">getInitializeReplication</A></B>()</CODE> 417 418<BR> 419 Return true if the database environment is configured for replication.</TD> 420</TR> 421<TR BGCOLOR="white" CLASS="TableRowColor"> 422<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 423<CODE> boolean</CODE></FONT></TD> 424<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getJoinEnvironment()">getJoinEnvironment</A></B>()</CODE> 425 426<BR> 427 Return the handle is configured to join an existing environment.</TD> 428</TR> 429<TR BGCOLOR="white" CLASS="TableRowColor"> 430<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 431<CODE> byte[][]</CODE></FONT></TD> 432<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getLockConflicts()">getLockConflicts</A></B>()</CODE> 433 434<BR> 435 Return the locking conflicts matrix.</TD> 436</TR> 437<TR BGCOLOR="white" CLASS="TableRowColor"> 438<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 439<CODE> <A HREF="../../../com/sleepycat/db/LockDetectMode.html" title="class in com.sleepycat.db">LockDetectMode</A></CODE></FONT></TD> 440<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getLockDetectMode()">getLockDetectMode</A></B>()</CODE> 441 442<BR> 443 Return true if the deadlock detector is configured to run whenever a lock 444 conflict occurs.</TD> 445</TR> 446<TR BGCOLOR="white" CLASS="TableRowColor"> 447<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 448<CODE> boolean</CODE></FONT></TD> 449<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getLockDown()">getLockDown</A></B>()</CODE> 450 451<BR> 452 Return true if the database environment is configured to lock shared 453 environment files and memory-mapped databases into memory.</TD> 454</TR> 455<TR BGCOLOR="white" CLASS="TableRowColor"> 456<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 457<CODE> long</CODE></FONT></TD> 458<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getLockTimeout()">getLockTimeout</A></B>()</CODE> 459 460<BR> 461 Return the database environment lock timeout value, in microseconds; 462 a timeout of 0 means no timeout is set.</TD> 463</TR> 464<TR BGCOLOR="white" CLASS="TableRowColor"> 465<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 466<CODE> boolean</CODE></FONT></TD> 467<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getLogAutoRemove()">getLogAutoRemove</A></B>()</CODE> 468 469<BR> 470 Return true if the system has been configured to to automatically remove log 471 files that are no longer needed.</TD> 472</TR> 473<TR BGCOLOR="white" CLASS="TableRowColor"> 474<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 475<CODE> int</CODE></FONT></TD> 476<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getLogBufferSize()">getLogBufferSize</A></B>()</CODE> 477 478<BR> 479 Return the size of the in-memory log buffer, in bytes.</TD> 480</TR> 481<TR BGCOLOR="white" CLASS="TableRowColor"> 482<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 483<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/File.html" title="class or interface in java.io">File</A></CODE></FONT></TD> 484<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getLogDirectory()">getLogDirectory</A></B>()</CODE> 485 486<BR> 487 Return the path of a directory to be used as the location of logging files.</TD> 488</TR> 489<TR BGCOLOR="white" CLASS="TableRowColor"> 490<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 491<CODE> int</CODE></FONT></TD> 492<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getLogFileMode()">getLogFileMode</A></B>()</CODE> 493 494<BR> 495 Return the absolute file mode for created log files.</TD> 496</TR> 497<TR BGCOLOR="white" CLASS="TableRowColor"> 498<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 499<CODE> boolean</CODE></FONT></TD> 500<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getLogInMemory()">getLogInMemory</A></B>()</CODE> 501 502<BR> 503 Return true if the database environment is configured to maintain transaction logs 504 in memory rather than on disk.</TD> 505</TR> 506<TR BGCOLOR="white" CLASS="TableRowColor"> 507<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 508<CODE> <A HREF="../../../com/sleepycat/db/LogRecordHandler.html" title="interface in com.sleepycat.db">LogRecordHandler</A></CODE></FONT></TD> 509<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getLogRecordHandler()">getLogRecordHandler</A></B>()</CODE> 510 511<BR> 512 Return the handler for application-specific log records.</TD> 513</TR> 514<TR BGCOLOR="white" CLASS="TableRowColor"> 515<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 516<CODE> int</CODE></FONT></TD> 517<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getLogRegionSize()">getLogRegionSize</A></B>()</CODE> 518 519<BR> 520 Return the size of the underlying logging subsystem region.</TD> 521</TR> 522<TR BGCOLOR="white" CLASS="TableRowColor"> 523<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 524<CODE> boolean</CODE></FONT></TD> 525<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getLogZero()">getLogZero</A></B>()</CODE> 526 527<BR> 528 Return true if the database environment is configured to zero all pages of 529 new log files upon their creation.</TD> 530</TR> 531<TR BGCOLOR="white" CLASS="TableRowColor"> 532<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 533<CODE> int</CODE></FONT></TD> 534<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMaxLockers()">getMaxLockers</A></B>()</CODE> 535 536<BR> 537 Return the maximum number of lockers.</TD> 538</TR> 539<TR BGCOLOR="white" CLASS="TableRowColor"> 540<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 541<CODE> int</CODE></FONT></TD> 542<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMaxLockObjects()">getMaxLockObjects</A></B>()</CODE> 543 544<BR> 545 Return the maximum number of locked objects.</TD> 546</TR> 547<TR BGCOLOR="white" CLASS="TableRowColor"> 548<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 549<CODE> int</CODE></FONT></TD> 550<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMaxLocks()">getMaxLocks</A></B>()</CODE> 551 552<BR> 553 Return the maximum number of locks.</TD> 554</TR> 555<TR BGCOLOR="white" CLASS="TableRowColor"> 556<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 557<CODE> int</CODE></FONT></TD> 558<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMaxLogFileSize()">getMaxLogFileSize</A></B>()</CODE> 559 560<BR> 561 Return the maximum size of a single file in the log, in bytes.</TD> 562</TR> 563<TR BGCOLOR="white" CLASS="TableRowColor"> 564<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 565<CODE> int</CODE></FONT></TD> 566<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMaxMutexes()">getMaxMutexes</A></B>()</CODE> 567 568<BR> 569 Return the total number of mutexes allocated.</TD> 570</TR> 571<TR BGCOLOR="white" CLASS="TableRowColor"> 572<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 573<CODE> int</CODE></FONT></TD> 574<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMaxOpenFiles()">getMaxOpenFiles</A></B>()</CODE> 575 576<BR> 577 Return the maximum number of file descriptors that will be opened concurrently..</TD> 578</TR> 579<TR BGCOLOR="white" CLASS="TableRowColor"> 580<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 581<CODE> int</CODE></FONT></TD> 582<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMaxWrite()">getMaxWrite</A></B>()</CODE> 583 584<BR> 585 Return the maximum number of sequential write operations.</TD> 586</TR> 587<TR BGCOLOR="white" CLASS="TableRowColor"> 588<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 589<CODE> long</CODE></FONT></TD> 590<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMaxWriteSleep()">getMaxWriteSleep</A></B>()</CODE> 591 592<BR> 593 Return the microseconds to pause before scheduling further write operations.</TD> 594</TR> 595<TR BGCOLOR="white" CLASS="TableRowColor"> 596<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 597<CODE> <A HREF="../../../com/sleepycat/db/MessageHandler.html" title="interface in com.sleepycat.db">MessageHandler</A></CODE></FONT></TD> 598<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMessageHandler()">getMessageHandler</A></B>()</CODE> 599 600<BR> 601 Return the function to be called with an informational message.</TD> 602</TR> 603<TR BGCOLOR="white" CLASS="TableRowColor"> 604<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 605<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/OutputStream.html" title="class or interface in java.io">OutputStream</A></CODE></FONT></TD> 606<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMessageStream()">getMessageStream</A></B>()</CODE> 607 608<BR> 609 Return the an OutputStream for displaying informational messages.</TD> 610</TR> 611<TR BGCOLOR="white" CLASS="TableRowColor"> 612<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 613<CODE> long</CODE></FONT></TD> 614<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMMapSize()">getMMapSize</A></B>()</CODE> 615 616<BR> 617 Return the maximum file size, in bytes, for a file to be mapped into 618 the process address space.</TD> 619</TR> 620<TR BGCOLOR="white" CLASS="TableRowColor"> 621<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 622<CODE> long</CODE></FONT></TD> 623<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMode()">getMode</A></B>()</CODE> 624 625<BR> 626 Return the mode to use when creating underlying files and shared 627 memory segments.</TD> 628</TR> 629<TR BGCOLOR="white" CLASS="TableRowColor"> 630<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 631<CODE> boolean</CODE></FONT></TD> 632<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMultiversion()">getMultiversion</A></B>()</CODE> 633 634<BR> 635 Return true if the handle is configured to open all databases for multiversion 636 concurrency control.</TD> 637</TR> 638<TR BGCOLOR="white" CLASS="TableRowColor"> 639<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 640<CODE> int</CODE></FONT></TD> 641<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMutexAlignment()">getMutexAlignment</A></B>()</CODE> 642 643<BR> 644 Return the mutex alignment, in bytes.</TD> 645</TR> 646<TR BGCOLOR="white" CLASS="TableRowColor"> 647<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 648<CODE> int</CODE></FONT></TD> 649<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMutexIncrement()">getMutexIncrement</A></B>()</CODE> 650 651<BR> 652 Return the number of additional mutexes to allocate.</TD> 653</TR> 654<TR BGCOLOR="white" CLASS="TableRowColor"> 655<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 656<CODE> int</CODE></FONT></TD> 657<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMutexTestAndSetSpins()">getMutexTestAndSetSpins</A></B>()</CODE> 658 659<BR> 660 Return the test-and-set spin count.</TD> 661</TR> 662<TR BGCOLOR="white" CLASS="TableRowColor"> 663<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 664<CODE> boolean</CODE></FONT></TD> 665<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getNoLocking()">getNoLocking</A></B>()</CODE> 666 667<BR> 668 Return true if the system has been configured to grant all requested mutual 669 exclusion mutexes and database locks without regard for their actual 670 availability.</TD> 671</TR> 672<TR BGCOLOR="white" CLASS="TableRowColor"> 673<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 674<CODE> boolean</CODE></FONT></TD> 675<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getNoMMap()">getNoMMap</A></B>()</CODE> 676 677<BR> 678 Return true if the system has been configured to copy read-only database files 679 into the local cache instead of potentially mapping them into process 680 memory.</TD> 681</TR> 682<TR BGCOLOR="white" CLASS="TableRowColor"> 683<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 684<CODE> boolean</CODE></FONT></TD> 685<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getNoPanic()">getNoPanic</A></B>()</CODE> 686 687<BR> 688 Return true if the system has been configured to ignore any panic state in 689 the database environment.</TD> 690</TR> 691<TR BGCOLOR="white" CLASS="TableRowColor"> 692<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 693<CODE> boolean</CODE></FONT></TD> 694<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getOverwrite()">getOverwrite</A></B>()</CODE> 695 696<BR> 697 Return true if the system has been configured to overwrite files stored in 698 encrypted formats before deleting them.</TD> 699</TR> 700<TR BGCOLOR="white" CLASS="TableRowColor"> 701<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 702<CODE> <A HREF="../../../com/sleepycat/db/PanicHandler.html" title="interface in com.sleepycat.db">PanicHandler</A></CODE></FONT></TD> 703<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getPanicHandler()">getPanicHandler</A></B>()</CODE> 704 705<BR> 706 Return the function to be called if the database environment panics.</TD> 707</TR> 708<TR BGCOLOR="white" CLASS="TableRowColor"> 709<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 710<CODE> boolean</CODE></FONT></TD> 711<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getPrivate()">getPrivate</A></B>()</CODE> 712 713<BR> 714 Return true if the database environment is configured to only be accessed 715 by a single process.</TD> 716</TR> 717<TR BGCOLOR="white" CLASS="TableRowColor"> 718<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 719<CODE> boolean</CODE></FONT></TD> 720<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getRegister()">getRegister</A></B>()</CODE> 721 722<BR> 723 Return true if the check for process failure when the environment is opened.</TD> 724</TR> 725<TR BGCOLOR="white" CLASS="TableRowColor"> 726<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 727<CODE> int</CODE></FONT></TD> 728<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getReplicationClockskewFast()">getReplicationClockskewFast</A></B>()</CODE> 729 730<BR> 731 Return the current clock skew value for the fastest clock in the group of sites.</TD> 732</TR> 733<TR BGCOLOR="white" CLASS="TableRowColor"> 734<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 735<CODE> int</CODE></FONT></TD> 736<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getReplicationClockskewSlow()">getReplicationClockskewSlow</A></B>()</CODE> 737 738<BR> 739 Return the current clock skew value for the slowest clock in the group of sites.</TD> 740</TR> 741<TR BGCOLOR="white" CLASS="TableRowColor"> 742<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 743<CODE> long</CODE></FONT></TD> 744<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getReplicationLimit()">getReplicationLimit</A></B>()</CODE> 745 746<BR> 747 Return the transmit limit in bytes for a single call to 748 <A HREF="../../../com/sleepycat/db/Environment.html#processReplicationMessage(com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, int)"><CODE>Environment.processReplicationMessage</CODE></A>.</TD> 749</TR> 750<TR BGCOLOR="white" CLASS="TableRowColor"> 751<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 752<CODE> <A HREF="../../../com/sleepycat/db/ReplicationManagerAckPolicy.html" title="class in com.sleepycat.db">ReplicationManagerAckPolicy</A></CODE></FONT></TD> 753<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getReplicationManagerAckPolicy()">getReplicationManagerAckPolicy</A></B>()</CODE> 754 755<BR> 756 Get the network Ack policy used by the replication manager.</TD> 757</TR> 758<TR BGCOLOR="white" CLASS="TableRowColor"> 759<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 760<CODE> <A HREF="../../../com/sleepycat/db/ReplicationHostAddress.html" title="class in com.sleepycat.db">ReplicationHostAddress</A></CODE></FONT></TD> 761<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getReplicationManagerLocalSite()">getReplicationManagerLocalSite</A></B>()</CODE> 762 763<BR> 764 Get the address of the local (this) site in a replication group.</TD> 765</TR> 766<TR BGCOLOR="white" CLASS="TableRowColor"> 767<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 768<CODE> int</CODE></FONT></TD> 769<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getReplicationNumSites()">getReplicationNumSites</A></B>()</CODE> 770 771<BR> 772 Get the total number of sites in the replication group.</TD> 773</TR> 774<TR BGCOLOR="white" CLASS="TableRowColor"> 775<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 776<CODE> int</CODE></FONT></TD> 777<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getReplicationPriority()">getReplicationPriority</A></B>()</CODE> 778 779<BR> 780 Get the current environment's priority.</TD> 781</TR> 782<TR BGCOLOR="white" CLASS="TableRowColor"> 783<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 784<CODE> int</CODE></FONT></TD> 785<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getReplicationRequestMax()">getReplicationRequestMax</A></B>()</CODE> 786 787<BR> 788 Get the threshold for the maximum amount of time that a client waits before 789 requesting retransmission of a missed message.</TD> 790</TR> 791<TR BGCOLOR="white" CLASS="TableRowColor"> 792<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 793<CODE> int</CODE></FONT></TD> 794<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getReplicationRequestMin()">getReplicationRequestMin</A></B>()</CODE> 795 796<BR> 797 Get the threshold for the minimum amount of time that a client waits before 798 requesting retransmission of a missed message.</TD> 799</TR> 800<TR BGCOLOR="white" CLASS="TableRowColor"> 801<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 802<CODE> <A HREF="../../../com/sleepycat/db/ReplicationTransport.html" title="interface in com.sleepycat.db">ReplicationTransport</A></CODE></FONT></TD> 803<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getReplicationTransport()">getReplicationTransport</A></B>()</CODE> 804 805<BR> 806 Return the replication callback function used to transmit data using 807 the replication application's communication infrastructure.</TD> 808</TR> 809<TR BGCOLOR="white" CLASS="TableRowColor"> 810<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 811<CODE> boolean</CODE></FONT></TD> 812<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getRunFatalRecovery()">getRunFatalRecovery</A></B>()</CODE> 813 814<BR> 815 Return the handle is configured to run catastrophic recovery on 816 the database environment before opening it for use.</TD> 817</TR> 818<TR BGCOLOR="white" CLASS="TableRowColor"> 819<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 820<CODE> boolean</CODE></FONT></TD> 821<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getRunRecovery()">getRunRecovery</A></B>()</CODE> 822 823<BR> 824 Return the handle is configured to run normal recovery on the 825 database environment before opening it for use.</TD> 826</TR> 827<TR BGCOLOR="white" CLASS="TableRowColor"> 828<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 829<CODE> long</CODE></FONT></TD> 830<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getSegmentId()">getSegmentId</A></B>()</CODE> 831 832<BR> 833 Return the base segment ID.</TD> 834</TR> 835<TR BGCOLOR="white" CLASS="TableRowColor"> 836<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 837<CODE> boolean</CODE></FONT></TD> 838<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getSystemMemory()">getSystemMemory</A></B>()</CODE> 839 840<BR> 841 Return true if the database environment is configured to allocate memory 842 from system shared memory instead of from memory backed by the 843 filesystem.</TD> 844</TR> 845<TR BGCOLOR="white" CLASS="TableRowColor"> 846<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 847<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/File.html" title="class or interface in java.io">File</A></CODE></FONT></TD> 848<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getTemporaryDirectory()">getTemporaryDirectory</A></B>()</CODE> 849 850<BR> 851 Return the path of a directory to be used as the location of 852 temporary files.</TD> 853</TR> 854<TR BGCOLOR="white" CLASS="TableRowColor"> 855<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 856<CODE> int</CODE></FONT></TD> 857<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getTestAndSetSpins()">getTestAndSetSpins</A></B>()</CODE> 858 859<BR> 860 <B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMutexTestAndSetSpins()"><CODE>getMutexTestAndSetSpins()</CODE></A></I></TD> 861</TR> 862<TR BGCOLOR="white" CLASS="TableRowColor"> 863<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 864<CODE> boolean</CODE></FONT></TD> 865<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getThreaded()">getThreaded</A></B>()</CODE> 866 867<BR> 868 Return true if the handle is configured to be <em>free-threaded</em>.</TD> 869</TR> 870<TR BGCOLOR="white" CLASS="TableRowColor"> 871<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 872<CODE> boolean</CODE></FONT></TD> 873<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getTransactional()">getTransactional</A></B>()</CODE> 874 875<BR> 876 Return true if the database environment is configured for transactions.</TD> 877</TR> 878<TR BGCOLOR="white" CLASS="TableRowColor"> 879<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 880<CODE> int</CODE></FONT></TD> 881<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getTxnMaxActive()">getTxnMaxActive</A></B>()</CODE> 882 883<BR> 884 Return the minimum number of simultaneously active transactions supported 885 by the database environment.</TD> 886</TR> 887<TR BGCOLOR="white" CLASS="TableRowColor"> 888<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 889<CODE> boolean</CODE></FONT></TD> 890<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getTxnNoSync()">getTxnNoSync</A></B>()</CODE> 891 892<BR> 893 Return true if the system has been configured to not write or synchronously 894 flush the log on transaction commit.</TD> 895</TR> 896<TR BGCOLOR="white" CLASS="TableRowColor"> 897<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 898<CODE> boolean</CODE></FONT></TD> 899<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getTxnNotDurable()">getTxnNotDurable</A></B>()</CODE> 900 901<BR> 902 Return true if the system has been configured to not write log records.</TD> 903</TR> 904<TR BGCOLOR="white" CLASS="TableRowColor"> 905<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 906<CODE> boolean</CODE></FONT></TD> 907<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getTxnNoWait()">getTxnNoWait</A></B>()</CODE> 908 909<BR> 910 Return true if the transactions have been configured to not wait for locks by default.</TD> 911</TR> 912<TR BGCOLOR="white" CLASS="TableRowColor"> 913<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 914<CODE> boolean</CODE></FONT></TD> 915<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getTxnSnapshot()">getTxnSnapshot</A></B>()</CODE> 916 917<BR> 918 Return true if the handle is configured to run all transactions at snapshot 919 isolation.</TD> 920</TR> 921<TR BGCOLOR="white" CLASS="TableRowColor"> 922<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 923<CODE> long</CODE></FONT></TD> 924<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getTxnTimeout()">getTxnTimeout</A></B>()</CODE> 925 926<BR> 927 Return the database environment transaction timeout value, in 928 microseconds; a timeout of 0 means no timeout is set.</TD> 929</TR> 930<TR BGCOLOR="white" CLASS="TableRowColor"> 931<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 932<CODE> <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Date.html" title="class or interface in java.util">Date</A></CODE></FONT></TD> 933<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getTxnTimestamp()">getTxnTimestamp</A></B>()</CODE> 934 935<BR> 936 Return the time to which recovery will be done, or 0 if recovery will 937 be done to the most current possible date.</TD> 938</TR> 939<TR BGCOLOR="white" CLASS="TableRowColor"> 940<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 941<CODE> boolean</CODE></FONT></TD> 942<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getTxnWriteNoSync()">getTxnWriteNoSync</A></B>()</CODE> 943 944<BR> 945 Return true if the system has been configured to write, but not synchronously 946 flush, the log on transaction commit.</TD> 947</TR> 948<TR BGCOLOR="white" CLASS="TableRowColor"> 949<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 950<CODE> boolean</CODE></FONT></TD> 951<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getUseEnvironment()">getUseEnvironment</A></B>()</CODE> 952 953<BR> 954 Return true if the database environment is configured to accept information 955 from the process environment when naming files.</TD> 956</TR> 957<TR BGCOLOR="white" CLASS="TableRowColor"> 958<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 959<CODE> boolean</CODE></FONT></TD> 960<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getUseEnvironmentRoot()">getUseEnvironmentRoot</A></B>()</CODE> 961 962<BR> 963 Return true if the database environment is configured to accept information 964 from the process environment when naming files if the process has 965 appropriate permissions.</TD> 966</TR> 967<TR BGCOLOR="white" CLASS="TableRowColor"> 968<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 969<CODE> boolean</CODE></FONT></TD> 970<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerbose(com.sleepycat.db.VerboseConfig)">getVerbose</A></B>(<A HREF="../../../com/sleepycat/db/VerboseConfig.html" title="class in com.sleepycat.db">VerboseConfig</A> flag)</CODE> 971 972<BR> 973 Return if the database environment is configured to display 974 a given type of verbose information.</TD> 975</TR> 976<TR BGCOLOR="white" CLASS="TableRowColor"> 977<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 978<CODE> boolean</CODE></FONT></TD> 979<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerboseDeadlock()">getVerboseDeadlock</A></B>()</CODE> 980 981<BR> 982 <B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerbose(com.sleepycat.db.VerboseConfig)"><CODE>getVerbose(com.sleepycat.db.VerboseConfig)</CODE></A></I></TD> 983</TR> 984<TR BGCOLOR="white" CLASS="TableRowColor"> 985<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 986<CODE> boolean</CODE></FONT></TD> 987<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerboseRecovery()">getVerboseRecovery</A></B>()</CODE> 988 989<BR> 990 <B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerbose(com.sleepycat.db.VerboseConfig)"><CODE>getVerbose(com.sleepycat.db.VerboseConfig)</CODE></A></I></TD> 991</TR> 992<TR BGCOLOR="white" CLASS="TableRowColor"> 993<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 994<CODE> boolean</CODE></FONT></TD> 995<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerboseRegister()">getVerboseRegister</A></B>()</CODE> 996 997<BR> 998 <B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerbose(com.sleepycat.db.VerboseConfig)"><CODE>getVerbose(com.sleepycat.db.VerboseConfig)</CODE></A></I></TD> 999</TR> 1000<TR BGCOLOR="white" CLASS="TableRowColor"> 1001<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1002<CODE> boolean</CODE></FONT></TD> 1003<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerboseReplication()">getVerboseReplication</A></B>()</CODE> 1004 1005<BR> 1006 <B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerbose(com.sleepycat.db.VerboseConfig)"><CODE>getVerbose(com.sleepycat.db.VerboseConfig)</CODE></A></I></TD> 1007</TR> 1008<TR BGCOLOR="white" CLASS="TableRowColor"> 1009<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1010<CODE> boolean</CODE></FONT></TD> 1011<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerboseWaitsFor()">getVerboseWaitsFor</A></B>()</CODE> 1012 1013<BR> 1014 <B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerbose(com.sleepycat.db.VerboseConfig)"><CODE>getVerbose(com.sleepycat.db.VerboseConfig)</CODE></A></I></TD> 1015</TR> 1016<TR BGCOLOR="white" CLASS="TableRowColor"> 1017<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1018<CODE> boolean</CODE></FONT></TD> 1019<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getYieldCPU()">getYieldCPU</A></B>()</CODE> 1020 1021<BR> 1022 Return true if the system has been configured to yield the processor 1023 immediately after each page or mutex acquisition.</TD> 1024</TR> 1025<TR BGCOLOR="white" CLASS="TableRowColor"> 1026<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1027<CODE> void</CODE></FONT></TD> 1028<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#replicationManagerAddRemoteSite(com.sleepycat.db.ReplicationHostAddress, boolean)">replicationManagerAddRemoteSite</A></B>(<A HREF="../../../com/sleepycat/db/ReplicationHostAddress.html" title="class in com.sleepycat.db">ReplicationHostAddress</A> repmgrRemoteAddr, 1029 boolean isPeer)</CODE> 1030 1031<BR> 1032 Add a remote site to a replication group.</TD> 1033</TR> 1034<TR BGCOLOR="white" CLASS="TableRowColor"> 1035<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1036<CODE> void</CODE></FONT></TD> 1037<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setAllowCreate(boolean)">setAllowCreate</A></B>(boolean allowCreate)</CODE> 1038 1039<BR> 1040 Configure the database environment to create any underlying files, 1041 as necessary.</TD> 1042</TR> 1043<TR BGCOLOR="white" CLASS="TableRowColor"> 1044<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1045<CODE> void</CODE></FONT></TD> 1046<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setCacheCount(int)">setCacheCount</A></B>(int cacheCount)</CODE> 1047 1048<BR> 1049 Set the number of shared memory buffer pools, that is, the number of 1050caches.</TD> 1051</TR> 1052<TR BGCOLOR="white" CLASS="TableRowColor"> 1053<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1054<CODE> void</CODE></FONT></TD> 1055<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setCacheMax(long)">setCacheMax</A></B>(long cacheMax)</CODE> 1056 1057<BR> 1058 Set the maximum cache size in bytes.</TD> 1059</TR> 1060<TR BGCOLOR="white" CLASS="TableRowColor"> 1061<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1062<CODE> void</CODE></FONT></TD> 1063<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setCacheSize(long)">setCacheSize</A></B>(long cacheSize)</CODE> 1064 1065<BR> 1066 Set the size of the shared memory buffer pool, that is, the size of the 1067cache.</TD> 1068</TR> 1069<TR BGCOLOR="white" CLASS="TableRowColor"> 1070<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1071<CODE> void</CODE></FONT></TD> 1072<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setCDBLockAllDatabases(boolean)">setCDBLockAllDatabases</A></B>(boolean cdbLockAllDatabases)</CODE> 1073 1074<BR> 1075 Configure Concurrent Data Store applications to perform locking on 1076 an environment-wide basis rather than on a per-database basis.</TD> 1077</TR> 1078<TR BGCOLOR="white" CLASS="TableRowColor"> 1079<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1080<CODE> void</CODE></FONT></TD> 1081<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setDirectDatabaseIO(boolean)">setDirectDatabaseIO</A></B>(boolean directDatabaseIO)</CODE> 1082 1083<BR> 1084 Configure the database environment to not buffer database files.</TD> 1085</TR> 1086<TR BGCOLOR="white" CLASS="TableRowColor"> 1087<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1088<CODE> void</CODE></FONT></TD> 1089<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setDirectLogIO(boolean)">setDirectLogIO</A></B>(boolean directLogIO)</CODE> 1090 1091<BR> 1092 Configure the database environment to not buffer log files.</TD> 1093</TR> 1094<TR BGCOLOR="white" CLASS="TableRowColor"> 1095<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1096<CODE> void</CODE></FONT></TD> 1097<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setDsyncDatabases(boolean)">setDsyncDatabases</A></B>(boolean dsyncDatabases)</CODE> 1098 1099<BR> 1100 Configure the database environment to flush database writes to the backing 1101 disk before returning from the write system call, rather than flushing 1102 database writes explicitly in a separate system call, as necessary.</TD> 1103</TR> 1104<TR BGCOLOR="white" CLASS="TableRowColor"> 1105<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1106<CODE> void</CODE></FONT></TD> 1107<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setDsyncLog(boolean)">setDsyncLog</A></B>(boolean dsyncLog)</CODE> 1108 1109<BR> 1110 Configure the database environment to flush log writes to the 1111 backing disk before returning from the write system call, rather 1112 than flushing log writes explicitly in a separate system call.</TD> 1113</TR> 1114<TR BGCOLOR="white" CLASS="TableRowColor"> 1115<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1116<CODE> void</CODE></FONT></TD> 1117<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setEncrypted(java.lang.String)">setEncrypted</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> password)</CODE> 1118 1119<BR> 1120 Set the password used to perform encryption and decryption.</TD> 1121</TR> 1122<TR BGCOLOR="white" CLASS="TableRowColor"> 1123<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1124<CODE> void</CODE></FONT></TD> 1125<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorHandler(com.sleepycat.db.ErrorHandler)">setErrorHandler</A></B>(<A HREF="../../../com/sleepycat/db/ErrorHandler.html" title="interface in com.sleepycat.db">ErrorHandler</A> errorHandler)</CODE> 1126 1127<BR> 1128 Set the function to be called if an error occurs.</TD> 1129</TR> 1130<TR BGCOLOR="white" CLASS="TableRowColor"> 1131<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1132<CODE> void</CODE></FONT></TD> 1133<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorPrefix(java.lang.String)">setErrorPrefix</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> errorPrefix)</CODE> 1134 1135<BR> 1136 Set the prefix string that appears before error messages.</TD> 1137</TR> 1138<TR BGCOLOR="white" CLASS="TableRowColor"> 1139<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1140<CODE> void</CODE></FONT></TD> 1141<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorStream(java.io.OutputStream)">setErrorStream</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/OutputStream.html" title="class or interface in java.io">OutputStream</A> errorStream)</CODE> 1142 1143<BR> 1144 Set an OutputStream for displaying error messages.</TD> 1145</TR> 1146<TR BGCOLOR="white" CLASS="TableRowColor"> 1147<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1148<CODE> void</CODE></FONT></TD> 1149<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setEventHandler(com.sleepycat.db.EventHandler)">setEventHandler</A></B>(<A HREF="../../../com/sleepycat/db/EventHandler.html" title="interface in com.sleepycat.db">EventHandler</A> eventHandler)</CODE> 1150 1151<BR> 1152 Set an object whose methods are to be called when a triggered event occurs.</TD> 1153</TR> 1154<TR BGCOLOR="white" CLASS="TableRowColor"> 1155<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1156<CODE> void</CODE></FONT></TD> 1157<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setFeedbackHandler(com.sleepycat.db.FeedbackHandler)">setFeedbackHandler</A></B>(<A HREF="../../../com/sleepycat/db/FeedbackHandler.html" title="interface in com.sleepycat.db">FeedbackHandler</A> feedbackHandler)</CODE> 1158 1159<BR> 1160 Set an object whose methods are called to provide feedback.</TD> 1161</TR> 1162<TR BGCOLOR="white" CLASS="TableRowColor"> 1163<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1164<CODE> void</CODE></FONT></TD> 1165<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setInitializeCache(boolean)">setInitializeCache</A></B>(boolean initializeCache)</CODE> 1166 1167<BR> 1168 Configure a shared memory buffer pool in the database environment.</TD> 1169</TR> 1170<TR BGCOLOR="white" CLASS="TableRowColor"> 1171<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1172<CODE> void</CODE></FONT></TD> 1173<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setInitializeCDB(boolean)">setInitializeCDB</A></B>(boolean initializeCDB)</CODE> 1174 1175<BR> 1176 Configure the database environment for the Concurrent Data Store 1177 product.</TD> 1178</TR> 1179<TR BGCOLOR="white" CLASS="TableRowColor"> 1180<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1181<CODE> void</CODE></FONT></TD> 1182<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setInitializeLocking(boolean)">setInitializeLocking</A></B>(boolean initializeLocking)</CODE> 1183 1184<BR> 1185 Configure the database environment for locking.</TD> 1186</TR> 1187<TR BGCOLOR="white" CLASS="TableRowColor"> 1188<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1189<CODE> void</CODE></FONT></TD> 1190<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setInitializeLogging(boolean)">setInitializeLogging</A></B>(boolean initializeLogging)</CODE> 1191 1192<BR> 1193 Configure the database environment for logging.</TD> 1194</TR> 1195<TR BGCOLOR="white" CLASS="TableRowColor"> 1196<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1197<CODE> void</CODE></FONT></TD> 1198<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setInitializeRegions(boolean)">setInitializeRegions</A></B>(boolean initializeRegions)</CODE> 1199 1200<BR> 1201 Configure the database environment to page-fault shared regions into 1202 memory when initially creating or joining a database environment.</TD> 1203</TR> 1204<TR BGCOLOR="white" CLASS="TableRowColor"> 1205<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1206<CODE> void</CODE></FONT></TD> 1207<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setInitializeReplication(boolean)">setInitializeReplication</A></B>(boolean initializeReplication)</CODE> 1208 1209<BR> 1210 Configure the database environment for replication.</TD> 1211</TR> 1212<TR BGCOLOR="white" CLASS="TableRowColor"> 1213<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1214<CODE> void</CODE></FONT></TD> 1215<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setJoinEnvironment(boolean)">setJoinEnvironment</A></B>(boolean joinEnvironment)</CODE> 1216 1217<BR> 1218 Configure the handle to join an existing environment.</TD> 1219</TR> 1220<TR BGCOLOR="white" CLASS="TableRowColor"> 1221<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1222<CODE> void</CODE></FONT></TD> 1223<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setLockConflicts(byte[][])">setLockConflicts</A></B>(byte[][] lockConflicts)</CODE> 1224 1225<BR> 1226 Configure the locking conflicts matrix.</TD> 1227</TR> 1228<TR BGCOLOR="white" CLASS="TableRowColor"> 1229<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1230<CODE> void</CODE></FONT></TD> 1231<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setLockDetectMode(com.sleepycat.db.LockDetectMode)">setLockDetectMode</A></B>(<A HREF="../../../com/sleepycat/db/LockDetectMode.html" title="class in com.sleepycat.db">LockDetectMode</A> lockDetectMode)</CODE> 1232 1233<BR> 1234 Configure if the deadlock detector is to be run whenever a lock 1235 conflict occurs.</TD> 1236</TR> 1237<TR BGCOLOR="white" CLASS="TableRowColor"> 1238<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1239<CODE> void</CODE></FONT></TD> 1240<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setLockDown(boolean)">setLockDown</A></B>(boolean lockDown)</CODE> 1241 1242<BR> 1243 Configure the database environment to lock shared environment files 1244 and memory-mapped databases into memory.</TD> 1245</TR> 1246<TR BGCOLOR="white" CLASS="TableRowColor"> 1247<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1248<CODE> void</CODE></FONT></TD> 1249<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setLockTimeout(long)">setLockTimeout</A></B>(long lockTimeout)</CODE> 1250 1251<BR> 1252 Set the timeout value for the database environment 1253locks.</TD> 1254</TR> 1255<TR BGCOLOR="white" CLASS="TableRowColor"> 1256<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1257<CODE> void</CODE></FONT></TD> 1258<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setLogAutoRemove(boolean)">setLogAutoRemove</A></B>(boolean logAutoRemove)</CODE> 1259 1260<BR> 1261 Configure the system to automatically remove log files that are no 1262 longer needed.</TD> 1263</TR> 1264<TR BGCOLOR="white" CLASS="TableRowColor"> 1265<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1266<CODE> void</CODE></FONT></TD> 1267<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setLogBufferSize(int)">setLogBufferSize</A></B>(int logBufferSize)</CODE> 1268 1269<BR> 1270 Set the size of the in-memory log buffer, in bytes.</TD> 1271</TR> 1272<TR BGCOLOR="white" CLASS="TableRowColor"> 1273<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1274<CODE> void</CODE></FONT></TD> 1275<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setLogDirectory(java.io.File)">setLogDirectory</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/File.html" title="class or interface in java.io">File</A> logDirectory)</CODE> 1276 1277<BR> 1278 Set the path of a directory to be used as the location of logging files.</TD> 1279</TR> 1280<TR BGCOLOR="white" CLASS="TableRowColor"> 1281<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1282<CODE> void</CODE></FONT></TD> 1283<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setLogFileMode(int)">setLogFileMode</A></B>(int logFileMode)</CODE> 1284 1285<BR> 1286 Set the absolute file mode for created log files.</TD> 1287</TR> 1288<TR BGCOLOR="white" CLASS="TableRowColor"> 1289<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1290<CODE> void</CODE></FONT></TD> 1291<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setLogInMemory(boolean)">setLogInMemory</A></B>(boolean logInMemory)</CODE> 1292 1293<BR> 1294 If set, maintain transaction logs in memory rather than on disk.</TD> 1295</TR> 1296<TR BGCOLOR="white" CLASS="TableRowColor"> 1297<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1298<CODE> void</CODE></FONT></TD> 1299<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setLogRecordHandler(com.sleepycat.db.LogRecordHandler)">setLogRecordHandler</A></B>(<A HREF="../../../com/sleepycat/db/LogRecordHandler.html" title="interface in com.sleepycat.db">LogRecordHandler</A> logRecordHandler)</CODE> 1300 1301<BR> 1302 Set a function to process application-specific log records.</TD> 1303</TR> 1304<TR BGCOLOR="white" CLASS="TableRowColor"> 1305<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1306<CODE> void</CODE></FONT></TD> 1307<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setLogRegionSize(int)">setLogRegionSize</A></B>(int logRegionSize)</CODE> 1308 1309<BR> 1310 Set the size of the underlying logging area of the database 1311 environment, in bytes.</TD> 1312</TR> 1313<TR BGCOLOR="white" CLASS="TableRowColor"> 1314<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1315<CODE> void</CODE></FONT></TD> 1316<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setLogZero(boolean)">setLogZero</A></B>(boolean logZero)</CODE> 1317 1318<BR> 1319 If set, zero all pages of a log file when that log file is created.</TD> 1320</TR> 1321<TR BGCOLOR="white" CLASS="TableRowColor"> 1322<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1323<CODE> void</CODE></FONT></TD> 1324<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMaxLockers(int)">setMaxLockers</A></B>(int maxLockers)</CODE> 1325 1326<BR> 1327 Set the maximum number of locking entities supported by the database 1328 environment.</TD> 1329</TR> 1330<TR BGCOLOR="white" CLASS="TableRowColor"> 1331<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1332<CODE> void</CODE></FONT></TD> 1333<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMaxLockObjects(int)">setMaxLockObjects</A></B>(int maxLockObjects)</CODE> 1334 1335<BR> 1336 Set the maximum number of locked objects supported by the database 1337 environment.</TD> 1338</TR> 1339<TR BGCOLOR="white" CLASS="TableRowColor"> 1340<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1341<CODE> void</CODE></FONT></TD> 1342<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMaxLocks(int)">setMaxLocks</A></B>(int maxLocks)</CODE> 1343 1344<BR> 1345 Set the maximum number of locks supported by the database 1346 environment.</TD> 1347</TR> 1348<TR BGCOLOR="white" CLASS="TableRowColor"> 1349<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1350<CODE> void</CODE></FONT></TD> 1351<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMaxLogFileSize(int)">setMaxLogFileSize</A></B>(int maxLogFileSize)</CODE> 1352 1353<BR> 1354 Set the maximum size of a single file in the log, in bytes.</TD> 1355</TR> 1356<TR BGCOLOR="white" CLASS="TableRowColor"> 1357<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1358<CODE> void</CODE></FONT></TD> 1359<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMaxMutexes(int)">setMaxMutexes</A></B>(int maxMutexes)</CODE> 1360 1361<BR> 1362 Set the total number of mutexes to allocate.</TD> 1363</TR> 1364<TR BGCOLOR="white" CLASS="TableRowColor"> 1365<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1366<CODE> void</CODE></FONT></TD> 1367<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMaxOpenFiles(int)">setMaxOpenFiles</A></B>(int maxOpenFiles)</CODE> 1368 1369<BR> 1370 Limit the number of file descriptors the library will open concurrently 1371 when flushing dirty pages from the cache.</TD> 1372</TR> 1373<TR BGCOLOR="white" CLASS="TableRowColor"> 1374<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1375<CODE> void</CODE></FONT></TD> 1376<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMaxWrite(int, long)">setMaxWrite</A></B>(int maxWrite, 1377 long maxWriteSleep)</CODE> 1378 1379<BR> 1380 Limit the number of sequential write operations scheduled by the 1381 library when flushing dirty pages from the cache.</TD> 1382</TR> 1383<TR BGCOLOR="white" CLASS="TableRowColor"> 1384<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1385<CODE> void</CODE></FONT></TD> 1386<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMessageHandler(com.sleepycat.db.MessageHandler)">setMessageHandler</A></B>(<A HREF="../../../com/sleepycat/db/MessageHandler.html" title="interface in com.sleepycat.db">MessageHandler</A> messageHandler)</CODE> 1387 1388<BR> 1389 Set a function to be called with an informational message.</TD> 1390</TR> 1391<TR BGCOLOR="white" CLASS="TableRowColor"> 1392<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1393<CODE> void</CODE></FONT></TD> 1394<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMessageStream(java.io.OutputStream)">setMessageStream</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/OutputStream.html" title="class or interface in java.io">OutputStream</A> messageStream)</CODE> 1395 1396<BR> 1397 Set an OutputStream for displaying informational messages.</TD> 1398</TR> 1399<TR BGCOLOR="white" CLASS="TableRowColor"> 1400<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1401<CODE> void</CODE></FONT></TD> 1402<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMMapSize(long)">setMMapSize</A></B>(long mmapSize)</CODE> 1403 1404<BR> 1405 Set the maximum file size, in bytes, for a file to be mapped into 1406 the process address space.</TD> 1407</TR> 1408<TR BGCOLOR="white" CLASS="TableRowColor"> 1409<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1410<CODE> void</CODE></FONT></TD> 1411<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMode(int)">setMode</A></B>(int mode)</CODE> 1412 1413<BR> 1414 Configure the database environment to use a specific mode when 1415 creating underlying files and shared memory segments.</TD> 1416</TR> 1417<TR BGCOLOR="white" CLASS="TableRowColor"> 1418<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1419<CODE> void</CODE></FONT></TD> 1420<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMultiversion(boolean)">setMultiversion</A></B>(boolean multiversion)</CODE> 1421 1422<BR> 1423 Configure the database environment to open all databases that are not 1424 using the queue access method for multiversion concurrency control.</TD> 1425</TR> 1426<TR BGCOLOR="white" CLASS="TableRowColor"> 1427<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1428<CODE> void</CODE></FONT></TD> 1429<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMutexAlignment(int)">setMutexAlignment</A></B>(int mutexAlignment)</CODE> 1430 1431<BR> 1432 Set the mutex alignment, in bytes.</TD> 1433</TR> 1434<TR BGCOLOR="white" CLASS="TableRowColor"> 1435<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1436<CODE> void</CODE></FONT></TD> 1437<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMutexIncrement(int)">setMutexIncrement</A></B>(int mutexIncrement)</CODE> 1438 1439<BR> 1440 Increase the number of mutexes to allocate.</TD> 1441</TR> 1442<TR BGCOLOR="white" CLASS="TableRowColor"> 1443<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1444<CODE> void</CODE></FONT></TD> 1445<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMutexTestAndSetSpins(int)">setMutexTestAndSetSpins</A></B>(int mutexTestAndSetSpins)</CODE> 1446 1447<BR> 1448 Specify the number of times that test-and-set mutexes should spin 1449 without blocking.</TD> 1450</TR> 1451<TR BGCOLOR="white" CLASS="TableRowColor"> 1452<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1453<CODE> void</CODE></FONT></TD> 1454<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setNoLocking(boolean)">setNoLocking</A></B>(boolean noLocking)</CODE> 1455 1456<BR> 1457 Configure the system to grant all requested mutual exclusion mutexes 1458 and database locks without regard for their actual availability.</TD> 1459</TR> 1460<TR BGCOLOR="white" CLASS="TableRowColor"> 1461<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1462<CODE> void</CODE></FONT></TD> 1463<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setNoMMap(boolean)">setNoMMap</A></B>(boolean noMMap)</CODE> 1464 1465<BR> 1466 Configure the system to copy read-only database files into the local 1467 cache instead of potentially mapping them into process memory.</TD> 1468</TR> 1469<TR BGCOLOR="white" CLASS="TableRowColor"> 1470<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1471<CODE> void</CODE></FONT></TD> 1472<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setNoPanic(boolean)">setNoPanic</A></B>(boolean noPanic)</CODE> 1473 1474<BR> 1475 Configure the system to ignore any panic state in the database 1476 environment.</TD> 1477</TR> 1478<TR BGCOLOR="white" CLASS="TableRowColor"> 1479<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1480<CODE> void</CODE></FONT></TD> 1481<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setOverwrite(boolean)">setOverwrite</A></B>(boolean overwrite)</CODE> 1482 1483<BR> 1484 Configure the system to overwrite files stored in encrypted formats 1485 before deleting them.</TD> 1486</TR> 1487<TR BGCOLOR="white" CLASS="TableRowColor"> 1488<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1489<CODE> void</CODE></FONT></TD> 1490<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setPanicHandler(com.sleepycat.db.PanicHandler)">setPanicHandler</A></B>(<A HREF="../../../com/sleepycat/db/PanicHandler.html" title="interface in com.sleepycat.db">PanicHandler</A> panicHandler)</CODE> 1491 1492<BR> 1493 Set the function to be called if the database environment panics.</TD> 1494</TR> 1495<TR BGCOLOR="white" CLASS="TableRowColor"> 1496<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1497<CODE> void</CODE></FONT></TD> 1498<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setPrivate(boolean)">setPrivate</A></B>(boolean isPrivate)</CODE> 1499 1500<BR> 1501 Configure the database environment to only be accessed by a single 1502 process (although that process may be multithreaded).</TD> 1503</TR> 1504<TR BGCOLOR="white" CLASS="TableRowColor"> 1505<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1506<CODE> void</CODE></FONT></TD> 1507<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setRegister(boolean)">setRegister</A></B>(boolean register)</CODE> 1508 1509<BR> 1510 Check if a process has failed while using the database environment, that 1511 is, if a process has exited with an open <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle.</TD> 1512</TR> 1513<TR BGCOLOR="white" CLASS="TableRowColor"> 1514<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1515<CODE> void</CODE></FONT></TD> 1516<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setReplicationClockskew(int, int)">setReplicationClockskew</A></B>(int replicationClockskewFast, 1517 int replicationClockskewSlow)</CODE> 1518 1519<BR> 1520 Sets the clock skew ratio among replication group members based on the 1521 fastest and slowest measurements among the group for use with master leases.</TD> 1522</TR> 1523<TR BGCOLOR="white" CLASS="TableRowColor"> 1524<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1525<CODE> void</CODE></FONT></TD> 1526<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setReplicationLimit(long)">setReplicationLimit</A></B>(long replicationLimit)</CODE> 1527 1528<BR> 1529 Impose a byte-count limit on the amount of data that will be 1530 transmitted from a site in a single call to <A HREF="../../../com/sleepycat/db/Environment.html#processReplicationMessage(com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, int)"><CODE>Environment.processReplicationMessage</CODE></A>.</TD> 1531</TR> 1532<TR BGCOLOR="white" CLASS="TableRowColor"> 1533<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1534<CODE> void</CODE></FONT></TD> 1535<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setReplicationManagerAckPolicy(com.sleepycat.db.ReplicationManagerAckPolicy)">setReplicationManagerAckPolicy</A></B>(<A HREF="../../../com/sleepycat/db/ReplicationManagerAckPolicy.html" title="class in com.sleepycat.db">ReplicationManagerAckPolicy</A> repmgrAckPolicy)</CODE> 1536 1537<BR> 1538 Set the network Ack policy used by the replication manager.</TD> 1539</TR> 1540<TR BGCOLOR="white" CLASS="TableRowColor"> 1541<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1542<CODE> void</CODE></FONT></TD> 1543<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setReplicationManagerLocalSite(com.sleepycat.db.ReplicationHostAddress)">setReplicationManagerLocalSite</A></B>(<A HREF="../../../com/sleepycat/db/ReplicationHostAddress.html" title="class in com.sleepycat.db">ReplicationHostAddress</A> repmgrLocalSiteAddr)</CODE> 1544 1545<BR> 1546 Set the address of the local (this) site in a replication group.</TD> 1547</TR> 1548<TR BGCOLOR="white" CLASS="TableRowColor"> 1549<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1550<CODE> void</CODE></FONT></TD> 1551<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setReplicationNumSites(int)">setReplicationNumSites</A></B>(int replicationNumSites)</CODE> 1552 1553<BR> 1554 Set the total number of sites in the replication group.</TD> 1555</TR> 1556<TR BGCOLOR="white" CLASS="TableRowColor"> 1557<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1558<CODE> void</CODE></FONT></TD> 1559<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setReplicationPriority(int)">setReplicationPriority</A></B>(int replicationPriority)</CODE> 1560 1561<BR> 1562 Set the current environment's priority.</TD> 1563</TR> 1564<TR BGCOLOR="white" CLASS="TableRowColor"> 1565<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1566<CODE> void</CODE></FONT></TD> 1567<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setReplicationRequestMax(int)">setReplicationRequestMax</A></B>(int replicationRequestMax)</CODE> 1568 1569<BR> 1570 Set a threshold for the maximum time that a client waits before requesting 1571 retransmission of a missing message.</TD> 1572</TR> 1573<TR BGCOLOR="white" CLASS="TableRowColor"> 1574<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1575<CODE> void</CODE></FONT></TD> 1576<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setReplicationRequestMin(int)">setReplicationRequestMin</A></B>(int replicationRequestMin)</CODE> 1577 1578<BR> 1579 Set a threshold for the minimum time that a client waits before requesting 1580 retransmission of a missing message.</TD> 1581</TR> 1582<TR BGCOLOR="white" CLASS="TableRowColor"> 1583<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1584<CODE> void</CODE></FONT></TD> 1585<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setReplicationTransport(int, com.sleepycat.db.ReplicationTransport)">setReplicationTransport</A></B>(int envid, 1586 <A HREF="../../../com/sleepycat/db/ReplicationTransport.html" title="interface in com.sleepycat.db">ReplicationTransport</A> replicationTransport)</CODE> 1587 1588<BR> 1589 Initialize the communication infrastructure for a database environment 1590 participating in a replicated application.</TD> 1591</TR> 1592<TR BGCOLOR="white" CLASS="TableRowColor"> 1593<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1594<CODE> void</CODE></FONT></TD> 1595<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setRPCServer(java.lang.String, long, long)">setRPCServer</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> rpcServer, 1596 long rpcClientTimeout, 1597 long rpcServerTimeout)</CODE> 1598 1599<BR> 1600 Establish a connection to a RPC server for this database environment.</TD> 1601</TR> 1602<TR BGCOLOR="white" CLASS="TableRowColor"> 1603<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1604<CODE> void</CODE></FONT></TD> 1605<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setRunFatalRecovery(boolean)">setRunFatalRecovery</A></B>(boolean runFatalRecovery)</CODE> 1606 1607<BR> 1608 Configure to run catastrophic recovery on this environment before opening it for 1609normal use.</TD> 1610</TR> 1611<TR BGCOLOR="white" CLASS="TableRowColor"> 1612<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1613<CODE> void</CODE></FONT></TD> 1614<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setRunRecovery(boolean)">setRunRecovery</A></B>(boolean runRecovery)</CODE> 1615 1616<BR> 1617 Configure to run normal recovery on this environment before opening it for 1618normal use.</TD> 1619</TR> 1620<TR BGCOLOR="white" CLASS="TableRowColor"> 1621<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1622<CODE> void</CODE></FONT></TD> 1623<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setSegmentId(long)">setSegmentId</A></B>(long segmentId)</CODE> 1624 1625<BR> 1626 Specify a base segment ID for database environment shared memory 1627 regions created in system memory on VxWorks or systems supporting 1628 X/Open-style shared memory interfaces; for example, UNIX systems 1629 supporting <code>shmget</code> and related System V IPC interfaces.</TD> 1630</TR> 1631<TR BGCOLOR="white" CLASS="TableRowColor"> 1632<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1633<CODE> void</CODE></FONT></TD> 1634<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setSystemMemory(boolean)">setSystemMemory</A></B>(boolean systemMemory)</CODE> 1635 1636<BR> 1637 Configure the database environment to allocate memory from system 1638 shared memory instead of from memory backed by the filesystem.</TD> 1639</TR> 1640<TR BGCOLOR="white" CLASS="TableRowColor"> 1641<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1642<CODE> void</CODE></FONT></TD> 1643<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTemporaryDirectory(java.io.File)">setTemporaryDirectory</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/File.html" title="class or interface in java.io">File</A> temporaryDirectory)</CODE> 1644 1645<BR> 1646 Set the path of a directory to be used as the location of temporary 1647 files.</TD> 1648</TR> 1649<TR BGCOLOR="white" CLASS="TableRowColor"> 1650<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1651<CODE> void</CODE></FONT></TD> 1652<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTemporaryDirectory(java.lang.String)">setTemporaryDirectory</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> temporaryDirectory)</CODE> 1653 1654<BR> 1655 <B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTemporaryDirectory(java.io.File)"><CODE>setTemporaryDirectory(java.io.File)</CODE></A></I></TD> 1656</TR> 1657<TR BGCOLOR="white" CLASS="TableRowColor"> 1658<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1659<CODE> void</CODE></FONT></TD> 1660<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTestAndSetSpins(int)">setTestAndSetSpins</A></B>(int mutexTestAndSetSpins)</CODE> 1661 1662<BR> 1663 <B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMutexTestAndSetSpins(int)"><CODE>setMutexTestAndSetSpins(int)</CODE></A></I></TD> 1664</TR> 1665<TR BGCOLOR="white" CLASS="TableRowColor"> 1666<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1667<CODE> void</CODE></FONT></TD> 1668<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setThreaded(boolean)">setThreaded</A></B>(boolean threaded)</CODE> 1669 1670<BR> 1671 Configure the handle to be <em>free-threaded</em>; that is, usable 1672 by multiple threads within a single address space.</TD> 1673</TR> 1674<TR BGCOLOR="white" CLASS="TableRowColor"> 1675<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1676<CODE> void</CODE></FONT></TD> 1677<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTransactional(boolean)">setTransactional</A></B>(boolean transactional)</CODE> 1678 1679<BR> 1680 Configure the database environment for transactions.</TD> 1681</TR> 1682<TR BGCOLOR="white" CLASS="TableRowColor"> 1683<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1684<CODE> void</CODE></FONT></TD> 1685<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTxnMaxActive(int)">setTxnMaxActive</A></B>(int txnMaxActive)</CODE> 1686 1687<BR> 1688 Configure the database environment to support at least txnMaxActive 1689 active transactions.</TD> 1690</TR> 1691<TR BGCOLOR="white" CLASS="TableRowColor"> 1692<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1693<CODE> void</CODE></FONT></TD> 1694<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTxnNoSync(boolean)">setTxnNoSync</A></B>(boolean txnNoSync)</CODE> 1695 1696<BR> 1697 Configure the system to not write or synchronously flush the log 1698 on transaction commit.</TD> 1699</TR> 1700<TR BGCOLOR="white" CLASS="TableRowColor"> 1701<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1702<CODE> void</CODE></FONT></TD> 1703<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTxnNotDurable(boolean)">setTxnNotDurable</A></B>(boolean txnNotDurable)</CODE> 1704 1705<BR> 1706 Configure the system to not write log records.</TD> 1707</TR> 1708<TR BGCOLOR="white" CLASS="TableRowColor"> 1709<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1710<CODE> void</CODE></FONT></TD> 1711<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTxnNoWait(boolean)">setTxnNoWait</A></B>(boolean txnNoWait)</CODE> 1712 1713<BR> 1714 If a lock is unavailable for any Berkeley DB operation performed in the 1715 context of a transaction, cause the operation to throw <A HREF="../../../com/sleepycat/db/LockNotGrantedException.html" title="class in com.sleepycat.db"><CODE>LockNotGrantedException</CODE></A> without waiting for the lock.</TD> 1716</TR> 1717<TR BGCOLOR="white" CLASS="TableRowColor"> 1718<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1719<CODE> void</CODE></FONT></TD> 1720<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTxnSnapshot(boolean)">setTxnSnapshot</A></B>(boolean txnSnapshot)</CODE> 1721 1722<BR> 1723 Configure the database environment to run transactions at snapshot 1724 isolation by default.</TD> 1725</TR> 1726<TR BGCOLOR="white" CLASS="TableRowColor"> 1727<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1728<CODE> void</CODE></FONT></TD> 1729<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTxnTimeout(long)">setTxnTimeout</A></B>(long txnTimeout)</CODE> 1730 1731<BR> 1732 Set the timeout value for the database environment 1733transactions.</TD> 1734</TR> 1735<TR BGCOLOR="white" CLASS="TableRowColor"> 1736<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1737<CODE> void</CODE></FONT></TD> 1738<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTxnTimestamp(java.util.Date)">setTxnTimestamp</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Date.html" title="class or interface in java.util">Date</A> txnTimestamp)</CODE> 1739 1740<BR> 1741 Recover to the specified time rather than to the most current 1742 possible date.</TD> 1743</TR> 1744<TR BGCOLOR="white" CLASS="TableRowColor"> 1745<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1746<CODE> void</CODE></FONT></TD> 1747<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTxnWriteNoSync(boolean)">setTxnWriteNoSync</A></B>(boolean txnWriteNoSync)</CODE> 1748 1749<BR> 1750 Configure the system to write, but not synchronously flush, the log on 1751 transaction commit.</TD> 1752</TR> 1753<TR BGCOLOR="white" CLASS="TableRowColor"> 1754<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1755<CODE> void</CODE></FONT></TD> 1756<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setUseEnvironment(boolean)">setUseEnvironment</A></B>(boolean useEnvironment)</CODE> 1757 1758<BR> 1759 Configure the database environment to accept information from the 1760 process environment when naming files, regardless of the status of 1761 the process.</TD> 1762</TR> 1763<TR BGCOLOR="white" CLASS="TableRowColor"> 1764<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1765<CODE> void</CODE></FONT></TD> 1766<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setUseEnvironmentRoot(boolean)">setUseEnvironmentRoot</A></B>(boolean useEnvironmentRoot)</CODE> 1767 1768<BR> 1769 Configure the database environment to accept information from the 1770 process environment when naming files, if the process has 1771 appropriate permissions (for example, users with a user-ID of 0 on 1772 UNIX systems).</TD> 1773</TR> 1774<TR BGCOLOR="white" CLASS="TableRowColor"> 1775<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1776<CODE> void</CODE></FONT></TD> 1777<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerbose(com.sleepycat.db.VerboseConfig, boolean)">setVerbose</A></B>(<A HREF="../../../com/sleepycat/db/VerboseConfig.html" title="class in com.sleepycat.db">VerboseConfig</A> flag, 1778 boolean enable)</CODE> 1779 1780<BR> 1781 Display verbose information.</TD> 1782</TR> 1783<TR BGCOLOR="white" CLASS="TableRowColor"> 1784<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1785<CODE> void</CODE></FONT></TD> 1786<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerboseDeadlock(boolean)">setVerboseDeadlock</A></B>(boolean verboseDeadlock)</CODE> 1787 1788<BR> 1789 <B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerbose(com.sleepycat.db.VerboseConfig, boolean)"><CODE>setVerbose(com.sleepycat.db.VerboseConfig, boolean)</CODE></A></I></TD> 1790</TR> 1791<TR BGCOLOR="white" CLASS="TableRowColor"> 1792<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1793<CODE> void</CODE></FONT></TD> 1794<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerboseRecovery(boolean)">setVerboseRecovery</A></B>(boolean verboseRecovery)</CODE> 1795 1796<BR> 1797 <B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerbose(com.sleepycat.db.VerboseConfig, boolean)"><CODE>setVerbose(com.sleepycat.db.VerboseConfig, boolean)</CODE></A></I></TD> 1798</TR> 1799<TR BGCOLOR="white" CLASS="TableRowColor"> 1800<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1801<CODE> void</CODE></FONT></TD> 1802<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerboseRegister(boolean)">setVerboseRegister</A></B>(boolean verboseRegister)</CODE> 1803 1804<BR> 1805 <B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerbose(com.sleepycat.db.VerboseConfig, boolean)"><CODE>setVerbose(com.sleepycat.db.VerboseConfig, boolean)</CODE></A></I></TD> 1806</TR> 1807<TR BGCOLOR="white" CLASS="TableRowColor"> 1808<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1809<CODE> void</CODE></FONT></TD> 1810<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerboseReplication(boolean)">setVerboseReplication</A></B>(boolean verboseReplication)</CODE> 1811 1812<BR> 1813 <B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerbose(com.sleepycat.db.VerboseConfig, boolean)"><CODE>setVerbose(com.sleepycat.db.VerboseConfig, boolean)</CODE></A></I></TD> 1814</TR> 1815<TR BGCOLOR="white" CLASS="TableRowColor"> 1816<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1817<CODE> void</CODE></FONT></TD> 1818<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerboseWaitsFor(boolean)">setVerboseWaitsFor</A></B>(boolean verboseWaitsFor)</CODE> 1819 1820<BR> 1821 <B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerbose(com.sleepycat.db.VerboseConfig, boolean)"><CODE>setVerbose(com.sleepycat.db.VerboseConfig, boolean)</CODE></A></I></TD> 1822</TR> 1823<TR BGCOLOR="white" CLASS="TableRowColor"> 1824<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 1825<CODE> void</CODE></FONT></TD> 1826<TD><CODE><B><A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setYieldCPU(boolean)">setYieldCPU</A></B>(boolean yieldCPU)</CODE> 1827 1828<BR> 1829 Configure the system to yield the processor immediately after each 1830 page or mutex acquisition.</TD> 1831</TR> 1832</TABLE> 1833 <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A> 1834<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 1835<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> 1836<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TH> 1837</TR> 1838<TR BGCOLOR="white" CLASS="TableRowColor"> 1839<TD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD> 1840</TR> 1841</TABLE> 1842 1843<P> 1844 1845<!-- ============ FIELD DETAIL =========== --> 1846 1847<A NAME="field_detail"><!-- --></A> 1848<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 1849<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 1850<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> 1851<B>Field Detail</B></FONT></TH> 1852</TR> 1853</TABLE> 1854 1855<A NAME="DEFAULT"><!-- --></A><H3> 1856DEFAULT</H3> 1857<PRE> 1858public static final <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html" title="class in com.sleepycat.db">EnvironmentConfig</A> <B>DEFAULT</B></PRE> 1859<DL> 1860<DL> 1861</DL> 1862</DL> 1863 1864<!-- ========= CONSTRUCTOR DETAIL ======== --> 1865 1866<A NAME="constructor_detail"><!-- --></A> 1867<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 1868<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 1869<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> 1870<B>Constructor Detail</B></FONT></TH> 1871</TR> 1872</TABLE> 1873 1874<A NAME="EnvironmentConfig()"><!-- --></A><H3> 1875EnvironmentConfig</H3> 1876<PRE> 1877public <B>EnvironmentConfig</B>()</PRE> 1878<DL> 1879<DD>Create an EnvironmentConfig initialized with the system default settings. 1880<P> 1881</DL> 1882 1883<!-- ============ METHOD DETAIL ========== --> 1884 1885<A NAME="method_detail"><!-- --></A> 1886<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 1887<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 1888<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> 1889<B>Method Detail</B></FONT></TH> 1890</TR> 1891</TABLE> 1892 1893<A NAME="setAllowCreate(boolean)"><!-- --></A><H3> 1894setAllowCreate</H3> 1895<PRE> 1896public void <B>setAllowCreate</B>(boolean allowCreate)</PRE> 1897<DL> 1898<DD>Configure the database environment to create any underlying files, 1899 as necessary. 1900 <p> 1901<P> 1902<DD><DL> 1903</DL> 1904</DD> 1905<DD><DL> 1906<DT><B>Parameters:</B><DD><CODE>allowCreate</CODE> - If true, configure the database environment to create any underlying 1907 files, as necessary.</DL> 1908</DD> 1909</DL> 1910<HR> 1911 1912<A NAME="getAllowCreate()"><!-- --></A><H3> 1913getAllowCreate</H3> 1914<PRE> 1915public boolean <B>getAllowCreate</B>()</PRE> 1916<DL> 1917<DD>Return true if the database environment is configured to create any 1918 underlying files, as necessary. 1919<p> 1920This method may be called at any time during the life of the application. 1921<p> 1922<P> 1923<DD><DL> 1924</DL> 1925</DD> 1926<DD><DL> 1927 1928<DT><B>Returns:</B><DD>True if the database environment is configured to create any 1929 underlying files, as necessary.</DL> 1930</DD> 1931</DL> 1932<HR> 1933 1934<A NAME="setCacheSize(long)"><!-- --></A><H3> 1935setCacheSize</H3> 1936<PRE> 1937public void <B>setCacheSize</B>(long cacheSize)</PRE> 1938<DL> 1939<DD>Set the size of the shared memory buffer pool, that is, the size of the 1940cache. 1941<p> 1942The cache should be the size of the normal working data set of the 1943application, with some small amount of additional memory for unusual 1944situations. (Note: the working set is not the same as the number of 1945pages accessed simultaneously, and is usually much larger.) 1946<p> 1947The default cache size is 256KB, and may not be specified as less than 194820KB. Any cache size less than 500MB is automatically increased by 25% 1949to account for buffer pool overhead; cache sizes larger than 500MB are 1950used as specified. The current maximum size of a single cache is 4GB. 1951(All sizes are in powers-of-two, that is, 256KB is 2^18 not 256,000.) 1952<p> 1953The database environment's cache size may also be set using the environment's 1954DB_CONFIG file. The syntax of the entry in that file is a single line 1955with the string "set_cachesize", one or more whitespace characters, and the cache size specified in three parts: the gigabytes of cache, the 1956additional bytes of cache, and the number of caches, also separated by 1957whitespace characters. For example, "set_cachesize 2 524288000 3" would 1958create a 2.5GB logical cache, split between three physical caches. 1959Because the DB_CONFIG file is read when the database environment is 1960opened, it will silently overrule configuration done before that time. 1961<p> 1962This method configures a database environment, including all threads 1963of control accessing the database environment, not only the operations 1964performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 1965<p> 1966This method may not be called after the 1967environment has been opened. 1968If joining an existing database environment, any 1969information specified to this method will be ignored. 1970<p> 1971This method may be called at any time during the life of the application. 1972<p> 1973<P> 1974<DD><DL> 1975</DL> 1976</DD> 1977<DD><DL> 1978<DT><B>Parameters:</B><DD><CODE>cacheSize</CODE> - The size of the shared memory buffer pool, that is, the size of the 1979cache. 1980<p> 1981<p> 1982<DT><B>Throws:</B> 1983<DD><CODE><A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</A></CODE> - if a failure occurs.</DL> 1984</DD> 1985</DL> 1986<HR> 1987 1988<A NAME="getCacheSize()"><!-- --></A><H3> 1989getCacheSize</H3> 1990<PRE> 1991public long <B>getCacheSize</B>()</PRE> 1992<DL> 1993<DD>Return the size of the shared memory buffer pool, that is, the cache. 1994<p> 1995This method may be called at any time during the life of the application. 1996<p> 1997<P> 1998<DD><DL> 1999</DL> 2000</DD> 2001<DD><DL> 2002 2003<DT><B>Returns:</B><DD>The size of the shared memory buffer pool, that is, the cache.</DL> 2004</DD> 2005</DL> 2006<HR> 2007 2008<A NAME="setCacheMax(long)"><!-- --></A><H3> 2009setCacheMax</H3> 2010<PRE> 2011public void <B>setCacheMax</B>(long cacheMax)</PRE> 2012<DL> 2013<DD>Set the maximum cache size in bytes. The specified size is rounded to the 2014 nearest multiple of the cache region size, which is the initial cache size 2015 divded by the number of regions specified to <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setCacheCount(int)"><CODE>setCacheCount(int)</CODE></A>. If no 2016 value is specified, it defaults to the initial cache size. 2017<P> 2018<DD><DL> 2019</DL> 2020</DD> 2021<DD><DL> 2022</DL> 2023</DD> 2024</DL> 2025<HR> 2026 2027<A NAME="getCacheMax()"><!-- --></A><H3> 2028getCacheMax</H3> 2029<PRE> 2030public long <B>getCacheMax</B>()</PRE> 2031<DL> 2032<DD>Return the maximum size of the cache. 2033<p> 2034This method may be called at any time during the life of the application. 2035<p> 2036<P> 2037<DD><DL> 2038</DL> 2039</DD> 2040<DD><DL> 2041 2042<DT><B>Returns:</B><DD>The maximum size of the cache.</DL> 2043</DD> 2044</DL> 2045<HR> 2046 2047<A NAME="setCacheCount(int)"><!-- --></A><H3> 2048setCacheCount</H3> 2049<PRE> 2050public void <B>setCacheCount</B>(int cacheCount)</PRE> 2051<DL> 2052<DD>Set the number of shared memory buffer pools, that is, the number of 2053caches. 2054<p> 2055It is possible to specify caches larger than 4GB and/or large enough 2056they cannot be allocated contiguously on some architectures. For 2057example, some releases of Solaris limit the amount of memory that may 2058be allocated contiguously by a process. This method allows applications 2059to break the cache broken up into a number of equally sized, separate 2060pieces of memory. 2061<p> 2062<p> 2063The database environment's cache size may also be set using the environment's 2064DB_CONFIG file. The syntax of the entry in that file is a single line 2065with the string "set_cachesize", one or more whitespace characters, and the cache size specified in three parts: the gigabytes of cache, the 2066additional bytes of cache, and the number of caches, also separated by 2067whitespace characters. For example, "set_cachesize 2 524288000 3" would 2068create a 2.5GB logical cache, split between three physical caches. 2069Because the DB_CONFIG file is read when the database environment is 2070opened, it will silently overrule configuration done before that time. 2071<p> 2072This method configures a database environment, including all threads 2073of control accessing the database environment, not only the operations 2074performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 2075<p> 2076This method may not be called after the 2077environment has been opened. 2078If joining an existing database environment, any 2079information specified to this method will be ignored. 2080<p> 2081This method may be called at any time during the life of the application. 2082<p> 2083<P> 2084<DD><DL> 2085</DL> 2086</DD> 2087<DD><DL> 2088<DT><B>Parameters:</B><DD><CODE>cacheCount</CODE> - The number of shared memory buffer pools, that is, the number of caches. 2089<p> 2090<p> 2091<DT><B>Throws:</B> 2092<DD><CODE><A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</A></CODE> - if a failure occurs.</DL> 2093</DD> 2094</DL> 2095<HR> 2096 2097<A NAME="getCacheCount()"><!-- --></A><H3> 2098getCacheCount</H3> 2099<PRE> 2100public int <B>getCacheCount</B>()</PRE> 2101<DL> 2102<DD>Return the number of shared memory buffer pools, that is, the number 2103 of cache regions. 2104<p> 2105This method may be called at any time during the life of the application. 2106<p> 2107<P> 2108<DD><DL> 2109</DL> 2110</DD> 2111<DD><DL> 2112 2113<DT><B>Returns:</B><DD>The number of shared memory buffer pools, that is, the number 2114 of cache regions.</DL> 2115</DD> 2116</DL> 2117<HR> 2118 2119<A NAME="setCDBLockAllDatabases(boolean)"><!-- --></A><H3> 2120setCDBLockAllDatabases</H3> 2121<PRE> 2122public void <B>setCDBLockAllDatabases</B>(boolean cdbLockAllDatabases)</PRE> 2123<DL> 2124<DD>Configure Concurrent Data Store applications to perform locking on 2125 an environment-wide basis rather than on a per-database basis. 2126 <p> 2127 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 2128any other library handles opened within the scope of that handle). 2129For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> 2130handles opened in the database environment must either call this method 2131or the configuration should be specified in the database environment's 2132DB_CONFIG configuration file. 2133 <p> 2134 This method may not be called after the 2135environment has been opened. 2136 <p> 2137<P> 2138<DD><DL> 2139</DL> 2140</DD> 2141<DD><DL> 2142<DT><B>Parameters:</B><DD><CODE>cdbLockAllDatabases</CODE> - If true, configure Concurrent Data Store applications to perform 2143 locking on an environment-wide basis rather than on a per-database 2144 basis.</DL> 2145</DD> 2146</DL> 2147<HR> 2148 2149<A NAME="getCDBLockAllDatabases()"><!-- --></A><H3> 2150getCDBLockAllDatabases</H3> 2151<PRE> 2152public boolean <B>getCDBLockAllDatabases</B>()</PRE> 2153<DL> 2154<DD>Return true if the Concurrent Data Store applications are configured to 2155 perform locking on an environment-wide basis rather than on a 2156 per-database basis. 2157<p> 2158This method may be called at any time during the life of the application. 2159<p> 2160<P> 2161<DD><DL> 2162</DL> 2163</DD> 2164<DD><DL> 2165 2166<DT><B>Returns:</B><DD>True if the Concurrent Data Store applications are configured to 2167 perform locking on an environment-wide basis rather than on a 2168 per-database basis.</DL> 2169</DD> 2170</DL> 2171<HR> 2172 2173<A NAME="addDataDir(java.io.File)"><!-- --></A><H3> 2174addDataDir</H3> 2175<PRE> 2176public void <B>addDataDir</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/File.html" title="class or interface in java.io">File</A> dataDir)</PRE> 2177<DL> 2178<DD>Set the path of a directory to be used as the location of the access 2179 method database files. 2180 <p> 2181 Paths specified to <A HREF="../../../com/sleepycat/db/Environment.html#openDatabase(com.sleepycat.db.Transaction, java.lang.String, java.lang.String, com.sleepycat.db.DatabaseConfig)"><CODE>Environment.openDatabase</CODE></A> and 2182 <A HREF="../../../com/sleepycat/db/Environment.html#openSecondaryDatabase(com.sleepycat.db.Transaction, java.lang.String, java.lang.String, com.sleepycat.db.Database, com.sleepycat.db.SecondaryConfig)"><CODE>Environment.openSecondaryDatabase</CODE></A> will be searched 2183 relative to this path. Paths set using this method are additive, and 2184 specifying more than one will result in each specified directory 2185 being searched for database files. If any directories are 2186 specified, created database files will always be created in the 2187 first path specified. 2188 <p> 2189 If no database directories are specified, database files must be named 2190 either by absolute paths or relative to the environment home directory. 2191 <p> 2192 The database environment's data directories may also be set using the environment's 2193DB_CONFIG file. The syntax of the entry in that file is a single line 2194with the string "set_data_dir", one or more whitespace characters, and the directory name. 2195 <p> 2196 This method configures only operations performed using a single a 2197<A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle, not an entire database environment. 2198 <p> 2199 This method may not be called after the 2200environment has been opened. 2201If joining an existing database environment, the 2202information specified to this method must be consistent with the 2203existing environment or corruption can occur. 2204 <p> 2205<P> 2206<DD><DL> 2207</DL> 2208</DD> 2209<DD><DL> 2210<DT><B>Parameters:</B><DD><CODE>dataDir</CODE> - A directory to be used as a location for database files. 2211 On Windows platforms, this argument will be interpreted as a UTF-8 2212string, which is equivalent to ASCII for Latin characters.</DL> 2213</DD> 2214</DL> 2215<HR> 2216 2217<A NAME="addDataDir(java.lang.String)"><!-- --></A><H3> 2218addDataDir</H3> 2219<PRE> 2220public void <B>addDataDir</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> dataDir)</PRE> 2221<DL> 2222<DD><B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#addDataDir(java.io.File)"><CODE>addDataDir(java.io.File)</CODE></A></I> 2223<P> 2224<DD><DL> 2225</DL> 2226</DD> 2227<DD><DL> 2228</DL> 2229</DD> 2230</DL> 2231<HR> 2232 2233<A NAME="getDataDirs()"><!-- --></A><H3> 2234getDataDirs</H3> 2235<PRE> 2236public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/File.html" title="class or interface in java.io">File</A>[] <B>getDataDirs</B>()</PRE> 2237<DL> 2238<DD>Return the array of data directories. 2239<p> 2240This method may be called at any time during the life of the application. 2241<p> 2242<P> 2243<DD><DL> 2244</DL> 2245</DD> 2246<DD><DL> 2247 2248<DT><B>Returns:</B><DD>The array of data directories.</DL> 2249</DD> 2250</DL> 2251<HR> 2252 2253<A NAME="setDirectDatabaseIO(boolean)"><!-- --></A><H3> 2254setDirectDatabaseIO</H3> 2255<PRE> 2256public void <B>setDirectDatabaseIO</B>(boolean directDatabaseIO)</PRE> 2257<DL> 2258<DD>Configure the database environment to not buffer database files. 2259 <p> 2260 This is intended to avoid to avoid double caching. 2261 <p> 2262 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 2263any other library handles opened within the scope of that handle). 2264For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> 2265handles opened in the database environment must either call this method 2266or the configuration should be specified in the database environment's 2267DB_CONFIG configuration file. 2268 <p> 2269 This method may be called at any time during the life of the application. 2270 <p> 2271<P> 2272<DD><DL> 2273</DL> 2274</DD> 2275<DD><DL> 2276<DT><B>Parameters:</B><DD><CODE>directDatabaseIO</CODE> - If true, configure the database environment to not buffer database files.</DL> 2277</DD> 2278</DL> 2279<HR> 2280 2281<A NAME="getDirectDatabaseIO()"><!-- --></A><H3> 2282getDirectDatabaseIO</H3> 2283<PRE> 2284public boolean <B>getDirectDatabaseIO</B>()</PRE> 2285<DL> 2286<DD>Return true if the database environment has been configured to not buffer 2287 database files. 2288<p> 2289This method may be called at any time during the life of the application. 2290<p> 2291<P> 2292<DD><DL> 2293</DL> 2294</DD> 2295<DD><DL> 2296 2297<DT><B>Returns:</B><DD>True if the database environment has been configured to not buffer 2298 database files.</DL> 2299</DD> 2300</DL> 2301<HR> 2302 2303<A NAME="setDirectLogIO(boolean)"><!-- --></A><H3> 2304setDirectLogIO</H3> 2305<PRE> 2306public void <B>setDirectLogIO</B>(boolean directLogIO)</PRE> 2307<DL> 2308<DD>Configure the database environment to not buffer log files. 2309 <p> 2310 This is intended to avoid to avoid double caching. 2311 <p> 2312 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 2313any other library handles opened within the scope of that handle). 2314For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> 2315handles opened in the database environment must either call this method 2316or the configuration should be specified in the database environment's 2317DB_CONFIG configuration file. 2318 <p> 2319 This method may be called at any time during the life of the application. 2320 <p> 2321<P> 2322<DD><DL> 2323</DL> 2324</DD> 2325<DD><DL> 2326<DT><B>Parameters:</B><DD><CODE>directLogIO</CODE> - If true, configure the database environment to not buffer log files.</DL> 2327</DD> 2328</DL> 2329<HR> 2330 2331<A NAME="getDirectLogIO()"><!-- --></A><H3> 2332getDirectLogIO</H3> 2333<PRE> 2334public boolean <B>getDirectLogIO</B>()</PRE> 2335<DL> 2336<DD>Return true if the database environment has been configured to not buffer 2337 log files. 2338<p> 2339This method may be called at any time during the life of the application. 2340<p> 2341<P> 2342<DD><DL> 2343</DL> 2344</DD> 2345<DD><DL> 2346 2347<DT><B>Returns:</B><DD>True if the database environment has been configured to not buffer 2348 log files.</DL> 2349</DD> 2350</DL> 2351<HR> 2352 2353<A NAME="setDsyncDatabases(boolean)"><!-- --></A><H3> 2354setDsyncDatabases</H3> 2355<PRE> 2356public void <B>setDsyncDatabases</B>(boolean dsyncDatabases)</PRE> 2357<DL> 2358<DD>Configure the database environment to flush database writes to the backing 2359 disk before returning from the write system call, rather than flushing 2360 database writes explicitly in a separate system call, as necessary. 2361 <p> 2362 This is only available on some systems (for example, systems supporting the 2363 m4_posix1_name standard O_DSYNC flag, or systems supporting the Win32 2364 FILE_FLAG_WRITE_THROUGH flag). This flag may result in inaccurate file 2365 modification times and other file-level information for Berkeley DB database 2366 files. This flag will almost certainly result in a performance decrease on 2367 most systems. This flag is only applicable to certain filesysystem (for 2368 example, the Veritas VxFS filesystem), where the filesystem's support for 2369 trickling writes back to stable storage behaves badly (or more likely, has 2370 been misconfigured). 2371 <p> 2372 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 2373any other library handles opened within the scope of that handle). 2374For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> 2375handles opened in the database environment must either call this method 2376or the configuration should be specified in the database environment's 2377DB_CONFIG configuration file. 2378 <p> 2379 This method may be called at any time during the life of the application. 2380 <p> 2381<P> 2382<DD><DL> 2383</DL> 2384</DD> 2385<DD><DL> 2386<DT><B>Parameters:</B><DD><CODE>dsyncDatabases</CODE> - If true, configure the database environment to flush database writes to the 2387 backing disk before returning from the write system call, rather than 2388 flushing log writes explicitly in a separate system call.</DL> 2389</DD> 2390</DL> 2391<HR> 2392 2393<A NAME="getDsyncDatabases()"><!-- --></A><H3> 2394getDsyncDatabases</H3> 2395<PRE> 2396public boolean <B>getDsyncDatabases</B>()</PRE> 2397<DL> 2398<DD>Return true if the database environment has been configured to flush database 2399 writes to the backing disk before returning from the write system call. 2400<p> 2401This method may be called at any time during the life of the application. 2402<p> 2403<P> 2404<DD><DL> 2405</DL> 2406</DD> 2407<DD><DL> 2408 2409<DT><B>Returns:</B><DD>True if the database environment has been configured to flush database 2410 writes to the backing disk before returning from the write system call.</DL> 2411</DD> 2412</DL> 2413<HR> 2414 2415<A NAME="setDsyncLog(boolean)"><!-- --></A><H3> 2416setDsyncLog</H3> 2417<PRE> 2418public void <B>setDsyncLog</B>(boolean dsyncLog)</PRE> 2419<DL> 2420<DD>Configure the database environment to flush log writes to the 2421 backing disk before returning from the write system call, rather 2422 than flushing log writes explicitly in a separate system call. 2423 <p> 2424 This configuration is only available on some systems (for example, 2425 systems supporting the POSIX standard O_DSYNC flag, or systems 2426 supporting the Win32 FILE_FLAG_WRITE_THROUGH flag). This 2427 configuration may result in inaccurate file modification times and 2428 other file-level information for Berkeley DB log files. This 2429 configuration may offer a performance increase on some systems and 2430 a performance decrease on others. 2431 <p> 2432 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 2433any other library handles opened within the scope of that handle). 2434For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> 2435handles opened in the database environment must either call this method 2436or the configuration should be specified in the database environment's 2437DB_CONFIG configuration file. 2438 <p> 2439 This method may be called at any time during the life of the application. 2440 <p> 2441<P> 2442<DD><DL> 2443</DL> 2444</DD> 2445<DD><DL> 2446<DT><B>Parameters:</B><DD><CODE>dsyncLog</CODE> - If true, configure the database environment to flush log writes to 2447 the backing disk before returning from the write system call, rather 2448 than flushing log writes explicitly in a separate system call.</DL> 2449</DD> 2450</DL> 2451<HR> 2452 2453<A NAME="getDsyncLog()"><!-- --></A><H3> 2454getDsyncLog</H3> 2455<PRE> 2456public boolean <B>getDsyncLog</B>()</PRE> 2457<DL> 2458<DD>Return true if the database environment has been configured to flush log 2459 writes to the backing disk before returning from the write system 2460 call. 2461<p> 2462This method may be called at any time during the life of the application. 2463<p> 2464<P> 2465<DD><DL> 2466</DL> 2467</DD> 2468<DD><DL> 2469 2470<DT><B>Returns:</B><DD>True if the database environment has been configured to flush log 2471 writes to the backing disk before returning from the write system 2472 call.</DL> 2473</DD> 2474</DL> 2475<HR> 2476 2477<A NAME="setEncrypted(java.lang.String)"><!-- --></A><H3> 2478setEncrypted</H3> 2479<PRE> 2480public void <B>setEncrypted</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> password)</PRE> 2481<DL> 2482<DD>Set the password used to perform encryption and decryption. 2483 <p> 2484 Berkeley DB uses the Rijndael/AES (also known as the Advanced 2485 Encryption Standard and Federal Information Processing 2486 Standard (FIPS) 197) algorithm for encryption or decryption. 2487<P> 2488<DD><DL> 2489</DL> 2490</DD> 2491<DD><DL> 2492</DL> 2493</DD> 2494</DL> 2495<HR> 2496 2497<A NAME="getEncrypted()"><!-- --></A><H3> 2498getEncrypted</H3> 2499<PRE> 2500public boolean <B>getEncrypted</B>()</PRE> 2501<DL> 2502<DD>Return the database environment has been configured to perform 2503 encryption. 2504<p> 2505This method may be called at any time during the life of the application. 2506<p> 2507<P> 2508<DD><DL> 2509</DL> 2510</DD> 2511<DD><DL> 2512 2513<DT><B>Returns:</B><DD>The database environment has been configured to perform 2514 encryption.</DL> 2515</DD> 2516</DL> 2517<HR> 2518 2519<A NAME="setErrorHandler(com.sleepycat.db.ErrorHandler)"><!-- --></A><H3> 2520setErrorHandler</H3> 2521<PRE> 2522public void <B>setErrorHandler</B>(<A HREF="../../../com/sleepycat/db/ErrorHandler.html" title="interface in com.sleepycat.db">ErrorHandler</A> errorHandler)</PRE> 2523<DL> 2524<DD>Set the function to be called if an error occurs. 2525<p> 2526When an error occurs in the Berkeley DB library, an exception is thrown. 2527In some cases, however, the error information returned to the 2528application may be insufficient to completely describe the cause of the 2529error, especially during initial application debugging. 2530<p> 2531The <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorHandler(com.sleepycat.db.ErrorHandler)"><CODE>EnvironmentConfig.setErrorHandler</CODE></A> and <A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setErrorHandler(com.sleepycat.db.ErrorHandler)"><CODE>DatabaseConfig.setErrorHandler</CODE></A> methods are used to enhance the mechanism for reporting 2532error messages to the application. In some cases, when an error occurs, 2533Berkeley DB will invoke the ErrorHandler's object error method. It is 2534up to this method to display the error message in an appropriate manner. 2535<p> 2536Alternatively, applications can use <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorStream(java.io.OutputStream)"><CODE>EnvironmentConfig.setErrorStream</CODE></A> and <A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setErrorStream(java.io.OutputStream)"><CODE>DatabaseConfig.setErrorStream</CODE></A> to 2537display the additional information via an output stream. Applications 2538should not mix these approaches. 2539<p> 2540This error-logging enhancement does not slow performance or significantly 2541increase application size, and may be run during normal operation as well 2542as during application debugging. 2543<p> 2544This method may be called at any time during the life of the application. 2545<p> 2546<P> 2547<DD><DL> 2548</DL> 2549</DD> 2550<DD><DL> 2551<DT><B>Parameters:</B><DD><CODE>errorHandler</CODE> - The function to be called if an error occurs.</DL> 2552</DD> 2553</DL> 2554<HR> 2555 2556<A NAME="getErrorHandler()"><!-- --></A><H3> 2557getErrorHandler</H3> 2558<PRE> 2559public <A HREF="../../../com/sleepycat/db/ErrorHandler.html" title="interface in com.sleepycat.db">ErrorHandler</A> <B>getErrorHandler</B>()</PRE> 2560<DL> 2561<DD>Return the function to be called if an error occurs. 2562<p> 2563This method may be called at any time during the life of the application. 2564<p> 2565<P> 2566<DD><DL> 2567</DL> 2568</DD> 2569<DD><DL> 2570 2571<DT><B>Returns:</B><DD>The function to be called if an error occurs.</DL> 2572</DD> 2573</DL> 2574<HR> 2575 2576<A NAME="setErrorPrefix(java.lang.String)"><!-- --></A><H3> 2577setErrorPrefix</H3> 2578<PRE> 2579public void <B>setErrorPrefix</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> errorPrefix)</PRE> 2580<DL> 2581<DD>Set the prefix string that appears before error messages. 2582<p> 2583This method may be called at any time during the life of the application. 2584<p> 2585<P> 2586<DD><DL> 2587</DL> 2588</DD> 2589<DD><DL> 2590<DT><B>Parameters:</B><DD><CODE>errorPrefix</CODE> - The prefix string that appears before error messages.</DL> 2591</DD> 2592</DL> 2593<HR> 2594 2595<A NAME="getErrorPrefix()"><!-- --></A><H3> 2596getErrorPrefix</H3> 2597<PRE> 2598public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getErrorPrefix</B>()</PRE> 2599<DL> 2600<DD>Return the prefix string that appears before error messages. 2601<p> 2602This method may be called at any time during the life of the application. 2603<p> 2604<P> 2605<DD><DL> 2606</DL> 2607</DD> 2608<DD><DL> 2609 2610<DT><B>Returns:</B><DD>The prefix string that appears before error messages.</DL> 2611</DD> 2612</DL> 2613<HR> 2614 2615<A NAME="setErrorStream(java.io.OutputStream)"><!-- --></A><H3> 2616setErrorStream</H3> 2617<PRE> 2618public void <B>setErrorStream</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/OutputStream.html" title="class or interface in java.io">OutputStream</A> errorStream)</PRE> 2619<DL> 2620<DD>Set an OutputStream for displaying error messages. 2621<p> 2622When an error occurs in the Berkeley DB library, an exception is thrown. 2623In some cases, however, the error information returned to the 2624application may be insufficient to completely describe the cause of the 2625error, especially during initial application debugging. 2626<p> 2627The <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorStream(java.io.OutputStream)"><CODE>EnvironmentConfig.setErrorStream</CODE></A> and 2628<A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setErrorStream(java.io.OutputStream)"><CODE>DatabaseConfig.setErrorStream</CODE></A> methods are used to enhance 2629the mechanism for reporting error messages to the application by setting 2630a OutputStream to be used for displaying additional Berkeley DB error 2631messages. In some cases, when an error occurs, Berkeley DB will output 2632an additional error message to the specified stream. 2633<p> 2634The error message will consist of the prefix string and a colon 2635("<b>:</b>") (if a prefix string was previously specified using 2636<A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorPrefix(java.lang.String)"><CODE>EnvironmentConfig.setErrorPrefix</CODE></A> or <A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setErrorPrefix(java.lang.String)"><CODE>DatabaseConfig.setErrorPrefix</CODE></A>), an error string, and a trailing newline character. 2637<p> 2638Setting errorStream to null unconfigures the interface. 2639<p> 2640Alternatively, applications can use <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setErrorHandler(com.sleepycat.db.ErrorHandler)"><CODE>EnvironmentConfig.setErrorHandler</CODE></A> and <A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setErrorHandler(com.sleepycat.db.ErrorHandler)"><CODE>DatabaseConfig.setErrorHandler</CODE></A> to capture 2641the additional error information in a way that does not use output 2642streams. Applications should not mix these approaches. 2643<p> 2644This error-logging enhancement does not slow performance or significantly 2645increase application size, and may be run during normal operation as well 2646as during application debugging. 2647<p> 2648This method may be called at any time during the life of the application. 2649<p> 2650<P> 2651<DD><DL> 2652</DL> 2653</DD> 2654<DD><DL> 2655<DT><B>Parameters:</B><DD><CODE>errorStream</CODE> - The application-specified OutputStream for error messages.</DL> 2656</DD> 2657</DL> 2658<HR> 2659 2660<A NAME="getErrorStream()"><!-- --></A><H3> 2661getErrorStream</H3> 2662<PRE> 2663public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/OutputStream.html" title="class or interface in java.io">OutputStream</A> <B>getErrorStream</B>()</PRE> 2664<DL> 2665<DD>Return the an OutputStream for displaying error messages. 2666<p> 2667This method may be called at any time during the life of the application. 2668<p> 2669<P> 2670<DD><DL> 2671</DL> 2672</DD> 2673<DD><DL> 2674 2675<DT><B>Returns:</B><DD>The an OutputStream for displaying error messages.</DL> 2676</DD> 2677</DL> 2678<HR> 2679 2680<A NAME="setEventHandler(com.sleepycat.db.EventHandler)"><!-- --></A><H3> 2681setEventHandler</H3> 2682<PRE> 2683public void <B>setEventHandler</B>(<A HREF="../../../com/sleepycat/db/EventHandler.html" title="interface in com.sleepycat.db">EventHandler</A> eventHandler)</PRE> 2684<DL> 2685<DD>Set an object whose methods are to be called when a triggered event occurs. 2686 <p> 2687<P> 2688<DD><DL> 2689</DL> 2690</DD> 2691<DD><DL> 2692<DT><B>Parameters:</B><DD><CODE>eventHandler</CODE> - An object whose methods are called when event callbacks are initiated from 2693 within Berkeley DB.</DL> 2694</DD> 2695</DL> 2696<HR> 2697 2698<A NAME="getEventHandler()"><!-- --></A><H3> 2699getEventHandler</H3> 2700<PRE> 2701public <A HREF="../../../com/sleepycat/db/EventHandler.html" title="interface in com.sleepycat.db">EventHandler</A> <B>getEventHandler</B>()</PRE> 2702<DL> 2703<DD>Return the object's methods to be called when a triggered event occurs. 2704<p> 2705This method may be called at any time during the life of the application. 2706<p> 2707<P> 2708<DD><DL> 2709</DL> 2710</DD> 2711<DD><DL> 2712 2713<DT><B>Returns:</B><DD>The object's methods to be called when a triggered event occurs.</DL> 2714</DD> 2715</DL> 2716<HR> 2717 2718<A NAME="setFeedbackHandler(com.sleepycat.db.FeedbackHandler)"><!-- --></A><H3> 2719setFeedbackHandler</H3> 2720<PRE> 2721public void <B>setFeedbackHandler</B>(<A HREF="../../../com/sleepycat/db/FeedbackHandler.html" title="interface in com.sleepycat.db">FeedbackHandler</A> feedbackHandler)</PRE> 2722<DL> 2723<DD>Set an object whose methods are called to provide feedback. 2724<p> 2725Some operations performed by the Berkeley DB library can take 2726non-trivial amounts of time. This method can be used by applications 2727to monitor progress within these operations. When an operation is 2728likely to take a long time, Berkeley DB will call the object's methods 2729with progress information. 2730<p> 2731It is up to the object's methods to display this information in an 2732appropriate manner. 2733<p> 2734This method configures only operations performed using a single a 2735<A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle 2736<p> 2737This method may be called at any time during the life of the application. 2738<p> 2739<P> 2740<DD><DL> 2741</DL> 2742</DD> 2743<DD><DL> 2744<DT><B>Parameters:</B><DD><CODE>feedbackHandler</CODE> - An object whose methods are called to provide feedback.</DL> 2745</DD> 2746</DL> 2747<HR> 2748 2749<A NAME="getFeedbackHandler()"><!-- --></A><H3> 2750getFeedbackHandler</H3> 2751<PRE> 2752public <A HREF="../../../com/sleepycat/db/FeedbackHandler.html" title="interface in com.sleepycat.db">FeedbackHandler</A> <B>getFeedbackHandler</B>()</PRE> 2753<DL> 2754<DD>Return the object's methods to be called to provide feedback. 2755<p> 2756This method may be called at any time during the life of the application. 2757<p> 2758<P> 2759<DD><DL> 2760</DL> 2761</DD> 2762<DD><DL> 2763 2764<DT><B>Returns:</B><DD>The object's methods to be called to provide feedback.</DL> 2765</DD> 2766</DL> 2767<HR> 2768 2769<A NAME="setInitializeCache(boolean)"><!-- --></A><H3> 2770setInitializeCache</H3> 2771<PRE> 2772public void <B>setInitializeCache</B>(boolean initializeCache)</PRE> 2773<DL> 2774<DD>Configure a shared memory buffer pool in the database environment. 2775 <p> 2776 This subsystem should be used whenever an application is using any 2777 Berkeley DB access method. 2778 <p> 2779<P> 2780<DD><DL> 2781</DL> 2782</DD> 2783<DD><DL> 2784<DT><B>Parameters:</B><DD><CODE>initializeCache</CODE> - If true, configure a shared memory buffer pool in the database 2785 environment.</DL> 2786</DD> 2787</DL> 2788<HR> 2789 2790<A NAME="getInitializeCache()"><!-- --></A><H3> 2791getInitializeCache</H3> 2792<PRE> 2793public boolean <B>getInitializeCache</B>()</PRE> 2794<DL> 2795<DD>Return true if the database environment is configured with a shared 2796 memory buffer pool. 2797<p> 2798This method may be called at any time during the life of the application. 2799<p> 2800<P> 2801<DD><DL> 2802</DL> 2803</DD> 2804<DD><DL> 2805 2806<DT><B>Returns:</B><DD>True if the database environment is configured with a shared 2807 memory buffer pool.</DL> 2808</DD> 2809</DL> 2810<HR> 2811 2812<A NAME="setInitializeCDB(boolean)"><!-- --></A><H3> 2813setInitializeCDB</H3> 2814<PRE> 2815public void <B>setInitializeCDB</B>(boolean initializeCDB)</PRE> 2816<DL> 2817<DD>Configure the database environment for the Concurrent Data Store 2818 product. 2819 <p> 2820 In this mode, Berkeley DB provides multiple reader/single writer access. 2821 The only other subsystem that should be specified for this handle is a 2822 cache. 2823 <p> 2824<P> 2825<DD><DL> 2826</DL> 2827</DD> 2828<DD><DL> 2829<DT><B>Parameters:</B><DD><CODE>initializeCDB</CODE> - If true, configure the database environment for the Concurrent Data 2830 Store product.</DL> 2831</DD> 2832</DL> 2833<HR> 2834 2835<A NAME="getInitializeCDB()"><!-- --></A><H3> 2836getInitializeCDB</H3> 2837<PRE> 2838public boolean <B>getInitializeCDB</B>()</PRE> 2839<DL> 2840<DD>Return true if the database environment is configured for the Concurrent 2841 Data Store product. 2842<p> 2843This method may be called at any time during the life of the application. 2844<p> 2845<P> 2846<DD><DL> 2847</DL> 2848</DD> 2849<DD><DL> 2850 2851<DT><B>Returns:</B><DD>True if the database environment is configured for the Concurrent 2852 Data Store product.</DL> 2853</DD> 2854</DL> 2855<HR> 2856 2857<A NAME="setInitializeLocking(boolean)"><!-- --></A><H3> 2858setInitializeLocking</H3> 2859<PRE> 2860public void <B>setInitializeLocking</B>(boolean initializeLocking)</PRE> 2861<DL> 2862<DD>Configure the database environment for locking. 2863 <p> 2864 Locking should be used when multiple processes or threads are going 2865 to be reading and writing a database, so they do not interfere with 2866 each other. If all threads are accessing the database(s) read-only, 2867 locking is unnecessary. When locking is configured, it is usually 2868 necessary to run a deadlock detector, as well. 2869 <p> 2870<P> 2871<DD><DL> 2872</DL> 2873</DD> 2874<DD><DL> 2875<DT><B>Parameters:</B><DD><CODE>initializeLocking</CODE> - If true, configure the database environment for locking.</DL> 2876</DD> 2877</DL> 2878<HR> 2879 2880<A NAME="getInitializeLocking()"><!-- --></A><H3> 2881getInitializeLocking</H3> 2882<PRE> 2883public boolean <B>getInitializeLocking</B>()</PRE> 2884<DL> 2885<DD>Return true if the database environment is configured for locking. 2886<p> 2887This method may be called at any time during the life of the application. 2888<p> 2889<P> 2890<DD><DL> 2891</DL> 2892</DD> 2893<DD><DL> 2894 2895<DT><B>Returns:</B><DD>True if the database environment is configured for locking.</DL> 2896</DD> 2897</DL> 2898<HR> 2899 2900<A NAME="setInitializeLogging(boolean)"><!-- --></A><H3> 2901setInitializeLogging</H3> 2902<PRE> 2903public void <B>setInitializeLogging</B>(boolean initializeLogging)</PRE> 2904<DL> 2905<DD>Configure the database environment for logging. 2906 <p> 2907 Logging should be used when recovery from application or system 2908 failure is necessary. If the log region is being created and log 2909 files are already present, the log files are reviewed; subsequent 2910 log writes are appended to the end of the log, rather than overwriting 2911 current log entries. 2912 <p> 2913<P> 2914<DD><DL> 2915</DL> 2916</DD> 2917<DD><DL> 2918<DT><B>Parameters:</B><DD><CODE>initializeLogging</CODE> - If true, configure the database environment for logging.</DL> 2919</DD> 2920</DL> 2921<HR> 2922 2923<A NAME="getInitializeLogging()"><!-- --></A><H3> 2924getInitializeLogging</H3> 2925<PRE> 2926public boolean <B>getInitializeLogging</B>()</PRE> 2927<DL> 2928<DD>Return true if the database environment is configured for logging. 2929<p> 2930This method may be called at any time during the life of the application. 2931<p> 2932<P> 2933<DD><DL> 2934</DL> 2935</DD> 2936<DD><DL> 2937 2938<DT><B>Returns:</B><DD>True if the database environment is configured for logging.</DL> 2939</DD> 2940</DL> 2941<HR> 2942 2943<A NAME="setInitializeRegions(boolean)"><!-- --></A><H3> 2944setInitializeRegions</H3> 2945<PRE> 2946public void <B>setInitializeRegions</B>(boolean initializeRegions)</PRE> 2947<DL> 2948<DD>Configure the database environment to page-fault shared regions into 2949 memory when initially creating or joining a database environment. 2950 <p> 2951 In some applications, the expense of page-faulting the underlying 2952 shared memory regions can affect performance. For example, if the 2953 page-fault occurs while holding a lock, other lock requests can 2954 convoy, and overall throughput may decrease. This method 2955 configures Berkeley DB to page-fault shared regions into memory when 2956 initially creating or joining a database environment. In addition, 2957 Berkeley DB will write the shared regions when creating an 2958 environment, forcing the underlying virtual memory and filesystems 2959 to instantiate both the necessary memory and the necessary disk 2960 space. This can also avoid out-of-disk space failures later on. 2961 <p> 2962 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 2963any other library handles opened within the scope of that handle). 2964For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> 2965handles opened in the database environment must either call this method 2966or the configuration should be specified in the database environment's 2967DB_CONFIG configuration file. 2968 <p> 2969 This method may be called at any time during the life of the application. 2970 <p> 2971<P> 2972<DD><DL> 2973</DL> 2974</DD> 2975<DD><DL> 2976<DT><B>Parameters:</B><DD><CODE>initializeRegions</CODE> - If true, configure the database environment to page-fault shared 2977 regions into memory when initially creating or joining a database 2978 environment.</DL> 2979</DD> 2980</DL> 2981<HR> 2982 2983<A NAME="getInitializeRegions()"><!-- --></A><H3> 2984getInitializeRegions</H3> 2985<PRE> 2986public boolean <B>getInitializeRegions</B>()</PRE> 2987<DL> 2988<DD>Return true if the database environment has been configured to page-fault 2989 shared regions into memory when initially creating or joining a 2990 database environment. 2991<p> 2992This method may be called at any time during the life of the application. 2993<p> 2994<P> 2995<DD><DL> 2996</DL> 2997</DD> 2998<DD><DL> 2999 3000<DT><B>Returns:</B><DD>True if the database environment has been configured to page-fault 3001 shared regions into memory when initially creating or joining a 3002 database environment.</DL> 3003</DD> 3004</DL> 3005<HR> 3006 3007<A NAME="setInitializeReplication(boolean)"><!-- --></A><H3> 3008setInitializeReplication</H3> 3009<PRE> 3010public void <B>setInitializeReplication</B>(boolean initializeReplication)</PRE> 3011<DL> 3012<DD>Configure the database environment for replication. 3013 <p> 3014 Replication requires both locking and transactions. 3015 <p> 3016<P> 3017<DD><DL> 3018</DL> 3019</DD> 3020<DD><DL> 3021<DT><B>Parameters:</B><DD><CODE>initializeReplication</CODE> - If true, configure the database environment for replication.</DL> 3022</DD> 3023</DL> 3024<HR> 3025 3026<A NAME="getInitializeReplication()"><!-- --></A><H3> 3027getInitializeReplication</H3> 3028<PRE> 3029public boolean <B>getInitializeReplication</B>()</PRE> 3030<DL> 3031<DD>Return true if the database environment is configured for replication. 3032<p> 3033This method may be called at any time during the life of the application. 3034<p> 3035<P> 3036<DD><DL> 3037</DL> 3038</DD> 3039<DD><DL> 3040 3041<DT><B>Returns:</B><DD>True if the database environment is configured for replication.</DL> 3042</DD> 3043</DL> 3044<HR> 3045 3046<A NAME="setJoinEnvironment(boolean)"><!-- --></A><H3> 3047setJoinEnvironment</H3> 3048<PRE> 3049public void <B>setJoinEnvironment</B>(boolean joinEnvironment)</PRE> 3050<DL> 3051<DD>Configure the handle to join an existing environment. 3052 <p> 3053 This option allows applications to join an existing environment 3054 without knowing which subsystems the environment supports. 3055 <p> 3056<P> 3057<DD><DL> 3058</DL> 3059</DD> 3060<DD><DL> 3061<DT><B>Parameters:</B><DD><CODE>joinEnvironment</CODE> - If true, configure the handle to join an existing environment.</DL> 3062</DD> 3063</DL> 3064<HR> 3065 3066<A NAME="getJoinEnvironment()"><!-- --></A><H3> 3067getJoinEnvironment</H3> 3068<PRE> 3069public boolean <B>getJoinEnvironment</B>()</PRE> 3070<DL> 3071<DD>Return the handle is configured to join an existing environment. 3072<p> 3073This method may be called at any time during the life of the application. 3074<p> 3075<P> 3076<DD><DL> 3077</DL> 3078</DD> 3079<DD><DL> 3080 3081<DT><B>Returns:</B><DD>The handle is configured to join an existing environment.</DL> 3082</DD> 3083</DL> 3084<HR> 3085 3086<A NAME="setLockConflicts(byte[][])"><!-- --></A><H3> 3087setLockConflicts</H3> 3088<PRE> 3089public void <B>setLockConflicts</B>(byte[][] lockConflicts)</PRE> 3090<DL> 3091<DD>Configure the locking conflicts matrix. 3092 <p> 3093 If the locking conflicts matrix is never configured, a standard 3094 conflicts array is used. 3095 <p> 3096 This method configures a database environment, including all threads 3097of control accessing the database environment, not only the operations 3098performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 3099 <p> 3100 This method may not be called after the 3101environment has been opened. 3102If joining an existing database environment, any 3103information specified to this method will be ignored. 3104 <p> 3105<P> 3106<DD><DL> 3107</DL> 3108</DD> 3109<DD><DL> 3110<DT><B>Parameters:</B><DD><CODE>lockConflicts</CODE> - The locking conflicts matrix. A non-0 value for an array element 3111 indicates the requested_mode and held_mode conflict: 3112 <blockquote><pre> 3113 lockConflicts[requested_mode][held_mode] 3114 </pre></blockquote> 3115 <p> 3116 The <em>not-granted</em> mode must be represented by 0.</DL> 3117</DD> 3118</DL> 3119<HR> 3120 3121<A NAME="getLockConflicts()"><!-- --></A><H3> 3122getLockConflicts</H3> 3123<PRE> 3124public byte[][] <B>getLockConflicts</B>()</PRE> 3125<DL> 3126<DD>Return the locking conflicts matrix. 3127<p> 3128This method may be called at any time during the life of the application. 3129<p> 3130<P> 3131<DD><DL> 3132</DL> 3133</DD> 3134<DD><DL> 3135 3136<DT><B>Returns:</B><DD>The locking conflicts matrix.</DL> 3137</DD> 3138</DL> 3139<HR> 3140 3141<A NAME="setLockDetectMode(com.sleepycat.db.LockDetectMode)"><!-- --></A><H3> 3142setLockDetectMode</H3> 3143<PRE> 3144public void <B>setLockDetectMode</B>(<A HREF="../../../com/sleepycat/db/LockDetectMode.html" title="class in com.sleepycat.db">LockDetectMode</A> lockDetectMode)</PRE> 3145<DL> 3146<DD>Configure if the deadlock detector is to be run whenever a lock 3147 conflict occurs. 3148 <p> 3149 The database environment's deadlock detector configuration may also be set using the environment's 3150DB_CONFIG file. The syntax of the entry in that file is a single line 3151with the string "set_lk_detect", one or more whitespace characters, and the method <code>detect</code> parameter as a string; for example, 3152 "set_lk_detect DB_LOCK_OLDEST". 3153Because the DB_CONFIG file is read when the database environment is 3154opened, it will silently overrule configuration done before that time. 3155 <p> 3156 This method configures a database environment, including all threads 3157of control accessing the database environment, not only the operations 3158performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 3159 <p> 3160 Although the method may be called at any time during the life of the 3161application, it should normally be called before opening the database 3162environment. 3163 <p> 3164<P> 3165<DD><DL> 3166</DL> 3167</DD> 3168<DD><DL> 3169<DT><B>Parameters:</B><DD><CODE>lockDetectMode</CODE> - The lock request(s) to be rejected. As transactions acquire locks 3170 on behalf of a single locker ID, rejecting a lock request associated 3171 with a transaction normally requires the transaction be aborted.</DL> 3172</DD> 3173</DL> 3174<HR> 3175 3176<A NAME="getLockDetectMode()"><!-- --></A><H3> 3177getLockDetectMode</H3> 3178<PRE> 3179public <A HREF="../../../com/sleepycat/db/LockDetectMode.html" title="class in com.sleepycat.db">LockDetectMode</A> <B>getLockDetectMode</B>()</PRE> 3180<DL> 3181<DD>Return true if the deadlock detector is configured to run whenever a lock 3182 conflict occurs. 3183<p> 3184This method may be called at any time during the life of the application. 3185<p> 3186<P> 3187<DD><DL> 3188</DL> 3189</DD> 3190<DD><DL> 3191 3192<DT><B>Returns:</B><DD>True if the deadlock detector is configured to run whenever a lock 3193 conflict occurs.</DL> 3194</DD> 3195</DL> 3196<HR> 3197 3198<A NAME="setLockDown(boolean)"><!-- --></A><H3> 3199setLockDown</H3> 3200<PRE> 3201public void <B>setLockDown</B>(boolean lockDown)</PRE> 3202<DL> 3203<DD>Configure the database environment to lock shared environment files 3204 and memory-mapped databases into memory. 3205 <p> 3206<P> 3207<DD><DL> 3208</DL> 3209</DD> 3210<DD><DL> 3211<DT><B>Parameters:</B><DD><CODE>lockDown</CODE> - If true, configure the database environment to lock shared 3212 environment files and memory-mapped databases into memory.</DL> 3213</DD> 3214</DL> 3215<HR> 3216 3217<A NAME="getLockDown()"><!-- --></A><H3> 3218getLockDown</H3> 3219<PRE> 3220public boolean <B>getLockDown</B>()</PRE> 3221<DL> 3222<DD>Return true if the database environment is configured to lock shared 3223 environment files and memory-mapped databases into memory. 3224<p> 3225This method may be called at any time during the life of the application. 3226<p> 3227<P> 3228<DD><DL> 3229</DL> 3230</DD> 3231<DD><DL> 3232 3233<DT><B>Returns:</B><DD>True if the database environment is configured to lock shared 3234 environment files and memory-mapped databases into memory.</DL> 3235</DD> 3236</DL> 3237<HR> 3238 3239<A NAME="setLockTimeout(long)"><!-- --></A><H3> 3240setLockTimeout</H3> 3241<PRE> 3242public void <B>setLockTimeout</B>(long lockTimeout)</PRE> 3243<DL> 3244<DD>Set the timeout value for the database environment 3245locks. 3246<p> 3247Lock timeouts are checked whenever a thread of control blocks on a lock 3248or when deadlock detection is performed. The lock may have been 3249requested explicitly through the Lock subsystem interfaces, or it may 3250be a lock requested by the database access methods underlying the 3251application. 3252As timeouts are only checked when the lock request first blocks or when 3253deadlock detection is performed, the accuracy of the timeout depends on 3254how often deadlock detection is performed. 3255<p> 3256Timeout values specified for the database environment may be overridden 3257on a 3258per-lock basis by <A HREF="../../../com/sleepycat/db/Environment.html#lockVector(int, boolean, com.sleepycat.db.LockRequest[])"><CODE>Environment.lockVector</CODE></A>. 3259<p> 3260This method configures a database environment, including all threads 3261of control accessing the database environment, not only the operations 3262performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 3263<p> 3264This method may be called at any time during the life of the application. 3265<p> 3266<P> 3267<DD><DL> 3268</DL> 3269</DD> 3270<DD><DL> 3271<DT><B>Parameters:</B><DD><CODE>lockTimeout</CODE> - The timeout value, specified as an unsigned 32-bit number of 3272microseconds, limiting the maximum timeout to roughly 71 minutes. 3273<p> 3274<p> 3275<DT><B>Throws:</B> 3276<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if an invalid parameter was specified. 3277<p> 3278<DD><CODE><A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</A></CODE> - if a failure occurs.</DL> 3279</DD> 3280</DL> 3281<HR> 3282 3283<A NAME="getLockTimeout()"><!-- --></A><H3> 3284getLockTimeout</H3> 3285<PRE> 3286public long <B>getLockTimeout</B>()</PRE> 3287<DL> 3288<DD>Return the database environment lock timeout value, in microseconds; 3289 a timeout of 0 means no timeout is set. 3290<p> 3291This method may be called at any time during the life of the application. 3292<p> 3293<P> 3294<DD><DL> 3295</DL> 3296</DD> 3297<DD><DL> 3298 3299<DT><B>Returns:</B><DD>The database environment lock timeout value, in microseconds; 3300 a timeout of 0 means no timeout is set.</DL> 3301</DD> 3302</DL> 3303<HR> 3304 3305<A NAME="setLogAutoRemove(boolean)"><!-- --></A><H3> 3306setLogAutoRemove</H3> 3307<PRE> 3308public void <B>setLogAutoRemove</B>(boolean logAutoRemove)</PRE> 3309<DL> 3310<DD>Configure the system to automatically remove log files that are no 3311 longer needed. 3312 <p> 3313 Automatic log file removal is likely to make catastrophic recovery 3314 impossible. 3315 <p> 3316 This method configures a database environment, including all threads 3317of control accessing the database environment, not only the operations 3318performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 3319 <p> 3320 This method may be called at any time during the life of the application. 3321 <p> 3322<P> 3323<DD><DL> 3324</DL> 3325</DD> 3326<DD><DL> 3327<DT><B>Parameters:</B><DD><CODE>logAutoRemove</CODE> - If true, configure the system to automatically remove log files that 3328 are no longer needed.</DL> 3329</DD> 3330</DL> 3331<HR> 3332 3333<A NAME="getLogAutoRemove()"><!-- --></A><H3> 3334getLogAutoRemove</H3> 3335<PRE> 3336public boolean <B>getLogAutoRemove</B>()</PRE> 3337<DL> 3338<DD>Return true if the system has been configured to to automatically remove log 3339 files that are no longer needed. 3340<p> 3341This method may be called at any time during the life of the application. 3342<p> 3343<P> 3344<DD><DL> 3345</DL> 3346</DD> 3347<DD><DL> 3348 3349<DT><B>Returns:</B><DD>True if the system has been configured to to automatically remove log 3350 files that are no longer needed.</DL> 3351</DD> 3352</DL> 3353<HR> 3354 3355<A NAME="setLogInMemory(boolean)"><!-- --></A><H3> 3356setLogInMemory</H3> 3357<PRE> 3358public void <B>setLogInMemory</B>(boolean logInMemory)</PRE> 3359<DL> 3360<DD>If set, maintain transaction logs in memory rather than on disk. This means 3361 that transactions exhibit the ACI (atomicity, consistency, and isolation) 3362 properties, but not D (durability); that is, database integrity will be 3363 maintained, but if the application or system fails, integrity will not 3364 persist. All database files must be verified and/or restored from a 3365 replication group master or archival backup after application or system 3366 failure. 3367 <p> 3368 When in-memory logs are configured and no more log buffer space is 3369 available, Berkeley DB methods will throw a <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A>. 3370 When choosing log buffer and file sizes for in-memory logs, applications 3371 should ensure the in-memory log buffer size is large enough that no 3372 transaction will ever span the entire buffer, and avoid a state where the 3373 in-memory buffer is full and no space can be freed because a transaction 3374 that started in the first log "file" is still active. 3375 <p> 3376 This method configures a database environment, including all threads 3377of control accessing the database environment, not only the operations 3378performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 3379 <p> 3380 This method may not be called after the 3381environment has been opened. 3382If joining an existing database environment, any 3383information specified to this method will be ignored. 3384 <p> 3385<P> 3386<DD><DL> 3387</DL> 3388</DD> 3389<DD><DL> 3390<DT><B>Parameters:</B><DD><CODE>logInMemory</CODE> - If true, maintain transaction logs in memory rather than on disk.</DL> 3391</DD> 3392</DL> 3393<HR> 3394 3395<A NAME="getLogInMemory()"><!-- --></A><H3> 3396getLogInMemory</H3> 3397<PRE> 3398public boolean <B>getLogInMemory</B>()</PRE> 3399<DL> 3400<DD>Return true if the database environment is configured to maintain transaction logs 3401 in memory rather than on disk. 3402<p> 3403This method may be called at any time during the life of the application. 3404<p> 3405<P> 3406<DD><DL> 3407</DL> 3408</DD> 3409<DD><DL> 3410 3411<DT><B>Returns:</B><DD>True if the database environment is configured to maintain transaction logs 3412 in memory rather than on disk.</DL> 3413</DD> 3414</DL> 3415<HR> 3416 3417<A NAME="setLogRecordHandler(com.sleepycat.db.LogRecordHandler)"><!-- --></A><H3> 3418setLogRecordHandler</H3> 3419<PRE> 3420public void <B>setLogRecordHandler</B>(<A HREF="../../../com/sleepycat/db/LogRecordHandler.html" title="interface in com.sleepycat.db">LogRecordHandler</A> logRecordHandler)</PRE> 3421<DL> 3422<DD>Set a function to process application-specific log records. 3423 <p> 3424 This method configures only operations performed using a single a 3425<A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle, not an entire database environment. 3426 <p> 3427 This method may not be called after the 3428environment has been opened. 3429If joining an existing database environment, the 3430information specified to this method must be consistent with the 3431existing environment or corruption can occur. 3432 <p> 3433<P> 3434<DD><DL> 3435</DL> 3436</DD> 3437<DD><DL> 3438<DT><B>Parameters:</B><DD><CODE>logRecordHandler</CODE> - The handler for application-specific log records.</DL> 3439</DD> 3440</DL> 3441<HR> 3442 3443<A NAME="getLogRecordHandler()"><!-- --></A><H3> 3444getLogRecordHandler</H3> 3445<PRE> 3446public <A HREF="../../../com/sleepycat/db/LogRecordHandler.html" title="interface in com.sleepycat.db">LogRecordHandler</A> <B>getLogRecordHandler</B>()</PRE> 3447<DL> 3448<DD>Return the handler for application-specific log records. 3449<p> 3450This method may be called at any time during the life of the application. 3451<p> 3452<P> 3453<DD><DL> 3454</DL> 3455</DD> 3456<DD><DL> 3457 3458<DT><B>Returns:</B><DD>The handler for application-specific log records.</DL> 3459</DD> 3460</DL> 3461<HR> 3462 3463<A NAME="setLogZero(boolean)"><!-- --></A><H3> 3464setLogZero</H3> 3465<PRE> 3466public void <B>setLogZero</B>(boolean logZero)</PRE> 3467<DL> 3468<DD>If set, zero all pages of a log file when that log file is created. This 3469 has been shown to provide greater transaction throughput in some 3470 environments. The log file will be zeroed by the thread which needs to 3471 re-create the new log file. Other threads may not write to the log file 3472 while this is happening. 3473 <p> 3474 This method configures the database environment, including all threads of 3475 control accessing the database environment. 3476 <p> 3477 This method may not be called after the environment has been opened. 3478 <p> 3479<P> 3480<DD><DL> 3481</DL> 3482</DD> 3483<DD><DL> 3484<DT><B>Parameters:</B><DD><CODE>logZero</CODE> - If true, zero all pages of new log files upon their creation.</DL> 3485</DD> 3486</DL> 3487<HR> 3488 3489<A NAME="getLogZero()"><!-- --></A><H3> 3490getLogZero</H3> 3491<PRE> 3492public boolean <B>getLogZero</B>()</PRE> 3493<DL> 3494<DD>Return true if the database environment is configured to zero all pages of 3495 new log files upon their creation. 3496 <p> 3497 This method may be called at any time during the life of the application. 3498 <p> 3499<P> 3500<DD><DL> 3501</DL> 3502</DD> 3503<DD><DL> 3504 3505<DT><B>Returns:</B><DD>True if the database environment is configured to pre-zero log pages.</DL> 3506</DD> 3507</DL> 3508<HR> 3509 3510<A NAME="setReplicationManagerAckPolicy(com.sleepycat.db.ReplicationManagerAckPolicy)"><!-- --></A><H3> 3511setReplicationManagerAckPolicy</H3> 3512<PRE> 3513public void <B>setReplicationManagerAckPolicy</B>(<A HREF="../../../com/sleepycat/db/ReplicationManagerAckPolicy.html" title="class in com.sleepycat.db">ReplicationManagerAckPolicy</A> repmgrAckPolicy)</PRE> 3514<DL> 3515<DD>Set the network Ack policy used by the replication manager. 3516 <p> 3517<P> 3518<DD><DL> 3519</DL> 3520</DD> 3521<DD><DL> 3522<DT><B>Parameters:</B><DD><CODE>repmgrAckPolicy</CODE> - The network Ack policy used by the replication manager.</DL> 3523</DD> 3524</DL> 3525<HR> 3526 3527<A NAME="getReplicationManagerAckPolicy()"><!-- --></A><H3> 3528getReplicationManagerAckPolicy</H3> 3529<PRE> 3530public <A HREF="../../../com/sleepycat/db/ReplicationManagerAckPolicy.html" title="class in com.sleepycat.db">ReplicationManagerAckPolicy</A> <B>getReplicationManagerAckPolicy</B>()</PRE> 3531<DL> 3532<DD>Get the network Ack policy used by the replication manager. 3533 <p> 3534<P> 3535<DD><DL> 3536</DL> 3537</DD> 3538<DD><DL> 3539 3540<DT><B>Returns:</B><DD>The network Ack policy used by the replication manager.</DL> 3541</DD> 3542</DL> 3543<HR> 3544 3545<A NAME="setReplicationManagerLocalSite(com.sleepycat.db.ReplicationHostAddress)"><!-- --></A><H3> 3546setReplicationManagerLocalSite</H3> 3547<PRE> 3548public void <B>setReplicationManagerLocalSite</B>(<A HREF="../../../com/sleepycat/db/ReplicationHostAddress.html" title="class in com.sleepycat.db">ReplicationHostAddress</A> repmgrLocalSiteAddr)</PRE> 3549<DL> 3550<DD>Set the address of the local (this) site in a replication group. 3551 <p> 3552<P> 3553<DD><DL> 3554</DL> 3555</DD> 3556<DD><DL> 3557<DT><B>Parameters:</B><DD><CODE>repmgrLocalSiteAddr</CODE> - The address of the local site.</DL> 3558</DD> 3559</DL> 3560<HR> 3561 3562<A NAME="getReplicationManagerLocalSite()"><!-- --></A><H3> 3563getReplicationManagerLocalSite</H3> 3564<PRE> 3565public <A HREF="../../../com/sleepycat/db/ReplicationHostAddress.html" title="class in com.sleepycat.db">ReplicationHostAddress</A> <B>getReplicationManagerLocalSite</B>()</PRE> 3566<DL> 3567<DD>Get the address of the local (this) site in a replication group. 3568 <p> 3569<P> 3570<DD><DL> 3571</DL> 3572</DD> 3573<DD><DL> 3574 3575<DT><B>Returns:</B><DD>The address of the local site.</DL> 3576</DD> 3577</DL> 3578<HR> 3579 3580<A NAME="replicationManagerAddRemoteSite(com.sleepycat.db.ReplicationHostAddress, boolean)"><!-- --></A><H3> 3581replicationManagerAddRemoteSite</H3> 3582<PRE> 3583public void <B>replicationManagerAddRemoteSite</B>(<A HREF="../../../com/sleepycat/db/ReplicationHostAddress.html" title="class in com.sleepycat.db">ReplicationHostAddress</A> repmgrRemoteAddr, 3584 boolean isPeer) 3585 throws <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</A></PRE> 3586<DL> 3587<DD>Add a remote site to a replication group. 3588 <p> 3589<P> 3590<DD><DL> 3591</DL> 3592</DD> 3593<DD><DL> 3594<DT><B>Parameters:</B><DD><CODE>repmgrRemoteAddr</CODE> - The address of the remote site<DD><CODE>isPeer</CODE> - Whether the remote site is the local site's peer. 3595<DT><B>Throws:</B> 3596<DD><CODE><A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</A></CODE></DL> 3597</DD> 3598</DL> 3599<HR> 3600 3601<A NAME="setMaxLocks(int)"><!-- --></A><H3> 3602setMaxLocks</H3> 3603<PRE> 3604public void <B>setMaxLocks</B>(int maxLocks)</PRE> 3605<DL> 3606<DD>Set the maximum number of locks supported by the database 3607 environment. 3608 <p> 3609 This value is used during environment creation to estimate how much 3610 space to allocate for various lock-table data structures. The 3611 default value is 1000 locks. 3612 <p> 3613 The database environment's maximum number of locks may also be set using the environment's 3614DB_CONFIG file. The syntax of the entry in that file is a single line 3615with the string "set_lk_max_locks", one or more whitespace characters, and the number of locks. 3616Because the DB_CONFIG file is read when the database environment is 3617opened, it will silently overrule configuration done before that time. 3618 <p> 3619 This method configures a database environment, including all threads 3620of control accessing the database environment, not only the operations 3621performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 3622 <p> 3623 This method may not be called after the 3624environment has been opened. 3625If joining an existing database environment, any 3626information specified to this method will be ignored. 3627 <p> 3628<P> 3629<DD><DL> 3630</DL> 3631</DD> 3632<DD><DL> 3633<DT><B>Parameters:</B><DD><CODE>maxLocks</CODE> - The maximum number of locks supported by the database environment.</DL> 3634</DD> 3635</DL> 3636<HR> 3637 3638<A NAME="getMaxLocks()"><!-- --></A><H3> 3639getMaxLocks</H3> 3640<PRE> 3641public int <B>getMaxLocks</B>()</PRE> 3642<DL> 3643<DD>Return the maximum number of locks. 3644<p> 3645This method may be called at any time during the life of the application. 3646<p> 3647<P> 3648<DD><DL> 3649</DL> 3650</DD> 3651<DD><DL> 3652 3653<DT><B>Returns:</B><DD>The maximum number of locks.</DL> 3654</DD> 3655</DL> 3656<HR> 3657 3658<A NAME="setMaxLockers(int)"><!-- --></A><H3> 3659setMaxLockers</H3> 3660<PRE> 3661public void <B>setMaxLockers</B>(int maxLockers)</PRE> 3662<DL> 3663<DD>Set the maximum number of locking entities supported by the database 3664 environment. 3665 <p> 3666 This value is used during environment creation to estimate how much 3667 space to allocate for various lock-table data structures. The default 3668 value is 1000 lockers. 3669 <p> 3670 The database environment's maximum number of lockers may also be set using the environment's 3671DB_CONFIG file. The syntax of the entry in that file is a single line 3672with the string "set_lk_max_lockers", one or more whitespace characters, and the number of lockers. 3673Because the DB_CONFIG file is read when the database environment is 3674opened, it will silently overrule configuration done before that time. 3675 <p> 3676 This method configures a database environment, including all threads 3677of control accessing the database environment, not only the operations 3678performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 3679 <p> 3680 This method may not be called after the 3681environment has been opened. 3682If joining an existing database environment, any 3683information specified to this method will be ignored. 3684 <p> 3685<P> 3686<DD><DL> 3687</DL> 3688</DD> 3689<DD><DL> 3690<DT><B>Parameters:</B><DD><CODE>maxLockers</CODE> - The maximum number simultaneous locking entities supported by the 3691 database environment.</DL> 3692</DD> 3693</DL> 3694<HR> 3695 3696<A NAME="getMaxLockers()"><!-- --></A><H3> 3697getMaxLockers</H3> 3698<PRE> 3699public int <B>getMaxLockers</B>()</PRE> 3700<DL> 3701<DD>Return the maximum number of lockers. 3702<p> 3703This method may be called at any time during the life of the application. 3704<p> 3705<P> 3706<DD><DL> 3707</DL> 3708</DD> 3709<DD><DL> 3710 3711<DT><B>Returns:</B><DD>The maximum number of lockers.</DL> 3712</DD> 3713</DL> 3714<HR> 3715 3716<A NAME="setMaxLockObjects(int)"><!-- --></A><H3> 3717setMaxLockObjects</H3> 3718<PRE> 3719public void <B>setMaxLockObjects</B>(int maxLockObjects)</PRE> 3720<DL> 3721<DD>Set the maximum number of locked objects supported by the database 3722 environment. 3723 <p> 3724 This value is used during environment creation to estimate how much 3725 space to allocate for various lock-table data structures. The default 3726 value is 1000 objects. 3727 <p> 3728 The database environment's maximum number of objects may also be set using the environment's 3729DB_CONFIG file. The syntax of the entry in that file is a single line 3730with the string "set_lk_max_objects", one or more whitespace characters, and the number of objects. 3731Because the DB_CONFIG file is read when the database environment is 3732opened, it will silently overrule configuration done before that time. 3733 <p> 3734 This method configures a database environment, including all threads 3735of control accessing the database environment, not only the operations 3736performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 3737 <p> 3738 This method may not be called after the 3739environment has been opened. 3740If joining an existing database environment, any 3741information specified to this method will be ignored. 3742 <p> 3743<P> 3744<DD><DL> 3745</DL> 3746</DD> 3747<DD><DL> 3748<DT><B>Parameters:</B><DD><CODE>maxLockObjects</CODE> - The maximum number of locked objects supported by the database 3749 environment.</DL> 3750</DD> 3751</DL> 3752<HR> 3753 3754<A NAME="getMaxLockObjects()"><!-- --></A><H3> 3755getMaxLockObjects</H3> 3756<PRE> 3757public int <B>getMaxLockObjects</B>()</PRE> 3758<DL> 3759<DD>Return the maximum number of locked objects. 3760<p> 3761This method may be called at any time during the life of the application. 3762<p> 3763<P> 3764<DD><DL> 3765</DL> 3766</DD> 3767<DD><DL> 3768 3769<DT><B>Returns:</B><DD>The maximum number of locked objects.</DL> 3770</DD> 3771</DL> 3772<HR> 3773 3774<A NAME="setMaxLogFileSize(int)"><!-- --></A><H3> 3775setMaxLogFileSize</H3> 3776<PRE> 3777public void <B>setMaxLogFileSize</B>(int maxLogFileSize)</PRE> 3778<DL> 3779<DD>Set the maximum size of a single file in the log, in bytes. 3780 <p> 3781 By default, or if the maxLogFileSize parameter is set to 0, a size 3782 of 10MB is used. If no size is specified by the application, the 3783 size last specified for the database region will be used, or if no 3784 database region previously existed, the default will be used. 3785 Because <A HREF="../../../com/sleepycat/db/LogSequenceNumber.html" title="class in com.sleepycat.db"><CODE>LogSequenceNumber</CODE></A> file offsets are unsigned four-byte 3786 values, the set value may not be larger than the maximum unsigned 3787 four-byte value. 3788 <p> 3789 The database environment's log file size may also be set using the environment's 3790DB_CONFIG file. The syntax of the entry in that file is a single line 3791with the string "set_lg_max", one or more whitespace characters, and the size in bytes. 3792Because the DB_CONFIG file is read when the database environment is 3793opened, it will silently overrule configuration done before that time. 3794 <p> 3795 This method configures a database environment, including all threads 3796of control accessing the database environment, not only the operations 3797performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 3798 <p> 3799 This method may be called at any time during the life of the application. 3800 <p> 3801<P> 3802<DD><DL> 3803</DL> 3804</DD> 3805<DD><DL> 3806<DT><B>Parameters:</B><DD><CODE>maxLogFileSize</CODE> - The maximum size of a single file in the log, in bytes.</DL> 3807</DD> 3808</DL> 3809<HR> 3810 3811<A NAME="getMaxLogFileSize()"><!-- --></A><H3> 3812getMaxLogFileSize</H3> 3813<PRE> 3814public int <B>getMaxLogFileSize</B>()</PRE> 3815<DL> 3816<DD>Return the maximum size of a single file in the log, in bytes. 3817<p> 3818This method may be called at any time during the life of the application. 3819<p> 3820<P> 3821<DD><DL> 3822</DL> 3823</DD> 3824<DD><DL> 3825 3826<DT><B>Returns:</B><DD>The maximum size of a single file in the log, in bytes.</DL> 3827</DD> 3828</DL> 3829<HR> 3830 3831<A NAME="setLogBufferSize(int)"><!-- --></A><H3> 3832setLogBufferSize</H3> 3833<PRE> 3834public void <B>setLogBufferSize</B>(int logBufferSize)</PRE> 3835<DL> 3836<DD>Set the size of the in-memory log buffer, in bytes. 3837 <p> 3838 Log information is stored in-memory until the storage space fills up 3839 or transaction commit forces the information to be flushed to stable 3840 storage. In the presence of long-running transactions or transactions 3841 producing large amounts of data, larger buffer sizes can increase 3842 throughput. 3843 <p> 3844 By default, or if the value is set to 0, a size of 32K is used. 3845 <p> 3846 The database environment's log buffer size may also be set using the environment's 3847DB_CONFIG file. The syntax of the entry in that file is a single line 3848with the string "set_lg_bsize", one or more whitespace characters, and the size in bytes. 3849Because the DB_CONFIG file is read when the database environment is 3850opened, it will silently overrule configuration done before that time. 3851 <p> 3852 This method configures a database environment, including all threads 3853of control accessing the database environment, not only the operations 3854performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 3855 <p> 3856 This method may not be called after the 3857environment has been opened. 3858If joining an existing database environment, any 3859information specified to this method will be ignored. 3860 <p> 3861<P> 3862<DD><DL> 3863</DL> 3864</DD> 3865<DD><DL> 3866<DT><B>Parameters:</B><DD><CODE>logBufferSize</CODE> - The size of the in-memory log buffer, in bytes.</DL> 3867</DD> 3868</DL> 3869<HR> 3870 3871<A NAME="getLogBufferSize()"><!-- --></A><H3> 3872getLogBufferSize</H3> 3873<PRE> 3874public int <B>getLogBufferSize</B>()</PRE> 3875<DL> 3876<DD>Return the size of the in-memory log buffer, in bytes. 3877<p> 3878This method may be called at any time during the life of the application. 3879<p> 3880<P> 3881<DD><DL> 3882</DL> 3883</DD> 3884<DD><DL> 3885 3886<DT><B>Returns:</B><DD>The size of the in-memory log buffer, in bytes.</DL> 3887</DD> 3888</DL> 3889<HR> 3890 3891<A NAME="setLogDirectory(java.io.File)"><!-- --></A><H3> 3892setLogDirectory</H3> 3893<PRE> 3894public void <B>setLogDirectory</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/File.html" title="class or interface in java.io">File</A> logDirectory)</PRE> 3895<DL> 3896<DD>Set the path of a directory to be used as the location of logging files. 3897 <p> 3898 Log files created by the Log Manager subsystem will be created in this 3899 directory. If no logging directory is specified, log files are 3900 created in the environment home directory. 3901 <p> 3902 For the greatest degree of recoverability from system or application 3903 failure, database files and log files should be located on separate 3904 physical devices. 3905 <p> 3906 The database environment's logging directory may also be set using the environment's 3907DB_CONFIG file. The syntax of the entry in that file is a single line 3908with the string "set_lg_dir", one or more whitespace characters, and the directory name. 3909Because the DB_CONFIG file is read when the database environment is 3910opened, it will silently overrule configuration done before that time. 3911 <p> 3912 This method configures only operations performed using a single a 3913<A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle, not an entire database environment. 3914 <p> 3915 This method may not be called after the 3916environment has been opened. 3917If joining an existing database environment, the 3918information specified to this method must be consistent with the 3919existing environment or corruption can occur. 3920 <p> 3921<P> 3922<DD><DL> 3923</DL> 3924</DD> 3925<DD><DL> 3926<DT><B>Parameters:</B><DD><CODE>logDirectory</CODE> - The directory used to store the logging files. 3927 On Windows platforms, this argument will be interpreted as a UTF-8 3928string, which is equivalent to ASCII for Latin characters.</DL> 3929</DD> 3930</DL> 3931<HR> 3932 3933<A NAME="getLogDirectory()"><!-- --></A><H3> 3934getLogDirectory</H3> 3935<PRE> 3936public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/File.html" title="class or interface in java.io">File</A> <B>getLogDirectory</B>()</PRE> 3937<DL> 3938<DD>Return the path of a directory to be used as the location of logging files. 3939<p> 3940This method may be called at any time during the life of the application. 3941<p> 3942<P> 3943<DD><DL> 3944</DL> 3945</DD> 3946<DD><DL> 3947 3948<DT><B>Returns:</B><DD>The path of a directory to be used as the location of logging files.</DL> 3949</DD> 3950</DL> 3951<HR> 3952 3953<A NAME="setLogFileMode(int)"><!-- --></A><H3> 3954setLogFileMode</H3> 3955<PRE> 3956public void <B>setLogFileMode</B>(int logFileMode)</PRE> 3957<DL> 3958<DD>Set the absolute file mode for created log files. This method is 3959 <b>only</b> useful for the rare Berkeley DB application that does not 3960 control its umask value. 3961 <p> 3962 Normally, if Berkeley DB applications set their umask appropriately, all 3963 processes in the application suite will have read permission on the log 3964 files created by any process in the application suite. However, if the 3965 Berkeley DB application is a library, a process using the library might set 3966 its umask to a value preventing other processes in the application suite 3967 from reading the log files it creates. In this rare case, this method 3968 can be used to set the mode of created log files to an absolute value. 3969 <p> 3970<P> 3971<DD><DL> 3972</DL> 3973</DD> 3974<DD><DL> 3975<DT><B>Parameters:</B><DD><CODE>logFileMode</CODE> - The absolute mode of the created log file.</DL> 3976</DD> 3977</DL> 3978<HR> 3979 3980<A NAME="getLogFileMode()"><!-- --></A><H3> 3981getLogFileMode</H3> 3982<PRE> 3983public int <B>getLogFileMode</B>()</PRE> 3984<DL> 3985<DD>Return the absolute file mode for created log files. 3986 <p> 3987 This method may be called at any time during the life of the application. 3988 <p> 3989<P> 3990<DD><DL> 3991</DL> 3992</DD> 3993<DD><DL> 3994 3995<DT><B>Returns:</B><DD>The absolute file mode for created log files.</DL> 3996</DD> 3997</DL> 3998<HR> 3999 4000<A NAME="setLogRegionSize(int)"><!-- --></A><H3> 4001setLogRegionSize</H3> 4002<PRE> 4003public void <B>setLogRegionSize</B>(int logRegionSize)</PRE> 4004<DL> 4005<DD>Set the size of the underlying logging area of the database 4006 environment, in bytes. 4007 <p> 4008 By default, or if the value is set to 0, the default size is 60KB. 4009 The log region is used to store filenames, and so may need to be 4010 increased in size if a large number of files will be opened and 4011 registered with the specified database environment's log manager. 4012 <p> 4013 The database environment's log region size may also be set using the environment's 4014DB_CONFIG file. The syntax of the entry in that file is a single line 4015with the string "set_lg_regionmax", one or more whitespace characters, and the size in bytes. 4016Because the DB_CONFIG file is read when the database environment is 4017opened, it will silently overrule configuration done before that time. 4018 <p> 4019 This method configures a database environment, including all threads 4020of control accessing the database environment, not only the operations 4021performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 4022 <p> 4023 This method may not be called after the 4024environment has been opened. 4025If joining an existing database environment, any 4026information specified to this method will be ignored. 4027 <p> 4028<P> 4029<DD><DL> 4030</DL> 4031</DD> 4032<DD><DL> 4033<DT><B>Parameters:</B><DD><CODE>logRegionSize</CODE> - The size of the logging area in the database environment, in bytes.</DL> 4034</DD> 4035</DL> 4036<HR> 4037 4038<A NAME="getLogRegionSize()"><!-- --></A><H3> 4039getLogRegionSize</H3> 4040<PRE> 4041public int <B>getLogRegionSize</B>()</PRE> 4042<DL> 4043<DD>Return the size of the underlying logging subsystem region. 4044<p> 4045This method may be called at any time during the life of the application. 4046<p> 4047<P> 4048<DD><DL> 4049</DL> 4050</DD> 4051<DD><DL> 4052 4053<DT><B>Returns:</B><DD>The size of the underlying logging subsystem region.</DL> 4054</DD> 4055</DL> 4056<HR> 4057 4058<A NAME="setMaxOpenFiles(int)"><!-- --></A><H3> 4059setMaxOpenFiles</H3> 4060<PRE> 4061public void <B>setMaxOpenFiles</B>(int maxOpenFiles)</PRE> 4062<DL> 4063<DD>Limit the number of file descriptors the library will open concurrently 4064 when flushing dirty pages from the cache. 4065 <p> 4066<P> 4067<DD><DL> 4068</DL> 4069</DD> 4070<DD><DL> 4071<DT><B>Parameters:</B><DD><CODE>maxOpenFiles</CODE> - The maximum number of file descriptors that may be concurrently opened 4072 by the library when flushing dirty pages from the cache.</DL> 4073</DD> 4074</DL> 4075<HR> 4076 4077<A NAME="getMaxOpenFiles()"><!-- --></A><H3> 4078getMaxOpenFiles</H3> 4079<PRE> 4080public int <B>getMaxOpenFiles</B>()</PRE> 4081<DL> 4082<DD>Return the maximum number of file descriptors that will be opened concurrently.. 4083<p> 4084This method may be called at any time during the life of the application. 4085<p> 4086<P> 4087<DD><DL> 4088</DL> 4089</DD> 4090<DD><DL> 4091 4092<DT><B>Returns:</B><DD>The maximum number of file descriptors that will be opened concurrently..</DL> 4093</DD> 4094</DL> 4095<HR> 4096 4097<A NAME="setMaxWrite(int, long)"><!-- --></A><H3> 4098setMaxWrite</H3> 4099<PRE> 4100public void <B>setMaxWrite</B>(int maxWrite, 4101 long maxWriteSleep)</PRE> 4102<DL> 4103<DD>Limit the number of sequential write operations scheduled by the 4104 library when flushing dirty pages from the cache. 4105 <p> 4106<P> 4107<DD><DL> 4108</DL> 4109</DD> 4110<DD><DL> 4111<DT><B>Parameters:</B><DD><CODE>maxWrite</CODE> - The maximum number of sequential write operations scheduled by the 4112 library when flushing dirty pages from the cache.<DD><CODE>maxWriteSleep</CODE> - The number of microseconds the thread of control should pause before 4113 scheduling further write operations.</DL> 4114</DD> 4115</DL> 4116<HR> 4117 4118<A NAME="getMaxWrite()"><!-- --></A><H3> 4119getMaxWrite</H3> 4120<PRE> 4121public int <B>getMaxWrite</B>()</PRE> 4122<DL> 4123<DD>Return the maximum number of sequential write operations. 4124<p> 4125This method may be called at any time during the life of the application. 4126<p> 4127<P> 4128<DD><DL> 4129</DL> 4130</DD> 4131<DD><DL> 4132 4133<DT><B>Returns:</B><DD>The maximum number of sequential write operations.</DL> 4134</DD> 4135</DL> 4136<HR> 4137 4138<A NAME="getMaxWriteSleep()"><!-- --></A><H3> 4139getMaxWriteSleep</H3> 4140<PRE> 4141public long <B>getMaxWriteSleep</B>()</PRE> 4142<DL> 4143<DD>Return the microseconds to pause before scheduling further write operations. 4144<p> 4145This method may be called at any time during the life of the application. 4146<p> 4147<P> 4148<DD><DL> 4149</DL> 4150</DD> 4151<DD><DL> 4152 4153<DT><B>Returns:</B><DD>The microseconds to pause before scheduling further write operations.</DL> 4154</DD> 4155</DL> 4156<HR> 4157 4158<A NAME="setMessageHandler(com.sleepycat.db.MessageHandler)"><!-- --></A><H3> 4159setMessageHandler</H3> 4160<PRE> 4161public void <B>setMessageHandler</B>(<A HREF="../../../com/sleepycat/db/MessageHandler.html" title="interface in com.sleepycat.db">MessageHandler</A> messageHandler)</PRE> 4162<DL> 4163<DD>Set a function to be called with an informational message. 4164<p> 4165There are interfaces in the Berkeley DB library which either directly 4166output informational messages or statistical information, or configure 4167the library to output such messages when performing other operations, 4168<A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerboseDeadlock(boolean)"><CODE>EnvironmentConfig.setVerboseDeadlock</CODE></A> for example. 4169<p> 4170The <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMessageHandler(com.sleepycat.db.MessageHandler)"><CODE>EnvironmentConfig.setMessageHandler</CODE></A> and 4171<A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setMessageHandler(com.sleepycat.db.MessageHandler)"><CODE>DatabaseConfig.setMessageHandler</CODE></A> methods are used to display 4172these messages for the application. 4173<p> 4174Setting messageHandler to null unconfigures the interface. 4175<p> 4176Alternatively, you can use <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMessageStream(java.io.OutputStream)"><CODE>EnvironmentConfig.setMessageStream</CODE></A> 4177and <A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setMessageStream(java.io.OutputStream)"><CODE>DatabaseConfig.setMessageStream</CODE></A> to send the additional 4178information directly to an output streams. You should not mix these 4179approaches. 4180<p> 4181This method may be called at any time during the life of the application. 4182<p> 4183<P> 4184<DD><DL> 4185</DL> 4186</DD> 4187<DD><DL> 4188<DT><B>Parameters:</B><DD><CODE>messageHandler</CODE> - The application-specified function for informational messages.</DL> 4189</DD> 4190</DL> 4191<HR> 4192 4193<A NAME="getMessageHandler()"><!-- --></A><H3> 4194getMessageHandler</H3> 4195<PRE> 4196public <A HREF="../../../com/sleepycat/db/MessageHandler.html" title="interface in com.sleepycat.db">MessageHandler</A> <B>getMessageHandler</B>()</PRE> 4197<DL> 4198<DD>Return the function to be called with an informational message. 4199<p> 4200This method may be called at any time during the life of the application. 4201<p> 4202<P> 4203<DD><DL> 4204</DL> 4205</DD> 4206<DD><DL> 4207 4208<DT><B>Returns:</B><DD>The function to be called with an informational message.</DL> 4209</DD> 4210</DL> 4211<HR> 4212 4213<A NAME="setMessageStream(java.io.OutputStream)"><!-- --></A><H3> 4214setMessageStream</H3> 4215<PRE> 4216public void <B>setMessageStream</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/OutputStream.html" title="class or interface in java.io">OutputStream</A> messageStream)</PRE> 4217<DL> 4218<DD>Set an OutputStream for displaying informational messages. 4219<p> 4220There are interfaces in the Berkeley DB library which either directly 4221output informational messages or statistical information, or configure 4222the library to output such messages when performing other operations, 4223<A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerboseDeadlock(boolean)"><CODE>EnvironmentConfig.setVerboseDeadlock</CODE></A> for example. 4224<p> 4225The <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMessageStream(java.io.OutputStream)"><CODE>EnvironmentConfig.setMessageStream</CODE></A> and 4226<A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setMessageStream(java.io.OutputStream)"><CODE>DatabaseConfig.setMessageStream</CODE></A> methods are used to display 4227these messages for the application. In this case, the message will 4228include a trailing newline character. 4229<p> 4230Setting messageStream to null unconfigures the interface. 4231<p> 4232Alternatively, you can use <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMessageHandler(com.sleepycat.db.MessageHandler)"><CODE>EnvironmentConfig.setMessageHandler</CODE></A> 4233and <A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setMessageHandler(com.sleepycat.db.MessageHandler)"><CODE>DatabaseConfig.setMessageHandler</CODE></A> to capture the additional 4234information in a way that does not use output streams. You should not 4235mix these approaches. 4236<p> 4237This method may be called at any time during the life of the application. 4238<p> 4239<P> 4240<DD><DL> 4241</DL> 4242</DD> 4243<DD><DL> 4244<DT><B>Parameters:</B><DD><CODE>messageStream</CODE> - The application-specified OutputStream for informational messages.</DL> 4245</DD> 4246</DL> 4247<HR> 4248 4249<A NAME="getMessageStream()"><!-- --></A><H3> 4250getMessageStream</H3> 4251<PRE> 4252public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/OutputStream.html" title="class or interface in java.io">OutputStream</A> <B>getMessageStream</B>()</PRE> 4253<DL> 4254<DD>Return the an OutputStream for displaying informational messages. 4255<p> 4256This method may be called at any time during the life of the application. 4257<p> 4258<P> 4259<DD><DL> 4260</DL> 4261</DD> 4262<DD><DL> 4263 4264<DT><B>Returns:</B><DD>The an OutputStream for displaying informational messages.</DL> 4265</DD> 4266</DL> 4267<HR> 4268 4269<A NAME="setMMapSize(long)"><!-- --></A><H3> 4270setMMapSize</H3> 4271<PRE> 4272public void <B>setMMapSize</B>(long mmapSize)</PRE> 4273<DL> 4274<DD>Set the maximum file size, in bytes, for a file to be mapped into 4275 the process address space. 4276 <p> 4277 If no value is specified, it defaults to 10MB. 4278 <p> 4279 Files that are opened read-only in the pool (and that satisfy a few 4280 other criteria) are, by default, mapped into the process address space 4281 instead of being copied into the local cache. This can result in 4282 better-than-usual performance because available virtual memory is 4283 normally much larger than the local cache, and page faults are faster 4284 than page copying on many systems. However, it can cause resource 4285 starvation in the presence of limited virtual memory, and it can result 4286 in immense process sizes in the presence of large databases. 4287 <p> 4288<P> 4289<DD><DL> 4290</DL> 4291</DD> 4292<DD><DL> 4293<DT><B>Parameters:</B><DD><CODE>mmapSize</CODE> - The maximum file size, in bytes, for a file to be mapped into the 4294 process address space. 4295 <p> 4296 This method configures only operations performed using a single a 4297<A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle, not an entire database environment. 4298 <p> 4299 This method may be called at any time during the life of the application.</DL> 4300</DD> 4301</DL> 4302<HR> 4303 4304<A NAME="getMMapSize()"><!-- --></A><H3> 4305getMMapSize</H3> 4306<PRE> 4307public long <B>getMMapSize</B>()</PRE> 4308<DL> 4309<DD>Return the maximum file size, in bytes, for a file to be mapped into 4310 the process address space. 4311 <p> 4312<P> 4313<DD><DL> 4314</DL> 4315</DD> 4316<DD><DL> 4317 4318<DT><B>Returns:</B><DD>The maximum file size, in bytes, for a file to be mapped into the 4319 process address space.</DL> 4320</DD> 4321</DL> 4322<HR> 4323 4324<A NAME="setMode(int)"><!-- --></A><H3> 4325setMode</H3> 4326<PRE> 4327public void <B>setMode</B>(int mode)</PRE> 4328<DL> 4329<DD>Configure the database environment to use a specific mode when 4330 creating underlying files and shared memory segments. 4331 <p> 4332 On UNIX systems or in POSIX environments, files created in the 4333 database environment are created with the specified mode (as 4334 modified by the process' umask value at the time of creation). 4335 <p> 4336 On UNIX systems or in POSIX environments, system shared memory 4337 segments created by the library are created with the specified 4338 mode, unmodified by the process' umask value. 4339 <p> 4340 If is 0, the library will use a default mode of readable and 4341 writable by both owner and group. 4342 <p> 4343 Created files are owned by the process owner; the group ownership 4344 of created files is based on the system and directory defaults, 4345 and is not further specified by the library. 4346 <p> 4347<P> 4348<DD><DL> 4349</DL> 4350</DD> 4351<DD><DL> 4352<DT><B>Parameters:</B><DD><CODE>mode</CODE> - The mode to use when creating underlying files and shared memory 4353 segments.</DL> 4354</DD> 4355</DL> 4356<HR> 4357 4358<A NAME="getMode()"><!-- --></A><H3> 4359getMode</H3> 4360<PRE> 4361public long <B>getMode</B>()</PRE> 4362<DL> 4363<DD>Return the mode to use when creating underlying files and shared 4364 memory segments. 4365<p> 4366This method may be called at any time during the life of the application. 4367<p> 4368<P> 4369<DD><DL> 4370</DL> 4371</DD> 4372<DD><DL> 4373 4374<DT><B>Returns:</B><DD>The mode to use when creating underlying files and shared 4375 memory segments.</DL> 4376</DD> 4377</DL> 4378<HR> 4379 4380<A NAME="setMultiversion(boolean)"><!-- --></A><H3> 4381setMultiversion</H3> 4382<PRE> 4383public void <B>setMultiversion</B>(boolean multiversion)</PRE> 4384<DL> 4385<DD>Configure the database environment to open all databases that are not 4386 using the queue access method for multiversion concurrency control. 4387 See <A HREF="../../../com/sleepycat/db/DatabaseConfig.html#setMultiversion(boolean)"><CODE>DatabaseConfig.setMultiversion(boolean)</CODE></A> for more information. 4388 <p> 4389 This method may be called at any time during the life of the application. 4390 <p> 4391<P> 4392<DD><DL> 4393</DL> 4394</DD> 4395<DD><DL> 4396<DT><B>Parameters:</B><DD><CODE>multiversion</CODE> - If true, all databases that are not using the queue access method will be 4397 opened for multiversion concurrency control.</DL> 4398</DD> 4399</DL> 4400<HR> 4401 4402<A NAME="getMultiversion()"><!-- --></A><H3> 4403getMultiversion</H3> 4404<PRE> 4405public boolean <B>getMultiversion</B>()</PRE> 4406<DL> 4407<DD>Return true if the handle is configured to open all databases for multiversion 4408 concurrency control. 4409<p> 4410This method may be called at any time during the life of the application. 4411<p> 4412<P> 4413<DD><DL> 4414</DL> 4415</DD> 4416<DD><DL> 4417 4418<DT><B>Returns:</B><DD>True if the handle is configured to open all databases for multiversion 4419 concurrency control.</DL> 4420</DD> 4421</DL> 4422<HR> 4423 4424<A NAME="setNoLocking(boolean)"><!-- --></A><H3> 4425setNoLocking</H3> 4426<PRE> 4427public void <B>setNoLocking</B>(boolean noLocking)</PRE> 4428<DL> 4429<DD>Configure the system to grant all requested mutual exclusion mutexes 4430 and database locks without regard for their actual availability. 4431 <p> 4432 This functionality should never be used for purposes other than 4433 debugging. 4434 <p> 4435 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 4436any other library handles opened within the scope of that handle). 4437 <p> 4438 This method may be called at any time during the life of the application. 4439 <p> 4440<P> 4441<DD><DL> 4442</DL> 4443</DD> 4444<DD><DL> 4445<DT><B>Parameters:</B><DD><CODE>noLocking</CODE> - If true, configure the system to grant all requested mutual exclusion 4446 mutexes and database locks without regard for their actual availability.</DL> 4447</DD> 4448</DL> 4449<HR> 4450 4451<A NAME="getNoLocking()"><!-- --></A><H3> 4452getNoLocking</H3> 4453<PRE> 4454public boolean <B>getNoLocking</B>()</PRE> 4455<DL> 4456<DD>Return true if the system has been configured to grant all requested mutual 4457 exclusion mutexes and database locks without regard for their actual 4458 availability. 4459<p> 4460This method may be called at any time during the life of the application. 4461<p> 4462<P> 4463<DD><DL> 4464</DL> 4465</DD> 4466<DD><DL> 4467 4468<DT><B>Returns:</B><DD>True if the system has been configured to grant all requested mutual 4469 exclusion mutexes and database locks without regard for their actual 4470 availability.</DL> 4471</DD> 4472</DL> 4473<HR> 4474 4475<A NAME="setNoMMap(boolean)"><!-- --></A><H3> 4476setNoMMap</H3> 4477<PRE> 4478public void <B>setNoMMap</B>(boolean noMMap)</PRE> 4479<DL> 4480<DD>Configure the system to copy read-only database files into the local 4481 cache instead of potentially mapping them into process memory. 4482 <p> 4483 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 4484any other library handles opened within the scope of that handle). 4485For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> 4486handles opened in the database environment must either call this method 4487or the configuration should be specified in the database environment's 4488DB_CONFIG configuration file. 4489 <p> 4490 This method may be called at any time during the life of the application. 4491 <p> 4492<P> 4493<DD><DL> 4494</DL> 4495</DD> 4496<DD><DL> 4497<DT><B>Parameters:</B><DD><CODE>noMMap</CODE> - If true, configure the system to copy read-only database files into 4498 the local cache instead of potentially mapping them into process memory.</DL> 4499</DD> 4500</DL> 4501<HR> 4502 4503<A NAME="getNoMMap()"><!-- --></A><H3> 4504getNoMMap</H3> 4505<PRE> 4506public boolean <B>getNoMMap</B>()</PRE> 4507<DL> 4508<DD>Return true if the system has been configured to copy read-only database files 4509 into the local cache instead of potentially mapping them into process 4510 memory. 4511<p> 4512This method may be called at any time during the life of the application. 4513<p> 4514<P> 4515<DD><DL> 4516</DL> 4517</DD> 4518<DD><DL> 4519 4520<DT><B>Returns:</B><DD>True if the system has been configured to copy read-only database files 4521 into the local cache instead of potentially mapping them into process 4522 memory.</DL> 4523</DD> 4524</DL> 4525<HR> 4526 4527<A NAME="setNoPanic(boolean)"><!-- --></A><H3> 4528setNoPanic</H3> 4529<PRE> 4530public void <B>setNoPanic</B>(boolean noPanic)</PRE> 4531<DL> 4532<DD>Configure the system to ignore any panic state in the database 4533 environment. 4534 <p> 4535 Database environments in a panic state normally refuse all attempts to 4536 call Berkeley DB functions, throwing <A HREF="../../../com/sleepycat/db/RunRecoveryException.html" title="class in com.sleepycat.db"><CODE>RunRecoveryException</CODE></A>. 4537 This functionality should never be used for purposes other than 4538 debugging. 4539 <p> 4540 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 4541any other library handles opened within the scope of that handle). 4542 <p> 4543 This method may be called at any time during the life of the application. 4544 <p> 4545<P> 4546<DD><DL> 4547</DL> 4548</DD> 4549<DD><DL> 4550<DT><B>Parameters:</B><DD><CODE>noPanic</CODE> - If true, configure the system to ignore any panic state in the 4551 database environment.</DL> 4552</DD> 4553</DL> 4554<HR> 4555 4556<A NAME="getNoPanic()"><!-- --></A><H3> 4557getNoPanic</H3> 4558<PRE> 4559public boolean <B>getNoPanic</B>()</PRE> 4560<DL> 4561<DD>Return true if the system has been configured to ignore any panic state in 4562 the database environment. 4563<p> 4564This method may be called at any time during the life of the application. 4565<p> 4566<P> 4567<DD><DL> 4568</DL> 4569</DD> 4570<DD><DL> 4571 4572<DT><B>Returns:</B><DD>True if the system has been configured to ignore any panic state in 4573 the database environment.</DL> 4574</DD> 4575</DL> 4576<HR> 4577 4578<A NAME="setOverwrite(boolean)"><!-- --></A><H3> 4579setOverwrite</H3> 4580<PRE> 4581public void <B>setOverwrite</B>(boolean overwrite)</PRE> 4582<DL> 4583<DD>Configure the system to overwrite files stored in encrypted formats 4584 before deleting them. 4585 <p> 4586 Berkeley DB overwrites files using alternating 0xff, 0x00 and 0xff 4587 byte patterns. For file overwriting to be effective, the underlying 4588 file must be stored on a fixed-block filesystem. Systems with 4589 journaling or logging filesystems will require operating system 4590 support and probably modification of the Berkeley DB sources. 4591 <p> 4592 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 4593any other library handles opened within the scope of that handle). 4594 <p> 4595 This method may be called at any time during the life of the application. 4596 <p> 4597<P> 4598<DD><DL> 4599</DL> 4600</DD> 4601<DD><DL> 4602<DT><B>Parameters:</B><DD><CODE>overwrite</CODE> - If true, configure the system to overwrite files stored in encrypted 4603 formats before deleting them.</DL> 4604</DD> 4605</DL> 4606<HR> 4607 4608<A NAME="getOverwrite()"><!-- --></A><H3> 4609getOverwrite</H3> 4610<PRE> 4611public boolean <B>getOverwrite</B>()</PRE> 4612<DL> 4613<DD>Return true if the system has been configured to overwrite files stored in 4614 encrypted formats before deleting them. 4615<p> 4616This method may be called at any time during the life of the application. 4617<p> 4618<P> 4619<DD><DL> 4620</DL> 4621</DD> 4622<DD><DL> 4623 4624<DT><B>Returns:</B><DD>True if the system has been configured to overwrite files stored in 4625 encrypted formats before deleting them.</DL> 4626</DD> 4627</DL> 4628<HR> 4629 4630<A NAME="setPanicHandler(com.sleepycat.db.PanicHandler)"><!-- --></A><H3> 4631setPanicHandler</H3> 4632<PRE> 4633public void <B>setPanicHandler</B>(<A HREF="../../../com/sleepycat/db/PanicHandler.html" title="interface in com.sleepycat.db">PanicHandler</A> panicHandler)</PRE> 4634<DL> 4635<DD>Set the function to be called if the database environment panics. 4636<p> 4637Errors can occur in the Berkeley DB library where the only solution is 4638to shut down the application and run recovery (for example, if Berkeley 4639DB is unable to allocate heap memory). In such cases, the Berkeley DB 4640methods will throw a <A HREF="../../../com/sleepycat/db/RunRecoveryException.html" title="class in com.sleepycat.db"><CODE>RunRecoveryException</CODE></A>. It is often easier 4641to simply exit the application when such errors occur rather than 4642gracefully return up the stack. This method specifies a function to be 4643called when <A HREF="../../../com/sleepycat/db/RunRecoveryException.html" title="class in com.sleepycat.db"><CODE>RunRecoveryException</CODE></A> is about to be thrown from a 4644Berkeley DB method. 4645<p> 4646This method may be called at any time during the life of the application. 4647<p> 4648<P> 4649<DD><DL> 4650</DL> 4651</DD> 4652<DD><DL> 4653<DT><B>Parameters:</B><DD><CODE>panicHandler</CODE> - The function to be called if the database environment panics.</DL> 4654</DD> 4655</DL> 4656<HR> 4657 4658<A NAME="getPanicHandler()"><!-- --></A><H3> 4659getPanicHandler</H3> 4660<PRE> 4661public <A HREF="../../../com/sleepycat/db/PanicHandler.html" title="interface in com.sleepycat.db">PanicHandler</A> <B>getPanicHandler</B>()</PRE> 4662<DL> 4663<DD>Return the function to be called if the database environment panics. 4664<p> 4665This method may be called at any time during the life of the application. 4666<p> 4667<P> 4668<DD><DL> 4669</DL> 4670</DD> 4671<DD><DL> 4672 4673<DT><B>Returns:</B><DD>The function to be called if the database environment panics.</DL> 4674</DD> 4675</DL> 4676<HR> 4677 4678<A NAME="setPrivate(boolean)"><!-- --></A><H3> 4679setPrivate</H3> 4680<PRE> 4681public void <B>setPrivate</B>(boolean isPrivate)</PRE> 4682<DL> 4683<DD>Configure the database environment to only be accessed by a single 4684 process (although that process may be multithreaded). 4685 <p> 4686 This has two effects on the database environment. First, all 4687 underlying data structures are allocated from per-process memory 4688 instead of from shared memory that is potentially accessible to more 4689 than a single process. Second, mutexes are only configured to work 4690 between threads. 4691 <p> 4692 This flag should not be specified if more than a single process is 4693 accessing the environment because it is likely to cause database 4694 corruption and unpredictable behavior. For example, if both a 4695 server application and the a Berkeley DB utility are expected to 4696 access the environment, the database environment should not be 4697 configured as private. 4698 <p> 4699<P> 4700<DD><DL> 4701</DL> 4702</DD> 4703<DD><DL> 4704<DT><B>Parameters:</B><DD><CODE>isPrivate</CODE> - If true, configure the database environment to only be accessed by 4705 a single process.</DL> 4706</DD> 4707</DL> 4708<HR> 4709 4710<A NAME="getPrivate()"><!-- --></A><H3> 4711getPrivate</H3> 4712<PRE> 4713public boolean <B>getPrivate</B>()</PRE> 4714<DL> 4715<DD>Return true if the database environment is configured to only be accessed 4716 by a single process. 4717<p> 4718This method may be called at any time during the life of the application. 4719<p> 4720<P> 4721<DD><DL> 4722</DL> 4723</DD> 4724<DD><DL> 4725 4726<DT><B>Returns:</B><DD>True if the database environment is configured to only be accessed 4727 by a single process.</DL> 4728</DD> 4729</DL> 4730<HR> 4731 4732<A NAME="setReplicationClockskew(int, int)"><!-- --></A><H3> 4733setReplicationClockskew</H3> 4734<PRE> 4735public void <B>setReplicationClockskew</B>(int replicationClockskewFast, 4736 int replicationClockskewSlow)</PRE> 4737<DL> 4738<DD>Sets the clock skew ratio among replication group members based on the 4739 fastest and slowest measurements among the group for use with master leases. 4740 Calling this method is optional, the default values for clock skew assume no 4741 skew. The user must also configure leases via the 4742 <A HREF="../../../com/sleepycat/db/Environment.html#setReplicationConfig(com.sleepycat.db.ReplicationConfig, boolean)"><CODE>Environment.setReplicationConfig(com.sleepycat.db.ReplicationConfig, boolean)</CODE></A> method. Additionally, the user must 4743 also set the master lease timeout via the 4744 <A HREF="../../../com/sleepycat/db/Environment.html#setReplicationTimeout(com.sleepycat.db.ReplicationTimeoutType, int)"><CODE>Environment.setReplicationTimeout(com.sleepycat.db.ReplicationTimeoutType, int)</CODE></A> method and the number of sites in 4745 the replication group via the (@link #setReplicationNumSites} method. These 4746 methods may be called in any order. For a description of the clock skew 4747 values, see <a href="../../../../ref/rep/clock_skew.html">Clock skew</a>. 4748 For a description of master leases, see 4749 <a href="../../../../ref/rep/lease.html">Master leases</a>. 4750 <p> 4751 These arguments can be used to express either raw measurements of a clock 4752 timing experiment or a percentage across machines. For instance a group of 4753 sites have a 2% variance, then <code>replicationClockskewFast</code> should be given as 4754 102, and <code>replicationClockskewSlow</code> should be set at 100. Or, for a 0.03% 4755 difference, you can use 10003 and 10000 respectively. 4756 <p> 4757 The database environment's replication subsystem may also be configured using 4758 the environment's 4759 <a href="../../../../ref/env/db_config.html#DB_CONFIG">DB_CONFIG</a> file. 4760 The syntax of the entry in that file is a single line with the string 4761 "rep_set_clockskew", one or more whitespace characters, and the clockskew 4762 specified in two parts: the replicationClockskewFast and the replicationClockskewSlow. For example, 4763 "rep_set_clockskew 102 100". Because the 4764 <a href="../../../../ref/env/db_config.html#DB_CONFIG">DB_CONFIG</a> file is 4765 read when the database environment is opened, it will silently overrule 4766 configuration done before that time. 4767 <p> 4768 This method configures a database environment, not only operations performed 4769 using the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 4770 <p> 4771 This method may not be called after the <A HREF="../../../com/sleepycat/db/Environment.html#replicationManagerStart(int, com.sleepycat.db.ReplicationManagerStartPolicy)"><CODE>Environment.replicationManagerStart(int, com.sleepycat.db.ReplicationManagerStartPolicy)</CODE></A> or <A HREF="../../../com/sleepycat/db/Environment.html#startReplication(com.sleepycat.db.DatabaseEntry, boolean)"><CODE>Environment.startReplication(com.sleepycat.db.DatabaseEntry, boolean)</CODE></A> methods are called. 4772 <p> 4773<P> 4774<DD><DL> 4775</DL> 4776</DD> 4777<DD><DL> 4778<DT><B>Parameters:</B><DD><CODE>replicationClockskewFast</CODE> - The value, relative to the <code>replicationClockskewSlow</code>, of the fastest clock in the group of sites.<DD><CODE>replicationClockskewSlow</CODE> - The value of the slowest clock in the group of sites.</DL> 4779</DD> 4780</DL> 4781<HR> 4782 4783<A NAME="getReplicationClockskewFast()"><!-- --></A><H3> 4784getReplicationClockskewFast</H3> 4785<PRE> 4786public int <B>getReplicationClockskewFast</B>()</PRE> 4787<DL> 4788<DD>Return the current clock skew value for the fastest clock in the group of sites. 4789 <p> 4790 This method may be called at any time during the life of the application. 4791<P> 4792<DD><DL> 4793</DL> 4794</DD> 4795<DD><DL> 4796 4797<DT><B>Returns:</B><DD>The current clock skew value for the fastest clock in the group of sites.</DL> 4798</DD> 4799</DL> 4800<HR> 4801 4802<A NAME="getReplicationClockskewSlow()"><!-- --></A><H3> 4803getReplicationClockskewSlow</H3> 4804<PRE> 4805public int <B>getReplicationClockskewSlow</B>()</PRE> 4806<DL> 4807<DD>Return the current clock skew value for the slowest clock in the group of sites. 4808 <p> 4809 This method may be called at any time during the life of the application. 4810<P> 4811<DD><DL> 4812</DL> 4813</DD> 4814<DD><DL> 4815 4816<DT><B>Returns:</B><DD>The current clock skew value for the slowest clock in the group of sites.</DL> 4817</DD> 4818</DL> 4819<HR> 4820 4821<A NAME="setReplicationLimit(long)"><!-- --></A><H3> 4822setReplicationLimit</H3> 4823<PRE> 4824public void <B>setReplicationLimit</B>(long replicationLimit)</PRE> 4825<DL> 4826<DD>Impose a byte-count limit on the amount of data that will be 4827 transmitted from a site in a single call to <A HREF="../../../com/sleepycat/db/Environment.html#processReplicationMessage(com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, int)"><CODE>Environment.processReplicationMessage</CODE></A>. 4828 <p> 4829 This method configures a database environment, including all threads 4830of control accessing the database environment, not only the operations 4831performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 4832 <p> 4833 This method may not be called before the database environment is opened. 4834 <p> 4835<P> 4836<DD><DL> 4837</DL> 4838</DD> 4839<DD><DL> 4840<DT><B>Parameters:</B><DD><CODE>replicationLimit</CODE> - The maximum number of bytes that will be sent in a single call to 4841 <A HREF="../../../com/sleepycat/db/Environment.html#processReplicationMessage(com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, int)"><CODE>Environment.processReplicationMessage</CODE></A>.</DL> 4842</DD> 4843</DL> 4844<HR> 4845 4846<A NAME="getReplicationLimit()"><!-- --></A><H3> 4847getReplicationLimit</H3> 4848<PRE> 4849public long <B>getReplicationLimit</B>()</PRE> 4850<DL> 4851<DD>Return the transmit limit in bytes for a single call to 4852 <A HREF="../../../com/sleepycat/db/Environment.html#processReplicationMessage(com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, int)"><CODE>Environment.processReplicationMessage</CODE></A>. 4853 <p> 4854 This method may be called at any time during the life of the application. 4855 <p> 4856<P> 4857<DD><DL> 4858</DL> 4859</DD> 4860<DD><DL> 4861 4862<DT><B>Returns:</B><DD>The transmit limit in bytes for a single call to <A HREF="../../../com/sleepycat/db/Environment.html#processReplicationMessage(com.sleepycat.db.DatabaseEntry, com.sleepycat.db.DatabaseEntry, int)"><CODE>Environment.processReplicationMessage</CODE></A>.</DL> 4863</DD> 4864</DL> 4865<HR> 4866 4867<A NAME="setReplicationRequestMin(int)"><!-- --></A><H3> 4868setReplicationRequestMin</H3> 4869<PRE> 4870public void <B>setReplicationRequestMin</B>(int replicationRequestMin)</PRE> 4871<DL> 4872<DD>Set a threshold for the minimum time that a client waits before requesting 4873 retransmission of a missing message. Specifically, if the client detects a 4874 gap in the sequence of incoming log records or database pages, Berkeley DB 4875 will wait for at least <code>replicationRequestMin</code> microseconds before requesting 4876 retransmission of the missing record. Berkeley DB will double that amount 4877 before requesting the same missing record again, and so on, up to a maximum 4878 threshold, set by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setReplicationRequestMax(int)"><CODE>setReplicationRequestMax(int)</CODE></A>. 4879 <p> 4880 These values are thresholds only. Since Berkeley DB has no thread available 4881 in the library as a timer, the threshold is only checked when a thread enters 4882 the Berkeley DB library to process an incoming replication message. Any 4883 amount of time may have passed since the last message arrived and Berkeley DB 4884 only checks whether the amount of time since a request was made is beyond the 4885 threshold value or not. 4886 <p> 4887 By default the minimum is 40000 and the maximum is 1280000 (1.28 seconds). 4888 These defaults are fairly arbitrary and the application likely needs to 4889 adjust these. The values should be based on expected load and performance 4890 characteristics of the master and client host platforms and transport 4891 infrastructure as well as round-trip message time. 4892 <p> 4893<P> 4894<DD><DL> 4895</DL> 4896</DD> 4897<DD><DL> 4898<DT><B>Parameters:</B><DD><CODE>replicationRequestMin</CODE> - The minimum amount of time the client waits before requesting retransmission 4899 of a missing message.</DL> 4900</DD> 4901</DL> 4902<HR> 4903 4904<A NAME="getReplicationRequestMin()"><!-- --></A><H3> 4905getReplicationRequestMin</H3> 4906<PRE> 4907public int <B>getReplicationRequestMin</B>()</PRE> 4908<DL> 4909<DD>Get the threshold for the minimum amount of time that a client waits before 4910 requesting retransmission of a missed message. 4911 <p> 4912<P> 4913<DD><DL> 4914</DL> 4915</DD> 4916<DD><DL> 4917 4918<DT><B>Returns:</B><DD>The threshold for the minimum amount of time that a client waits before 4919 requesting retransmission of a missed message.</DL> 4920</DD> 4921</DL> 4922<HR> 4923 4924<A NAME="setReplicationRequestMax(int)"><!-- --></A><H3> 4925setReplicationRequestMax</H3> 4926<PRE> 4927public void <B>setReplicationRequestMax</B>(int replicationRequestMax)</PRE> 4928<DL> 4929<DD>Set a threshold for the maximum time that a client waits before requesting 4930 retransmission of a missing message. Specifically, if the client detects a 4931 gap in the sequence of incoming log records or database pages, Berkeley DB 4932 will wait for at least the minimum threshold, set by 4933 <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setReplicationRequestMin(int)"><CODE>setReplicationRequestMin(int)</CODE></A>, before requesting retransmission of the 4934 missing record. Berkeley DB will double that amount before requesting the 4935 same missing record again, and so on, up to <code>replicationRequestMax</code>. 4936 <p> 4937 These values are thresholds only. Since Berkeley DB has no thread available 4938 in the library as a timer, the threshold is only checked when a thread enters 4939 the Berkeley DB library to process an incoming replication message. Any 4940 amount of time may have passed since the last message arrived and Berkeley DB 4941 only checks whether the amount of time since a request was made is beyond the 4942 threshold value or not. 4943 <p> 4944 By default the minimum is 40000 and the maximum is 1280000 (1.28 seconds). 4945 These defaults are fairly arbitrary and the application likely needs to 4946 adjust these. The values should be based on expected load and performance 4947 characteristics of the master and client host platforms and transport 4948 infrastructure as well as round-trip message time. 4949 <p> 4950<P> 4951<DD><DL> 4952</DL> 4953</DD> 4954<DD><DL> 4955<DT><B>Parameters:</B><DD><CODE>replicationRequestMax</CODE> - The maximum amount of time the client waits before requesting retransmission 4956 of a missing message.</DL> 4957</DD> 4958</DL> 4959<HR> 4960 4961<A NAME="getReplicationRequestMax()"><!-- --></A><H3> 4962getReplicationRequestMax</H3> 4963<PRE> 4964public int <B>getReplicationRequestMax</B>()</PRE> 4965<DL> 4966<DD>Get the threshold for the maximum amount of time that a client waits before 4967 requesting retransmission of a missed message. 4968 <p> 4969<P> 4970<DD><DL> 4971</DL> 4972</DD> 4973<DD><DL> 4974 4975<DT><B>Returns:</B><DD>The threshold for the maximum amount of time that a client waits before 4976 requesting retransmission of a missed message.</DL> 4977</DD> 4978</DL> 4979<HR> 4980 4981<A NAME="setReplicationTransport(int, com.sleepycat.db.ReplicationTransport)"><!-- --></A><H3> 4982setReplicationTransport</H3> 4983<PRE> 4984public void <B>setReplicationTransport</B>(int envid, 4985 <A HREF="../../../com/sleepycat/db/ReplicationTransport.html" title="interface in com.sleepycat.db">ReplicationTransport</A> replicationTransport)</PRE> 4986<DL> 4987<DD>Initialize the communication infrastructure for a database environment 4988 participating in a replicated application. 4989 <p> 4990 This method configures only operations performed using a single a 4991<A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle, not an entire database environment. 4992 <p> 4993 This method may be called at any time during the life of the application. 4994 <p> 4995<P> 4996<DD><DL> 4997</DL> 4998</DD> 4999<DD><DL> 5000<DT><B>Parameters:</B><DD><CODE>envid</CODE> - The local environment's ID. It must be a positive integer and 5001 uniquely identify this Berkeley DB database environment. 5002 <p><DD><CODE>replicationTransport</CODE> - The callback function is used to transmit data using the replication 5003 application's communication infrastructure.</DL> 5004</DD> 5005</DL> 5006<HR> 5007 5008<A NAME="getReplicationTransport()"><!-- --></A><H3> 5009getReplicationTransport</H3> 5010<PRE> 5011public <A HREF="../../../com/sleepycat/db/ReplicationTransport.html" title="interface in com.sleepycat.db">ReplicationTransport</A> <B>getReplicationTransport</B>()</PRE> 5012<DL> 5013<DD>Return the replication callback function used to transmit data using 5014 the replication application's communication infrastructure. 5015 <p> 5016<P> 5017<DD><DL> 5018</DL> 5019</DD> 5020<DD><DL> 5021 5022<DT><B>Returns:</B><DD>The replication callback function used to transmit data using the 5023 replication application's communication infrastructure.</DL> 5024</DD> 5025</DL> 5026<HR> 5027 5028<A NAME="setRegister(boolean)"><!-- --></A><H3> 5029setRegister</H3> 5030<PRE> 5031public void <B>setRegister</B>(boolean register)</PRE> 5032<DL> 5033<DD>Check if a process has failed while using the database environment, that 5034 is, if a process has exited with an open <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. (For 5035 this check to be accurate, all processes using the environment must 5036 specify this flag when opening the environment.) If recovery 5037 needs to be run for any reason and either <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setRunRecovery(boolean)"><CODE>setRunRecovery(boolean)</CODE></A> or 5038 <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setRunFatalRecovery(boolean)"><CODE>setRunFatalRecovery(boolean)</CODE></A> are also specified, recovery will be performed 5039 and the open will proceed normally. If recovery needs to be run and no 5040 recovery flag is specified, a <A HREF="../../../com/sleepycat/db/RunRecoveryException.html" title="class in com.sleepycat.db"><CODE>RunRecoveryException</CODE></A> will be thrown. 5041 If recovery does not need to be run, the recovery flags will be ignored. 5042 See 5043 <a href="../../../../ref/transapp/app.html" target="_top">Architecting 5044 Transactional Data Store applications</a>) for more information. 5045 <p> 5046<P> 5047<DD><DL> 5048</DL> 5049</DD> 5050<DD><DL> 5051<DT><B>Parameters:</B><DD><CODE>register</CODE> - If true, check for process failure when the environment is opened.</DL> 5052</DD> 5053</DL> 5054<HR> 5055 5056<A NAME="getRegister()"><!-- --></A><H3> 5057getRegister</H3> 5058<PRE> 5059public boolean <B>getRegister</B>()</PRE> 5060<DL> 5061<DD>Return true if the check for process failure when the environment is opened. 5062<p> 5063This method may be called at any time during the life of the application. 5064<p> 5065<P> 5066<DD><DL> 5067</DL> 5068</DD> 5069<DD><DL> 5070 5071<DT><B>Returns:</B><DD>True if the check for process failure when the environment is opened.</DL> 5072</DD> 5073</DL> 5074<HR> 5075 5076<A NAME="setRunFatalRecovery(boolean)"><!-- --></A><H3> 5077setRunFatalRecovery</H3> 5078<PRE> 5079public void <B>setRunFatalRecovery</B>(boolean runFatalRecovery)</PRE> 5080<DL> 5081<DD>Configure to run catastrophic recovery on this environment before opening it for 5082normal use. 5083<p> 5084A standard part of the recovery process is to remove the existing 5085database environment and create a new one. Applications running 5086recovery must be prepared to re-create the environment because 5087underlying shared regions will be removed and re-created. 5088<p> 5089If the thread of control performing recovery does not specify the 5090correct database environment initialization information (for example, 5091the correct memory pool cache size), the result can be an application 5092running in an environment with incorrect cache and other subsystem 5093sizes. For this reason, the thread of control performing recovery 5094should specify correct configuration information before recovering the 5095environment; or it should remove the environment after recovery is 5096completed, leaving creation of a correctly sized environment to a 5097subsequent call. 5098<p> 5099All recovery processing must be single-threaded; that is, only a single 5100thread of control may perform recovery or access a database environment 5101while recovery is being performed. Because it is not an error to run 5102recovery for an environment for which no recovery is required, it is 5103reasonable programming practice for the thread of control responsible 5104for performing recovery and creating the environment to always specify 5105recovery during startup. 5106<p> 5107This method returns successfully if recovery is run no log files exist, 5108so it is necessary to ensure that all necessary log files are present 5109before running recovery. 5110<p> 5111<P> 5112<DD><DL> 5113</DL> 5114</DD> 5115<DD><DL> 5116<DT><B>Parameters:</B><DD><CODE>runFatalRecovery</CODE> - If true, configure to run catastrophic recovery on this environment 5117before opening it for normal use.</DL> 5118</DD> 5119</DL> 5120<HR> 5121 5122<A NAME="getRunFatalRecovery()"><!-- --></A><H3> 5123getRunFatalRecovery</H3> 5124<PRE> 5125public boolean <B>getRunFatalRecovery</B>()</PRE> 5126<DL> 5127<DD>Return the handle is configured to run catastrophic recovery on 5128 the database environment before opening it for use. 5129<p> 5130This method may be called at any time during the life of the application. 5131<p> 5132<P> 5133<DD><DL> 5134</DL> 5135</DD> 5136<DD><DL> 5137 5138<DT><B>Returns:</B><DD>The handle is configured to run catastrophic recovery on 5139 the database environment before opening it for use.</DL> 5140</DD> 5141</DL> 5142<HR> 5143 5144<A NAME="setRunRecovery(boolean)"><!-- --></A><H3> 5145setRunRecovery</H3> 5146<PRE> 5147public void <B>setRunRecovery</B>(boolean runRecovery)</PRE> 5148<DL> 5149<DD>Configure to run normal recovery on this environment before opening it for 5150normal use. 5151<p> 5152A standard part of the recovery process is to remove the existing 5153database environment and create a new one. Applications running 5154recovery must be prepared to re-create the environment because 5155underlying shared regions will be removed and re-created. 5156<p> 5157If the thread of control performing recovery does not specify the 5158correct database environment initialization information (for example, 5159the correct memory pool cache size), the result can be an application 5160running in an environment with incorrect cache and other subsystem 5161sizes. For this reason, the thread of control performing recovery 5162should specify correct configuration information before recovering the 5163environment; or it should remove the environment after recovery is 5164completed, leaving creation of a correctly sized environment to a 5165subsequent call. 5166<p> 5167All recovery processing must be single-threaded; that is, only a single 5168thread of control may perform recovery or access a database environment 5169while recovery is being performed. Because it is not an error to run 5170recovery for an environment for which no recovery is required, it is 5171reasonable programming practice for the thread of control responsible 5172for performing recovery and creating the environment to always specify 5173recovery during startup. 5174<p> 5175This method returns successfully if recovery is run no log files exist, 5176so it is necessary to ensure that all necessary log files are present 5177before running recovery. 5178<p> 5179<P> 5180<DD><DL> 5181</DL> 5182</DD> 5183<DD><DL> 5184<DT><B>Parameters:</B><DD><CODE>runRecovery</CODE> - If true, configure to run normal recovery on this environment 5185before opening it for normal use.</DL> 5186</DD> 5187</DL> 5188<HR> 5189 5190<A NAME="getRunRecovery()"><!-- --></A><H3> 5191getRunRecovery</H3> 5192<PRE> 5193public boolean <B>getRunRecovery</B>()</PRE> 5194<DL> 5195<DD>Return the handle is configured to run normal recovery on the 5196 database environment before opening it for use. 5197<p> 5198This method may be called at any time during the life of the application. 5199<p> 5200<P> 5201<DD><DL> 5202</DL> 5203</DD> 5204<DD><DL> 5205 5206<DT><B>Returns:</B><DD>The handle is configured to run normal recovery on the 5207 database environment before opening it for use.</DL> 5208</DD> 5209</DL> 5210<HR> 5211 5212<A NAME="setSystemMemory(boolean)"><!-- --></A><H3> 5213setSystemMemory</H3> 5214<PRE> 5215public void <B>setSystemMemory</B>(boolean systemMemory)</PRE> 5216<DL> 5217<DD>Configure the database environment to allocate memory from system 5218 shared memory instead of from memory backed by the filesystem. 5219 <p> 5220<P> 5221<DD><DL> 5222</DL> 5223</DD> 5224<DD><DL> 5225<DT><B>Parameters:</B><DD><CODE>systemMemory</CODE> - If true, configure the database environment to allocate memory from 5226 system shared memory instead of from memory backed by the filesystem.</DL> 5227</DD> 5228</DL> 5229<HR> 5230 5231<A NAME="getSystemMemory()"><!-- --></A><H3> 5232getSystemMemory</H3> 5233<PRE> 5234public boolean <B>getSystemMemory</B>()</PRE> 5235<DL> 5236<DD>Return true if the database environment is configured to allocate memory 5237 from system shared memory instead of from memory backed by the 5238 filesystem. 5239<p> 5240This method may be called at any time during the life of the application. 5241<p> 5242<P> 5243<DD><DL> 5244</DL> 5245</DD> 5246<DD><DL> 5247 5248<DT><B>Returns:</B><DD>True if the database environment is configured to allocate memory 5249 from system shared memory instead of from memory backed by the 5250 filesystem.</DL> 5251</DD> 5252</DL> 5253<HR> 5254 5255<A NAME="setRPCServer(java.lang.String, long, long)"><!-- --></A><H3> 5256setRPCServer</H3> 5257<PRE> 5258public void <B>setRPCServer</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> rpcServer, 5259 long rpcClientTimeout, 5260 long rpcServerTimeout)</PRE> 5261<DL> 5262<DD>Establish a connection to a RPC server for this database environment. 5263 <p> 5264 After this method is called, subsequent calls to Berkeley DB library 5265 interfaces may throw exceptions encapsulating DB_NOSERVER, 5266 DB_NOSERVER_ID or DB_NOSERVER_HOME. 5267 <p> 5268 This method configures only operations performed using a single a 5269<A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle, not an entire database environment. 5270 <p> 5271 This method may not be called after the 5272environment has been opened. 5273 <p> 5274<P> 5275<DD><DL> 5276</DL> 5277</DD> 5278<DD><DL> 5279<DT><B>Parameters:</B><DD><CODE>rpcServer</CODE> - The host to which the client will connect and create a channel for 5280 communication. 5281 <p><DD><CODE>rpcClientTimeout</CODE> - The number of seconds the client should wait for results to come 5282 back from the server. Once the timeout has expired on any 5283 communication with the server, <A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db"><CODE>DatabaseException</CODE></A> 5284 encapsulating DB_NOSERVER will be thrown. If this value is zero, a 5285 default timeout is used. 5286 <p><DD><CODE>rpcServerTimeout</CODE> - The number of seconds the server should allow a client connection 5287 to remain idle before assuming that the client is gone. Once that 5288 timeout has been reached, the server releases all resources 5289 associated with that client connection. Subsequent attempts by that 5290 client to communicate with the server result in an error return, 5291 indicating that an invalid identifier has been given to the server. 5292 This value can be considered a hint to the server. The server may 5293 alter this value based on its own policies or allowed values. If 5294 this value is zero, a default timeout is used.</DL> 5295</DD> 5296</DL> 5297<HR> 5298 5299<A NAME="setSegmentId(long)"><!-- --></A><H3> 5300setSegmentId</H3> 5301<PRE> 5302public void <B>setSegmentId</B>(long segmentId)</PRE> 5303<DL> 5304<DD>Specify a base segment ID for database environment shared memory 5305 regions created in system memory on VxWorks or systems supporting 5306 X/Open-style shared memory interfaces; for example, UNIX systems 5307 supporting <code>shmget</code> and related System V IPC interfaces. 5308 <p> 5309 This base segment ID will be used when database environment shared 5310 memory regions are first created. It will be incremented a small 5311 integer value each time a new shared memory region is created; that 5312 is, if the base ID is 35, the first shared memory region created 5313 will have a segment ID of 35, and the next one will have a segment 5314 ID between 36 and 40 or so. A database environment always creates 5315 a master shared memory region; an additional shared memory region 5316 for each of the subsystems supported by the environment (Locking, 5317 Logging, Memory Pool and Transaction); plus an additional shared 5318 memory region for each additional memory pool cache that is 5319 supported. Already existing regions with the same segment IDs will 5320 be removed. 5321 <p> 5322 The intent behind this method is two-fold: without it, applications 5323 have no way to ensure that two Berkeley DB applications don't 5324 attempt to use the same segment IDs when creating different database 5325 environments. In addition, by using the same segment IDs each time 5326 the environment is created, previously created segments will be 5327 removed, and the set of segments on the system will not grow without 5328 bound. 5329 The database environment's base segment ID may also be set using the environment's 5330DB_CONFIG file. The syntax of the entry in that file is a single line 5331with the string "set_shm_key", one or more whitespace characters, and the ID. 5332Because the DB_CONFIG file is read when the database environment is 5333opened, it will silently overrule configuration done before that time. 5334 <p> 5335 This method configures only operations performed using a single a 5336<A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle, not an entire database environment. 5337 <p> 5338 This method may not be called after the 5339environment has been opened. 5340If joining an existing database environment, the 5341information specified to this method must be consistent with the 5342existing environment or corruption can occur. 5343 <p> 5344<P> 5345<DD><DL> 5346</DL> 5347</DD> 5348<DD><DL> 5349<DT><B>Parameters:</B><DD><CODE>segmentId</CODE> - The base segment ID for the database environment.</DL> 5350</DD> 5351</DL> 5352<HR> 5353 5354<A NAME="getSegmentId()"><!-- --></A><H3> 5355getSegmentId</H3> 5356<PRE> 5357public long <B>getSegmentId</B>()</PRE> 5358<DL> 5359<DD>Return the base segment ID. 5360<p> 5361This method may be called at any time during the life of the application. 5362<p> 5363<P> 5364<DD><DL> 5365</DL> 5366</DD> 5367<DD><DL> 5368 5369<DT><B>Returns:</B><DD>The base segment ID.</DL> 5370</DD> 5371</DL> 5372<HR> 5373 5374<A NAME="setTemporaryDirectory(java.io.File)"><!-- --></A><H3> 5375setTemporaryDirectory</H3> 5376<PRE> 5377public void <B>setTemporaryDirectory</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/File.html" title="class or interface in java.io">File</A> temporaryDirectory)</PRE> 5378<DL> 5379<DD>Set the path of a directory to be used as the location of temporary 5380 files. 5381 <p> 5382 The files created to back in-memory access method databases will be 5383 created relative to this path. These temporary files can be quite 5384 large, depending on the size of the database. 5385 <p> 5386 If no directory is specified, the following alternatives are checked 5387 in the specified order. The first existing directory path is used 5388 for all temporary files. 5389 <blockquote><ol> 5390 <li>The value of the environment variable TMPDIR. 5391 <li>The value of the environment variable TEMP. 5392 <li>The value of the environment variable TMP. 5393 <li>The value of the environment variable TempFolder. 5394 <li>The value returned by the GetTempPath interface. 5395 <li>The directory /var/tmp. 5396 <li>The directory /usr/tmp. 5397 <li>The directory /temp. 5398 <li>The directory /tmp. 5399 <li>The directory C:/temp. 5400 <li>The directory C:/tmp. 5401 </ol</blockquote> 5402 <p> 5403 Note: the environment variables are only checked if the database 5404 environment has been configured with one of 5405 <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setUseEnvironment(boolean)"><CODE>EnvironmentConfig.setUseEnvironment</CODE></A> or 5406 <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setUseEnvironmentRoot(boolean)"><CODE>EnvironmentConfig.setUseEnvironmentRoot</CODE></A>. 5407 <p> 5408 Note: the GetTempPath interface is only checked on Win/32 platforms. 5409 <p> 5410 The database environment's temporary file directory may also be set using the environment's 5411DB_CONFIG file. The syntax of the entry in that file is a single line 5412with the string "set_tmp_dir", one or more whitespace characters, and the directory name. 5413Because the DB_CONFIG file is read when the database environment is 5414opened, it will silently overrule configuration done before that time. 5415 <p> 5416 This method configures only operations performed using a single a 5417<A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle, not an entire database environment. 5418 <p> 5419 This method may not be called after the 5420environment has been opened. 5421If joining an existing database environment, the 5422information specified to this method must be consistent with the 5423existing environment or corruption can occur. 5424 <p> 5425<P> 5426<DD><DL> 5427</DL> 5428</DD> 5429<DD><DL> 5430<DT><B>Parameters:</B><DD><CODE>temporaryDirectory</CODE> - The directory to be used to store temporary files. 5431 On Windows platforms, this argument will be interpreted as a UTF-8 5432string, which is equivalent to ASCII for Latin characters.</DL> 5433</DD> 5434</DL> 5435<HR> 5436 5437<A NAME="setTemporaryDirectory(java.lang.String)"><!-- --></A><H3> 5438setTemporaryDirectory</H3> 5439<PRE> 5440public void <B>setTemporaryDirectory</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> temporaryDirectory)</PRE> 5441<DL> 5442<DD><B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setTemporaryDirectory(java.io.File)"><CODE>setTemporaryDirectory(java.io.File)</CODE></A></I> 5443<P> 5444<DD><DL> 5445</DL> 5446</DD> 5447<DD><DL> 5448</DL> 5449</DD> 5450</DL> 5451<HR> 5452 5453<A NAME="getTemporaryDirectory()"><!-- --></A><H3> 5454getTemporaryDirectory</H3> 5455<PRE> 5456public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/io/File.html" title="class or interface in java.io">File</A> <B>getTemporaryDirectory</B>()</PRE> 5457<DL> 5458<DD>Return the path of a directory to be used as the location of 5459 temporary files. 5460<p> 5461This method may be called at any time during the life of the application. 5462<p> 5463<P> 5464<DD><DL> 5465</DL> 5466</DD> 5467<DD><DL> 5468 5469<DT><B>Returns:</B><DD>The path of a directory to be used as the location of 5470 temporary files.</DL> 5471</DD> 5472</DL> 5473<HR> 5474 5475<A NAME="setMutexAlignment(int)"><!-- --></A><H3> 5476setMutexAlignment</H3> 5477<PRE> 5478public void <B>setMutexAlignment</B>(int mutexAlignment)</PRE> 5479<DL> 5480<DD>Set the mutex alignment, in bytes. 5481 <p> 5482 It is sometimes advantageous to align mutexes on specific byte 5483 boundaries in order to minimize cache line collisions. This method 5484 specifies an alignment for mutexes allocated by Berkeley DB. 5485 <p> 5486 The database environment's mutex alignment may also be set using the environment's 5487DB_CONFIG file. The syntax of the entry in that file is a single line 5488with the string "mutex_set_align", one or more whitespace characters, and the mutex alignment in bytes. 5489Because the DB_CONFIG file is read when the database environment is 5490opened, it will silently overrule configuration done before that time. 5491 <p> 5492 This method configures a database environment, including all threads 5493of control accessing the database environment, not only the operations 5494performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 5495 <p> 5496 This method may not be called after the 5497environment has been opened. 5498If joining an existing database environment, any 5499information specified to this method will be ignored. 5500<P> 5501<DD><DL> 5502</DL> 5503</DD> 5504<DD><DL> 5505<DT><B>Parameters:</B><DD><CODE>mutexAlignment</CODE> - mutex alignment, in bytes. The mutex alignment must be a power-of-two.</DL> 5506</DD> 5507</DL> 5508<HR> 5509 5510<A NAME="getMutexAlignment()"><!-- --></A><H3> 5511getMutexAlignment</H3> 5512<PRE> 5513public int <B>getMutexAlignment</B>()</PRE> 5514<DL> 5515<DD>Return the mutex alignment, in bytes. 5516<p> 5517This method may be called at any time during the life of the application. 5518<p> 5519<P> 5520<DD><DL> 5521</DL> 5522</DD> 5523<DD><DL> 5524 5525<DT><B>Returns:</B><DD>The mutex alignment, in bytes.</DL> 5526</DD> 5527</DL> 5528<HR> 5529 5530<A NAME="setMutexIncrement(int)"><!-- --></A><H3> 5531setMutexIncrement</H3> 5532<PRE> 5533public void <B>setMutexIncrement</B>(int mutexIncrement)</PRE> 5534<DL> 5535<DD>Increase the number of mutexes to allocate. 5536 <p> 5537 Berkeley DB allocates a default number of mutexes based on the initial 5538 configuration of the database environment. That default calculation may 5539 be too small if the application has an unusual need for mutexes (for 5540 example, if the application opens an unexpectedly large number of 5541 databases) or too large (if the application is trying to minimize its 5542 memory footprint). This method configure the number of additional 5543 mutexes to allocate. 5544 <p> 5545 Calling this method discards any value previously 5546 set using the <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMaxMutexes(int)"><CODE>setMaxMutexes(int)</CODE></A> method. 5547 <p> 5548 This method configures a database environment, including all threads 5549of control accessing the database environment, not only the operations 5550performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 5551 <p> 5552 This method may not be called after the 5553environment has been opened. 5554If joining an existing database environment, any 5555information specified to this method will be ignored. 5556 <p> 5557<P> 5558<DD><DL> 5559</DL> 5560</DD> 5561<DD><DL> 5562<DT><B>Parameters:</B><DD><CODE>mutexIncrement</CODE> - The number of additional mutexes to allocate.</DL> 5563</DD> 5564</DL> 5565<HR> 5566 5567<A NAME="getMutexIncrement()"><!-- --></A><H3> 5568getMutexIncrement</H3> 5569<PRE> 5570public int <B>getMutexIncrement</B>()</PRE> 5571<DL> 5572<DD>Return the number of additional mutexes to allocate. 5573<p> 5574This method may be called at any time during the life of the application. 5575<p> 5576<P> 5577<DD><DL> 5578</DL> 5579</DD> 5580<DD><DL> 5581 5582<DT><B>Returns:</B><DD>The number of additional mutexes to allocate.</DL> 5583</DD> 5584</DL> 5585<HR> 5586 5587<A NAME="setMaxMutexes(int)"><!-- --></A><H3> 5588setMaxMutexes</H3> 5589<PRE> 5590public void <B>setMaxMutexes</B>(int maxMutexes)</PRE> 5591<DL> 5592<DD>Set the total number of mutexes to allocate. 5593 <p> 5594 Berkeley DB allocates a default number of mutexes based on the initial 5595 configuration of the database environment. That default calculation may 5596 be too small if the application has an unusual need for mutexes (for 5597 example, if the application opens an unexpectedly large number of 5598 databases) or too large (if the application is trying to minimize its 5599 memory footprint). This method is used to specify an 5600 absolute number of mutexes to allocate. 5601 <p> 5602 Calling this method discards any value previously 5603 set using the <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMutexIncrement(int)"><CODE>setMutexIncrement(int)</CODE></A> method. 5604 <p> 5605 The database environment's total number of mutexes may also be set using 5606 the environment's <b>DB_CONFIG</b> file. The syntax of the entry in that 5607 file is a single line with the string "mutex_set_max", one or more 5608 whitespace characters, and the total number of mutexes. Because the 5609 <b>DB_CONFIG</b> file is read when the database environment is opened, it 5610 will silently overrule configuration done before that time. 5611 <p> 5612 This method configures a database environment, including all threads 5613of control accessing the database environment, not only the operations 5614performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 5615 <p> 5616 This method may not be called after the 5617environment has been opened. 5618If joining an existing database environment, any 5619information specified to this method will be ignored. 5620 <p> 5621<P> 5622<DD><DL> 5623</DL> 5624</DD> 5625<DD><DL> 5626<DT><B>Parameters:</B><DD><CODE>maxMutexes</CODE> - The absolute number of mutexes to allocate.</DL> 5627</DD> 5628</DL> 5629<HR> 5630 5631<A NAME="getMaxMutexes()"><!-- --></A><H3> 5632getMaxMutexes</H3> 5633<PRE> 5634public int <B>getMaxMutexes</B>()</PRE> 5635<DL> 5636<DD>Return the total number of mutexes allocated. 5637<p> 5638This method may be called at any time during the life of the application. 5639<p> 5640<P> 5641<DD><DL> 5642</DL> 5643</DD> 5644<DD><DL> 5645 5646<DT><B>Returns:</B><DD>The total number of mutexes allocated.</DL> 5647</DD> 5648</DL> 5649<HR> 5650 5651<A NAME="setMutexTestAndSetSpins(int)"><!-- --></A><H3> 5652setMutexTestAndSetSpins</H3> 5653<PRE> 5654public void <B>setMutexTestAndSetSpins</B>(int mutexTestAndSetSpins)</PRE> 5655<DL> 5656<DD>Specify the number of times that test-and-set mutexes should spin 5657 without blocking. The value defaults to 1 on uniprocessor systems and 5658 to 50 times the number of processors on multiprocessor systems. 5659 <p> 5660 The database environment's test-and-set spin count may also be set using the environment's 5661DB_CONFIG file. The syntax of the entry in that file is a single line 5662with the string "set_tas_spins", one or more whitespace characters, and the number of spins. 5663Because the DB_CONFIG file is read when the database environment is 5664opened, it will silently overrule configuration done before that time. 5665 <p> 5666 This method configures only operations performed using a single a 5667<A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle, not an entire database environment. 5668 <p> 5669 This method may be called at any time during the life of the application. 5670 <p> 5671<P> 5672<DD><DL> 5673</DL> 5674</DD> 5675<DD><DL> 5676<DT><B>Parameters:</B><DD><CODE>mutexTestAndSetSpins</CODE> - The number of spins test-and-set mutexes should execute before blocking.</DL> 5677</DD> 5678</DL> 5679<HR> 5680 5681<A NAME="getMutexTestAndSetSpins()"><!-- --></A><H3> 5682getMutexTestAndSetSpins</H3> 5683<PRE> 5684public int <B>getMutexTestAndSetSpins</B>()</PRE> 5685<DL> 5686<DD>Return the test-and-set spin count. 5687<p> 5688This method may be called at any time during the life of the application. 5689<p> 5690<P> 5691<DD><DL> 5692</DL> 5693</DD> 5694<DD><DL> 5695 5696<DT><B>Returns:</B><DD>The test-and-set spin count.</DL> 5697</DD> 5698</DL> 5699<HR> 5700 5701<A NAME="setReplicationNumSites(int)"><!-- --></A><H3> 5702setReplicationNumSites</H3> 5703<PRE> 5704public void <B>setReplicationNumSites</B>(int replicationNumSites)</PRE> 5705<DL> 5706<DD>Set the total number of sites in the replication group. 5707 <p> 5708<P> 5709<DD><DL> 5710</DL> 5711</DD> 5712<DD><DL> 5713<DT><B>Parameters:</B><DD><CODE>replicationNumSites</CODE> - The total number of sites in the replication group.</DL> 5714</DD> 5715</DL> 5716<HR> 5717 5718<A NAME="getReplicationNumSites()"><!-- --></A><H3> 5719getReplicationNumSites</H3> 5720<PRE> 5721public int <B>getReplicationNumSites</B>()</PRE> 5722<DL> 5723<DD>Get the total number of sites in the replication group. 5724 <p> 5725<P> 5726<DD><DL> 5727</DL> 5728</DD> 5729<DD><DL> 5730 5731<DT><B>Returns:</B><DD>The total number of sites in the replication group.</DL> 5732</DD> 5733</DL> 5734<HR> 5735 5736<A NAME="setReplicationPriority(int)"><!-- --></A><H3> 5737setReplicationPriority</H3> 5738<PRE> 5739public void <B>setReplicationPriority</B>(int replicationPriority)</PRE> 5740<DL> 5741<DD>Set the current environment's priority. Priority is used to determine 5742 which replicated site will be selected as master when an election occurs. 5743 <p> 5744<P> 5745<DD><DL> 5746</DL> 5747</DD> 5748<DD><DL> 5749<DT><B>Parameters:</B><DD><CODE>replicationPriority</CODE> - The database environment priority.</DL> 5750</DD> 5751</DL> 5752<HR> 5753 5754<A NAME="getReplicationPriority()"><!-- --></A><H3> 5755getReplicationPriority</H3> 5756<PRE> 5757public int <B>getReplicationPriority</B>()</PRE> 5758<DL> 5759<DD>Get the current environment's priority. Priority is used to determine 5760 which replicated site will be selected as master when an election occurs. 5761 <p> 5762<P> 5763<DD><DL> 5764</DL> 5765</DD> 5766<DD><DL> 5767 5768<DT><B>Returns:</B><DD>The database environment priority.</DL> 5769</DD> 5770</DL> 5771<HR> 5772 5773<A NAME="setTestAndSetSpins(int)"><!-- --></A><H3> 5774setTestAndSetSpins</H3> 5775<PRE> 5776public void <B>setTestAndSetSpins</B>(int mutexTestAndSetSpins)</PRE> 5777<DL> 5778<DD><B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setMutexTestAndSetSpins(int)"><CODE>setMutexTestAndSetSpins(int)</CODE></A></I> 5779<P> 5780<DD>Set the number of times test-and-set mutexes should spin before 5781 blocking. 5782 <p> 5783 The value defaults to 1 on uniprocessor systems and to 50 times the 5784 number of processors on multiprocessor systems. 5785 <p> 5786 This method configures only operations performed using a single a 5787<A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle, not an entire database environment. 5788 <p> 5789 This method may be called at any time during the life of the application. 5790 <p> 5791<P> 5792<DD><DL> 5793</DL> 5794</DD> 5795<DD><DL> 5796<DT><B>Parameters:</B><DD><CODE>mutexTestAndSetSpins</CODE> - The number of times test-and-set mutexes should spin before blocking. 5797 <p></DL> 5798</DD> 5799</DL> 5800<HR> 5801 5802<A NAME="getTestAndSetSpins()"><!-- --></A><H3> 5803getTestAndSetSpins</H3> 5804<PRE> 5805public int <B>getTestAndSetSpins</B>()</PRE> 5806<DL> 5807<DD><B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getMutexTestAndSetSpins()"><CODE>getMutexTestAndSetSpins()</CODE></A></I> 5808<P> 5809<DD>Return the number of times test-and-set mutexes should spin before 5810 blocking. 5811<p> 5812This method may be called at any time during the life of the application. 5813<p> 5814<P> 5815<DD><DL> 5816</DL> 5817</DD> 5818<DD><DL> 5819 5820<DT><B>Returns:</B><DD>The number of times test-and-set mutexes should spin before 5821 blocking. 5822 <p></DL> 5823</DD> 5824</DL> 5825<HR> 5826 5827<A NAME="setThreaded(boolean)"><!-- --></A><H3> 5828setThreaded</H3> 5829<PRE> 5830public void <B>setThreaded</B>(boolean threaded)</PRE> 5831<DL> 5832<DD>Configure the handle to be <em>free-threaded</em>; that is, usable 5833 by multiple threads within a single address space. 5834 <p> 5835 This is the default; threading is always assumed in Java, so no special 5836 configuration is required. 5837 <p> 5838<P> 5839<DD><DL> 5840</DL> 5841</DD> 5842<DD><DL> 5843<DT><B>Parameters:</B><DD><CODE>threaded</CODE> - If true, configure the handle to be <em>free-threaded</em>.</DL> 5844</DD> 5845</DL> 5846<HR> 5847 5848<A NAME="getThreaded()"><!-- --></A><H3> 5849getThreaded</H3> 5850<PRE> 5851public boolean <B>getThreaded</B>()</PRE> 5852<DL> 5853<DD>Return true if the handle is configured to be <em>free-threaded</em>. 5854<p> 5855This method may be called at any time during the life of the application. 5856<p> 5857<P> 5858<DD><DL> 5859</DL> 5860</DD> 5861<DD><DL> 5862 5863<DT><B>Returns:</B><DD>True if the handle is configured to be <em>free-threaded</em>.</DL> 5864</DD> 5865</DL> 5866<HR> 5867 5868<A NAME="setTransactional(boolean)"><!-- --></A><H3> 5869setTransactional</H3> 5870<PRE> 5871public void <B>setTransactional</B>(boolean transactional)</PRE> 5872<DL> 5873<DD>Configure the database environment for transactions. 5874 <p> 5875 This configuration option should be used when transactional guarantees 5876 such as atomicity of multiple operations and durability are important. 5877 <p> 5878<P> 5879<DD><DL> 5880</DL> 5881</DD> 5882<DD><DL> 5883<DT><B>Parameters:</B><DD><CODE>transactional</CODE> - If true, configure the database environment for transactions.</DL> 5884</DD> 5885</DL> 5886<HR> 5887 5888<A NAME="getTransactional()"><!-- --></A><H3> 5889getTransactional</H3> 5890<PRE> 5891public boolean <B>getTransactional</B>()</PRE> 5892<DL> 5893<DD>Return true if the database environment is configured for transactions. 5894<p> 5895This method may be called at any time during the life of the application. 5896<p> 5897<P> 5898<DD><DL> 5899</DL> 5900</DD> 5901<DD><DL> 5902 5903<DT><B>Returns:</B><DD>True if the database environment is configured for transactions.</DL> 5904</DD> 5905</DL> 5906<HR> 5907 5908<A NAME="setTxnNoSync(boolean)"><!-- --></A><H3> 5909setTxnNoSync</H3> 5910<PRE> 5911public void <B>setTxnNoSync</B>(boolean txnNoSync)</PRE> 5912<DL> 5913<DD>Configure the system to not write or synchronously flush the log 5914 on transaction commit. 5915 <p> 5916 This means that transactions exhibit the ACI (atomicity, consistency, 5917 and isolation) properties, but not D (durability); that is, database 5918 integrity will be maintained, but if the application or system fails, 5919 it is possible some number of the most recently committed transactions 5920 may be undone during recovery. The number of transactions at risk is 5921 governed by how many log updates can fit into the log buffer, how often 5922 the operating system flushes dirty buffers to disk, and how often the 5923 log is checkpointed. 5924 <p> 5925 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 5926any other library handles opened within the scope of that handle). 5927For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> 5928handles opened in the database environment must either call this method 5929or the configuration should be specified in the database environment's 5930DB_CONFIG configuration file. 5931 <p> 5932 This method may be called at any time during the life of the application. 5933 <p> 5934<P> 5935<DD><DL> 5936</DL> 5937</DD> 5938<DD><DL> 5939<DT><B>Parameters:</B><DD><CODE>txnNoSync</CODE> - If true, configure the system to not write or synchronously flush 5940 the log on transaction commit.</DL> 5941</DD> 5942</DL> 5943<HR> 5944 5945<A NAME="getTxnNoSync()"><!-- --></A><H3> 5946getTxnNoSync</H3> 5947<PRE> 5948public boolean <B>getTxnNoSync</B>()</PRE> 5949<DL> 5950<DD>Return true if the system has been configured to not write or synchronously 5951 flush the log on transaction commit. 5952<p> 5953This method may be called at any time during the life of the application. 5954<p> 5955<P> 5956<DD><DL> 5957</DL> 5958</DD> 5959<DD><DL> 5960 5961<DT><B>Returns:</B><DD>True if the system has been configured to not write or synchronously 5962 flush the log on transaction commit.</DL> 5963</DD> 5964</DL> 5965<HR> 5966 5967<A NAME="setTxnNoWait(boolean)"><!-- --></A><H3> 5968setTxnNoWait</H3> 5969<PRE> 5970public void <B>setTxnNoWait</B>(boolean txnNoWait)</PRE> 5971<DL> 5972<DD>If a lock is unavailable for any Berkeley DB operation performed in the 5973 context of a transaction, cause the operation to throw <A HREF="../../../com/sleepycat/db/LockNotGrantedException.html" title="class in com.sleepycat.db"><CODE>LockNotGrantedException</CODE></A> without waiting for the lock. 5974 <p> 5975 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 5976any other library handles opened within the scope of that handle). 5977For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> 5978handles opened in the database environment must either call this method 5979or the configuration should be specified in the database environment's 5980DB_CONFIG configuration file. 5981 <p> 5982 This method may be called at any time during the life of the application. 5983 <p> 5984<P> 5985<DD><DL> 5986</DL> 5987</DD> 5988<DD><DL> 5989<DT><B>Parameters:</B><DD><CODE>txnNoWait</CODE> - If true, configure transactions to not wait for locks by default.</DL> 5990</DD> 5991</DL> 5992<HR> 5993 5994<A NAME="getTxnNoWait()"><!-- --></A><H3> 5995getTxnNoWait</H3> 5996<PRE> 5997public boolean <B>getTxnNoWait</B>()</PRE> 5998<DL> 5999<DD>Return true if the transactions have been configured to not wait for locks by default. 6000<p> 6001This method may be called at any time during the life of the application. 6002<p> 6003<P> 6004<DD><DL> 6005</DL> 6006</DD> 6007<DD><DL> 6008 6009<DT><B>Returns:</B><DD>True if the transactions have been configured to not wait for locks by default.</DL> 6010</DD> 6011</DL> 6012<HR> 6013 6014<A NAME="setTxnNotDurable(boolean)"><!-- --></A><H3> 6015setTxnNotDurable</H3> 6016<PRE> 6017public void <B>setTxnNotDurable</B>(boolean txnNotDurable)</PRE> 6018<DL> 6019<DD>Configure the system to not write log records. 6020 <p> 6021 This means that transactions exhibit the ACI (atomicity, consistency, 6022 and isolation) properties, but not D (durability); that is, database 6023 integrity will be maintained, but if the application or system 6024 fails, integrity will not persist. All database files must be 6025 verified and/or restored from backup after a failure. In order to 6026 ensure integrity after application shut down, all database handles 6027 must be closed without specifying noSync, or all database changes 6028 must be flushed from the database environment cache using the 6029 <A HREF="../../../com/sleepycat/db/Environment.html#checkpoint(com.sleepycat.db.CheckpointConfig)"><CODE>Environment.checkpoint</CODE></A>. 6030 <p> 6031 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 6032any other library handles opened within the scope of that handle). 6033For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> 6034handles opened in the database environment must either call this method 6035or the configuration should be specified in the database environment's 6036DB_CONFIG configuration file. 6037 <p> 6038 This method may be called at any time during the life of the application. 6039 <p> 6040<P> 6041<DD><DL> 6042</DL> 6043</DD> 6044<DD><DL> 6045<DT><B>Parameters:</B><DD><CODE>txnNotDurable</CODE> - If true, configure the system to not write log records.</DL> 6046</DD> 6047</DL> 6048<HR> 6049 6050<A NAME="getTxnNotDurable()"><!-- --></A><H3> 6051getTxnNotDurable</H3> 6052<PRE> 6053public boolean <B>getTxnNotDurable</B>()</PRE> 6054<DL> 6055<DD>Return true if the system has been configured to not write log records. 6056<p> 6057This method may be called at any time during the life of the application. 6058<p> 6059<P> 6060<DD><DL> 6061</DL> 6062</DD> 6063<DD><DL> 6064 6065<DT><B>Returns:</B><DD>True if the system has been configured to not write log records.</DL> 6066</DD> 6067</DL> 6068<HR> 6069 6070<A NAME="setTxnSnapshot(boolean)"><!-- --></A><H3> 6071setTxnSnapshot</H3> 6072<PRE> 6073public void <B>setTxnSnapshot</B>(boolean txnSnapshot)</PRE> 6074<DL> 6075<DD>Configure the database environment to run transactions at snapshot 6076 isolation by default. See <A HREF="../../../com/sleepycat/db/TransactionConfig.html#setSnapshot(boolean)"><CODE>TransactionConfig.setSnapshot(boolean)</CODE></A> for more 6077 information. 6078 <p> 6079 This method may be called at any time during the life of the application. 6080 <p> 6081<P> 6082<DD><DL> 6083</DL> 6084</DD> 6085<DD><DL> 6086<DT><B>Parameters:</B><DD><CODE>txnSnapshot</CODE> - If true, configure the system to default to snapshot isolation.</DL> 6087</DD> 6088</DL> 6089<HR> 6090 6091<A NAME="getTxnSnapshot()"><!-- --></A><H3> 6092getTxnSnapshot</H3> 6093<PRE> 6094public boolean <B>getTxnSnapshot</B>()</PRE> 6095<DL> 6096<DD>Return true if the handle is configured to run all transactions at snapshot 6097 isolation. 6098<p> 6099This method may be called at any time during the life of the application. 6100<p> 6101<P> 6102<DD><DL> 6103</DL> 6104</DD> 6105<DD><DL> 6106 6107<DT><B>Returns:</B><DD>True if the handle is configured to run all transactions at snapshot 6108 isolation.</DL> 6109</DD> 6110</DL> 6111<HR> 6112 6113<A NAME="setTxnMaxActive(int)"><!-- --></A><H3> 6114setTxnMaxActive</H3> 6115<PRE> 6116public void <B>setTxnMaxActive</B>(int txnMaxActive)</PRE> 6117<DL> 6118<DD>Configure the database environment to support at least txnMaxActive 6119 active transactions. 6120 <p> 6121 This value bounds the size of the memory allocated for transactions. 6122 Child transactions are counted as active until they either commit 6123 or abort. 6124 <p> 6125 When all of the memory available in the database environment for 6126 transactions is in use, calls to <A HREF="../../../com/sleepycat/db/Environment.html#beginTransaction(com.sleepycat.db.Transaction, com.sleepycat.db.TransactionConfig)"><CODE>Environment.beginTransaction</CODE></A> 6127 will fail (until some active transactions complete). If this 6128 interface is never called, the database environment is configured 6129 to support at least 20 active transactions. 6130 <p> 6131 The database environment's number of active transactions may also be set using the environment's 6132DB_CONFIG file. The syntax of the entry in that file is a single line 6133with the string "set_tx_max", one or more whitespace characters, and the number of transactions. 6134Because the DB_CONFIG file is read when the database environment is 6135opened, it will silently overrule configuration done before that time. 6136 <p> 6137 This method configures a database environment, including all threads 6138of control accessing the database environment, not only the operations 6139performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 6140 <p> 6141 This method may not be called after the 6142environment has been opened. 6143If joining an existing database environment, any 6144information specified to this method will be ignored. 6145 <p> 6146<P> 6147<DD><DL> 6148</DL> 6149</DD> 6150<DD><DL> 6151<DT><B>Parameters:</B><DD><CODE>txnMaxActive</CODE> - The minimum number of simultaneously active transactions supported 6152 by the database environment.</DL> 6153</DD> 6154</DL> 6155<HR> 6156 6157<A NAME="getTxnMaxActive()"><!-- --></A><H3> 6158getTxnMaxActive</H3> 6159<PRE> 6160public int <B>getTxnMaxActive</B>()</PRE> 6161<DL> 6162<DD>Return the minimum number of simultaneously active transactions supported 6163 by the database environment. 6164<p> 6165This method may be called at any time during the life of the application. 6166<p> 6167<P> 6168<DD><DL> 6169</DL> 6170</DD> 6171<DD><DL> 6172 6173<DT><B>Returns:</B><DD>The minimum number of simultaneously active transactions supported 6174 by the database environment.</DL> 6175</DD> 6176</DL> 6177<HR> 6178 6179<A NAME="setTxnTimeout(long)"><!-- --></A><H3> 6180setTxnTimeout</H3> 6181<PRE> 6182public void <B>setTxnTimeout</B>(long txnTimeout)</PRE> 6183<DL> 6184<DD>Set the timeout value for the database environment 6185transactions. 6186<p> 6187Transaction timeouts are checked whenever a thread of control blocks on 6188a lock or when deadlock detection is performed. The lock is one 6189requested on behalf of a transaction, normally by the database access 6190methods underlying the application. 6191As timeouts are only checked when the lock request first blocks or when 6192deadlock detection is performed, the accuracy of the timeout depends on 6193how often deadlock detection is performed. 6194<p> 6195Timeout values specified for the database environment may be overridden 6196on a 6197per-transaction basis by <A HREF="../../../com/sleepycat/db/Transaction.html#setTxnTimeout(long)"><CODE>Transaction.setTxnTimeout</CODE></A>. 6198<p> 6199This method configures a database environment, including all threads 6200of control accessing the database environment, not only the operations 6201performed using a specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle. 6202<p> 6203This method may be called at any time during the life of the application. 6204<p> 6205<P> 6206<DD><DL> 6207</DL> 6208</DD> 6209<DD><DL> 6210<DT><B>Parameters:</B><DD><CODE>txnTimeout</CODE> - The timeout value, specified as an unsigned 32-bit number of 6211microseconds, limiting the maximum timeout to roughly 71 minutes. 6212<p> 6213<p> 6214<DT><B>Throws:</B> 6215<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if an invalid parameter was specified. 6216<p> 6217<DD><CODE><A HREF="../../../com/sleepycat/db/DatabaseException.html" title="class in com.sleepycat.db">DatabaseException</A></CODE> - if a failure occurs.</DL> 6218</DD> 6219</DL> 6220<HR> 6221 6222<A NAME="getTxnTimeout()"><!-- --></A><H3> 6223getTxnTimeout</H3> 6224<PRE> 6225public long <B>getTxnTimeout</B>()</PRE> 6226<DL> 6227<DD>Return the database environment transaction timeout value, in 6228 microseconds; a timeout of 0 means no timeout is set. 6229<p> 6230This method may be called at any time during the life of the application. 6231<p> 6232<P> 6233<DD><DL> 6234</DL> 6235</DD> 6236<DD><DL> 6237 6238<DT><B>Returns:</B><DD>The database environment transaction timeout value, in 6239 microseconds; a timeout of 0 means no timeout is set.</DL> 6240</DD> 6241</DL> 6242<HR> 6243 6244<A NAME="setTxnTimestamp(java.util.Date)"><!-- --></A><H3> 6245setTxnTimestamp</H3> 6246<PRE> 6247public void <B>setTxnTimestamp</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Date.html" title="class or interface in java.util">Date</A> txnTimestamp)</PRE> 6248<DL> 6249<DD>Recover to the specified time rather than to the most current 6250 possible date. 6251 <p> 6252 Once a database environment has been upgraded to a new version of 6253 Berkeley DB involving a log format change, it is no longer possible 6254 to recover to a specific time before that upgrade. 6255 <p> 6256 This method configures only operations performed using a single a 6257<A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle, not an entire database environment. 6258 <p> 6259 This method may not be called after the 6260environment has been opened. 6261 <p> 6262<P> 6263<DD><DL> 6264</DL> 6265</DD> 6266<DD><DL> 6267<DT><B>Parameters:</B><DD><CODE>txnTimestamp</CODE> - The recovery timestamp. 6268 Only the seconds (not the milliseconds) of the timestamp are used.</DL> 6269</DD> 6270</DL> 6271<HR> 6272 6273<A NAME="getTxnTimestamp()"><!-- --></A><H3> 6274getTxnTimestamp</H3> 6275<PRE> 6276public <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/util/Date.html" title="class or interface in java.util">Date</A> <B>getTxnTimestamp</B>()</PRE> 6277<DL> 6278<DD>Return the time to which recovery will be done, or 0 if recovery will 6279 be done to the most current possible date. 6280 <p> 6281<P> 6282<DD><DL> 6283</DL> 6284</DD> 6285<DD><DL> 6286 6287<DT><B>Returns:</B><DD>The time to which recovery will be done, or 0 if recovery will be 6288 done to the most current possible date.</DL> 6289</DD> 6290</DL> 6291<HR> 6292 6293<A NAME="setTxnWriteNoSync(boolean)"><!-- --></A><H3> 6294setTxnWriteNoSync</H3> 6295<PRE> 6296public void <B>setTxnWriteNoSync</B>(boolean txnWriteNoSync)</PRE> 6297<DL> 6298<DD>Configure the system to write, but not synchronously flush, the log on 6299 transaction commit. 6300 <p> 6301 This means that transactions exhibit the ACI (atomicity, consistency, 6302 and isolation) properties, but not D (durability); that is, database 6303 integrity will be maintained, but if the system fails, it is possible 6304 some number of the most recently committed transactions may be undone 6305 during recovery. The number of transactions at risk is governed by how 6306 often the system flushes dirty buffers to disk and how often the log is 6307 checkpointed. 6308 <p> 6309 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 6310any other library handles opened within the scope of that handle). 6311For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> 6312handles opened in the database environment must either call this method 6313or the configuration should be specified in the database environment's 6314DB_CONFIG configuration file. 6315 <p> 6316 This method may be called at any time during the life of the application. 6317 <p> 6318<P> 6319<DD><DL> 6320</DL> 6321</DD> 6322<DD><DL> 6323<DT><B>Parameters:</B><DD><CODE>txnWriteNoSync</CODE> - If true, configure the system to write, but not synchronously flush, 6324 the log on transaction commit.</DL> 6325</DD> 6326</DL> 6327<HR> 6328 6329<A NAME="getTxnWriteNoSync()"><!-- --></A><H3> 6330getTxnWriteNoSync</H3> 6331<PRE> 6332public boolean <B>getTxnWriteNoSync</B>()</PRE> 6333<DL> 6334<DD>Return true if the system has been configured to write, but not synchronously 6335 flush, the log on transaction commit. 6336<p> 6337This method may be called at any time during the life of the application. 6338<p> 6339<P> 6340<DD><DL> 6341</DL> 6342</DD> 6343<DD><DL> 6344 6345<DT><B>Returns:</B><DD>True if the system has been configured to write, but not synchronously 6346 flush, the log on transaction commit.</DL> 6347</DD> 6348</DL> 6349<HR> 6350 6351<A NAME="setUseEnvironment(boolean)"><!-- --></A><H3> 6352setUseEnvironment</H3> 6353<PRE> 6354public void <B>setUseEnvironment</B>(boolean useEnvironment)</PRE> 6355<DL> 6356<DD>Configure the database environment to accept information from the 6357 process environment when naming files, regardless of the status of 6358 the process. 6359 <p> 6360 Because permitting users to specify which files are used can create 6361 security problems, environment information will be used in file 6362 naming for all users only if configured to do so. 6363 <p> 6364<P> 6365<DD><DL> 6366</DL> 6367</DD> 6368<DD><DL> 6369<DT><B>Parameters:</B><DD><CODE>useEnvironment</CODE> - If true, configure the database environment to accept information 6370 from the process environment when naming files.</DL> 6371</DD> 6372</DL> 6373<HR> 6374 6375<A NAME="getUseEnvironment()"><!-- --></A><H3> 6376getUseEnvironment</H3> 6377<PRE> 6378public boolean <B>getUseEnvironment</B>()</PRE> 6379<DL> 6380<DD>Return true if the database environment is configured to accept information 6381 from the process environment when naming files. 6382<p> 6383This method may be called at any time during the life of the application. 6384<p> 6385<P> 6386<DD><DL> 6387</DL> 6388</DD> 6389<DD><DL> 6390 6391<DT><B>Returns:</B><DD>True if the database environment is configured to accept information 6392 from the process environment when naming files.</DL> 6393</DD> 6394</DL> 6395<HR> 6396 6397<A NAME="setUseEnvironmentRoot(boolean)"><!-- --></A><H3> 6398setUseEnvironmentRoot</H3> 6399<PRE> 6400public void <B>setUseEnvironmentRoot</B>(boolean useEnvironmentRoot)</PRE> 6401<DL> 6402<DD>Configure the database environment to accept information from the 6403 process environment when naming files, if the process has 6404 appropriate permissions (for example, users with a user-ID of 0 on 6405 UNIX systems). 6406 <p> 6407 Because permitting users to specify which files are used can create 6408 security problems, environment information will be used in file 6409 naming for all users only if configured to do so. 6410 <p> 6411<P> 6412<DD><DL> 6413</DL> 6414</DD> 6415<DD><DL> 6416<DT><B>Parameters:</B><DD><CODE>useEnvironmentRoot</CODE> - If true, configure the database environment to accept information 6417 from the process environment when naming files if the process has 6418 appropriate permissions.</DL> 6419</DD> 6420</DL> 6421<HR> 6422 6423<A NAME="getUseEnvironmentRoot()"><!-- --></A><H3> 6424getUseEnvironmentRoot</H3> 6425<PRE> 6426public boolean <B>getUseEnvironmentRoot</B>()</PRE> 6427<DL> 6428<DD>Return true if the database environment is configured to accept information 6429 from the process environment when naming files if the process has 6430 appropriate permissions. 6431<p> 6432This method may be called at any time during the life of the application. 6433<p> 6434<P> 6435<DD><DL> 6436</DL> 6437</DD> 6438<DD><DL> 6439 6440<DT><B>Returns:</B><DD>True if the database environment is configured to accept information 6441 from the process environment when naming files if the process has 6442 appropriate permissions.</DL> 6443</DD> 6444</DL> 6445<HR> 6446 6447<A NAME="setVerbose(com.sleepycat.db.VerboseConfig, boolean)"><!-- --></A><H3> 6448setVerbose</H3> 6449<PRE> 6450public void <B>setVerbose</B>(<A HREF="../../../com/sleepycat/db/VerboseConfig.html" title="class in com.sleepycat.db">VerboseConfig</A> flag, 6451 boolean enable)</PRE> 6452<DL> 6453<DD>Display verbose information. 6454 <p> 6455 This method may be called at any time during the life of the application. 6456 <p> 6457<P> 6458<DD><DL> 6459</DL> 6460</DD> 6461<DD><DL> 6462<DT><B>Parameters:</B><DD><CODE>flag</CODE> - The type of verbose information being configured. 6463 <p><DD><CODE>enable</CODE> - If true, display additional information.</DL> 6464</DD> 6465</DL> 6466<HR> 6467 6468<A NAME="getVerbose(com.sleepycat.db.VerboseConfig)"><!-- --></A><H3> 6469getVerbose</H3> 6470<PRE> 6471public boolean <B>getVerbose</B>(<A HREF="../../../com/sleepycat/db/VerboseConfig.html" title="class in com.sleepycat.db">VerboseConfig</A> flag)</PRE> 6472<DL> 6473<DD>Return if the database environment is configured to display 6474 a given type of verbose information. 6475 <p> 6476 This method may be called at any time during the life of the application. 6477 <p> 6478<P> 6479<DD><DL> 6480</DL> 6481</DD> 6482<DD><DL> 6483<DT><B>Parameters:</B><DD><CODE>flag</CODE> - The type of verbose information being queried. 6484 <p> 6485<DT><B>Returns:</B><DD>If the database environment is configured to display additional 6486 information of the specified type.</DL> 6487</DD> 6488</DL> 6489<HR> 6490 6491<A NAME="setVerboseDeadlock(boolean)"><!-- --></A><H3> 6492setVerboseDeadlock</H3> 6493<PRE> 6494public void <B>setVerboseDeadlock</B>(boolean verboseDeadlock)</PRE> 6495<DL> 6496<DD><B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerbose(com.sleepycat.db.VerboseConfig, boolean)"><CODE>setVerbose(com.sleepycat.db.VerboseConfig, boolean)</CODE></A></I> 6497<P> 6498<DD>Display additional information when doing deadlock detection. 6499 <p> 6500 This method may be called at any time during the life of the application. 6501 <p> 6502<P> 6503<DD><DL> 6504</DL> 6505</DD> 6506<DD><DL> 6507<DT><B>Parameters:</B><DD><CODE>verboseDeadlock</CODE> - If true, display additional information when doing deadlock 6508 detection. 6509 <p></DL> 6510</DD> 6511</DL> 6512<HR> 6513 6514<A NAME="getVerboseDeadlock()"><!-- --></A><H3> 6515getVerboseDeadlock</H3> 6516<PRE> 6517public boolean <B>getVerboseDeadlock</B>()</PRE> 6518<DL> 6519<DD><B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerbose(com.sleepycat.db.VerboseConfig)"><CODE>getVerbose(com.sleepycat.db.VerboseConfig)</CODE></A></I> 6520<P> 6521<DD>Return if the database environment is configured to display 6522 additional information when doing deadlock detection. 6523 <p> 6524 This method may be called at any time during the life of the application. 6525 <p> 6526<P> 6527<DD><DL> 6528</DL> 6529</DD> 6530<DD><DL> 6531 6532<DT><B>Returns:</B><DD>If the database environment is configured to display additional 6533 information when doing deadlock detection. 6534 <p></DL> 6535</DD> 6536</DL> 6537<HR> 6538 6539<A NAME="setVerboseRecovery(boolean)"><!-- --></A><H3> 6540setVerboseRecovery</H3> 6541<PRE> 6542public void <B>setVerboseRecovery</B>(boolean verboseRecovery)</PRE> 6543<DL> 6544<DD><B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerbose(com.sleepycat.db.VerboseConfig, boolean)"><CODE>setVerbose(com.sleepycat.db.VerboseConfig, boolean)</CODE></A></I> 6545<P> 6546<DD>Display additional information when performing recovery. 6547 <p> 6548 This method may be called at any time during the life of the application. 6549 <p> 6550<P> 6551<DD><DL> 6552</DL> 6553</DD> 6554<DD><DL> 6555<DT><B>Parameters:</B><DD><CODE>verboseRecovery</CODE> - If true, display additional information when performing recovery. 6556 <p></DL> 6557</DD> 6558</DL> 6559<HR> 6560 6561<A NAME="getVerboseRecovery()"><!-- --></A><H3> 6562getVerboseRecovery</H3> 6563<PRE> 6564public boolean <B>getVerboseRecovery</B>()</PRE> 6565<DL> 6566<DD><B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerbose(com.sleepycat.db.VerboseConfig)"><CODE>getVerbose(com.sleepycat.db.VerboseConfig)</CODE></A></I> 6567<P> 6568<DD>Return if the database environment is configured to display 6569 additional information when performing recovery. 6570 <p> 6571 This method may be called at any time during the life of the application. 6572 <p> 6573<P> 6574<DD><DL> 6575</DL> 6576</DD> 6577<DD><DL> 6578 6579<DT><B>Returns:</B><DD>If the database environment is configured to display additional 6580 information when performing recovery. 6581 <p></DL> 6582</DD> 6583</DL> 6584<HR> 6585 6586<A NAME="setVerboseRegister(boolean)"><!-- --></A><H3> 6587setVerboseRegister</H3> 6588<PRE> 6589public void <B>setVerboseRegister</B>(boolean verboseRegister)</PRE> 6590<DL> 6591<DD><B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerbose(com.sleepycat.db.VerboseConfig, boolean)"><CODE>setVerbose(com.sleepycat.db.VerboseConfig, boolean)</CODE></A></I> 6592<P> 6593<DD>Display additional information concerning support for the 6594 <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setRegister(boolean)"><CODE>setRegister(boolean)</CODE></A> method. 6595 <p> 6596 This method may be called at any time during the life of the application. 6597 <p> 6598<P> 6599<DD><DL> 6600</DL> 6601</DD> 6602<DD><DL> 6603<DT><B>Parameters:</B><DD><CODE>verboseRegister</CODE> - If true, display additional information concerning support for the 6604 <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setRegister(boolean)"><CODE>setRegister(boolean)</CODE></A> method 6605 <p></DL> 6606</DD> 6607</DL> 6608<HR> 6609 6610<A NAME="getVerboseRegister()"><!-- --></A><H3> 6611getVerboseRegister</H3> 6612<PRE> 6613public boolean <B>getVerboseRegister</B>()</PRE> 6614<DL> 6615<DD><B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerbose(com.sleepycat.db.VerboseConfig)"><CODE>getVerbose(com.sleepycat.db.VerboseConfig)</CODE></A></I> 6616<P> 6617<DD>Return if the database environment is configured to display 6618 additional information concerning support for the 6619 <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setRegister(boolean)"><CODE>setRegister(boolean)</CODE></A> method. 6620 <p> 6621 This method may be called at any time during the life of the application. 6622 <p> 6623<P> 6624<DD><DL> 6625</DL> 6626</DD> 6627<DD><DL> 6628 6629<DT><B>Returns:</B><DD>If the database environment is configured to display additional 6630 information concerning support for the 6631 <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setRegister(boolean)"><CODE>setRegister(boolean)</CODE></A> method. 6632 <p></DL> 6633</DD> 6634</DL> 6635<HR> 6636 6637<A NAME="setVerboseReplication(boolean)"><!-- --></A><H3> 6638setVerboseReplication</H3> 6639<PRE> 6640public void <B>setVerboseReplication</B>(boolean verboseReplication)</PRE> 6641<DL> 6642<DD><B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerbose(com.sleepycat.db.VerboseConfig, boolean)"><CODE>setVerbose(com.sleepycat.db.VerboseConfig, boolean)</CODE></A></I> 6643<P> 6644<DD>Display additional information when processing replication messages. 6645 <p> 6646 Note, to get complete replication logging when debugging replication 6647 applications, you must also configure and build the Berkeley DB 6648 library with the --enable-diagnostic configuration option as well 6649 as call this method. 6650 <p> 6651 This method may be called at any time during the life of the application. 6652 <p> 6653<P> 6654<DD><DL> 6655</DL> 6656</DD> 6657<DD><DL> 6658<DT><B>Parameters:</B><DD><CODE>verboseReplication</CODE> - If true, display additional information when processing replication 6659 messages. 6660 <p></DL> 6661</DD> 6662</DL> 6663<HR> 6664 6665<A NAME="getVerboseReplication()"><!-- --></A><H3> 6666getVerboseReplication</H3> 6667<PRE> 6668public boolean <B>getVerboseReplication</B>()</PRE> 6669<DL> 6670<DD><B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerbose(com.sleepycat.db.VerboseConfig)"><CODE>getVerbose(com.sleepycat.db.VerboseConfig)</CODE></A></I> 6671<P> 6672<DD>Return if the database environment is configured to display 6673 additional information when processing replication messages. 6674 <p> 6675 This method may be called at any time during the life of the application. 6676 <p> 6677<P> 6678<DD><DL> 6679</DL> 6680</DD> 6681<DD><DL> 6682 6683<DT><B>Returns:</B><DD>If the database environment is configured to display additional 6684 information when processing replication messages. 6685 <p></DL> 6686</DD> 6687</DL> 6688<HR> 6689 6690<A NAME="setVerboseWaitsFor(boolean)"><!-- --></A><H3> 6691setVerboseWaitsFor</H3> 6692<PRE> 6693public void <B>setVerboseWaitsFor</B>(boolean verboseWaitsFor)</PRE> 6694<DL> 6695<DD><B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#setVerbose(com.sleepycat.db.VerboseConfig, boolean)"><CODE>setVerbose(com.sleepycat.db.VerboseConfig, boolean)</CODE></A></I> 6696<P> 6697<DD>Display the waits-for table when doing deadlock detection. 6698 <p> 6699 This method may be called at any time during the life of the application. 6700 <p> 6701<P> 6702<DD><DL> 6703</DL> 6704</DD> 6705<DD><DL> 6706<DT><B>Parameters:</B><DD><CODE>verboseWaitsFor</CODE> - If true, display the waits-for table when doing deadlock detection. 6707 <p></DL> 6708</DD> 6709</DL> 6710<HR> 6711 6712<A NAME="getVerboseWaitsFor()"><!-- --></A><H3> 6713getVerboseWaitsFor</H3> 6714<PRE> 6715public boolean <B>getVerboseWaitsFor</B>()</PRE> 6716<DL> 6717<DD><B>Deprecated.</B> <I>replaced by <A HREF="../../../com/sleepycat/db/EnvironmentConfig.html#getVerbose(com.sleepycat.db.VerboseConfig)"><CODE>getVerbose(com.sleepycat.db.VerboseConfig)</CODE></A></I> 6718<P> 6719<DD>Return if the database environment is configured to display the 6720 waits-for table when doing deadlock detection. 6721 <p> 6722 This method may be called at any time during the life of the application. 6723 <p> 6724<P> 6725<DD><DL> 6726</DL> 6727</DD> 6728<DD><DL> 6729 6730<DT><B>Returns:</B><DD>If the database environment is configured to display the waits-for 6731 table when doing deadlock detection. 6732 <p></DL> 6733</DD> 6734</DL> 6735<HR> 6736 6737<A NAME="setYieldCPU(boolean)"><!-- --></A><H3> 6738setYieldCPU</H3> 6739<PRE> 6740public void <B>setYieldCPU</B>(boolean yieldCPU)</PRE> 6741<DL> 6742<DD>Configure the system to yield the processor immediately after each 6743 page or mutex acquisition. 6744 <p> 6745 This functionality should never be used for purposes other than 6746 stress testing. 6747 <p> 6748 This method only affects the specified <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> handle (and 6749any other library handles opened within the scope of that handle). 6750For consistent behavior across the environment, all <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><CODE>Environment</CODE></A> 6751handles opened in the database environment must either call this method 6752or the configuration should be specified in the database environment's 6753DB_CONFIG configuration file. 6754 <p> 6755 This method may be called at any time during the life of the application. 6756 <p> 6757<P> 6758<DD><DL> 6759</DL> 6760</DD> 6761<DD><DL> 6762<DT><B>Parameters:</B><DD><CODE>yieldCPU</CODE> - If true, configure the system to yield the processor immediately 6763 after each page or mutex acquisition.</DL> 6764</DD> 6765</DL> 6766<HR> 6767 6768<A NAME="getYieldCPU()"><!-- --></A><H3> 6769getYieldCPU</H3> 6770<PRE> 6771public boolean <B>getYieldCPU</B>()</PRE> 6772<DL> 6773<DD>Return true if the system has been configured to yield the processor 6774 immediately after each page or mutex acquisition. 6775<p> 6776This method may be called at any time during the life of the application. 6777<p> 6778<P> 6779<DD><DL> 6780</DL> 6781</DD> 6782<DD><DL> 6783 6784<DT><B>Returns:</B><DD>True if the system has been configured to yield the processor 6785 immediately after each page or mutex acquisition.</DL> 6786</DD> 6787</DL> 6788<!-- ========= END OF CLASS DATA ========= --> 6789<HR> 6790 6791 6792<!-- ======= START OF BOTTOM NAVBAR ====== --> 6793<A NAME="navbar_bottom"><!-- --></A> 6794<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A> 6795<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 6796<TR> 6797<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 6798<A NAME="navbar_bottom_firstrow"><!-- --></A> 6799<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 6800 <TR ALIGN="center" VALIGN="top"> 6801 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 6802 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> 6803 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> 6804 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/EnvironmentConfig.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 6805 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 6806 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 6807 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 6808 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 6809 </TR> 6810</TABLE> 6811</TD> 6812<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 6813<b>Berkeley DB</b><br><font size="-1"> version 4.7.25</font></EM> 6814</TD> 6815</TR> 6816 6817<TR> 6818<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 6819 <A HREF="../../../com/sleepycat/db/Environment.html" title="class in com.sleepycat.db"><B>PREV CLASS</B></A> 6820 <A HREF="../../../com/sleepycat/db/ErrorHandler.html" title="interface in com.sleepycat.db"><B>NEXT CLASS</B></A></FONT></TD> 6821<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 6822 <A HREF="../../../index.html?com/sleepycat/db/EnvironmentConfig.html" target="_top"><B>FRAMES</B></A> 6823 <A HREF="EnvironmentConfig.html" target="_top"><B>NO FRAMES</B></A> 6824 <SCRIPT type="text/javascript"> 6825 <!-- 6826 if(window==top) { 6827 document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>'); 6828 } 6829 //--> 6830</SCRIPT> 6831<NOSCRIPT> 6832 <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A> 6833</NOSCRIPT> 6834 6835 6836</FONT></TD> 6837</TR> 6838<TR> 6839<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 6840 SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> 6841<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 6842DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> 6843</TR> 6844</TABLE> 6845<A NAME="skip-navbar_bottom"></A> 6846<!-- ======== END OF BOTTOM NAVBAR ======= --> 6847 6848<HR> 6849<font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 6850</BODY> 6851</HTML> 6852