86 lines
5.6 KiB
HTML
86 lines
5.6 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="Receive journal entries in an exit program" />
|
|
<meta name="abstract" content="You can write a program to receive journal entries as they are written to the journal receiver." />
|
|
<meta name="description" content="You can write a program to receive journal entries as they are written to the journal receiver." />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakiwrkjrninfo.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakiexitjrnentry.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakirqstblckmode.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/rcvjrne.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/dspjrn.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakirretrievejrn.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="rzakircvjrnentry" />
|
|
<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>Receive journal entries in an exit program</title>
|
|
</head>
|
|
<body id="rzakircvjrnentry"><a name="rzakircvjrnentry"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Receive journal entries in an exit program</h1>
|
|
<div><p>You can write a program to receive journal entries as they are
|
|
written to the journal receiver.</p>
|
|
<p>When you use the Receive Journal Entry (RCVJRNE) command, you can specify
|
|
a user-defined program, called an <span class="uicontrol">exit program</span>, to
|
|
receive journal entries. The program can, for example, write the entries to
|
|
tape or to an i5/OS<sup>®</sup> intersystem
|
|
communications function (ICF) file that sends them to a backup system. You
|
|
can use the received entries to update a backup copy of the primary object
|
|
on the backup system. You cannot use these received entries with system-supplied
|
|
recovery commands (Apply Journaled Changes (APYJRNCHG) and Remove Journaled
|
|
Changes (RMVJRNCHG)) to update your objects because the RCVJRNE command converts
|
|
the entries to their external form. You must write your own program to apply
|
|
the changes that are contained in the entries to the objects.</p>
|
|
<p>The RCVJRNE command supports the same selection criteria (database
|
|
files, data areas, data queues, or integrated file system objects) as the
|
|
Display Journal (DSPJRN) command. You can specify which entries go to the
|
|
exit program.</p>
|
|
<p>For example, you can choose not to receive journal entries that are generated
|
|
by the action of trigger programs or referential constraints. If you have
|
|
a user-written program that updates the files on a second system with the
|
|
journal entries, you probably want to specify DEPENT(*NONE). The actions performed
|
|
by trigger programs or referential constraints are duplicated automatically
|
|
on the second system if your database definitions are the same and you replay
|
|
the original file operations.</p>
|
|
<p>You can specify DELAY(*NEXTENT) to have journal entries sent to your program
|
|
as soon as they are written to the journal receiver. You can also specify
|
|
a time interval. The exit program will be called sometime within that time
|
|
interval. Either new entries are sent or an indicator is sent
|
|
that there are no new entries.</p>
|
|
</div>
|
|
<div>
|
|
<ul class="ullinks">
|
|
<li class="ulchildlink"><strong><a href="rzakiexitjrnentry.htm">Exit program to receive journal entries</a></strong><br />
|
|
Use the parameters in this topic to determine how the exit program will receive journal entries.</li>
|
|
<li class="ulchildlink"><strong><a href="rzakirqstblckmode.htm">Request block mode</a></strong><br />
|
|
Use block mode to specify whether the system will be sending one or more journal entries to the exit program and specifies the block length of the buffer passed to the exit program.</li>
|
|
</ul>
|
|
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakiwrkjrninfo.htm" title="Provides ways that you can display, retrieve, and receive journal entries.">Work with journal entry information</a></div>
|
|
</div>
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
|
<div><a href="rzakirretrievejrn.htm" title="During the catch-up phase, journal entries that have been replicated to the target system can be retrieved from the remote journal.">Retrieve journal entries from a remote journal during the catch-up phase</a></div>
|
|
</div>
|
|
<div class="relref"><strong>Related reference</strong><br />
|
|
<div><a href="../cl/rcvjrne.htm">Receive Journal Entry (RCVJRNE) command</a></div>
|
|
<div><a href="../cl/dspjrn.htm">Display Journal (DSPJRN) command</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |