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

219 lines
8.2 KiB
HTML
Raw 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>Analyze DPR Journaling (ANZDPRJRN)</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="ANZDPRJRN.Top_Of_Page"></a>
<h2>Analyze DPR Journaling (ANZDPRJRN)</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="#ANZDPRJRN.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ANZDPRJRN.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ANZDPRJRN.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ANZDPRJRN"></a>
<p>The Analyze DPR Journals (ANZDPRJRN) command helps you determine which journal receivers are no longer needed by the DataPropagator Capture component, and optionally deletes the journal receivers that are not needed.
</p>
<p>Journal receivers are analyzed for the following types of source tables:
</p>
<ul>
<li>source tables that have been registered under DataPropagator, and
</li>
<li>source tables that have started differential refresh (that is, a base file for which a row exists in its change data table).
</li>
</ul>
<p>The term <u> base file</u> includes SQL tables, SQL views, local and remote physical files, and logical files built on physical file members of multi-member physical files.
</p>
<p>You can run this command whether or not the Capture process is running; however, it is recommended that you run it when the Capture process is not running.
</p>
<p>For each receiver that is eligible for deletion, the command issues informational message ASN602E (if you do not choose automatic deletion), or informational message ASN602D (if you do choose automatic deletion).
</p>
<p>The command creates a file named QZSNSPLF in library QTEMP with four members.
</p>
<p>
<b>Note: </b>The ANZDPRJRN command decides whether or not a journal receiver can be deleted only on the basis of its usefulness to the Capture component. Some of your journal receivers might be used for other purposes outside of DataPropagator. Unless you have complete knowledge about the journals that the registered files use, use caution when you specify that you want to have the eligible receivers automatically deleted for you.
</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 ANZDPRJRN</h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>ASN2023</b></dt>
<dd>Error occurred on file in .
</dd>
<dt><b>ASN6021</b></dt>
<dd>Attempt to get member information for base table in library failed with message .
</dd>
<dt><b>ASN6022</b></dt>
<dd>Failed to read the journal list from the PCB.
</dd>
<dt><b>ASN6024</b></dt>
<dd>Could not read any registration records.
</dd>
<dt><b>ASN6025</b></dt>
<dd>Could not open table in library .
</dd>
<dt><b>ASN6026</b></dt>
<dd>Attempt to get file information for base table in library failed with message .
</dd>
<dt><b>ASN6027</b></dt>
<dd>Number of journals used for capturing data for propagation exceeds the limit of .
</dd>
<dt><b>ASN6028</b></dt>
<dd>Could not delete journal receiver in library for journal in library .
</dd>
<dt><b>ASN6029</b></dt>
<dd>Could not open member of file QZSNSPLF in library QTEMP.
</dd>
<dt><b>ASN602A</b></dt>
<dd>Number of receivers for journal in library exceeds the limit of .
</dd>
<dt><b>ASN602B</b></dt>
<dd>Could not delete journal receiver in library because of cancel reply to message CPA7025.
</dd>
<dt><b>ASN602C</b></dt>
<dd>Could not establish starting sequence number or ending sequence number of a journal receiver.
</dd>
<dt><b>ASN602D</b></dt>
<dd>Journal receiver in library for journal in library has been deleted.
</dd>
<dt><b>ASN602E</b></dt>
<dd>Journal receiver in library for journal in library is eligible for deletion.
</dd>
<dt><b>ASN602F</b></dt>
<dd>No journal receivers eligible for deletion were found for journal in library .
</dd>
<dt><b>ASN604F</b></dt>
<dd>WRKJRNA command failed with escape message when working with journal in library .
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ANZDPRJRN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ANZDPRJRN.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="#ANZDPRJRN.DLTJRNRCV"><b>DLTJRNRCV</b></a></td>
<td valign="top">Delete journal receiver</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="#ANZDPRJRN.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ANZDPRJRN.DLTJRNRCV"></a>
<h3>Delete journal receiver (DLTJRNRCV)</h3>
<p>Specifies whether or not you want to have the command delete those receivers that are no longer needed by the Capture component. Messages are issued for each receiver that is eligible for deletion, and the information is displayed in the job log as well.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Eligible receivers are not automatically deleted.
<p>You might want to run the command using this option first to verify which journal receivers will be deleted.
</p>
</dd>
<dt><b>*YES</b></dt>
<dd>Eligible receivers are automatically deleted.
<p>
<b>Note: </b>Unless you have complete knowledge about the journals that the registered files use, use caution when you specify that you want to have the eligible receivers automatically deleted for you.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ANZDPRJRN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ANZDPRJRN.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#ANZDPRJRN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ANZDPRJRN.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>ASN2023</b></dt>
<dd>Error occurred on file in .
</dd>
<dt><b>ASN6021</b></dt>
<dd>Attempt to get member information for base table in library failed with message .
</dd>
<dt><b>ASN6022</b></dt>
<dd>Failed to read the journal list from the PCB.
</dd>
<dt><b>ASN6024</b></dt>
<dd>Could not read any registration records.
</dd>
<dt><b>ASN6025</b></dt>
<dd>Could not open table in library .
</dd>
<dt><b>ASN6026</b></dt>
<dd>Attempt to get file information for base table in library failed with message .
</dd>
<dt><b>ASN6027</b></dt>
<dd>Number of journals used for capturing data for propagation exceeds the limit of .
</dd>
<dt><b>ASN6028</b></dt>
<dd>Could not delete journal receiver in library for journal in library .
</dd>
<dt><b>ASN6029</b></dt>
<dd>Could not open member of file QZSNSPLF in library QTEMP.
</dd>
<dt><b>ASN602A</b></dt>
<dd>Number of receivers for journal in library exceeds the limit of .
</dd>
<dt><b>ASN602B</b></dt>
<dd>Could not delete journal receiver in library because of cancel reply to message CPA7025.
</dd>
<dt><b>ASN602C</b></dt>
<dd>Could not establish starting sequence number or ending sequence number of a journal receiver.
</dd>
<dt><b>ASN602D</b></dt>
<dd>Journal receiver in library for journal in library has been deleted.
</dd>
<dt><b>ASN602E</b></dt>
<dd>Journal receiver in library for journal in library is eligible for deletion.
</dd>
<dt><b>ASN602F</b></dt>
<dd>No journal receivers eligible for deletion were found for journal in library .
</dd>
<dt><b>ASN604F</b></dt>
<dd>WRKJRNA command failed with escape message when working with journal in library .
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ANZDPRJRN.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>