1<!--$Id: incomplete.so,v 1.9 2004/08/15 03:22:57 bostic Exp $--> 2<!--Copyright (c) 1997,2008 Oracle. All rights reserved.--> 3<!--See the file LICENSE for redistribution information.--> 4<html> 5<head> 6<title>Berkeley DB Reference Guide: Release 3.2: DB_INCOMPLETE</title> 7<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> 8<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> 9</head> 10<body bgcolor=white> 11<table width="100%"><tr valign=top> 12<td><b><dl><dt>Berkeley DB Reference Guide:<dd>Upgrading Berkeley DB Applications</dl></b></td> 13<td align=right><a href="../upgrade.3.2/renumber.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../upgrade.3.2/tx_recover.html"><img src="../../images/next.gif" alt="Next"></a> 14</td></tr></table> 15<p align=center><b>Release 3.2: DB_INCOMPLETE</b></p> 16<p>There are a number of functions that flush pages from the Berkeley DB shared 17memory buffer pool to disk. Most of those functions can potentially 18fail because a page that needs to be flushed is not currently available. 19However, this is not a hard failure and is rarely cause for concern. 20In the Berkeley DB 3.2 release, the C++ API (if that API is configured to 21throw exceptions) and the Java API have been changed so that this 22failure does not throw an exception, but rather returns a non-zero error 23code of DB_INCOMPLETE.</p> 24<p>The following C++ methods will return DB_INCOMPLETE rather than throw 25an exception: <a href="../../api_cxx/db_close.html">Db::close</a>, <a href="../../api_cxx/db_sync.html">Db::sync</a>, DbEnv::memp_sync, 26DbEnv::txn_checkpoint, DbMpoolFile::memp_fsync.</p> 27<p>The following Java methods are now declared "public int" rather than 28"public void", and will return Db.DB_INCOMPLETE rather than throw an 29exception: Db.close, Db.sync, and DbEnv.checkpoint.</p> 30<p>It is likely that the only change required by any application will be 31those currently checking for a DB_INCOMPLETE return that has 32been encapsulated in an exception.</p> 33<table width="100%"><tr><td><br></td><td align=right><a href="../upgrade.3.2/renumber.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../upgrade.3.2/tx_recover.html"><img src="../../images/next.gif" alt="Next"></a> 34</td></tr></table> 35<p><font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 36</body> 37</html> 38