130 lines
8.5 KiB
HTML
130 lines
8.5 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="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="Start commitment control" />
|
||
|
|
<meta name="abstract" content="To start commitment control, use the Start Commitment Control (STRCMTCTL) Command." />
|
||
|
|
<meta name="description" content="To start commitment control, use the Start Commitment Control (STRCMTCTL) Command." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakjcommitkickoff.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakjnotify.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakjlocklevel.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/strcmtctl.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakjstates.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakjheuristic.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../rzaki/rzakijournalfinder.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="rzakjstartcommit" />
|
||
|
|
<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>Start commitment control</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakjstartcommit"><a name="rzakjstartcommit"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Start commitment control</h1>
|
||
|
|
<div><p>To start commitment control, use the Start Commitment Control (STRCMTCTL)
|
||
|
|
Command.</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> Commitment control does not need to be started by SQL applications.
|
||
|
|
SQL implicitly starts commitment control at connect time when the SQL isolation
|
||
|
|
level is not *NONE.</div>
|
||
|
|
<p>When you use the STRCMTCTL command, you can specify these parameters.</p>
|
||
|
|
<dl><dt class="dlterm">Commit lock-level</dt>
|
||
|
|
<dd>Specify the lock-level with the LCKLVL parameter on the STRCMTCTL command.
|
||
|
|
The level you specify becomes the default level of record locking for database
|
||
|
|
files that are opened and placed under commitment control for the commitment
|
||
|
|
definition.</dd>
|
||
|
|
<dt class="dlterm">Commit notify object</dt>
|
||
|
|
<dd>Use the NTFY parameter to specify the notify object. A notify object is
|
||
|
|
a message queue, data area, or database file that contains information identifying
|
||
|
|
the last successful transaction completed for a particular commitment definition
|
||
|
|
if that commitment definition did not end normally.</dd>
|
||
|
|
<dt class="dlterm">Commit scope parameter</dt>
|
||
|
|
<dd>Use the CMTSCOPE parameter to specify commit scope. When commitment control
|
||
|
|
is started, the system creates a commitment definition. The commit scope parameter
|
||
|
|
identifies the scope for the commitment definition. The default is to scope
|
||
|
|
the commitment definition to the activation group of the program making the
|
||
|
|
start commitment control request. The alternative scope is to the job.</dd>
|
||
|
|
<dt class="dlterm">Default journal parameter</dt>
|
||
|
|
<dd>You can specify a default journal when you start commitment control. You
|
||
|
|
might use a default journal for these reasons:<ul><li>You want to capture transaction journal entries. These entries can assist
|
||
|
|
you in analyzing the history of what resources are associated with a transaction.
|
||
|
|
They are not used for applying and removing journaled changes. The omit journal
|
||
|
|
entries (OMTJRNE) parameter determines whether the system writes transaction
|
||
|
|
entries.</li>
|
||
|
|
<li>You want to improve performance for jobs that close files and open them
|
||
|
|
again within a routing step. If you close all the files assigned to a journal
|
||
|
|
that is not the default journal, all the system information about the journal
|
||
|
|
is removed from the routing step. If a file that is assigned to that journal
|
||
|
|
is opened later, all the information about the journal must be created again.
|
||
|
|
The system keeps information about the default journal with the commitment
|
||
|
|
definition, whether any resources that are assigned to the journal are active.</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt class="dlterm">Commit text parameter</dt>
|
||
|
|
<dd>Use the TEXT parameter to identify the specific text to be associated
|
||
|
|
with a commitment definition when displaying information about the commitment
|
||
|
|
definitions started for a job. If no text is specified, the system provides
|
||
|
|
a default text description.</dd>
|
||
|
|
<dt class="dlterm">Omit journal entries parameter</dt>
|
||
|
|
<dd>If you specify a default journal to improve performance, you can use the
|
||
|
|
OMTJRNE parameter to prevent the system from writing transaction journal entries.
|
||
|
|
Having the system write transaction entries significantly increases the size
|
||
|
|
of your journal receiver and degrades performance during commit and rollback
|
||
|
|
operations.<p>Transaction entries can be useful when you are setting up and
|
||
|
|
testing either your commitment control environment or a new application.</p>
|
||
|
|
<p>Transaction
|
||
|
|
entries are written to the default journal regardless of the value of the
|
||
|
|
OMTJRNE parameter under these conditions:</p>
|
||
|
|
<ul><li>A system error occurs during a commit or rollback operation.</li>
|
||
|
|
<li>A manual change is made to a resource that participated in a transaction,
|
||
|
|
and the change caused a heuristic mixed condition. See States of the transaction
|
||
|
|
for two-phase commitment control for a description of the heuristic mixed
|
||
|
|
condition. This type of manual change is called a heuristic decision.</li>
|
||
|
|
</ul>
|
||
|
|
<p>You can use the information about what resources participated in the
|
||
|
|
transaction to determine what action to take in these situations.</p>
|
||
|
|
<p>You
|
||
|
|
can use the Journal entry information finder to show the layouts for the entry-specific
|
||
|
|
data for transaction (commitment control) journal entries.</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<ul class="ullinks">
|
||
|
|
<li class="ulchildlink"><strong><a href="rzakjnotify.htm">Commit notify object</a></strong><br />
|
||
|
|
A <dfn class="term">notify object</dfn> is a message queue, data area, or
|
||
|
|
database file that contains information identifying the last successful transaction
|
||
|
|
completed for a particular commitment definition if that commitment definition
|
||
|
|
did not end normally.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzakjlocklevel.htm">Commit lock level</a></strong><br />
|
||
|
|
The value you specify for the LCKLVL parameter on the Start Commitment Control (STRCMTCTL) command becomes the default level of record locking for database files that are opened and placed under commitment control for the commitment definition.</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakjcommitkickoff.htm" title="Commitment control is a function that ensures data integrity. It allows you to define and process a group of changes to resources, such as database files or tables, as a transaction.">Commitment control</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="rzakjstates.htm" title="A commitment definition is established at each location that is part of the transaction program network. For each commitment definition, the system keeps track of the state of its current transaction and previous transaction.">States of the transaction for two-phase commitment control</a></div>
|
||
|
|
<div><a href="../rzaki/rzakijournalfinder.htm">Journal entry information finder</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="reltasks"><strong>Related tasks</strong><br />
|
||
|
|
<div><a href="rzakjheuristic.htm" title="You can find when and how to force a rollback or commit, and when to cancel resynchronization in this topic.">When to force commits and rollbacks and when to cancel resynchronization</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relref"><strong>Related reference</strong><br />
|
||
|
|
<div><a href="../cl/strcmtctl.htm">Start Commitment Control (STRCMTCTL) command</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|