138 lines
8.2 KiB
HTML
138 lines
8.2 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2005" />
|
|
<meta name="DC.rights.owner" content="(C) Copyright IBM Corporation 2005" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow" />
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<meta name="DC.Type" content="concept" />
|
|
<meta name="DC.Title" content="Limit recoverable errors during copy" />
|
|
<meta name="abstract" content="When you copy to or from a database file or from a tape file, you can limit the number of recoverable errors that you accept before the copy ends. Use the ERRLVL parameter to specify this limit." />
|
|
<meta name="description" content="When you copy to or from a database file or from a tape file, you can limit the number of recoverable errors that you accept before the copy ends. Use the ERRLVL parameter to specify this limit." />
|
|
<meta name="DC.Relation" scheme="URI" content="rbal3preerr.htm" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="rbal3limrec" />
|
|
<meta name="DC.Language" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>Limit recoverable errors during copy</title>
|
|
</head>
|
|
<body id="rbal3limrec"><a name="rbal3limrec"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Limit recoverable errors during copy</h1>
|
|
<div><p>When you copy to or from a database file or from a tape file, you
|
|
can limit the number of recoverable errors that you accept before the copy
|
|
ends. Use the ERRLVL parameter to specify this limit.</p>
|
|
<div class="p">This parameter applies to the following types of errors: <dl><dt class="dlterm">CPF4826</dt>
|
|
<dd>Media error</dd>
|
|
<dt class="dlterm">CPF5026</dt>
|
|
<dd>Duplicate key in the access path of this member. (Note: The copy command
|
|
does not count CPF5026 as an ERRLVL error when you specify MBROPT(*UPDADD)
|
|
on CPYF.)</dd>
|
|
<dt class="dlterm">CPF5027</dt>
|
|
<dd>Record in use by another job. (Note: The copy command only counts CPF5027
|
|
as an ERRLVL error when you specify MBROPT(*UPDADD) on CPYF.)</dd>
|
|
<dt class="dlterm">CPF5029</dt>
|
|
<dd>Data or key conversion error</dd>
|
|
<dt class="dlterm">CPF502D</dt>
|
|
<dd>Referential integrity constraint violation</dd>
|
|
<dt class="dlterm">CPF502E</dt>
|
|
<dd>Referential integrity constraints cannot be validated</dd>
|
|
<dt class="dlterm">CPF5030</dt>
|
|
<dd>Partial damage on member</dd>
|
|
<dt class="dlterm">CPF5034</dt>
|
|
<dd>Duplicate key in the access path of another member</dd>
|
|
<dt class="dlterm">CPF5036</dt>
|
|
<dd>Invalid length tape block read</dd>
|
|
<dt class="dlterm">CPF504B</dt>
|
|
<dd>DataLink error</dd>
|
|
<dt class="dlterm">CPF504C</dt>
|
|
<dd>DataLink preparation error</dd>
|
|
<dt class="dlterm">CPF5097</dt>
|
|
<dd>*NAN (Not a Number) value not allowed in floating-point key field</dd>
|
|
</dl>
|
|
</div>
|
|
<div class="p">The ERRLVL parameter specifies the maximum number of recoverable errors
|
|
allowed for each label pair or each member copied. The value specified for
|
|
ERRLVL indicates the total errors that are allowed on both the from-file and
|
|
the to-file that are combined for each label pair or each member copied. Each
|
|
time an error occurs, the following process runs: <ol><li>The process increases the count for that label pair or that member by
|
|
1.</li>
|
|
<li>A message identifying the last good record that is read or written is
|
|
printed on all copy lists if TOFILE(*PRINT), PRINT(*COPIED), or PRINT(*EXCLD)
|
|
was specified.</li>
|
|
<li>The error record is printed if you specified PRINT(*ERROR).</li>
|
|
<li>Copying continues.</li>
|
|
<li>If the copy command completely copies the from-file member without exceeding
|
|
the limit, the process resets the counter to 0, and the copy of the next member
|
|
starts.</li>
|
|
<li>If the limit is exceeded during the copy of a member, copying ends and
|
|
a message is sent, even if more records or members remain to be copied.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="p"><strong>For a database from-file, including the open query file, the recoverable
|
|
errors are</strong>: <ul><li>those that occur when data is converted (mapped) AND</li>
|
|
<li>those caused by a damaged area on the disk (in auxiliary storage)</li>
|
|
</ul>
|
|
</div>
|
|
<div class="p"><strong>For a tape from-file, the recoverable errors are</strong>: <ul><li>a block length that is not valid AND</li>
|
|
<li>a media-read operation from the tape volume on the device resulting in
|
|
an error</li>
|
|
</ul>
|
|
</div>
|
|
<div class="p"><strong>For a physical to-file, the recoverable errors are</strong>: <ul><li>those that occur when data is converted AND</li>
|
|
<li>those that occur when more than one of the same key is found</li>
|
|
</ul>
|
|
Any record that causes an error is not copied to the to-file. For a write
|
|
error, the record is printed on a PRINT(*COPIED) and PRINT(*EXCLD) printout.
|
|
A message then follows this printout. This message indicates that the record
|
|
was not actually copied. If you specified PRINT(*ERROR), the command prints
|
|
the records that caused write errors on the *ERROR listing. A message then
|
|
indicates that an error occurred. For a read error, no record is available
|
|
to be printed on the copy printouts (TOFILE(*PRINT), PRINT(*COPIED), PRINT(*EXCLD),
|
|
or PRINT(*ERROR)). However, a message prints on all specified printouts that
|
|
indicates that a record cannot be read.</div>
|
|
<p>When the command cannot read a portion of the file from disk, partial object
|
|
damage to the contents of a database file occurs. If a file is damaged in
|
|
such a way, you can bypass the records that are in error by copying the good
|
|
records and manually adding the records that were not copied because of the
|
|
damage.</p>
|
|
<p>Regardless of the value of the ERRLVL parameter, recoverable errors always
|
|
appear in the job log with a reply of <span class="q">"C"</span> for <span class="q">"Cancel."</span></p>
|
|
<p>For files that have constraint relationships, the ERRLVL parameter only
|
|
affects the to-file. If you set the ERRLVL parameter to 0, the copy command
|
|
does not copy into the file any record that causes the to-file to violate
|
|
the constraint relationship. The copy operation ends. If ERRLVL is greater
|
|
than 0, the copy command does not copy into the file any record that causes
|
|
the to-file to violate the constraint relationship. However, the copy operation
|
|
continues until enough violations (recoverable errors) have occurred so that
|
|
the ERRLVL value has been reached. If this value is exceeded, the copy operation
|
|
ends.</p>
|
|
<p>You can use the ERRLVL parameter to bring files with constraint relationships
|
|
in check pending status back into non-check pending status. Do this by setting
|
|
up the dependent to-file with constraints that are the same as the dependent
|
|
from-file. Then, use a <a href="../cl/cpyf.htm">CPYF</a> command
|
|
with the ERRLVL(*NOMAX) to copy all valid records. The to-file should not
|
|
contain any records. The copy command does not insert into the to-file any
|
|
records that it encounters from the from-file that would cause the to-file
|
|
constraints to go to check pending status. With ERRLVL set to *NOMAX, the
|
|
copy command processes all records in the from-file.</p>
|
|
<p>Other copy commands (<a href="../cl/cpysrcf.htm">CPYSRCF</a>, <a href="../cl/cpyfrmtap.htm">CPYFRMTAP</a>, and<a href="../cl/cpytotap.htm">CPYTOTAP</a>)
|
|
end immediately if the systems signals one of the recoverable errors because
|
|
there is no ERRLVL parameter for them.</p>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal3preerr.htm" title="You can prevent many copy errors when you plan for certain conditions and situations ahead of time.">Prevent errors when copying files</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |