246 lines
8.7 KiB
HTML
246 lines
8.7 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>Commit (COMMIT)</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="COMMIT.Top_Of_Page"></a>
|
||
|
|
<h2>Commit (COMMIT)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
||
|
|
<b>Threadsafe: </b>Yes
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#COMMIT.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#COMMIT.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#COMMIT.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="COMMIT"></a>
|
||
|
|
<p>The Commit (COMMIT) command is used to complete the current transaction and to establish a new commitment boundary for the commitment definition associated with the program issuing the command.
|
||
|
|
</p>
|
||
|
|
<p>The Start Commitment Control (STRCMTCTL) command must be issued first to establish the commitment definition before the COMMIT command is issued; otherwise, a message is sent.
|
||
|
|
</p>
|
||
|
|
<p>When the COMMIT command is issued, all pending changes made to resources under commitment control for the commitment definition since the last commitment boundary was started are made permanent. A commitment identifier can be specified that is associated with this set of changes. If any files or API commitment resources associated with a journal are under commitment control, the commitment identifier is placed in the changes committed (CM) journal entry of each journal.
|
||
|
|
</p>
|
||
|
|
<p>The commitment identifier is also used by the system when updating the notify object if it needs updating during activation group end, job end, or IPL (initial program load) processing.
|
||
|
|
</p>
|
||
|
|
<p>No error occurs if there are no resources under commitment control for the commitment definition at the time the commit is issued. All record locks held for files opened under commitment control for the commitment definition are released when the commit is issued. Locks on object level commitment control resources, acquired when the resources are created or changed during the transaction, are released when the commit is issued.
|
||
|
|
</p>
|
||
|
|
<p>More information on commitment control is in the "Commitment control" article is in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#COMMIT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="COMMIT.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="#COMMIT.CMTID"><b>CMTID</b></a></td>
|
||
|
|
<td valign="top">Commit identification</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b>, *LUWID</td>
|
||
|
|
<td valign="top">Optional, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#COMMIT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="COMMIT.CMTID"></a>
|
||
|
|
<h3>Commit identification (CMTID)</h3>
|
||
|
|
<p>Specifies the text used to identify a group of changes committed with the commitment boundary. This text is placed in the object specified on the NFYOBJ parameter of the STRCMTCTL command during IPL processing if an abnormal system failure occurs, or if a job ends with uncommitted changes or with a nonzero completion code.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No text is used to identify the transaction committed with this commitment boundary.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LUWID</b></dt>
|
||
|
|
<dd>The logical unit of work identifier and the default journal name for this logical unit of work are used to identify the group of changes being committed with this commitment boundary.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'description'</i></b></dt>
|
||
|
|
<dd>Specify a maximum of 3000 characters, enclosed in apostrophes, to identify the group of changes being committed with this commitment boundary.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#COMMIT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="COMMIT.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
COMMIT CMTID('Account #123456 changes end')
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command specifies that all changes made to this point for the commitment definition associated with the program issuing the command are committed. The commitment identifier is 'Account #123456 changes end' and may be used by the system when updating the notify object if it needs updating during activation group end, job end, or IPL processing.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#COMMIT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="COMMIT.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF5030</b></dt>
|
||
|
|
<dd>Partial damage on member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF509F</b></dt>
|
||
|
|
<dd>Job has successfully connected after I/O error.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5104</b></dt>
|
||
|
|
<dd>Cancel reply received for message &7.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF511D</b></dt>
|
||
|
|
<dd>Parameter integrity error occurred with reason code &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5134</b></dt>
|
||
|
|
<dd>Not authorized to process request on member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5149</b></dt>
|
||
|
|
<dd>Operation for program device or member &4, file &2 in library &3 is not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5168</b></dt>
|
||
|
|
<dd>Cannot open member &3 file &1 in &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5169</b></dt>
|
||
|
|
<dd>Cannot complete input or output (I/O) to DDM file &2 in &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5173</b></dt>
|
||
|
|
<dd>&6 records in buffer not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5235</b></dt>
|
||
|
|
<dd>Entry for member &4 not journaled.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5257</b></dt>
|
||
|
|
<dd>Failure for device or member &4 file &2 in library &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5272</b></dt>
|
||
|
|
<dd>Records not added to member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF83DB</b></dt>
|
||
|
|
<dd>Commit operation resulted in rollback.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF83D0</b></dt>
|
||
|
|
<dd>Commitment operation not allowed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF83E1</b></dt>
|
||
|
|
<dd>Commit operation failed due to constraint violation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF83E2</b></dt>
|
||
|
|
<dd>Rollback operation required.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF835F</b></dt>
|
||
|
|
<dd>Commit or rollback operation failed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8350</b></dt>
|
||
|
|
<dd>Commitment definition not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8363</b></dt>
|
||
|
|
<dd>Commit operation failed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8367</b></dt>
|
||
|
|
<dd>Cannot perform commitment control operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9203</b></dt>
|
||
|
|
<dd>Reply &1 received from DDM target system not expected.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9255</b></dt>
|
||
|
|
<dd>Commitment control operation failed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b><u>*STATUS Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF5001</b></dt>
|
||
|
|
<dd>End of file &2 detected in library &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF83E6</b></dt>
|
||
|
|
<dd>Commitment control operation completed with resynchronization in progress.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b><u>*NOTIFY Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF5018</b></dt>
|
||
|
|
<dd>Member &4 at maximum size. Increment not allowed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF502A</b></dt>
|
||
|
|
<dd>Variable length record error on member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF502B</b></dt>
|
||
|
|
<dd>Error occurred in trigger program.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF502D</b></dt>
|
||
|
|
<dd>Referential constraint violation on member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF502E</b></dt>
|
||
|
|
<dd>Referential constraints could not be validated for member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF502F</b></dt>
|
||
|
|
<dd>Check constraint violation on member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5026</b></dt>
|
||
|
|
<dd>Duplicate key not allowed for member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5029</b></dt>
|
||
|
|
<dd>Data mapping error on member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF503A</b></dt>
|
||
|
|
<dd>Referential constraint violation on member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF503B</b></dt>
|
||
|
|
<dd>Record could not be inserted or updated in member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF503F</b></dt>
|
||
|
|
<dd>Partition key error on member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5030</b></dt>
|
||
|
|
<dd>Partial damage on member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5033</b></dt>
|
||
|
|
<dd>Select/omit error on member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5034</b></dt>
|
||
|
|
<dd>Duplicate key on access path.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5079</b></dt>
|
||
|
|
<dd>Commitment control resource limit exceeded for this job.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5084</b></dt>
|
||
|
|
<dd>Duplicate key not allowed for member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5085</b></dt>
|
||
|
|
<dd>Duplicate key on access path for based-on member of &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5090</b></dt>
|
||
|
|
<dd>Unique access path problems prevent updates to member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5097</b></dt>
|
||
|
|
<dd>Key mapping error on member &4.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#COMMIT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|