Sets the maximum size of a single file in the log, in bytes. Because
<aclass="link"href="lsn.html"title="Chapter8. The DbLsn Handle">DbLsn</a> file offsets are
unsigned four-byte values, the set value may not be larger than the
maximum unsigned four-byte value.
</p>
<p>
When the logging subsystem is configured for on-disk logging, the
default size of a log file is 10MB.
</p>
<p>
When the logging subsystem is configured for in-memory logging, the
default size of a log file is 256KB. In addition, the configured log
buffer size must be larger than the log file size. (The logging
subsystem divides memory configured for in-memory log records into
"files", as database environments configured for in-memory log records
may exchange log records with other members of a replication group,
and those members may be configured to store log records on-disk.)
When choosing log buffer and file sizes for in-memory logs,
applications should ensure the in-memory log buffer size is large
enough that no transaction will ever span the entire buffer, and avoid
a state where the in-memory buffer is full and no space can be freed
because a transaction that started in the first log "file" is still
active.
</p>
<p>
See <ahref="../../programmer_reference/log_limits.html"class="olink">Log File Limits</a> for
more information.
</p>
<p>
The database environment's log file 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_lg_max", one or
more whitespace characters, and the size in bytes. 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">DbEnv::set_lg_max()</code> method configures a database environment,
not only operations performed using the specified
<aclass="link"href="env.html"title="Chapter5. The DbEnv Handle">DbEnv</a> handle.
</p>
<p>
The <codeclass="methodname">DbEnv::set_lg_max()</code> method may be called at any time during the
life of the application.
</p>
<p>
If no size is specified by the application, the size last specified
for the database region will be used, or if no database region
previously existed, the default will be used.
</p>
<p>
The <codeclass="methodname">DbEnv::set_lg_max()</code><span>
<span>
method either returns a non-zero error value or throws an
exception that encapsulates a non-zero error value on
