ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakj_5.4.0.1/rzakjnormcommit.htm

135 lines
7.4 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<?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="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="Failure of normal commit or rollback processing" />
<meta name="abstract" content="Errors might occur at any time during commit or rollback processing." />
<meta name="description" content="Errors might occur at any time during commit or rollback processing." />
<meta name="DC.Relation" scheme="URI" content="rzakjcommiterror.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2004, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2004, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzakjnormcommit" />
<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>Failure of normal commit or rollback processing</title>
</head>
<body id="rzakjnormcommit"><a name="rzakjnormcommit"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Failure of normal commit or rollback processing</h1>
<div><p>Errors might occur at any time during commit or rollback processing.</p>
<p>The following table divides this processing into four situations. The middle
column describes the actions taken by the system when it encounters errors
during each situation. The third column suggests what you or your application
must do in response to the messages. These suggestions are consistent with
the way commitment control processing is handled by the system.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" id="d0e21">Situation</th>
<th valign="top" id="d0e23">Commit or rollback processing</th>
<th valign="top" id="d0e25">Suggested action</th>
</tr>
</thead>
<tbody><tr><td valign="top" headers="d0e21 ">Record-level I/O <span class="uicontrol">commit</span> fails</td>
<td valign="top" headers="d0e23 "> <ul><li>If the error occurs during the prepare wave, the transaction is rolled
back and message CPF83DB is sent.</li>
<li>If the error occurs during the committed wave, commit processing continues
to commit as many remaining resources as possible. Message CPF8363 is sent
at the end of commit processing.</li>
</ul>
</td>
<td valign="top" headers="d0e25 ">Monitor for messages; handle as you want</td>
</tr>
<tr><td valign="top" headers="d0e21 "> Object-level or commit and rollback exit program for API commitment
resource fails during commit</td>
<td valign="top" headers="d0e23 "> <ul><li>If the error occurs during the prepare wave, the transaction is rolled
back and message CPF83DB is sent.</li>
<li>If the error occurs during the committed wave, processing continues to
commit or roll back as many remaining resources as possible. One of the following
messages is returned, depending on the commitment resource type: <ul><li>CPD8353</li>
<li>CPD8354</li>
<li>CPD8355</li>
<li>CPD8361</li>
</ul>
<p>Message CPF8363 is sent at the end of commit processing.</p>
</li>
</ul>
</td>
<td valign="top" headers="d0e25 ">Monitor for messages; handle as you want</td>
</tr>
<tr><td valign="top" headers="d0e21 ">Record-level I/O <span class="uicontrol">rollback</span> fails</td>
<td valign="top" headers="d0e23 "> <ol><li>Returns CPD8356</li>
<li>Attempt to continue processing to rollback object-level or API commitment
resources</li>
<li>Returns CPF8359 at end of processing</li>
</ol>
</td>
<td valign="top" headers="d0e25 ">Monitor for messages; handle as you want</td>
</tr>
<tr><td valign="top" headers="d0e21 ">Object-level or commit and rollback exit program for API commitment
resources fails during rollback</td>
<td valign="top" headers="d0e23 "> <ol><li>Returns one of the following messages depending on the commitment resource
type: <ul><li>CPD8358</li>
<li>CPD8359</li>
<li>CPD835A</li>
<li>CPD8362</li>
</ul>
</li>
<li>Continues processing</li>
<li>Returns CPF8359 at end of processing</li>
</ol>
</td>
<td valign="top" headers="d0e25 ">Monitor for messages; handle as you want</td>
</tr>
</tbody>
</table>
</div>
<div class="section" id="rzakjnormcommit__commitrollprcssjobend"><a name="rzakjnormcommit__commitrollprcssjobend"><!-- --></a><h4 class="sectiontitle">Commit or rollback processing during
job end</h4><p>All of the situations described in the previous table also
apply when a job is ending except that one of the following messages is sent:</p>
<ul><li>CPF8356 if only local resources are registered</li>
<li>CPF835C if only remote resources are registered</li>
<li>CPF83E4 if both local and remote resources are registered</li>
</ul>
<p>In addition, one of two messages might appear specific to job completion
if a commit and rollback exit program for an API committable resource has
been called. If the commit and rollback exit program does not complete within
5 minutes, the program is canceled; a diagnostic message CPD8363 (for commit)
or CPD8364 (for rollback) is sent; and the remainder of the commit or rollback
processing continues.</p>
</div>
<div class="section" id="rzakjnormcommit__commitrollbackprocipl"><a name="rzakjnormcommit__commitrollbackprocipl"><!-- --></a><h4 class="sectiontitle">Commit or rollback processing during
IPL</h4><p>All of the situations described in the previous table also apply
during IPL recovery for commitment definitions except that message CPF835F
is sent instead of message CPF8359 or CPF8363. Messages that get sent for
a particular commitment definition might appear in the job log for one of
the QDBSRVxx jobs or the QHST log. In the QHST log, message CPI8356 indicates
the beginning of IPL recovery for a particular commitment definition. Message
CPC8351 indicates the end of IPL recovery for a particular commitment definition
and any other messages regarding the recovery of that commitment definition
is found between those two messages.</p>
<p>One of two messages might appear
specific to a commitment definition if a commit and rollback exit program
for an API committable resource has been called. If the commit and rollback
exit program does not complete within 5 minutes, the program is canceled;
a diagnostic message CPD8363 (for commit) or CPD8364 (for rollback) is sent;
and the remainder of the commit or rollback processing continues.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakjcommiterror.htm" title="When you use commitment control, it is important to understand which conditions cause errors and which do not.">Commitment control errors</a></div>
</div>
</div>
</body>
</html>