169 lines
6.1 KiB
HTML
169 lines
6.1 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>End DPR Capture (ENDDPRCAP)</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="ENDDPRCAP.Top_Of_Page"></a>
|
|
<h2>End DPR Capture (ENDDPRCAP)</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="#ENDDPRCAP.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ENDDPRCAP.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ENDDPRCAP.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ENDDPRCAP"></a>
|
|
<p>The End DPR Capture (ENDDPRCAP) command ends the DataPropagator for iSeries Capture process for registered source tables (both local and remote). The ENDDPRCAP command fails if the Capture process is not active, or if another request for the same ending type (*IMMED, *CNTRLD) is made.
|
|
</p>
|
|
<p>You should run this command to end the Capture process before shutting down the system. Also, you might want to end the process during periods of peak system use to increase the performance of other programs running on the system.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The ENDDPRCAP command may take a longer time to end the Capture process when the *CNTRLD option is specified. This is because the Capture process completes all of its subordinate processes before ending.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If you use the ENDJOB command, temporary objects might be left in the QDP4 library. These objects have the types *DTAQ and are named QDPRnnnnnn where nnnnnn is the job number of the job that used them. You can delete these objects when the job that used them (identified by the job number in the object name) is not active.
|
|
</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 ENDDPRCAP</h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<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="#ENDDPRCAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ENDDPRCAP.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="#ENDDPRCAP.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">How to end</td>
|
|
<td valign="top"><b><u>*CNTRLD</u></b>, *IMMED</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDDPRCAP.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 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDDPRCAP.RGZCTLTBL"><b>RGZCTLTBL</b></a></td>
|
|
<td valign="top">Reorganize control tables</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDPRCAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ENDDPRCAP.OPTION"></a>
|
|
<h3>How to end (OPTION)</h3>
|
|
<p>Specifies how to end the Capture process.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CNTRLD</u></b></dt>
|
|
<dd>The Capture process completes all of its tasks and then ends normally.
|
|
</dd>
|
|
<dt><b>*IMMED</b></dt>
|
|
<dd>The Capture process completes all of its tasks with the ENDJOB OPTION(*IMMED) command and ends normally.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDPRCAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDDPRCAP.CAPCTLLIB"></a>
|
|
<h3>Capture control library (CAPCTLLIB)</h3>
|
|
<p>Specifies the name of the Capture Instance to end.
|
|
</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 a 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="#ENDDPRCAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDDPRCAP.RGZCTLTBL"></a>
|
|
<h3>Reorganize control tables (REZCTLTBL)</h3>
|
|
<p>Specifies whether to do Reorganize Physical File Member (RGZPFM) on the control tables which includes CD and UOW tables when ending Capture. After pruning, disk space is not recovered unless RGZPFM is performed on the table. Provided this will be done only when ENDDPRCAP gets exclusive lock on the CD tables.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO (default)</u></b></dt>
|
|
<dd>Specifies that RGZPFM is not performed.
|
|
</dd>
|
|
<dt><b><i>*YES</i></b></dt>
|
|
<dd>Specifies that RGZPFM will be performed. Allowed only for OPTION(*CNTRLD).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDPRCAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="ENDDPRCAP.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDPRCAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDDPRCAP.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<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="#ENDDPRCAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|