003 File Manager
Current Path:
/usr/local/share/doc/db5/programmer_reference
usr
/
local
/
share
/
doc
/
db5
/
programmer_reference
/
📁
..
📄
BDB_Prog_Reference.pdf
(1.9 MB)
📄
am.html
(13.27 KB)
📄
am_close.html
(4.17 KB)
📄
am_conf.html
(13.76 KB)
📄
am_conf_logrec.html
(7.32 KB)
📄
am_conf_select.html
(24.85 KB)
📄
am_cursor.html
(36.58 KB)
📄
am_delete.html
(2.95 KB)
📄
am_foreign.html
(9.84 KB)
📄
am_get.html
(4.07 KB)
📄
am_misc.html
(6.3 KB)
📄
am_misc_bulk.html
(17.31 KB)
📄
am_misc_db_sql.html
(4.79 KB)
📄
am_misc_dbsizes.html
(4.06 KB)
📄
am_misc_diskspace.html
(11.57 KB)
📄
am_misc_error.html
(4.83 KB)
📄
am_misc_faq.html
(10.34 KB)
📄
am_misc_partial.html
(7.81 KB)
📄
am_misc_perm.html
(4.19 KB)
📄
am_misc_stability.html
(4.82 KB)
📄
am_misc_struct.html
(5.06 KB)
📄
am_misc_tune.html
(9.91 KB)
📄
am_opensub.html
(7.84 KB)
📄
am_partition.html
(17.19 KB)
📄
am_put.html
(4.68 KB)
📄
am_second.html
(14.76 KB)
📄
am_stat.html
(3.11 KB)
📄
am_sync.html
(3.63 KB)
📄
am_truncate.html
(2.54 KB)
📄
am_upgrade.html
(4.72 KB)
📄
am_verify.html
(4.77 KB)
📄
apprec.html
(8.14 KB)
📄
apprec_auto.html
(12.16 KB)
📄
apprec_config.html
(10 KB)
📄
apprec_def.html
(9.13 KB)
📄
arch.html
(11.09 KB)
📄
arch_apis.html
(10.27 KB)
📄
arch_bigpic.gif
(2.53 KB)
📄
arch_progmodel.html
(3.1 KB)
📄
arch_script.html
(4.39 KB)
📄
arch_smallpic.gif
(1.58 KB)
📄
arch_utilities.html
(8 KB)
📄
bdb_usenix.pdf
(79.81 KB)
📄
bt_conf.html
(29.94 KB)
📄
cam.html
(11.77 KB)
📄
cam_app.html
(16.91 KB)
📄
cam_fail.html
(7.77 KB)
📄
ch13s02.html
(4.19 KB)
📄
csharp.html
(7.48 KB)
📄
dumpload.html
(5.42 KB)
📄
dumpload_format.html
(6.58 KB)
📄
dumpload_text.html
(3.39 KB)
📄
embedded.html
(31.62 KB)
📄
env.html
(7.43 KB)
📄
env_create.html
(10.06 KB)
📄
env_db_config.html
(4.21 KB)
📄
env_encrypt.html
(10.19 KB)
📄
env_error.html
(4.77 KB)
📄
env_faq.html
(5.54 KB)
📄
env_naming.html
(15.54 KB)
📄
env_open.html
(4.95 KB)
📄
env_region.html
(8.11 KB)
📄
env_remote.html
(5.28 KB)
📄
env_security.html
(5.64 KB)
📄
env_size.html
(8.11 KB)
📄
ext.html
(7.13 KB)
📄
ext_perl.html
(3.84 KB)
📄
ext_php.html
(5.47 KB)
📄
general_am_conf.html
(21.43 KB)
📄
gettingStarted.css
(1.13 KB)
📄
group_membership.html
(20.37 KB)
📄
hash_conf.html
(6.96 KB)
📄
hash_usenix.pdf
(256.14 KB)
📄
heap_conf.html
(4.14 KB)
📄
index.html
(77.48 KB)
📄
intro.html
(9.57 KB)
📄
intro_dbis.html
(15.02 KB)
📄
intro_dbisnot.html
(13.49 KB)
📄
intro_distrib.html
(2.92 KB)
📄
intro_need.html
(5.06 KB)
📄
intro_products.html
(14.3 KB)
📄
intro_terrain.html
(19.43 KB)
📄
intro_what.html
(4.94 KB)
📄
intro_where.html
(3.75 KB)
📄
java.html
(7.62 KB)
📄
java_compat.html
(2.57 KB)
📄
java_faq.html
(7.5 KB)
📄
java_program.html
(6.69 KB)
📄
libtp_usenix.pdf
(243.14 KB)
📄
lock.html
(11.29 KB)
📄
lock_am_conv.html
(10.62 KB)
📄
lock_cam_conv.html
(4.95 KB)
📄
lock_config.html
(4.67 KB)
📄
lock_dead.html
(7.25 KB)
📄
lock_deaddbg.html
(10.32 KB)
📄
lock_max.html
(11.04 KB)
📄
lock_nondb.html
(4.94 KB)
📄
lock_notxn.html
(4.55 KB)
📄
lock_page.html
(5.71 KB)
📄
lock_stdmode.html
(5.27 KB)
📄
lock_timeout.html
(6.16 KB)
📄
lock_twopl.html
(4.48 KB)
📄
log.html
(7.08 KB)
📄
log_config.html
(5.06 KB)
📄
log_limits.html
(4.24 KB)
📄
magic.s5.be.txt
(3.54 KB)
📄
magic.s5.le.txt
(3.56 KB)
📄
magic.txt
(1.98 KB)
📄
moreinfo.html
(7.45 KB)
📄
mp.html
(8.86 KB)
📄
mp_config.html
(6.08 KB)
📄
mp_warm.html
(13.45 KB)
📄
preface.html
(5.1 KB)
📄
program.html
(7.21 KB)
📄
program_cache.html
(3.3 KB)
📄
program_compatible.html
(3.66 KB)
📄
program_copy.html
(7.35 KB)
📄
program_environ.html
(3.58 KB)
📄
program_errorret.html
(10.38 KB)
📄
program_faq.html
(4.58 KB)
📄
program_mt.html
(7.54 KB)
📄
program_namespace.html
(5.66 KB)
📄
program_perfmon.html
(32.07 KB)
📄
program_ram.html
(12.58 KB)
📄
program_runtime.html
(7.09 KB)
📄
program_scope.html
(9.8 KB)
📄
refs.html
(11.84 KB)
📄
rep.html
(16.57 KB)
📄
rep_app.html
(9.75 KB)
📄
rep_base_meth.html
(8.59 KB)
📄
rep_bulk.html
(4.01 KB)
📄
rep_clock_skew.html
(5.38 KB)
📄
rep_comm.html
(11.28 KB)
📄
rep_elect.html
(13.17 KB)
📄
rep_ex.html
(9.64 KB)
📄
rep_ex_chan.html
(8.52 KB)
📄
rep_ex_comm.html
(7.58 KB)
📄
rep_ex_rq.html
(5.52 KB)
📄
rep_faq.html
(9.2 KB)
📄
rep_filename.html
(7.7 KB)
📄
rep_id.html
(4.76 KB)
📄
rep_init.html
(5.14 KB)
📄
rep_lease.html
(18.32 KB)
📄
rep_mastersync.html
(11.24 KB)
📄
rep_mgr_ack.html
(8.5 KB)
📄
rep_mgr_meth.html
(11.06 KB)
📄
rep_mgrmulti.html
(10.28 KB)
📄
rep_newsite.html
(5.29 KB)
📄
rep_partition.html
(9.21 KB)
📄
rep_pri.html
(3.64 KB)
📄
rep_replicate.html
(18.8 KB)
📄
rep_ryw.html
(9.82 KB)
📄
rep_trans.html
(21.58 KB)
📄
rep_twosite.html
(6.76 KB)
📄
repmgr_channels.html
(13.34 KB)
📄
rq_conf.html
(18.29 KB)
📄
second.javas
(3.87 KB)
📄
sequence.html
(4.43 KB)
📄
solaris.txt
(5.62 KB)
📄
stl.html
(16.28 KB)
📄
stl_complex_rw.html
(19.31 KB)
📄
stl_container_specific.html
(9.04 KB)
📄
stl_db_advanced_usage.html
(9.68 KB)
📄
stl_db_usage.html
(13.27 KB)
📄
stl_efficienct_use.html
(11.87 KB)
📄
stl_examples.html
(8.24 KB)
📄
stl_known_issues.html
(4.54 KB)
📄
stl_memory_mgmt.html
(9.22 KB)
📄
stl_misc.html
(8.22 KB)
📄
stl_mt_usage.html
(9.06 KB)
📄
stl_persistence.html
(14.74 KB)
📄
stl_primitive_rw.html
(8.18 KB)
📄
stl_txn_usage.html
(4.88 KB)
📄
stl_usecase.html
(3.67 KB)
📄
tcl.html
(7.88 KB)
📄
tcl_error.html
(5.2 KB)
📄
tcl_faq.html
(4.89 KB)
📄
tcl_program.html
(3.78 KB)
📄
tcl_using.html
(4.43 KB)
📄
transapp.cs
(10.34 KB)
📄
transapp.html
(8.55 KB)
📄
transapp_admin.html
(4.8 KB)
📄
transapp_app.html
(25.08 KB)
📄
transapp_archival.html
(15.5 KB)
📄
transapp_atomicity.html
(5.46 KB)
📄
transapp_checkpoint.html
(6.18 KB)
📄
transapp_cursor.html
(6.79 KB)
📄
transapp_data_open.html
(7.52 KB)
📄
transapp_deadlock.html
(7.35 KB)
📄
transapp_env_open.html
(8.39 KB)
📄
transapp_fail.html
(6.8 KB)
📄
transapp_faq.html
(11.26 KB)
📄
transapp_filesys.html
(5.89 KB)
📄
transapp_hotfail.html
(10.54 KB)
📄
transapp_inc.html
(8.09 KB)
📄
transapp_journal.html
(4.72 KB)
📄
transapp_logfile.html
(5.3 KB)
📄
transapp_nested.html
(5.42 KB)
📄
transapp_put.html
(12.47 KB)
📄
transapp_read.html
(9.9 KB)
📄
transapp_reclimit.html
(12.6 KB)
📄
transapp_recovery.html
(8.74 KB)
📄
transapp_term.html
(6.02 KB)
📄
transapp_throughput.html
(9.06 KB)
📄
transapp_tune.html
(13.99 KB)
📄
transapp_why.html
(3.94 KB)
📄
txn.html
(8.63 KB)
📄
txn_config.html
(4.5 KB)
📄
txn_limits.html
(5.77 KB)
📄
witold.html
(745 B)
📄
writetest.cs
(2.26 KB)
📄
xa.html
(6.69 KB)
📄
xa_build.html
(19.12 KB)
📄
xa_faq.html
(7.27 KB)
📄
xa_xa_config.html
(8.1 KB)
📄
xa_xa_intro.html
(4.46 KB)
📄
xa_xa_restrict.html
(6.02 KB)
Editing: repmgr_channels.html
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <title>Using Replication Manager message channels</title> <link rel="stylesheet" href="gettingStarted.css" type="text/css" /> <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /> <link rel="start" href="index.html" title="Berkeley DB Programmer's Reference Guide" /> <link rel="up" href="rep.html" title="Chapter 12. Berkeley DB Replication" /> <link rel="prev" href="rep_clock_skew.html" title="Clock Skew" /> <link rel="next" href="rep_twosite.html" title="Special considerations for two-site replication groups" /> </head> <body> <div xmlns="" class="navheader"> <div class="libver"> <p>Library Version 11.2.5.3</p> </div> <table width="100%" summary="Navigation header"> <tr> <th colspan="3" align="center">Using Replication Manager message channels</th> </tr> <tr> <td width="20%" align="left"><a accesskey="p" href="rep_clock_skew.html">Prev</a> </td> <th width="60%" align="center">Chapter 12. Berkeley DB Replication </th> <td width="20%" align="right"> <a accesskey="n" href="rep_twosite.html">Next</a></td> </tr> </table> <hr /> </div> <div class="sect1" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h2 class="title" style="clear: both"><a id="repmgr_channels"></a>Using Replication Manager message channels</h2> </div> </div> </div> <div class="toc"> <dl> <dt> <span class="sect2"> <a href="repmgr_channels.html#dbchannel_class">DB_CHANNEL</a> </span> </dt> <dt> <span class="sect2"> <a href="repmgr_channels.html#dbchannel_send">Sending messages over a message channel</a> </span> </dt> <dt> <span class="sect2"> <a href="repmgr_channels.html#dbchannel_receive">Receiving messages</a> </span> </dt> </dl> </div> <p> The various sites comprising a replication group frequently need to communicate with one another. Mostly, these messages are handled for you internally by the Replication Manager. However, your application may have a requirement to pass messages beyond what the Replication Manager requires in order to satisfy its own internal workings. </p> <p> For this reason, you can access and use the Replication Manager's internal message channels. You do this by using the <code class="literal">DB_CHANNEL</code> class, and by implementing a message handling function on each of your sites. </p> <p> Note that an example of using Replication Manager message channels is available in the distribution. See <a class="xref" href="rep_ex_chan.html" title="Ex_rep_chan: a Replication Manager channel example">Ex_rep_chan: a Replication Manager channel example</a> for more information. </p> <div class="sect2" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h3 class="title"><a id="dbchannel_class"></a>DB_CHANNEL</h3> </div> </div> </div> <p> The <code class="literal">DB_CHANNEL</code> class provides a series of methods which allow you to send messages to the other sites in your replication group. You create a <code class="literal">DB_CHANNEL</code> handle using the <a href="../api_reference/C/repmgr_channel.html" class="olink">DB_ENV->repmgr_channel()</a> method. When you are done with the handle, close it using the <a href="../api_reference/C/dbchannel_close.html" class="olink">DB_CHANNEL->close()</a> method. A closed handle must never be accessed again. Note that all channel handles should be closed before the associated environment handle is closed. Also, allow all message operations to complete on the channel before closing the handle. </p> <p> When you create a <code class="literal">DB_CHANNEL</code> handle, you indicate what channel you want to use. Possibilities are: </p> <div class="itemizedlist"> <ul type="disc"> <li> <p> The numerical env ID of a remote site in the replication group. </p> </li> <li> <p> <code class="literal">DB_EID_MASTER</code> </p> <p> Messages sent on this channel are sent only to the master site. Note that messages are always sent to the current master, even if the master has changed since the channel was opened. </p> <p> If the local site is the master, then sending messages on this channel will result in the local site receiving those messages echoed back to itself. </p> </li> </ul> </div> </div> <div class="sect2" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h3 class="title"><a id="dbchannel_send"></a>Sending messages over a message channel</h3> </div> </div> </div> <p> You can send any message you want over a message channel. The message can be as simple as a character string and as complex as a large data structure. However, before you can send the message, you must encapsulate it within one or more <a href="../api_reference/C/dbt.html" class="olink">DBT</a>s. This means <a class="link" href="am_misc_struct.html" title="Storing C/C++ structures/objects">marshaling the message</a> if it is contained within a complex data structure. </p> <p> The methods that you use to send messages all accept an array of <a href="../api_reference/C/dbt.html" class="olink">DBT</a>s. This means that in most circumstances it is perfectly acceptable to send multi-part messages. </p> <p> Messages may be sent either asynchronously or synchronously. To send a message asynchronously, use the <a href="../api_reference/C/dbchannel_send_msg.html" class="olink">DB_CHANNEL->send_msg()</a> method. This method sends its message and then immediately returns without waiting for any sort of a response. </p> <p> To send a message synchronously, use the <a href="../api_reference/C/dbchannel_send_request.html" class="olink">DB_CHANNEL->send_request()</a> method. This method blocks until it receives a response from the site to which it sent the message (or until a timeout threshold is reached). </p> <div class="sect3" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h4 class="title"><a id="dbchannel_respond"></a>Message Responses</h4> </div> </div> </div> <p> Message responses are required if a message is sent on a channel using the <a href="../api_reference/C/dbchannel_send_request.html" class="olink">DB_CHANNEL->send_request()</a> method. That method accepts the address of a single <a href="../api_reference/C/dbt.html" class="olink">DBT</a> which is used to receive the response from the remote site. </p> <p> Message responses are encapsulated in a single <a href="../api_reference/C/dbt.html" class="olink">DBT</a>. The response can be anything from a complex data structure, to a string, to a simple type, to no information at all. In the latter case, receipt of the <a href="../api_reference/C/dbt.html" class="olink">DBT</a> is sufficient to indicate that the request was received at the remote site. </p> <p> Responses are sent back from the remote system using its message handling function. Usually that function calls <a href="../api_reference/C/dbchannel_send_msg.html" class="olink">DB_CHANNEL->send_msg()</a> to send a single response. </p> <p> The response must be contained in a single <a href="../api_reference/C/dbt.html" class="olink">DBT</a>. If a multi-part response is required by the application, you can configure the response <a href="../api_reference/C/dbt.html" class="olink">DBT</a> that you provide to <a href="../api_reference/C/dbchannel_send_request.html" class="olink">DB_CHANNEL->send_request()</a> for <a class="link" href="am_misc_bulk.html" title="Retrieving and updating records in bulk">bulk operations</a>. </p> </div> </div> <div class="sect2" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h3 class="title"><a id="dbchannel_receive"></a>Receiving messages</h3> </div> </div> </div> <p> Messages received at a remote site are handled using a callback function. This function is configured for the local environment using the <a href="../api_reference/C/repmgr_msg_dispatch.html" class="olink">DB_ENV->repmgr_msg_dispatch()</a> method. For best results, the message dispatch function should be configured for the local environment before replication is started. In this way, you do not run the risk of missing messages sent after replication has started but before the message dispatch function is configured for the environment. </p> <p> The callback configured by <a href="../api_reference/C/repmgr_msg_dispatch.html" class="olink">DB_ENV->repmgr_msg_dispatch()</a> accepts four parameters of note: </p> <div class="itemizedlist"> <ul type="disc"> <li> <p> A response channel. This is the channel the function will use to response to the message, if a response is required. To respond to the message, the function uses the <a href="../api_reference/C/dbchannel_send_msg.html" class="olink">DB_CHANNEL->send_msg()</a> method. </p> </li> <li> <p> An array of <a href="../api_reference/C/dbt.html" class="olink">DBT</a>s. These hold the message that this function must handle. </p> </li> <li> <p> A numerical value that indicates how many elements the previously described array holds. </p> </li> <li> <p> A flag that indicates whether the message requires a response. If the flag is set to <code class="literal">DB_REPMGR_NEED_RESPONSE</code>, then the function should send a single <a href="../api_reference/C/dbt.html" class="olink">DBT</a> in response using the channel provided to this function, and the <a href="../api_reference/C/dbchannel_send_msg.html" class="olink">DB_CHANNEL->send_msg()</a> method. </p> </li> </ul> </div> <p> For an example of using this callback, see the <code class="literal">operation_dispatch()</code> function, which is available with the <a class="link" href="rep_ex_chan.html" title="Ex_rep_chan: a Replication Manager channel example">ex_rep_chan example</a> in your product distribution. </p> </div> </div> <div class="navfooter"> <hr /> <table width="100%" summary="Navigation footer"> <tr> <td width="40%" align="left"><a accesskey="p" href="rep_clock_skew.html">Prev</a> </td> <td width="20%" align="center"> <a accesskey="u" href="rep.html">Up</a> </td> <td width="40%" align="right"> <a accesskey="n" href="rep_twosite.html">Next</a></td> </tr> <tr> <td width="40%" align="left" valign="top">Clock Skew </td> <td width="20%" align="center"> <a accesskey="h" href="index.html">Home</a> </td> <td width="40%" align="right" valign="top"> Special considerations for two-site replication groups</td> </tr> </table> </div> </body> </html>
Upload File
Create Folder
