149 lines
13 KiB
HTML
149 lines
13 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="Exit program to receive journal entries" />
|
||
|
|
<meta name="abstract" content="Use the parameters in this topic to determine how the exit program will receive journal entries." />
|
||
|
|
<meta name="description" content="Use the parameters in this topic to determine how the exit program will receive journal entries." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakircvjrnentry.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakirqstblckmode.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../apis/QJORJRNE.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/rcvjrne.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../apis/QJOCHGST.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/chgrmtjrn.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="rzakiexitjrnentry" />
|
||
|
|
<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>Exit program to receive journal entries</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakiexitjrnentry"><a name="rzakiexitjrnentry"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Exit program to receive journal entries</h1>
|
||
|
|
<div><p>Use the parameters in this topic to determine how the exit program will receive journal entries.</p>
|
||
|
|
<p>You use two parameters to communicate between your exit program and the system when you are receiving journal entries. The system uses the first parameter for the contents of one or more journal entries
|
||
|
|
that it is passing to the exit program. The exit program uses the first parameter to indicate the block length if the exit program requests block mode.</p>
|
||
|
|
<p>The system and the exit program use the second parameter to communicate about status changes, such as requesting block mode or ending the RCVJRNE command. The second parameter is a character field that
|
||
|
|
is three bytes long. Following are the possible values for the first byte of the second parameter:</p>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th colspan="2" valign="top" class="firstcol" id="d0e25">Possible values for the first byte of the second parameter </th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><th valign="top" width="12.5%" class="firstcol" id="d0e29" headers="d0e25 ">0</th>
|
||
|
|
<td valign="top" width="87.5%" headers="d0e29 d0e25 ">This value is passed from the system to the exit program. It indicates that no journal entry is being passed on this call of the exit program.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><th valign="top" width="12.5%" class="firstcol" id="d0e34" headers="d0e25 ">1</th>
|
||
|
|
<td valign="top" width="87.5%" headers="d0e34 d0e25 ">This value is passed from the system to the exit program. It indicates that a single journal entry is being passed on this call of the exit program. If the specified entry format is not *TYPEPTR
|
||
|
|
or *JRNENTFMT, then the figure, First parameter of RCVJRNE command: Single-entry mode shows the layout of the first parameter. Otherwise, the layout is the same as returned to the Retrieve Journal Entries
|
||
|
|
(QjoRetrieveJournalEntries) API interface.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><th valign="top" width="12.5%" class="firstcol" id="d0e39" headers="d0e25 ">2</th>
|
||
|
|
<td valign="top" width="87.5%" headers="d0e39 d0e25 ">This value is passed from the system to the exit program. It indicates that block mode is in effect. One or more journal entries are being passed on this call of the exit program. If the specified
|
||
|
|
entry format is not *TYPEPTR or *JRNENTFMT, then the figure, First parameter of RCVJRNE command: Block mode shows the layout of the first parameter. Otherwise, the layout is the same as returned to the
|
||
|
|
QjoRetrieveJournalEntries API interface.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><th valign="top" width="12.5%" class="firstcol" id="d0e44" headers="d0e25 ">3</th>
|
||
|
|
<td valign="top" width="87.5%" headers="d0e44 d0e25 ">This value is passed from the system to the exit program. It indicates that no journal entry is being passed on this call of the exit program because the journal receiver that was attached when the
|
||
|
|
Receive Journal Entry (RCVJRNE) command was started is no longer attached. The system ends the RCVJRNE command after returning this value to the exit program.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><th valign="top" width="12.5%" class="firstcol" id="d0e49" headers="d0e25 ">4</th>
|
||
|
|
<td valign="top" width="87.5%" headers="d0e49 d0e25 ">No journal entry is passed on this call to the exit program, and no more entries can be passed unless the local or remote journal is activated. <p>This value can only be passed to the exit program
|
||
|
|
when receiving journal entries from the attached receiver of a local or remote journal. The journal state for the journal must be *INACTIVE.</p>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr><th valign="top" width="12.5%" class="firstcol" id="d0e56" headers="d0e25 ">8</th>
|
||
|
|
<td valign="top" width="87.5%" headers="d0e56 d0e25 ">This value is passed from the exit program to the system. It indicates that the system must begin block mode and pass multiple entries to the exit program. <p>You can also specify block mode by using
|
||
|
|
the BLKLEN parameter of the RCVJRNE command. If you specify a BLKLEN value other than *NONE, then specifying 8 in the first byte of the second parameter will have no impact and the first 5 bytes of the
|
||
|
|
first parameter bill be ignored. However even if BLKLEN(*NONE) is specified, the system will begin block mode if you specify 8 for the first byte of the second parameter. See Request block mode for more
|
||
|
|
information.</p>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr><th valign="top" width="12.5%" class="firstcol" id="d0e63" headers="d0e25 ">9</th>
|
||
|
|
<td valign="top" width="87.5%" headers="d0e63 d0e25 ">This value is passed from the exit program to the system. It indicates that the RCVJRNE command will be ended.</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th colspan="2" valign="top" class="firstcol" id="d0e73">Possible Values for the Second Byte of the Second Parameter:</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><th valign="top" width="12.5%" class="firstcol" id="d0e77" headers="d0e73 ">N</th>
|
||
|
|
<td valign="top" width="87.5%" headers="d0e77 d0e73 ">This value is passed from the system to the exit program. Additional journal entries are not currently available to be passed after this call of the exit program, or the RCVJRNE command will end
|
||
|
|
after this call of the exit program.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><th valign="top" width="12.5%" class="firstcol" id="d0e82" headers="d0e73 ">Y</th>
|
||
|
|
<td valign="top" width="87.5%" headers="d0e82 d0e73 ">This value is passed from the system to the exit program. Additional journal entries are currently available to be passed after this call of the exit program.</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th colspan="2" valign="top" class="firstcol" id="d0e92">Possible values for the third byte of the second parameter: </th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><th valign="top" width="12.5%" class="firstcol" id="d0e96" headers="d0e92 ">'00' x</th>
|
||
|
|
<td valign="top" width="87.5%" headers="d0e96 d0e92 ">One or more journal entries are being passed to the exit program and the object names in the fixed-length portion of each journal entry do not necessarily reflect the name of the object at the time
|
||
|
|
the journal entry was deposited into the journal. <p>This value is only returned when receiving journal entries from a journal receiver that was attached to a journal prior to V4R2M0.</p>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr><th valign="top" width="12.5%" class="firstcol" id="d0e103" headers="d0e92 ">0</th>
|
||
|
|
<td valign="top" width="87.5%" headers="d0e103 d0e92 ">No journal entries are currently being passed, so the information that is normally returned in this byte is not applicable.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><th valign="top" width="12.5%" class="firstcol" id="d0e108" headers="d0e92 ">1</th>
|
||
|
|
<td valign="top" width="87.5%" headers="d0e108 d0e92 ">One or more journal entries are being passed to the exit program. The object names in the fixed-length portion of each journal entry reflect the name of the object at the time the journal entry was
|
||
|
|
deposited into the journal.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><th valign="top" width="12.5%" class="firstcol" id="d0e113" headers="d0e92 ">2</th>
|
||
|
|
<td valign="top" width="87.5%" headers="d0e113 d0e92 ">One or more journal entries are being passed to the exit program. The object names in the fixed-length portion of each journal entry do not necessarily reflect the name of the object at the time
|
||
|
|
the journal entry was deposited into the journal. The object name in the fixed-length portion of the journal entry may be returned as a known name for the object prior to the journal entry being deposited
|
||
|
|
into the journal. The object name in the fixed-length portion of the journal entry may also be returned as *UNKNOWN. <p>This value will only be returned when receiving journal entries from a remote journal
|
||
|
|
and the remote journal is currently being caught up from its source journal. A remote journal is being caught up from its source journal when the Change Journal State (QjoChangeJournalState) API or Change
|
||
|
|
Remote Journal (CHGRMTJRN) command is invoked and is currently replicating journal entries to the remote journal. After the call to the QjoChangeJournalState API or CHGRMTJRN command returns, the remote
|
||
|
|
journal is maintained with a synchronous or asynchronous delivery mode, and the remote journal is no longer being caught up.</p>
|
||
|
|
<p>Refer to Retrieve journal entries from a remote journal during the catch-up
|
||
|
|
phase for more information.</p>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<p>Any information that is passed from the exit program to the system in the second byte or third byte is ignored.</p>
|
||
|
|
<p>The second byte of the second exit program parameter is provided whether journal entries are being processed as a single journal entry per call of the exit program, or as a block of journal entries per
|
||
|
|
call.</p>
|
||
|
|
<p>When an N is passed to the exit program in the second byte of the second parameter indicated that no additional journal entries are currently available, it does not necessarily mean that when the exit
|
||
|
|
program returns, that the RCVJRNE command will have to wait for additional journal entries to be deposited into the journal. By the time the exit program returns, additional journal entries may already
|
||
|
|
be available and depending upon what was specified on the DELAY parameter, may or may not be immediately passed to the exit program. If DELAY(N) was specified the system will wait N seconds before passing
|
||
|
|
the journal entries to the exit program. If DELAY(*NEXTENT) was specified, the journal entries will immediately be passed to the exit program.</p>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakircvjrnentry.htm" title="You can write a program to receive journal entries as they are written to the journal receiver.">Receive journal entries in an exit program</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="rzakirqstblckmode.htm" title="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.">Request block mode</a></div>
|
||
|
|
<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="../apis/QJORJRNE.htm">Retrieve Journal Entries (QjoRetrieveJournalEntries) API</a></div>
|
||
|
|
<div><a href="../cl/rcvjrne.htm">Receive Journal Entry (RCVJRNE) command</a></div>
|
||
|
|
<div><a href="../apis/QJOCHGST.htm">Change Journal State (QjoChangeJournalState) API</a></div>
|
||
|
|
<div><a href="../cl/chgrmtjrn.htm">Change Remote Journal (CHGRMTJRN) command</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|