ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/rmvdprsubm.htm

332 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 Member (RMVDPRSUBM)</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="RMVDPRSUBM.Top_Of_Page"></a>
<h2>Remove DPR Subscription Member (RMVDPRSUBM)</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="#RMVDPRSUBM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVDPRSUBM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVDPRSUBM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVDPRSUBM"></a>
<p>The Remove DPR Subscription Member (RMVDPRSUBM) command removes a member from the subscription control tables for a specified set. 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. 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 ADDDPRSUBM</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>ASN3252</b></dt>
<dd>Subscription not found.
</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>ASN3263</b></dt>
<dd>Not authorized to Prune Control table.
</dd>
<dt><b>ASN3270</b></dt>
<dd>Member does not exist.
</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>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="#RMVDPRSUBM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVDPRSUBM.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="#RMVDPRSUBM.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="#RMVDPRSUBM.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" rowspan="3"><a href="#RMVDPRSUBM.TGTTBL"><b>TGTTBL</b></a></td>
<td valign="top">Target table</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 3</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Target table</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top"><a href="#RMVDPRSUBM.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="#RMVDPRSUBM.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="#RMVDPRSUBM.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="#RMVDPRSUBM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVDPRSUBM.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="#RMVDPRSUBM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVDPRSUBM.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="#RMVDPRSUBM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVDPRSUBM.TGTTBL"></a>
<h3>Target table (TGTTBL)</h3>
<p>Specifies the target table member to remove from the subscription set.
</p>
<dl>
<dt><b><i>library/target-table-name</i></b></dt>
<dd>The qualified name of the target table.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDPRSUBM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVDPRSUBM.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="#RMVDPRSUBM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVDPRSUBM.RMVREG"></a>
<h3>Remove DPR registration (RMVREG)</h3>
<p>Specifies whether to remove the target table registration.
</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="#RMVDPRSUBM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVDPRSUBM.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="#RMVDPRSUBM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVDPRSUBM.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDPRSUBM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVDPRSUBM.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>ASN3252</b></dt>
<dd>Subscription not found.
</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>ASN3263</b></dt>
<dd>Not authorized to Prune Control table.
</dd>
<dt><b>ASN3270</b></dt>
<dd>Member does not exist.
</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>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="#RMVDPRSUBM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>