152 lines
7.9 KiB
HTML
152 lines
7.9 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="task" />
|
|
<meta name="DC.Title" content="Example: Restore a directory after eliminating save-outage time" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiurzaiu348.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="rstifshard" />
|
|
<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>Example: Restore a directory after eliminating save-outage time</title>
|
|
</head>
|
|
<body id="rstifshard"><a name="rstifshard"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Example: Restore a directory after eliminating save-outage time</h1>
|
|
<div><div class="section"> <p>This example shows a typical restore procedure after you eliminate
|
|
save-outage time in a directory. Your exact use of the function may differ,
|
|
based on your specific application requirements.</p>
|
|
<p>Perform the following
|
|
steps when restoring directory MyDirectory:</p>
|
|
</div>
|
|
<ol><li class="stepexpand"><span>Restore the directory with the following command:</span> <pre>RST DEV('/QSYS.LIB/TAP01.DEVD') +
|
|
OBJ('/MyDirectory') </pre>
|
|
|
|
<p>At the completion of these restore commands, the objects exist on the server,
|
|
but they will not be in a consistent state in relationship to each other.</p>
|
|
</li>
|
|
<li class="stepexpand"><span>Restore the necessary journal receivers that were attached at the
|
|
time the directory was. Use, a command such as the following to restore the
|
|
receivers: </span> <pre>RST DEV('/QSYS.LIB/TAP01.DEVD') +
|
|
OBJ('receiver-path') </pre>
|
|
</li>
|
|
<li class="stepexpand"><span>Determine a point in time, or application boundary, in which to
|
|
bring the objects in MyDirectory. This way all of the objects are in a consistent
|
|
state in relationship to each other. After determining the desired application
|
|
boundary, you might need to restore additional journal receivers. If you need
|
|
to restore additional journal receivers, but the receivers are not online,
|
|
restore them with a restore command such as the following. Multiple restore
|
|
commands may be necessary for this step:</span> <pre>RST DEV('/QSYS.LIB/TAP01.DEVD') +
|
|
OBJ('receiver-path') </pre>
|
|
<p>The Work with Journal Attributes (WRKJRNA) and Display Journal
|
|
(DSPJRN) commands can be helpful in finding the application boundary.</p>
|
|
|
|
<p>You can use the WRKJRNA command to determine the appropriate range of receivers
|
|
you need for the ensuing Apply Journaled Changes (APYJRNCHG) operations. You
|
|
can use the DSPJRN command to locate the exact sequence number that identifies
|
|
the desired application boundary. If multiple journals are involved, you must
|
|
locate the same application boundary (most likely identified by the timestamp)
|
|
in each journal. You must also note the appropriate journal sequence number.</p>
|
|
</li>
|
|
<li class="stepexpand"><span>Bring the objects forward to a specific application boundary with
|
|
one of the following Apply Journaled Changes (APYJRNCHG) commands. Different
|
|
variations of the APYJRNCHG command may be appropriate based on the given
|
|
criteria. </span> <ol type="a"><li>Use the commands below to apply the journaled changes to the objects if
|
|
the following is true:
|
|
<ul><li>The objects were saved prior to V5R3.</li>
|
|
<li>You did not restore the journal.</li>
|
|
<li>The media used represent the most recent save of the objects</li>
|
|
<li>You saved the objects specifying UPDHST(*YES) on the save command.</li>
|
|
<li>If the above conditions are not met but you are using V5R3.</li>
|
|
</ul>
|
|
|
|
<pre>APYJRNCHG JRN(jrnlib/jrnname) +
|
|
OBJPATH(/MyDirectory) +
|
|
SUBTREE(*ALL)+
|
|
TOENT(seq#-for-application-boundary)</pre>
|
|
|
|
<p>If multiple journals are involved, then repeat these commands for each
|
|
journal specifying the correct sequence number (TOENT parameter) that identifies
|
|
the desired application boundary. </p>
|
|
</li>
|
|
<li>Use the commands below to apply the journaled changes to the objects if
|
|
the following is true
|
|
<ul><li>The objects were saved prior to V5R3.</li>
|
|
<li>You restored the journal.</li>
|
|
<li>The media used represent the most recent save of the objects.</li>
|
|
<li>You saved the objects specifying UPDHST(*YES) on the save command.</li>
|
|
</ul>
|
|
|
|
<pre>APYJRNCHG JRN(jrnlib/jrnname) +
|
|
OBJPATH(/MyDirectory) +
|
|
SUBTREE(*ALL)+
|
|
RCVRNG(rcv-attached-at-save-time +
|
|
ending-rcv) +
|
|
TOENT(seq#-for-application-boundary)+
|
|
</pre>
|
|
|
|
<p>In the situation where the journal is restored, and the journaled objects
|
|
for which changes are going to be applied were saved prior to V5R3, the server
|
|
cannot determine the correct receiver range. Therefore, the correct range
|
|
of receivers must be specified on the RCVRNG parameter. The attached receiver
|
|
at the time that the directory was saved is the specified starting journal
|
|
receiver. If the journaled objects for which changes are going to be applied
|
|
were saved in V5R3 or later, then the server can determine the correct receiver
|
|
range when the default of RCVRNG(*LASTSAVE) is used. In this situation, the
|
|
apply command from step a works correctly.</p>
|
|
|
|
<p>If multiple journals are involved, then repeat these commands for each
|
|
journal specifying the correct sequence number (TOENT parameter) that identifies
|
|
the desired application boundary.</p>
|
|
</li>
|
|
<li>If you are not using V5R3, do the following commands if the save-while-active
|
|
media used does not represent the most recent save of the objects specifying
|
|
UPDHST(*YES).
|
|
<ol type="i"><li>Use the DSPJRN command to determine the sequence number of the start of
|
|
save journal entry for each object.</li>
|
|
<li> Issue an individual APYJRNCHG command for each of the objects.</li>
|
|
</ol>
|
|
The following example demonstrates such an APYJRNCHG command:
|
|
<pre>APYJRNCHG JRN(jrnlib/jrnname) +
|
|
OBJPATH(/MyDirectory) +
|
|
RCVRNG(rcv-attached-at-save-time +
|
|
ending-rcv) +
|
|
FROMENT(seq#-for-save or start-of-save-entry) +
|
|
TOENT(seq#-for-application-boundary)</pre>
|
|
|
|
<p>Because the most recent save of the objects is not being used, you cannot
|
|
specify FROMENT(*LASTSAVE) on the APYJRNCHG command. You must specify an individual
|
|
sequence number for directory MyDirectory</p>
|
|
|
|
<p>Some of the APYJRNCHG commands could specify multiple objects if there
|
|
is a continuous series of save or start-of-save entries in the journal. The
|
|
objects identified by the continuous series of save or start-of-save journal
|
|
entries could be applied to with a single APYJRNCHG command by specifying
|
|
the earliest sequence number of all the save or start-of-save entries in the
|
|
continuous series for the FROMENT parameter. If you are using V5R3, use the
|
|
*LASTSAVE value in the FROMENT parameter.</p>
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiurzaiu348.htm" title="Use the save-while-active function to eliminate your save-outage time.">Eliminate your save-outage time</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |