Berkeley DB: DbEnv::set_paniccall
Description: Berkeley DB: An embedded database programmatic toolkit.
Keywords: embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++

### DbEnv::set_paniccall |

`

###

    #include <db_cxx.h>

    int
    DbEnv::set_paniccall(void (*db_panic_fcn)(DbEnv *dbenv, int errval));

### Description: DbEnv::set_paniccall

Errors can occur in the Berkeley DB library where the only solution is to shut down the application and run recovery (for example, if Berkeley DB is unable to allocate heap memory). In such cases, the Berkeley DB methods will either return DB_RUNRECOVERY or throw a DbRunRecoveryException, depending on the API configuration. It is often easier to simply exit the application when such errors occur rather than gracefully return up the stack. The DbEnv::set_paniccall method specifies a function to be called when DB_RUNRECOVERY is about to be returned or DbRunRecoveryException is about to be thrown from a Berkeley DB method.

The DbEnv::set_paniccall method may be called at any time during the life of the application.

The DbEnv::set_paniccall method either returns a non-zero error value or throws an exception that encapsulates a non-zero error value on failure, and returns 0 on success.

### Parameters

db_panic_fcn
  The db_panic_fcn parameter is the application-specified function called in the case of a database environment panic. The function takes two arguments:

  dbenv
    The dbenv parameter is the enclosing database environment handle.

  errval
    The errval parameter is the error value that would have been returned to the caller if DB_RUNRECOVERY were not going to be returned instead.

### Class

DbEnv

### See Also

Database Environments and Related Methods`

Copyright (c) 1996-2003 Sleepycat Software, Inc. - All rights reserved.