Sets the maximum cache size in bytes. The specified size is
rounded to the nearest multiple of the cache region size, which is
the initial cache size divided by the number of regions specified
to the <aclass="xref"href="envset_cachesize.html"title="DB_ENV->set_cachesize()">DB_ENV->set_cachesize()</a> method. If no value is
specified, it defaults to the initial cache
size.
</p>
<p>
The database environment's maximum cache size may also be
configured using the environment's <ahref="../../programmer_reference/env_db_config.html#env_db_config.DB_CONFIG"class="olink">DB_CONFIG</a> file. The syntax of
the entry in that file is a single line with the string
"set_cache_max", one or more whitespace characters, and the
maximum cache size in bytes, specified in two parts: the gigabytes
of cache and the additional bytes of cache. Because the
<ahref="../../programmer_reference/env_db_config.html#env_db_config.DB_CONFIG"class="olink">DB_CONFIG</a> file is read when the database environment is opened,
it will silently overrule configuration done before that time.
</p>
<p>
The <codeclass="methodname">DB_ENV->set_cache_max()</code> method configures a database environment,
not only operations performed using the specified
<aclass="link"href="env.html"title="Chapter5. The DB_ENV Handle">DB_ENV</a> handle.
</p>
<p>
The <codeclass="methodname">DB_ENV->set_cache_max()</code> method may be called at any time during
the life of the application.
</p>
<p>
The <codeclass="methodname">DB_ENV->set_cache_max()</code><span>
<span>
method returns a non-zero error value on failure and 0 on success.
