# DbEnv::set_pageyield

`

###

    #include <db_cxx.h>

    static int
    DbEnv::set_pageyield(int pageyield);

# Description

Yield the processor whenever requesting a page from the cache. Setting pageyield to a non-zero value causes Berkeley DB to yield the processor any time a thread requests a page from the cache.

The DbEnv::set_pageyield interface affects the entire application, not a single database or database environment.

While the DbEnv::set_pageyield interface may be used to configure Berkeley DB at any time during the life of the application, it should normally be called before making any calls to the db_env_create or db_create methods.

This functionality should never be used for any other purpose than stress testing.

The DbEnv::set_pageyield interface may be used to configure Berkeley DB at any time during the life of the application.

The DbEnv::set_pageyield 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.

# Errors

EINVAL
  An invalid flag value or parameter was specified.

### Class

DbEnv

# See Also

DbEnv::close, DbEnv::open, DbEnv::remove, DbEnv::err, DbEnv::strerror, DbEnv::version, DbEnv::set_cachesize, DbEnv::set_errcall, DbEnv::set_errfile, DbEnv::set_error_stream, DbEnv::set_errpfx, DbEnv::set_flags, DbEnv::set_mutexlocks, DbEnv::set_paniccall, and DbEnv::set_verbose.`

Copyright Sleepycat Software