355 lines
11 KiB
HTML
355 lines
11 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Remove DPR Subscription (RMVDPRSUB)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="RMVDPRSUB.Top_Of_Page"></a>
|
|
<h2>Remove DPR Subscription (RMVDPRSUB)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#RMVDPRSUB.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RMVDPRSUB.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RMVDPRSUB.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RMVDPRSUB"></a>
|
|
<p>The Remove DPR Subscription (RMVDPRSUB) command removes the associated entries from the subscription control tables for the given Apply Qualifier and Set Name. The command issues an error message if the requested entry is not found in the table.
|
|
</p>
|
|
<p>You can use the DLTTGTTBL parameter to delete the target table associated with this subscription.
|
|
</p>
|
|
<p>You can use the RMVREG parameter to remove the registration to the target table if it was registered as a source table when the subscription was created.
|
|
</p>
|
|
<p>This command supports the iSeries environment only, and not the other databases that support DataPropagator.
|
|
</p>
|
|
<ul>
|
|
<li>Note: Do not precede an entry with an asterisk unless that entry is shown on the display itself or in the help information with an asterisk.
|
|
</li>
|
|
</ul>
|
|
<h3>Error Messages for RMVDPRSUB</h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>ASN2501</b></dt>
|
|
<dd>Not authorized to register table.
|
|
</dd>
|
|
<dt><b>ASN3221</b></dt>
|
|
<dd>DLTTGTFILE(*YES) is not allowed with RMVCAPE(*NO).
|
|
</dd>
|
|
<dt><b>ASN3239</b></dt>
|
|
<dd>Registration for target table cannot be removed.
|
|
</dd>
|
|
<dt><b>ASN3240</b></dt>
|
|
<dd>Registration for target table cannot be removed.
|
|
</dd>
|
|
<dt><b>ASN3242</b></dt>
|
|
<dd>Registration not found on data server for table .
|
|
</dd>
|
|
<dt><b>ASN3243</b></dt>
|
|
<dd>Registration for target table cannot be removed.
|
|
</dd>
|
|
<dt><b>ASN3244</b></dt>
|
|
<dd>Target table cannot be deleted because it is registered as a source table.
|
|
</dd>
|
|
<dt><b>ASN3245</b></dt>
|
|
<dd>Target table in library could not be deleted.
|
|
</dd>
|
|
<dt><b>ASN3246</b></dt>
|
|
<dd>Source table registration not changed because connection to failed.
|
|
</dd>
|
|
<dt><b>ASN3247</b></dt>
|
|
<dd>Target table registration not removed because connection to failed.
|
|
</dd>
|
|
<dt><b>ASN3250</b></dt>
|
|
<dd>Target table in library has been deleted.
|
|
</dd>
|
|
<dt><b>ASN3252</b></dt>
|
|
<dd>Subscription not found.
|
|
</dd>
|
|
<dt><b>ASN3255</b></dt>
|
|
<dd>Subscription set for Apply Qualifier Set Name removed.
|
|
</dd>
|
|
<dt><b>ASN3256</b></dt>
|
|
<dd>Not authorized to Subscription Set table.
|
|
</dd>
|
|
<dt><b>ASN3257</b></dt>
|
|
<dd>Not authorized to Subscription Member table.
|
|
</dd>
|
|
<dt><b>ASN3258</b></dt>
|
|
<dd>Not authorized to Subscription Columns table.
|
|
</dd>
|
|
<dt><b>ASN3259</b></dt>
|
|
<dd>Not authorized to Subscription Statement table.
|
|
</dd>
|
|
<dt><b>ASN3263</b></dt>
|
|
<dd>Not authorized to Prune Control table.
|
|
</dd>
|
|
<dt><b>ASN3264</b></dt>
|
|
<dd>Subscription set for Apply Qualifier contains members.
|
|
</dd>
|
|
<dt><b>ASN3272</b></dt>
|
|
<dd>Member cannot be removed.
|
|
</dd>
|
|
<dt><b>ASN3292</b></dt>
|
|
<dd>Register table not found.
|
|
</dd>
|
|
<dt><b>ASN3293</b></dt>
|
|
<dd>Pruning control table not found.
|
|
</dd>
|
|
<dt><b>ASN4512</b></dt>
|
|
<dd>Set subscription table not found.
|
|
</dd>
|
|
<dt><b>ASN4514</b></dt>
|
|
<dd>Subscription statements table not found.
|
|
</dd>
|
|
<dt><b>ASN4518</b></dt>
|
|
<dd>Subscription member table not found.
|
|
</dd>
|
|
<dt><b>ASN4520</b></dt>
|
|
<dd>Subscription columns table not found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDPRSUB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RMVDPRSUB.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVDPRSUB.APYQUAL"><b>APYQUAL</b></a></td>
|
|
<td valign="top">Apply qualifier</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVDPRSUB.SETNAME"><b>SETNAME</b></a></td>
|
|
<td valign="top">Set name</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVDPRSUB.CTLSVR"><b>CTLSVR</b></a></td>
|
|
<td valign="top">Control server</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LOCAL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVDPRSUB.RMVMBRS"><b>RMVMBRS</b></a></td>
|
|
<td valign="top">Remove members</td>
|
|
<td valign="top">*YES, <b><u>*NO</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVDPRSUB.RMVREG"><b>RMVREG</b></a></td>
|
|
<td valign="top">Remove DPR registration</td>
|
|
<td valign="top">*YES, <b><u>*NO</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVDPRSUB.DLTTGTTBL"><b>DLTTGTTBL</b></a></td>
|
|
<td valign="top">Delete target table</td>
|
|
<td valign="top">*YES, <b><u>*NO</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDPRSUB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RMVDPRSUB.APYQUAL"></a>
|
|
<h3>Apply qualifier (APYQUAL)</h3>
|
|
<p>Specifies the apply qualifier. The apply qualifier is the name which is used to group the subscriptions that are to be run by the same Apply instance. The apply qualifier must already exist in the IBMSNAP_SUBS_SET table.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDPRSUB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVDPRSUB.SETNAME"></a>
|
|
<h3>Set name (SETNAME)</h3>
|
|
<p>Specifies the Set Name which identifies a group of target tables (subscription set members) that are processed by the Apply program as a group. The set name must already exist in the IBMSNAP_SUBS_SET table.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDPRSUB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVDPRSUB.CTLSVR"></a>
|
|
<h3>Control server (CTLSVR)</h3>
|
|
<p>The relational database name where the Apply control tables exist. This is the relational database name for the control server.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LOCAL</u></b></dt>
|
|
<dd>The Apply control tables are located on the local relational database.
|
|
</dd>
|
|
<dt><b><i>rdb-name</i></b></dt>
|
|
<dd>The relational database name where the Apply control tables reside. You can use the Work with RDB Directory Entries (WRKRDBDIRE) command on the data server to find this name. If the Apply control tables are on the system where the ADDDPRSUB command is being executed, <i>rdb-name</i> is the relational database name that has a remote location of *LOCAL associated with it.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDPRSUB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVDPRSUB.RMVMBRS"></a>
|
|
<h3>Remove members (RMVMBRS)</h3>
|
|
<p>Specifies whether to remove all of the members of the set.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The members are not removed, only the set definition is removed. If members exist in the set, the command will fail.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>All members of the set are removed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDPRSUB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVDPRSUB.RMVREG"></a>
|
|
<h3>Remove DPR registration (RMVREG)</h3>
|
|
<p>Specifies whether or not the target table registration should be removed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The target table registration is not removed.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The target table registration is removed. If the target table is registered as a source table and the Pruning Control table associated with the registration is empty, an entry will be removed from the ASN/IBMSNAP_REGISTER table.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDPRSUB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVDPRSUB.DLTTGTTBL"></a>
|
|
<h3>Delete target table (DLTTGTTBL)</h3>
|
|
<p>Specifies whether or not the target table is to be deleted after the subscription is removed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The target table should not be deleted.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The target table should be deleted.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDPRSUB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="RMVDPRSUB.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDPRSUB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVDPRSUB.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>ASN2501</b></dt>
|
|
<dd>Not authorized to register table.
|
|
</dd>
|
|
<dt><b>ASN3221</b></dt>
|
|
<dd>DLTTGTFILE(*YES) is not allowed with RMVCAPE(*NO).
|
|
</dd>
|
|
<dt><b>ASN3239</b></dt>
|
|
<dd>Registration for target table cannot be removed.
|
|
</dd>
|
|
<dt><b>ASN3240</b></dt>
|
|
<dd>Registration for target table cannot be removed.
|
|
</dd>
|
|
<dt><b>ASN3242</b></dt>
|
|
<dd>Registration not found on data server for table .
|
|
</dd>
|
|
<dt><b>ASN3243</b></dt>
|
|
<dd>Registration for target table cannot be removed.
|
|
</dd>
|
|
<dt><b>ASN3244</b></dt>
|
|
<dd>Target table cannot be deleted because it is registered as a source table.
|
|
</dd>
|
|
<dt><b>ASN3245</b></dt>
|
|
<dd>Target table in library could not be deleted.
|
|
</dd>
|
|
<dt><b>ASN3246</b></dt>
|
|
<dd>Source table registration not changed because connection to failed.
|
|
</dd>
|
|
<dt><b>ASN3247</b></dt>
|
|
<dd>Target table registration not removed because connection to failed.
|
|
</dd>
|
|
<dt><b>ASN3250</b></dt>
|
|
<dd>Target table in library has been deleted.
|
|
</dd>
|
|
<dt><b>ASN3252</b></dt>
|
|
<dd>Subscription not found.
|
|
</dd>
|
|
<dt><b>ASN3255</b></dt>
|
|
<dd>Subscription set for Apply Qualifier Set Name removed.
|
|
</dd>
|
|
<dt><b>ASN3256</b></dt>
|
|
<dd>Not authorized to Subscription Set table.
|
|
</dd>
|
|
<dt><b>ASN3257</b></dt>
|
|
<dd>Not authorized to Subscription Member table.
|
|
</dd>
|
|
<dt><b>ASN3258</b></dt>
|
|
<dd>Not authorized to Subscription Columns table.
|
|
</dd>
|
|
<dt><b>ASN3259</b></dt>
|
|
<dd>Not authorized to Subscription Statement table.
|
|
</dd>
|
|
<dt><b>ASN3263</b></dt>
|
|
<dd>Not authorized to Prune Control table.
|
|
</dd>
|
|
<dt><b>ASN3264</b></dt>
|
|
<dd>Subscription set for Apply Qualifier contains members.
|
|
</dd>
|
|
<dt><b>ASN3272</b></dt>
|
|
<dd>Member cannot be removed.
|
|
</dd>
|
|
<dt><b>ASN3292</b></dt>
|
|
<dd>Register table not found.
|
|
</dd>
|
|
<dt><b>ASN3293</b></dt>
|
|
<dd>Pruning control table not found.
|
|
</dd>
|
|
<dt><b>ASN4512</b></dt>
|
|
<dd>Set subscription table not found.
|
|
</dd>
|
|
<dt><b>ASN4514</b></dt>
|
|
<dd>Subscription statements table not found.
|
|
</dd>
|
|
<dt><b>ASN4518</b></dt>
|
|
<dd>Subscription member table not found.
|
|
</dd>
|
|
<dt><b>ASN4520</b></dt>
|
|
<dd>Subscription columns table not found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDPRSUB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|