270 lines
10 KiB
HTML
270 lines
10 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>Grant DPR Authority (GRTDPRAUT)</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="GRTDPRAUT.Top_Of_Page"></a>
|
|
<h2>Grant DPR Authority (GRTDPRAUT)</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="#GRTDPRAUT.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#GRTDPRAUT.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#GRTDPRAUT.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="GRTDPRAUT"></a>
|
|
<p>The Grant DPR Authority (GRTDPRAUT) command authorizes a list of users to the DataPropagator control tables so that the users can be registrars and subscribers. Registrars can make files eligible for copying, and subscribers can create subscriptions to and propagate from a registered base file.
|
|
</p>
|
|
<p>You cannot run the GRTDPRAUT command while the Capture or Apply processes are running, or when applications using the source tables are active. This is because authorizations cannot be changed on files that are in use.
|
|
</p>
|
|
<p>As more tables are registered for capture by authorized registrars, the person who registered the tables must assign subscriber rights to the users who should be authorized to those tables.
|
|
</p>
|
|
<p>The command issues an error message if a user specified on the command does not exist, if the user running the command is not authorized to the user profiles specified, if the DataPropagator control tables do not exist , or if the user running the command does not have permission to grant authorities to the DataPropagator control tables.
|
|
</p>
|
|
<p>The GRTDPRAUT command compensates for these different authority requirements. For example, the authority requirements for the user who is running Capture and Apply may differ from the authority requirements for the user who defines registrations and subscriptions.
|
|
</p>
|
|
<p>You must must have *ALLOBJ special authority to grant authorities with the GRTDPRAUT command.
|
|
</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 GRTDPRAUT</h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>ASN3011</b></dt>
|
|
<dd>Not allowed to grant registration authority.
|
|
</dd>
|
|
<dt><b>ASN3013</b></dt>
|
|
<dd>Not allowed to grant subscription authority.
|
|
</dd>
|
|
<dt><b>ASN3095</b></dt>
|
|
<dd>Registration authority granted. Not granted to some objects.
|
|
</dd>
|
|
<dt><b>ASN3097</b></dt>
|
|
<dd>Subscription authority granted. Not granted to some objects.
|
|
</dd>
|
|
<dt><b>ASN301A</b></dt>
|
|
<dd>The APYQUAL parameter cannot be used.
|
|
</dd>
|
|
<dt><b>ASN301B</b></dt>
|
|
<dd>Not allowed to grant authority.
|
|
</dd>
|
|
<dt><b>ASN301D</b></dt>
|
|
<dd>authority granted. Not granted to some objects.
|
|
</dd>
|
|
<dt><b>ASN301E</b></dt>
|
|
<dd>in library , type was not found.
|
|
</dd>
|
|
<dt><b>ASN301F</b></dt>
|
|
<dd>*ALLOBJ special authority is required.
|
|
</dd>
|
|
<dt><b>ASN302A</b></dt>
|
|
<dd>Authority cannot be granted to in type .
|
|
</dd>
|
|
<dt><b>ASN302B</b></dt>
|
|
<dd>The USER and APYQUAL parameters are incorrect.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#GRTDPRAUT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="GRTDPRAUT.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="#GRTDPRAUT.CAPCTLLIB"><b>CAPCTLLIB</b></a></td>
|
|
<td valign="top">Capture control library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>ASN</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#GRTDPRAUT.USER"><b>USER</b></a></td>
|
|
<td valign="top">User</td>
|
|
<td valign="top">Single values: *PUBLIC<br>Other values (up to 50 repetitions): <i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#GRTDPRAUT.AUT"><b>AUT</b></a></td>
|
|
<td valign="top">Authority</td>
|
|
<td valign="top">*REGISTRAR, *SUBSCRIBER, *CAPTURE, *APPLY</td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#GRTDPRAUT.APYQUAL"><b>APYQUAL</b></a></td>
|
|
<td valign="top">Apply qualifier</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b>, *USER</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#GRTDPRAUT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="GRTDPRAUT.CAPCTLLIB"></a>
|
|
<h3>Capture control library (CAPCTLLIB)</h3>
|
|
<p>Specifies the name of the Capture control library to which authority to be granted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>ASN</u></b></dt>
|
|
<dd>Specifies the default capture instance provided with the DataPropagator product for iSeries.
|
|
</dd>
|
|
<dt><b><i>capture-instance-name</i></b></dt>
|
|
<dd>Specifies the name of the capture control library to which authority to be granted.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#GRTDPRAUT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="GRTDPRAUT.USER"></a>
|
|
<h3>User (USER)</h3>
|
|
<p>Identifies the users who should have registrar or subscriber authority.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>user-name</i></b></dt>
|
|
<dd>Up to 50 specified users are granted the proper authorities to be registrars or subscribers.
|
|
</dd>
|
|
<dt><b>*PUBLIC</b></dt>
|
|
<dd>Authority is given to all users who have no specific authority, are not on the authorization list associated with the file, and whose group profile does not have any authority.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#GRTDPRAUT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="GRTDPRAUT.AUT"></a>
|
|
<h3>Authority (AUT)</h3>
|
|
<p>Identifies the type of DataPropagator authority being granted.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*REGISTRAR</b></dt>
|
|
<dd>The users are granted registrar authority.
|
|
<p>*REGISTRAR authority will give the user the authorities necssary to define, change, and remove replication sources. The GRTDPRAUT command will not grant the authorities needed to run the Capture process. This must be done using the *CAPTURE keyword.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*SUBSCRIBER</b></dt>
|
|
<dd>The users are granted subscriber authority.
|
|
<p>*SUBSCRIBER authority will give the user the authorities necessary to define, change, and remove replication targets. The GRTDPRAUT command will not grant the authorities needed to run the apply process. This must be done using the *APPLY keyword.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*CAPTURE</b></dt>
|
|
<dd>The users are granted capture authority.
|
|
<p>A user with capture authority has sufficient authority to all the objects necessary to successfully run the Capture process.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*APPLY</b></dt>
|
|
<dd>The users are granted apply authority.
|
|
<p>A user with apply authority has sufficient authority to all the objects located on this system necessary to run the Apply process. The command does not grant authority to any of the objects that reside on other databases that are accessed by the Apply process.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#GRTDPRAUT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="GRTDPRAUT.APYQUAL"></a>
|
|
<h3>Apply qualifier (APYQUAL)</h3>
|
|
<p>Identifies the apply qualifier that will be used. specified and when AUT(*APPLY) or AUT(*SUBSCRIBER) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The user is granted authority to run the Apply process or define and remove subscriptions for all apply qualifiers.
|
|
<ul>
|
|
<li>The user will be granted authority to all CD tables and CCD tables associated with replication sources defined on this system.
|
|
</li>
|
|
<li>The user will be granted authority to all replication targets listed in IBMSNAP_SUBS_MEMBR that reside on this system.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
<dt><b>*USER</b></dt>
|
|
<dd>The users specified on the USER parameter will be granted authority to subscriptions with an apply qualifier the same as the user name.
|
|
</dd>
|
|
<dt><b><i>apply-qualifier</i></b></dt>
|
|
<dd>The user is granted authority to run the apply process or define and remove subscriptions for the apply qualifiers associated with this apply qualifier.
|
|
<ul>
|
|
<li>The user will be granted authority to all replication sources, CD tables and CCD tables associated with records in IBMSNAP_PRUNCNTL that have a value in the APPLY_QUAL column matching the value input with the APYQUAL parameter.
|
|
</li>
|
|
<li>The user will be granted authority to all replication targets on this system listed in IBMSNAP_SUBS_MEMBR that have a value in the APPLY_QUAL column matching the value input with the APYQUAL parameter.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#GRTDPRAUT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="GRTDPRAUT.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#GRTDPRAUT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="GRTDPRAUT.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>ASN3011</b></dt>
|
|
<dd>Not allowed to grant registration authority.
|
|
</dd>
|
|
<dt><b>ASN3013</b></dt>
|
|
<dd>Not allowed to grant subscription authority.
|
|
</dd>
|
|
<dt><b>ASN3095</b></dt>
|
|
<dd>Registration authority granted. Not granted to some objects.
|
|
</dd>
|
|
<dt><b>ASN3097</b></dt>
|
|
<dd>Subscription authority granted. Not granted to some objects.
|
|
</dd>
|
|
<dt><b>ASN301A</b></dt>
|
|
<dd>The APYQUAL parameter cannot be used.
|
|
</dd>
|
|
<dt><b>ASN301B</b></dt>
|
|
<dd>Not allowed to grant authority.
|
|
</dd>
|
|
<dt><b>ASN301D</b></dt>
|
|
<dd>authority granted. Not granted to some objects.
|
|
</dd>
|
|
<dt><b>ASN301E</b></dt>
|
|
<dd>in library , type was not found.
|
|
</dd>
|
|
<dt><b>ASN301F</b></dt>
|
|
<dd>*ALLOBJ special authority is required.
|
|
</dd>
|
|
<dt><b>ASN302A</b></dt>
|
|
<dd>Authority cannot be granted to in type .
|
|
</dd>
|
|
<dt><b>ASN302B</b></dt>
|
|
<dd>The USER and APYQUAL parameters are incorrect.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#GRTDPRAUT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|