The <codeclass="methodname">DB_ENV->rep_set_priority()</code> method specifies the database
environment's priority in replication group elections. A special
value of 0 indicates that this environment cannot be a replication
group master.
</p>
<p>
The database environment's replication subsystem 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
"rep_set_priority", one or more whitespace characters, and the
priority of this site. For example, "rep_set_priority 1" sets the
priority of this site to 1. 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>
Note that if the application never explicitly sets a priority, then a default value of 100
is used.
</p>
<p>
The <codeclass="methodname">DB_ENV->rep_set_priority()</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->rep_set_priority()</code> method may be called at any time
during the life of the application.
</p>
<p>
The <codeclass="methodname">DB_ENV->rep_set_priority()</code><span>
<span>
method returns a non-zero error value on failure and 0 on success.