127 lines
8.3 KiB
HTML
127 lines
8.3 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="Remove journaled changes" />
|
|
<meta name="abstract" content="Depending on the type of damage to the journaled object and the amount of activity since the object was last saved, removing changes from the object can be easier than applying changes to the object. Use the Remove Journaled Changes (RMVJRNCHG) command to remove changes from an object if you are journaling before-images." />
|
|
<meta name="description" content="Depending on the type of damage to the journaled object and the amount of activity since the object was last saved, removing changes from the object can be easier than applying changes to the object. Use the Remove Journaled Changes (RMVJRNCHG) command to remove changes from an object if you are journaling before-images." />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakiapyjrnchg.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakiwrkbkout.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakijrncodes.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakiqajrnchg.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="rzakirmvjrnchg" />
|
|
<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>Remove journaled changes</title>
|
|
</head>
|
|
<body id="rzakirmvjrnchg"><a name="rzakirmvjrnchg"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Remove journaled changes</h1>
|
|
<div><p>Depending on the type of damage to the journaled object and the
|
|
amount of activity since the object was last saved, removing changes from
|
|
the object can be easier than applying changes to the object. Use the Remove
|
|
Journaled Changes (RMVJRNCHG) command to remove changes from an object if
|
|
you are journaling before-images.</p>
|
|
<p>The RMVJRNCHG command removes changes in reverse chronological order, starting
|
|
with the most recent change.</p>
|
|
<p>On the RMVJRNCHG command, you identify the first journal entry to be removed
|
|
from the object. This entry can be from:</p>
|
|
<ul><li>The last journal entry that is contained within the range of journal receivers
|
|
specified.</li>
|
|
<li>The entry that corresponds to the last save of the object.</li>
|
|
<li>An identified sequence number.</li>
|
|
</ul>
|
|
<p>You can control the changes that are removed from the object. For example,
|
|
assume that an application updated data incorrectly for a period of time.
|
|
In this case, you can remove the changes from the object until that application
|
|
first opened the object.</p>
|
|
<p>You can stop removing journaled changes at:</p>
|
|
<ul><li>The start of the commit cycle for a transaction.</li>
|
|
<li>The end of data in the journal receivers. This corresponds to the first
|
|
journal entry that was recorded on the range of journal receivers that are
|
|
specified.</li>
|
|
<li>An identified sequence number that corresponds to a particular entry in
|
|
the journal.</li>
|
|
<li>The start of a particular job's use of the object. You can only specify
|
|
this if you did not specify any the following: <ul><li>To exclude open and close journal entries (OMTJRNE(*OPNCLO)) when starting
|
|
journaling for the file</li>
|
|
<li>To minimize fixed-length entries RCVSIZOPT(*MINFIXLEN) for the journal
|
|
at any time while the object was journaled.</li>
|
|
<li>To omit a FIXLENDTA option that includes the job name.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<p>You can ensure that commitment transaction boundaries are honored on the
|
|
remove journaled changes operations by using the CMTBDY parameter on these
|
|
commands.</p>
|
|
<p>If the system encounters a journal entry that causes the apply or remove
|
|
process to stop, the commitment boundary may not be honored.</p>
|
|
<div class="section"><h4 class="sectiontitle">Error handling</h4><p>When the system encounters a journal
|
|
entry it cannot process, it ends remove processing either for that specific
|
|
object or for the entire remove operation. You can specify how the system
|
|
behaves when it encounters a journal entry it cannot process with the Object
|
|
Error Option (OBJERROPT) on the Remove Journaled Changes (RMVJRNCHG) command.
|
|
If you specify OBJERROPT(*CONTINUE), the system ends remove processing for
|
|
the specific object, but it continues remove processing for the other objects
|
|
in the remove operation. If you specify OBJERROPT(*END), the system ends processing
|
|
for the entire remove operation. Actions of applying or removing journaled
|
|
changes by journal code shows which entry types cause processing to end for
|
|
an object.</p>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Starting and ending points</h4><p>Use the Display Journal
|
|
(DSPJRN) command to identify the required starting and ending points. If you
|
|
use a control language (CL) program for your recovery procedures, use the
|
|
following:</p>
|
|
<ul><li>Receive Journal Entry (RCVJRNE) command to receive journal entries as
|
|
they are written to the journal receiver.</li>
|
|
<li>Retrieve Journal Entry (RTVJRNE) command to retrieve a journal entry and
|
|
place it in program variables.</li>
|
|
</ul>
|
|
<p>You can also use the Retrieve Journal Entries (QjoRetrieveJournalEntries)
|
|
API to retrieve the information into a High Level Language (HLL) program.</p>
|
|
<p>Another
|
|
way to remove journaled changes is to Remove journaled changes with the WRKJRN
|
|
command and follow the command prompts.</p>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">The apply and remove journaled changes output file</h4><p>It
|
|
is highly recommended that you use the apply and remove journaled changes
|
|
output file when you remove journaled changes. The output file contains a
|
|
record for each object that the remove operation processes. It contains a
|
|
record for each object created and each object deleted during the remove.
|
|
This output file is especially useful when the remove ends early. It is much
|
|
easier to query the output file for the status of each object rather then
|
|
searching through the job log messages. Also the messages are limited to 512
|
|
while the output file is not limited.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<ul class="ullinks">
|
|
<li class="ulchildlink"><strong><a href="rzakiwrkbkout.htm">Remove journaled changes with the WRKJRN command</a></strong><br />
|
|
Remove journaled changes with the <span class="cmdname">Work With Journal (WRKJRN)</span> command
|
|
by selecting Option 3 (Backout recovery). </li>
|
|
</ul>
|
|
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakiapyjrnchg.htm" title="One of the primary advantages of journaling is its ability to return a journaled object to its current state since the last save.">Recover journaled objects</a></div>
|
|
</div>
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
|
<div><a href="rzakijrncodes.htm" title="The following table shows the actions that are taken by the Apply Journaled Changes (APYJRNCHG), Apply Journaled Changes Extend (APYJRNCHGX), or Remove Journaled Changes (RMVJRNCHG) command by journal code and entry type.">Actions of applying or removing journaled changes by journal code</a></div>
|
|
<div><a href="rzakiqajrnchg.htm" title="Use the apply and remove journaled changes output (QAJRNCHG) file to make a record of all the activity that occurs when you perform an apply or remove journaled changes operation.">Use the apply and remove journaled changes output file</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |