142 lines
8.6 KiB
HTML
142 lines
8.6 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">
|
||
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
||
|
|
<title>Journal and Commit APIs</title>
|
||
|
|
<!-- Begin Header Records ========================================== -->
|
||
|
|
<!-- 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. -->
|
||
|
|
<!-- Change History: -->
|
||
|
|
<!-- YYMMDD USERID Change description -->
|
||
|
|
<!-- JC1 SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
|
||
|
|
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
|
||
|
|
<!-- File restructured for V5R2; Tidy run -->
|
||
|
|
<!-- 030501 JETAYLOR replaced API and Exit listings with -->
|
||
|
|
<!-- pagegenerator output from javascript array -->
|
||
|
|
<!-- 030918 JETAYLOR replaced API and/or Exit listings with -->
|
||
|
|
<!-- pagegenerator output from javascript array -->
|
||
|
|
<!-- 031111 JETAYLOR replaced API and/or Exit listings with -->
|
||
|
|
<!-- pagegenerator output from javascript array -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<!-- End Header Records -->
|
||
|
|
<!-- Java sync-link -->
|
||
|
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
||
|
|
</script>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h2>Journal and Commit APIs</h2>
|
||
|
|
|
||
|
|
<p>Journaling allows you to specify objects that you want to protect for
|
||
|
|
recovery purposes. It also provides an audit trail for object changes.
|
||
|
|
Journaling provides an audit or activity trail for other objects either through
|
||
|
|
system operations or user actions. The journal APIs allow you to:</p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>Obtain information about some of the journal's attributes or the journal
|
||
|
|
receiver's attributes</li>
|
||
|
|
|
||
|
|
<li>Obtain journal information based on the journal identifier</li>
|
||
|
|
|
||
|
|
<li>Send an entry to specified journal</li>
|
||
|
|
|
||
|
|
<li>Add, remove, activate, and inactivate remote journals.</li>
|
||
|
|
|
||
|
|
<li>Start and stop journaling.</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p>Commitment control allows you to define and process changes to resources,
|
||
|
|
such as database files or tables, as a single logical unit of work. Commitment
|
||
|
|
control uses the journaling facility to provide for logical units of work. The
|
||
|
|
commitment control APIs allow you to:</p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>Add and remove your own resources to be used during system commit or
|
||
|
|
rollback processing</li>
|
||
|
|
|
||
|
|
<li>Retrieve information about the commitment control environment</li>
|
||
|
|
|
||
|
|
<li>Change commitment control options</li>
|
||
|
|
|
||
|
|
<li>Put a commitment definition into rollback-required state</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p>For additional information, see:</p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><a href="jc3.htm">Journaling for Journal and Commit APIs</a><br>
|
||
|
|
<br>
|
||
|
|
</li>
|
||
|
|
|
||
|
|
<li><a href="jc4.htm">Commitment Control for Journal and Commit APIs</a></li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p>If you plan to use the APIs described in this chapter, you must understand
|
||
|
|
the <a href="../rzakj/rzakjcommitkickoff.htm">Commitment Control</a> and
|
||
|
|
<a href="../rzaki/rzakikickoff.htm">Journal Management</a> topics in the
|
||
|
|
Information Center. These topics include information on remote journaling,
|
||
|
|
remote journaling support, and a complete description of the information
|
||
|
|
contained in journal entries that the system sends and all the possible
|
||
|
|
journal codes and entry types.<br>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p>The journal and commit APIs are:</p>
|
||
|
|
<!-- ***** NOTE ***** Do not manually update text or links in this section. -->
|
||
|
|
<!-- Updates made in this section *will* be overlaid by automated tools -->
|
||
|
|
<!-- Notify User Technologies of needed updates to be made in XML for API finder.-->
|
||
|
|
<!--***************API BEGIN PASTE***************-->
|
||
|
|
<ul>
|
||
|
|
<li><A HREF="QTNADDCR.htm">Add Commitment Resource</A> (QTNADDCR) adds an API commitment resource to the current commitment definition.</li>
|
||
|
|
<li><A HREF="QJOADDRJ.htm">Add Remote Journal</A> (QjoAddRemoteJournal) associates a remote journal on the target system, as identified by the relational database directory entry, with the specified journal on the source system.</li>
|
||
|
|
<li><A HREF="QTNCHGCO.htm">Change Commitment Options</A> (QTNCHGCO) changes the commitment control options for the current commitment definition.</li>
|
||
|
|
<li><A HREF="qjochrvc.htm">Change Journal Recovery Count</A> (QJOCHRVC) controls how often changes to journaled objects are forced to auxiliary storage.</li>
|
||
|
|
<li><A HREF="QJOCHGST.htm">Change Journal State</A> (QjoChangeJournalState) changes the journal state of local and remote journals.</li>
|
||
|
|
<li><A HREF="qtnclrlu.htm">Clear LU6.2 Partners</A> (QTNCLRLU) clears LU6.2 syncpoint LOG partners known to the system.</li>
|
||
|
|
<li><A HREF="QJODLTPH.htm">Delete Pointer Handle</A> (QjoDeletePointerHandle) deletes the specified pointer handle.</li>
|
||
|
|
<li><A HREF="qjoejobj.htm">End Journal</A> (QjoEndJournal) ends journaling for the specified object.</li>
|
||
|
|
<li><A HREF="QMATJPAT.htm">Materialize Journal Port Attributes</A> (QusMaterializeJournalPortAttr) retrieves some of the current attributes of a journal.</li>
|
||
|
|
<li><A HREF="QMATJSAT.htm">Materialize Journal Space Attributes</A> (QusMaterializeJournalSpaceAttr) retrieves some of the current attributes of a journal receiver.</li>
|
||
|
|
<li><A HREF="QTNRMVCR.htm">Remove Commitment Resource</A> (QTNRMVCR) removes an API commitment resource from the current commitment definition.</li>
|
||
|
|
<li><A HREF="QJORMVRJ.htm">Remove Remote Journal</A> (QjoRemoveRemoteJournal) disassociates a remote journal on the target system, as identified by the relational database directory entry, from the specified journal on the source system.</li>
|
||
|
|
<li><A HREF="qdbrplay.htm">Replay Database Operation</A> (QDBRPLAY) Replay a database operation from a single journal entry.</li>
|
||
|
|
<li><A HREF="QTNRCMTI.htm">Retrieve Commitment Information</A> (QTNRCMTI) gets information about the current commitment definition.</li>
|
||
|
|
<li><A HREF="QJORJRNE.htm">Retrieve Journal Entries</A> (QjoRetrieveJournalEntries) provides access to journal entries.</li>
|
||
|
|
<li><A HREF="QJORJIDI.htm">Retrieve Journal Identifier Information</A> (QJORJIDI) gets information about a specific journal identifier (JID) for a specified journal.</li>
|
||
|
|
<li><A HREF="QJORJRNI.htm">Retrieve Journal Information</A> (QjoRetrieveJournalInformation) provides access to journal-related information to help manage a journal environment, including a remote journal environment.</li>
|
||
|
|
<li><A HREF="QJORRCVI.htm">Retrieve Journal Receiver Information</A> (QjoRtvJrnReceiverInformation) provides access to journal-receiver-related information to help manage a journal environment, including a remote journal environment.</li>
|
||
|
|
<li><A HREF="qtnrtnlu.htm">Return LU6.2 Partners</A> (QTNRTNLU) returnss LU6.2 syncpoint LOG partners known to the system.</li>
|
||
|
|
<li><A HREF="QTNRBRQD.htm">Rollback Required</A> (QTNRBRQD) puts the current commitment definition into a rollback-required state.</li>
|
||
|
|
<li><A HREF="QJOSJRNE.htm">Send Journal Entry</A> (QJOSJRNE) writes a single journal entry to a specific journal.</li>
|
||
|
|
<li><A HREF="qjosjobj.htm">Start Journal</A> (QjoStartJournal) starts journaling for the specified object.</li>
|
||
|
|
</ul>
|
||
|
|
<!--***************API END PASTE***************-->
|
||
|
|
|
||
|
|
<p>The journal and commit exit programs are:</p>
|
||
|
|
<!-- ***** NOTE ***** Do not manually update text or links in this section. -->
|
||
|
|
<!-- Updates made in this section *will* be overlaid by automated tools -->
|
||
|
|
<!-- Notify User Technologies of needed updates to be made in XML for API finder.-->
|
||
|
|
<!--***************EXIT PROGRAM BEGIN PASTE***************-->
|
||
|
|
<ul>
|
||
|
|
<li><A HREF="QTNEXIT.htm">Commitment Control</A> is called during commitment control operations after an API commitment resource is added to a commitment definition. The commitment control operations pass specific information to the exit program.</li>
|
||
|
|
<li><A HREF="XDLTRCV.htm">Delete Journal Receiver</A> is called when a journal receiver is to be deleted by any method. For example, the exit program will be called when the user runs the Delete Journal Receiver (DLTJRNRCV) command, or when the system attempts to delete a journal receiver because the journal has the DLTRCV(*YES) attribute specified.</li>
|
||
|
|
</ul>
|
||
|
|
<!--***************EXIT PROGRAM END PASTE***************-->
|
||
|
|
|
||
|
|
<hr>
|
||
|
|
<center>
|
||
|
|
<table cellpadding="2" cellspacing="2">
|
||
|
|
<tr align="center">
|
||
|
|
<td valign="middle" align="center">
|
||
|
|
<a href="#Top_Of_Page">Top</a> |
|
||
|
|
<a href="aplist.htm">APIs by category</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
</center>
|
||
|
|
</body>
|
||
|
|
</html>
|