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