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

173 lines
6.1 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Initialize DPR Capture (INZDPRCAP)</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="INZDPRCAP.Top_Of_Page"></a>
<h2>Initialize DPR Capture (INZDPRCAP)</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="#INZDPRCAP.PARAMETERS.TABLE">Parameters</a><br>
<a href="#INZDPRCAP.COMMAND.EXAMPLES">Examples</a><br>
<a href="#INZDPRCAP.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="INZDPRCAP"></a>
<p>The Initialize DPR Capture (INZDPRCAP) command initializes the DataPropagator for iSeries Capture instance by directing the Capture instance to work with an updated list of files (both local and remote)in the register table for the given capture control library. The Capture instance must be running before you run this command.
</p>
<p>The initialization function is cumulative. Files being journaled to the journals specified on the JRN parameter are added to those currently being processed by the Capture process.
</p>
<p>If files that are currently being processed have been removed from the Change Data Control table, the Capture process stops processing them. If a file is already being processed by the Capture process, it will not be added again.
</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 INZDPRCAP</h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>ASN2551</b></dt>
<dd>Capture schema not found in the Userspace.
</dd>
<dt><b>ASN2553</b></dt>
<dd>Could not get lock on User Space QZS8CTLBLK.
</dd>
<dt><b>ASN2555</b></dt>
<dd>Attempt to change user space QZS8CTLBLK in ASN failed.
</dd>
<dt><b>ASN2557</b></dt>
<dd>User Space ASN/QZS8CTLBLK not found.
</dd>
<dt><b>ASN2563</b></dt>
<dd>Capture instance is not active.
</dd>
<dt><b>ASN2564</b></dt>
<dd>Capture instance is already ending with option .
</dd>
<dt><b>ASN2565</b></dt>
<dd>Capture instance is ending with option .
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZDPRCAP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="INZDPRCAP.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="#INZDPRCAP.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, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#INZDPRCAP.JRN"><b>JRN</b></a></td>
<td valign="top">Journal</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 3 repetitions): <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Journal</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr></table>
<table width="100%">
<tr><td align="right"><a href="#INZDPRCAP.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="INZDPRCAP.CAPCTLLIB"></a>
<h3>Capture control library (CAPCTLLIB)</h3>
<p>Specifies the name of the Capture Instance to initialize.
</p>
<dl>
<dt><b><u>ASN</u></b></dt>
<dd>Specifies the default capture instance provided with the DataPropagator product for iSeries and defined as the first capture instance.
</dd>
<dt><b><i>capture-instance-name</i></b></dt>
<dd>Specifies the library where the capture control tables resides.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZDPRCAP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INZDPRCAP.JRN"></a>
<h3>Journal (JRN)</h3>
<p>Specify a list of up to 50 journals that you want the Capture instance to work with. Capture will start processing all of the source tables registered in the given capture control library that are currently journaled to the specified journal or journals.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Capture will start working with all of the journals that are associated with all of the source tables registered in the given capture control library.
</dd>
<dt><b><i>library-name/journal-name</i></b></dt>
<dd>Specify the qualified name of the journal that you want the Capture process to work with.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZDPRCAP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="INZDPRCAP.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#INZDPRCAP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="INZDPRCAP.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>ASN2551</b></dt>
<dd>Capture schema not found in the Userspace.
</dd>
<dt><b>ASN2553</b></dt>
<dd>Could not get lock on User Space QZS8CTLBLK.
</dd>
<dt><b>ASN2555</b></dt>
<dd>Attempt to change user space QZS8CTLBLK in ASN failed.
</dd>
<dt><b>ASN2557</b></dt>
<dd>User Space ASN/QZS8CTLBLK not found.
</dd>
<dt><b>ASN2563</b></dt>
<dd>Capture instance is not active.
</dd>
<dt><b>ASN2564</b></dt>
<dd>Capture instance is already ending with option .
</dd>
<dt><b>ASN2565</b></dt>
<dd>Capture instance is ending with option .
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZDPRCAP.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>