environment. The default value is estimated based on defaults,
initial and (deprecated) maximum settings of the number of lock
objects allocated. The maximum memory allocation is also
considered. The table is generally set to be close to the number
of lock objects in the system to avoid collisions and delay in
processing lock operations.
</p>
<p>
The database environment's tablesize 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_lk_tablesize", one
or more whitespace characters, and the size of the table. 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_lk_tablesize()</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_lk_tablesize()</code> method may not be called after the
<aclass="xref"href="envopen.html"title="DB_ENV->open()">DB_ENV->open()</a> method is
called. If the database environment already exists when
<aclass="xref"href="envopen.html"title="DB_ENV->open()">DB_ENV->open()</a> is called, the
information specified to <codeclass="methodname">DB_ENV->set_lk_tablesize()</code> will be ignored.
</p>
<p>
The <codeclass="methodname">DB_ENV->set_lk_tablesize()</code><span>
<span>
method returns a non-zero error value on failure and 0 on success.
