1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-
- This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
- project.
-
- Copyright (C) 1998-2018 OpenLink Software
-
- This project is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by the
- Free Software Foundation; only version 2 of the License, dated June 1991.
-
- This program is distributed in the hope that it will be useful, but
- WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
-
- You should have received a copy of the GNU General Public License along
- with this program; if not, write to the Free Software Foundation, Inc.,
- 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
-
-
-->
<refentry id="fn_repl_unsubscribe">
<refmeta>
<refentrytitle>REPL_UNSUBSCRIBE</refentrytitle>
<refmiscinfo>repl</refmiscinfo>
</refmeta>
<refnamediv>
<refname>REPL_UNSUBSCRIBE</refname>
<refpurpose>drop subscription</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis id="fsyn_repl_unsubscribe">
<funcprototype id="fproto_repl_unsubscribe">
<funcdef><function>REPL_UNSUBSCRIBE</function></funcdef>
<paramdef>in <parameter>server_name</parameter> varchar</paramdef>
<paramdef>in <parameter>publication</parameter> varchar</paramdef>
<paramdef>in <parameter>item</parameter> varchar</paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="desc_repl_unsubscribe"><title>Description</title>
<para>This function is used to stop receiving a replication messages from a
publisher server for a item or whole subscription. It will be invoked
automatically when a publication is dropped. The subscriber can also invoke
this function to stop receiving replication messages. The existing items can be
dropped or not depending on the copy mode flag. The description entries for
that subscription will be removed. There is no "undo" ability. To
temporally halt the replication messages you can use repl_disconnect().</para>
</refsect1>
<refsect1 id="params_"><title>Parameters</title>
<refsect2><title>server_name</title>
<para>Name of the target publishing server.</para>
</refsect2>
<refsect2><title>publication</title>
<para>The name of the publication.</para>
</refsect2>
<refsect2><title>item</title>
<para>The item to removed. NULL can be supplied to remove all items.</para>
</refsect2>
</refsect1>
<!-- 3019
this function has no return value
Errors:
TR004 37000 The subscription <name> from <server> doesn't exist
-->
<refsect1 id="examples_repl_unsubscribe"><title>Example</title>
<example id="ex_repl_unsubscribe_1"><title>Unsubscribing from a publication.</title>
<para>This is to stop replication on subscription 'demo-publication' from publisher server 'demo-srv'.</para>
<screen>
SQL> DB.DBA.REPL_UNSUBSCRIBE ('demo-srv', 'demo-publication', NULL);
</screen>
</example>
</refsect1>
<refsect1 id="seealso_repl_unsubscribe"><title>See Also</title>
<para><link linkend="fn_sub_schedule"><function>sub_schedule()</function></link></para>
<para><link linkend="fn_repl_disconnect"><function>repl_disconnect()</function></link></para>
<para><link linkend="fn_repl_grant"><function>repl_grant()</function></link></para>
<para><link linkend="fn_repl_init_copy"><function>repl_init_copy()</function></link></para>
<para><link linkend="fn_repl_new_log"><function>repl_new_log()</function></link></para>
<para><link linkend="fn_repl_pub_add"><function>repl_pub_add()</function></link></para>
<para><link linkend="fn_repl_pub_init_image"><function>repl_pub_init_image()</function></link></para>
<para><link linkend="fn_repl_pub_remove"><function>repl_pub_remove()</function></link></para>
<para><link linkend="fn_repl_publish"><function>repl_publish()</function></link></para>
<para><link linkend="fn_repl_revoke"><function>repl_revoke()</function></link></para>
<para><link linkend="fn_repl_sched_init"><function>repl_sched_init()</function></link></para>
<para><link linkend="fn_repl_server"><function>repl_server()</function></link></para>
<para><link linkend="fn_repl_server_rename"><function>repl_server_rename()</function></link></para>
<para><link linkend="fn_repl_stat"><function>repl_stat()</function></link></para>
<para><link linkend="fn_repl_status"><function>repl_status()</function></link></para>
<para><link linkend="fn_repl_subscribe"><function>repl_subscribe()</function></link></para>
<para><link linkend="fn_repl_sync"><function>repl_sync()</function></link></para>
<para><link linkend="fn_repl_sync_all"><function>repl_sync_all()</function></link></para>
<para><link linkend="fn_repl_text"><function>repl_text()</function></link></para>
<para><link linkend="fn_repl_this_server"><function>repl_this_server()</function></link></para>
<para><link linkend="fn_repl_unpublish"><function>repl_unpublish()</function></link></para>
</refsect1>
</refentry>
|
