3374 lines
162 KiB
HTML
3374 lines
162 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">
|
|
<title>Receive Journal Entry (RCVJRNE)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="RCVJRNE.Top_Of_Page"></a>
|
|
<h2>Receive Journal Entry (RCVJRNE)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#RCVJRNE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RCVJRNE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RCVJRNE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RCVJRNE"></a>
|
|
<p>The Receive Journal Entry (RCVJRNE) command allows a specified user exit program to continuously receive journal entries. This program can be set up, for example, to write the entries either (1) to an ICF file, supplying updates to a file on a backup system, or (2) on a tape, imitating a journal-to-tape function. The information in the journal entries received can be used to update the objects being journaled to minimize the loss of data in the event of a disk failure, and to update objects on a backup system in case of a system failure on the primary system.
|
|
</p>
|
|
<p>The value specified on the ENTFMT parameter determines the format of the journal entries passed to the exit program.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>If the sequence number is reset in the range of the receivers specified, the first occurrence of FROMENTLRG or FROMENT is used, if they are specified. If TOENTLRG or TOENT is specified, the first occurance after the FROMENTLRG or FROMENT entry is used, if FROMENTLRG or FROMENT is specified. Otherwise the first occurance is used.
|
|
</li>
|
|
<li>The FILE, OBJ, OBJPATH, OBJFID, SUBTREE, PATTERN, JRNCDE, ENTTYP, JOB, PGM, USRPRF, CCIDLRG, CMTCYCID, and DEPENT parameters can be used to specify a subset of all available entries within a range of journal entries.
|
|
<ul>
|
|
<li>If no values are specified using these parameters, all available journal entries are received.
|
|
</li>
|
|
<li>If more than one of these parameters are specified, then a journal entry must satisfy all of the values specified on these parameters, except when *IGNFILSLT or *IGNOBJSLT is specified on the JRNCDE parameter.
|
|
</li>
|
|
<li>If a journal code is specified on the JRNCDE parameter and *IGNFILSLT is the second element of that journal code, then journal entries with the specified journal code are selected if they satisfy all selection criteria except what is specified on the FILE parameter.
|
|
</li>
|
|
<li>If a journal code is specified on the JRNCDE parameter and *IGNOBJSLT is the second element of that journal code, then journal entries with the specified journal code are selected if they satisfy all selection criteria except what is specified on the OBJ, OBJPATH, OBJFID, SUBTREE, and PATTERN parameters.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>The JOB, PGM, and USRPRF parameters cannot be used to specify selection criteria if one or more journal receivers in the specified receiver range was attached to the journal when a receiver size option (RCVSIZOPT) or a fixed length data option (FIXLENDTA) that would have omitted this data was in effect.
|
|
</li>
|
|
<li>If more than the maximum number of objects is identified (32767 objects), an error occurs and no entries are received. This restriction is ignored if *ALLFILE is specified or no objects are specified.
|
|
</li>
|
|
<li>When journal caching is being used, entries that are in the cache are not returned.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RCVJRNE.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RCVJRNE.JRN"><b>JRN</b></a></td>
|
|
<td valign="top">Journal</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Journal</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#RCVJRNE.EXITPGM"><b>EXITPGM</b></a></td>
|
|
<td valign="top">Program to receive entries</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Program to receive entries</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="5"><a href="#RCVJRNE.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">Journaled physical file</td>
|
|
<td valign="top">Single values: *ALLFILE<br>Other values (up to 300 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="5">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: File</td>
|
|
<td valign="top">
|
|
<i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: File</td>
|
|
<td valign="top"><i>Name</i>, *ALL</td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top">Element 2: Member</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*FIRST</u></b>, *ALL, *NONE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="6"><a href="#RCVJRNE.OBJ"><b>OBJ</b></a></td>
|
|
<td valign="top">Objects</td>
|
|
<td valign="top">Values (up to 300 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="6">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Object</td>
|
|
<td valign="top">
|
|
<i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Object</td>
|
|
<td valign="top"><i>Name</i>, *ALL</td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top">Element 2: Object type</td>
|
|
<td valign="top">
|
|
*FILE, *DTAARA, *DTAQ</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Member, if data base file</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*FIRST</u></b>, *ALL, *NONE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RCVJRNE.OBJPATH"><b>OBJPATH</b></a></td>
|
|
<td valign="top">Objects</td>
|
|
<td valign="top">Values (up to 300 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Name</td>
|
|
<td valign="top">
|
|
<i>Path name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Include or omit</td>
|
|
<td valign="top">
|
|
<b><u>*INCLUDE</u></b>, *OMIT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.OBJFID"><b>OBJFID</b></a></td>
|
|
<td valign="top">File identifier</td>
|
|
<td valign="top">Values (up to 300 repetitions): <i>Hexadecimal value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.SUBTREE"><b>SUBTREE</b></a></td>
|
|
<td valign="top">Directory subtree</td>
|
|
<td valign="top"><b><u>*NONE</u></b>, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RCVJRNE.PATTERN"><b>PATTERN</b></a></td>
|
|
<td valign="top">Name pattern</td>
|
|
<td valign="top">Values (up to 20 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Pattern</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Include or omit</td>
|
|
<td valign="top">
|
|
<b><u>*INCLUDE</u></b>, *OMIT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="7"><a href="#RCVJRNE.RCVRNG"><b>RCVRNG</b></a></td>
|
|
<td valign="top">Range of journal receivers</td>
|
|
<td valign="top">Single values: <b><u>*CURRENT</u></b>, *CURCHAIN<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="7">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Starting journal receiver</td>
|
|
<td valign="top">
|
|
<i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Starting journal receiver</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top">Element 2: Ending journal receiver</td>
|
|
<td valign="top">
|
|
Single values: <b><u>*CURRENT</u></b><br>Other values: <i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Ending journal receiver</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#RCVJRNE.FROMENTLRG"><b>FROMENTLRG</b></a></td>
|
|
<td valign="top">Starting large sequence number</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*FIRST</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RCVJRNE.FROMTIME"><b>FROMTIME</b></a></td>
|
|
<td valign="top">Starting date and time</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Starting date</td>
|
|
<td valign="top">
|
|
<i>Date</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Starting time</td>
|
|
<td valign="top">
|
|
<i>Time</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.TOENTLRG"><b>TOENTLRG</b></a></td>
|
|
<td valign="top">Ending large sequence number</td>
|
|
<td valign="top"><i>Character value</i>, *LAST, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RCVJRNE.TOTIME"><b>TOTIME</b></a></td>
|
|
<td valign="top">Ending date and time</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Ending date</td>
|
|
<td valign="top">
|
|
<i>Date</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Ending time</td>
|
|
<td valign="top">
|
|
<i>Time</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.NBRENT"><b>NBRENT</b></a></td>
|
|
<td valign="top">Number of journal entries</td>
|
|
<td valign="top"><i>Integer</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RCVJRNE.JRNCDE"><b>JRNCDE</b></a></td>
|
|
<td valign="top">Journal codes</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b>, *CTL<br>Other values (up to 16 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Journal code value</td>
|
|
<td valign="top">
|
|
A, B, C, D, E, F, J, L, M, P, R, Q, S, T, U</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Journal code selection</td>
|
|
<td valign="top">
|
|
<b><u>*ALLSLT</u></b>, *IGNFILSLT, *IGNOBJSLT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.ENTTYP"><b>ENTTYP</b></a></td>
|
|
<td valign="top">Journal entry types</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b>, *RCD<br>Other values (up to 300 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#RCVJRNE.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b>, *<br>Other values: <i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Job name</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: User</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000000-999999</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#RCVJRNE.PGM"><b>PGM</b></a></td>
|
|
<td valign="top">Program</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.USRPRF"><b>USRPRF</b></a></td>
|
|
<td valign="top">User profile</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.CCIDLRG"><b>CCIDLRG</b></a></td>
|
|
<td valign="top">Commit cycle large identifier</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.DEPENT"><b>DEPENT</b></a></td>
|
|
<td valign="top">Dependent entries</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.ENTFMT"><b>ENTFMT</b></a></td>
|
|
<td valign="top">Entry format</td>
|
|
<td valign="top"><b><u>*TYPE1</u></b>, *TYPE2, *TYPE3, *TYPE4, *TYPEPTR, *JRNENTFMT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.FMTMINDTA"><b>FMTMINDTA</b></a></td>
|
|
<td valign="top">Format minimized data</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RCVJRNE.NULLINDLEN"><b>NULLINDLEN</b></a></td>
|
|
<td valign="top">Null value indicators length</td>
|
|
<td valign="top">Single values: <b><u>*ENTFMT</u></b><br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Field data format</td>
|
|
<td valign="top">
|
|
1-8000, <b><u>*VARLEN</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Variable length field length</td>
|
|
<td valign="top">
|
|
1-8000</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RCVJRNE.DELAY"><b>DELAY</b></a></td>
|
|
<td valign="top">Delay time</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Delay time value</td>
|
|
<td valign="top">
|
|
1-99999, <b><u>30</u></b>, *NEXTENT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Maximum delay time value</td>
|
|
<td valign="top">
|
|
1-99999, *CLS</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.BLKLEN"><b>BLKLEN</b></a></td>
|
|
<td valign="top">Block length</td>
|
|
<td valign="top">32-4000, <b><u>*NONE</u></b>, *CALC</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.JRNENTFMT"><b>JRNENTFMT</b></a></td>
|
|
<td valign="top">Journal entry format</td>
|
|
<td valign="top"><b><u>RJNE0100</u></b>, RJNE0200</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.RTNPTR"><b>RTNPTR</b></a></td>
|
|
<td valign="top">Return pointers</td>
|
|
<td valign="top"><b><u>*NONE</u></b>, *SYSMNG, *USRMNG</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.INCENT"><b>INCENT</b></a></td>
|
|
<td valign="top">Include entries</td>
|
|
<td valign="top"><b><u>*CONFIRMED</u></b>, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.FROMENT"><b>FROMENT</b></a></td>
|
|
<td valign="top">Starting sequence number</td>
|
|
<td valign="top">1-9999999999, <b><u>*FIRST</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.TOENT"><b>TOENT</b></a></td>
|
|
<td valign="top">Ending sequence number</td>
|
|
<td valign="top">1-9999999999, *LAST, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCVJRNE.CMTCYCID"><b>CMTCYCID</b></a></td>
|
|
<td valign="top">Commit cycle identifier</td>
|
|
<td valign="top">1-9999999999, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RCVJRNE.JRN"></a>
|
|
<h3>Journal (JRN)</h3>
|
|
<p>Specifies the journal from which the journal entries are received.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Journal</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>journal-name</i></b></dt>
|
|
<dd>Specify the name of the journal.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.EXITPGM"></a>
|
|
<h3>Program to receive entries (EXITPGM)</h3>
|
|
<p>Specifies a user-written exit program that controls the receiving of each journal entry passed from the command. Additional information on the interface between this command and the exit program is supplied after the listing of possible values for this parameter, and is described in more detail in the Journal Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Program to receive entries</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>program-name</i></b></dt>
|
|
<dd>Specify the name of the exit program that controls the reception of each journal entry passed from the command.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the program. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library where the program is located.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Additional Information on the Exit Program Interface</b>
|
|
</p>
|
|
<p>When the program is called, two parameters are passed to it at a time. A single journal entry or a block of journal entries is passed in the first parameter.
|
|
</p>
|
|
<ul>
|
|
<li>If a single journal entry is passed, and if the length of the parameter defined by the program is smaller than the length of the journal entry, the journal entry passed to the program is truncated. If the length of the parameter defined by the program is greater than the length of the journal entry, the parameter positions beyond the length of the journal entry contain nonessential information. The user's program should not specifically refer to data in the positions beyond the length of the journal entry.
|
|
</li>
|
|
<li>If BLKLEN(*NONE) was specified, then the exit program may indicate to the system that multiple entries should be returned in subsequent calls to the exit program by specifying 8 in the first byte of the second parameter. This is called "Block Mode" and the exit program must specify the size of the block in bytes as a zoned value in the first 5 bytes of the first parameter. If an error is made in this specification, only one journal entry is passed in the block. If BLKLEN(*NONE) was not specified, then specifying 8 in the first byte of the second parameter will have no effect and the first 5 bytes of the first parameter will be ignored.
|
|
</li>
|
|
<li>If pointers are being returned, this first parameter must be aligned on a 16-byte boundary since journal entry specific data could include actual pointers.
|
|
</li>
|
|
</ul>
|
|
<p>For *TYPE1, *TYPE2, *TYPE3 and *TYPE4 formats there is a zoned journal entry length field that is filled with zeros at the end of the single journal entry or block of journal entries passed. This field indicates that the last journal entry has been passed. The format of the information in each journal entry is shown in the ENTFMT parameter description. The format of the first parameter is detailed in the Journal Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The maximum length of the parameter specification in the exit program is language dependent (for example, for CL, the maximum length is 9999). For more information about limitations refer to the corresponding programming language book.
|
|
</p>
|
|
<p>A character variable of LEN(3) is passed in the second exit program parameter. This parameter will be passed from the system to the exit program and can be passed from the exit program to the system. Its values are presented in the following lists:
|
|
</p>
|
|
<ul>
|
|
<li>Information in the first byte of the second parameter:
|
|
<dl>
|
|
<dt><b>Char(1)</b></dt>
|
|
<dd><b> Passed to the Exit Program
|
|
</b></dd>
|
|
<dt><b>0</b></dt>
|
|
<dd>No journal entry is passed on this call of the exit program.
|
|
</dd>
|
|
<dt><b>1</b></dt>
|
|
<dd>A single journal entry is passed to the exit program.
|
|
</dd>
|
|
<dt><b>2</b></dt>
|
|
<dd>A block of one or more journal entries is passed to the exit program.
|
|
</dd>
|
|
<dt><b>3</b></dt>
|
|
<dd>No journal entry is passed on this call to the exit program, and no more entries can be passed, because the journal receiver that was attached when the receive journal entry operation started is no longer attached.
|
|
<p>
|
|
<b>Note: </b>The system ends the RCVJRNE command after calling the exit program once with a reason code of 3.
|
|
</p>
|
|
</dd>
|
|
<dt><b>4</b></dt>
|
|
<dd>No journal entry is passed on this call to the exit program, and no more entries can be passed unless the remote journal is activated.
|
|
<p>
|
|
<b>Note: </b>This value can only be passed to the exit program when receiving journal entries from the attached receiver of a remote journal and the journal state for the journal is currently *INACTIVE.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>Char(1)</b></dt>
|
|
<dd><b> Passed to the System from the Exit Program
|
|
</b></dd>
|
|
<dt><b>8</b></dt>
|
|
<dd>Requests the command processing program to start passing one or more journal entries in a block. If BLKLEN(*NONE) was not specified, then specifying 8 in the first byte of the second parameter will have no effect and the first 5 bytes of the first parameter will be ignored.
|
|
</dd>
|
|
<dt><b>9</b></dt>
|
|
<dd>Requests the RCVJRNE command to end. The exit program returns control to the system.
|
|
</dd>
|
|
</dl>
|
|
</li>
|
|
<li>Information in the second byte of the second parameter:
|
|
<dl>
|
|
<dt><b>Char(1)</b></dt>
|
|
<dd><b> Passed to the Exit Program
|
|
</b></dd>
|
|
<dt><b>N</b></dt>
|
|
<dd>Additional journal entries are not currently available to be passed after this call of the exit program, or the RCVJRNE command will be ending after this call of the exit program.
|
|
</dd>
|
|
<dt><b>Y</b></dt>
|
|
<dd>Additional journal entries are currently available to be passed after this call of the exit program.
|
|
</dd>
|
|
</dl>
|
|
<p>Any information passed from the exit program to the system in this second character will be ignored.
|
|
</p>
|
|
<p>This second byte of the second exit program parameter is provided whether journal entries are being passed as a single journal entry per call of the exit program, or as a block of journal entries per call.
|
|
</p>
|
|
</li>
|
|
<li>Information in the third byte of the second parameter:
|
|
<dl>
|
|
<dt><b>Char(1)</b></dt>
|
|
<dd><b> Passed to the Exit Program
|
|
</b></dd>
|
|
<dt><b>'00'x</b></dt>
|
|
<dd>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>
|
|
<b>Note: </b>This value is returned only when receiving journal entries from a journal receiver that was attached to a journal prior to V4R2M0.
|
|
</p>
|
|
</dd>
|
|
<dt><b>0</b></dt>
|
|
<dd>No journal entries are currently being passed, so the information normally returned in this byte is not applicable.
|
|
</dd>
|
|
<dt><b>1</b></dt>
|
|
<dd>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 reflect the name of the object at the time the journal entry was deposited into the journal.
|
|
</dd>
|
|
<dt><b>2</b></dt>
|
|
<dd>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. The object name in the fixed length portion of the journal entry may be returned as a previously known name for the object prior to the journal entry being deposited into the journal or be returned as *UNKNOWN.
|
|
<p>
|
|
<b>Note: </b>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 Remote Journal (CHGRMTJRN) command or Change Journal State (QjoChangeJournalState) API is invoked and is currently replicating journal entries to the remote journal. After the call to the CHGRMTJRN command or QjoChangeJournalState API returns, the remote journal is maintained with a synchronous or asynchronous delivery mode, and the remote journal is no longer being caught up.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p>Any information passed from the exit program to the system in the third byte will be ignored. The second byte of the second exit program parameter is provided whether journal entries are being passed as a single journal entry per call of the exit program, or as a block of journal entries per call.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>When an <b>N</b> is passed to the exit program in the second byte of the second parameter indicating 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>
|
|
<p>The third 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. When returned for a block of journal entries, the attribute applies to the object names for all of the journal entries being returned in the block.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<p>For more information on the exit program and these two parameters used to receive the journal entries, see the Journal Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.FILE"></a>
|
|
<h3>Journaled physical file (FILE)</h3>
|
|
<p>Specifies a maximum of 300 qualified file names whose journal entries are received. This parameter also specifies the name of the file member whose journal entries are to be received.
|
|
</p>
|
|
<p>Either the FILE parameter may be specified, or one or more of the object parameters (OBJ, OBJPATH, or OBJFID) may be specified, but not both.
|
|
</p>
|
|
<p>To determine which journal entries are to be received, based on the specified file member name, the following is done:
|
|
</p>
|
|
<ul>
|
|
<li>If the journal is a local journal, and if the specified file member currently exists on the system, the journal identifier is determined from the specified file member. All journal entries in the specified receiver range for that journal identifier are received.
|
|
</li>
|
|
<li>If the journal is a remote journal, or if the specified file member does not currently exist on the system, the specified receiver range is searched to determine all possible journal identifiers that are associated with the specified file member. All journal entries in the specified receiver range for those journal identifiers are received. Specify the library name or *CURLIB to have entries returned for the file.
|
|
<p>There may be more than one journal identifier associated with a specified object within the specified receiver range. This can happen when a journaled object is deleted, and then a new object is created with the same name and journaled to the same journal.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>The journal identifier is the unique identifier associated with the object when journaling is started for that object. The journal identifier stays constant, even if the object is renamed, moved, or restored. See the Journal Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for more information.
|
|
</li>
|
|
<li>When specifying a database file on this parameter, journal entries with the following journal code values are received only if they satisfy the values specified on the other parameters:
|
|
<ul>
|
|
<li>Journal code D (database file-level information entries).
|
|
</li>
|
|
<li>Journal code F (file member-level information entries).
|
|
</li>
|
|
<li>Journal code R (record-level information entries).
|
|
</li>
|
|
<li>Journal code U (user-generated entries).
|
|
</li>
|
|
<li>Other journal codes, if *IGNFILSLT is specified on that journal code. If *ALLSLT is specified on that journal code, no journal entries with that code are received.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALLFILE</b></dt>
|
|
<dd>The search for the journal entries received is not limited to a specified file name. All journal entries are received, regardless of which objects, if any, the entries are associated with.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Journaled physical file</b>
|
|
</p>
|
|
<p><b>Qualifier 1: Journaled physical file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>Journal entries for all physical files in the specified library (the library name must be specified) whose journaled changes are currently in the journal receiver are received. If *ALL is specified and the user does not have the required authority to all of the files, an error occurs, and the command ends.
|
|
</dd>
|
|
<dt><b><i>physical-file-name</i></b></dt>
|
|
<dd>Specify the name of the database physical file for which a journal entry is received.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Member</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>Entries for the database file and the first member in the file are received.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>Entries for the database file and all the currently existing members of the file are received.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Only entries for the database file are received. Entries for members of the file are not received.
|
|
</dd>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Specify the name of the member for which journal entries are received.
|
|
</dd>
|
|
</dl>
|
|
<p>If *ALL is specified for the file-name element, this member name is used for all applicable files in the library. For example, if library-name/*ALL *FIRST is specified on the FILE parameter, the journal entries of the first members of all applicable files in the specified library are received.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.OBJ"></a>
|
|
<h3>Objects (OBJ)</h3>
|
|
<p>Specifies a maximum of 300 qualified object names whose journal entries are to be received. The possible object types are *FILE, *DTAARA, and *DTAQ. If *FILE is specified, this parameter also specifies the name of the file member whose journal entries are to be received.
|
|
</p>
|
|
<p>Either the FILE parameter may be specified, or one or more of the object parameters (OBJ, OBJPATH, or OBJFID) may be specified, but not both.
|
|
</p>
|
|
<p>To determine which journal entries are to be received, based on the specified object name, the following is done:
|
|
</p>
|
|
<ul>
|
|
<li>If the journal is a local journal, and if the specified object currently exists on the system, the journal identifier is determined from the specified object. All journal entries in the specified receiver range for that journal identifier are received.
|
|
</li>
|
|
<li>If the journal is a remote journal, or if the specified object does not currently exist on the system, the specified receiver range is searched to determine all possible journal identifiers that are associated with the specified object. All journal entries in the specified receiver range for those journal identifiers are received. Specify the library name or *CURLIB to have entries returned for an object.
|
|
<p>There may be more than one journal identifier associated with a specified object within the specified receiver range. This can happen when a journaled object is deleted, and then a new object is created with the same name and journaled to the same journal.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>The journal identifier is the unique identifier associated with the object when journaling is started for that object. The journal identifier stays constant, even if the object is renamed, moved or restored. See the Journal Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for more information.
|
|
</li>
|
|
<li>When specifying an object on this parameter, journal entries with the following journal code values are received only if they satisfy the values specified on the other parameters in addition to the object name specification:
|
|
<ul>
|
|
<li>Journal code D (database file-level information entries).
|
|
</li>
|
|
<li>Journal code E (data area information entries).
|
|
</li>
|
|
<li>Journal code F (file member-level information entries).
|
|
</li>
|
|
<li>Journal code Q (data queue information entries).
|
|
</li>
|
|
<li>Journal code R (record-level information entries).
|
|
</li>
|
|
<li>Journal code U (user-generated entries).
|
|
</li>
|
|
<li>Other journal codes, if *IGNOBJSLT is the second element of the journal code. If *ALLSLT is the second element of the journal code, no journal entries with that code are received.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
<p><b>Element 1: Object</b>
|
|
</p>
|
|
<p><b>Qualifier 1: Object</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>Journal entries for all objects of the specified object type in the specified library (the library name must be specified) whose journaled changes are currently in the journal receiver are received. The library name must be specified. If *ALL is specified and the user does not have the required authority for all objects in the library, a message is sent and the command ends.
|
|
</dd>
|
|
<dt><b><i>object-name</i></b></dt>
|
|
<dd>Specify the name of the object whose journaled changes are to be received.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Object type</b>
|
|
</p>
|
|
<p>Specify the object type of the object whose journaled changes are to be received.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*FILE</b></dt>
|
|
<dd>Entries for database files and database file members are received.
|
|
</dd>
|
|
<dt><b>*DTAARA</b></dt>
|
|
<dd>Entries for data areas are received.
|
|
</dd>
|
|
<dt><b>*DTAQ</b></dt>
|
|
<dd>Entries for data queues are received.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Member, if data base file</b>
|
|
</p>
|
|
<p>Specify the name of the member in the file whose journal entries are to be received. If *ALL is specified for the first part of this parameter, the value specified for the member name is used for all applicable files in the library. For example, if *FIRST is specified, the journal entries of the first member of all applicable files in the specified library are received
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If the specified object type is not *FILE, the member name element value is ignored.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>Entries for the database file and the first member in the file are received.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>Entries for the database file and all the currently existing members of the file are received.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Only entries for the database file are received. Entries for members of the file are not received.
|
|
</dd>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Specify the name of the member for which journal entries are received.
|
|
</dd>
|
|
</dl>
|
|
<p>If *ALL is specified for the object-name element, this member name is used for all applicable files in the library. For example, if library-name/*ALL *FILE *FIRST is specified on the OBJ parameter, the journal entries of the first members of all applicable files in the specified library are received.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.OBJPATH"></a>
|
|
<h3>Objects (OBJPATH)</h3>
|
|
<p>Specifies a maximum of 300 objects whose journal entries are to be received. Only objects whose path name identifies an object of type *STMF, *DIR or *SYMLNK that are in the "root" ('/'), QOpenSys, and user-defined file systems are supported. All other objects are ignored.
|
|
</p>
|
|
<p>This parameter is not valid for remote journals.
|
|
</p>
|
|
<p>Either the FILE parameter may be specified, or one or more of the object parameters (OBJ, OBJPATH, or OBJFID) may be specified, but not both.
|
|
</p>
|
|
<p>Only objects that are currently linked with the specified path name and have a journal identifier associated with them are used in journal entry selection. If the specified object does exist, the journal identifier associated with that link is used for journal entry selection. If a specified object does not exist or does not have a journal identifier associated with it, that link is not used in selecting journal entries and no error is sent.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>The journal identifier is the unique identifier associated with the object when journaling is started for that object. The journal identifier stays constant, even if the object is renamed, moved or restored. See the Journal Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for more information.
|
|
</li>
|
|
<li>When specifying an object on this parameter, journal entries with the following journal code values are received only if they satisfy the values specified on the other parameters in addition to the object name specification:
|
|
<ul>
|
|
<li>Journal code B (integrated file system information entries).
|
|
</li>
|
|
<li>Journal code U (user-generated entries).
|
|
</li>
|
|
<li>Other journal codes, if *IGNOBJSLT is the second element of the journal code. If *ALLSLT is the second element of the journal code, no journal entries with that code are received.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
<p><b>Element 1: Name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>path-name</i></b></dt>
|
|
<dd>Entries for objects identified by the path name are received.
|
|
<p>A pattern can be specified in the last part of the path name. An asterisk (*) matches any number of characters and a question mark (?) matches a single character. If the path name is qualified or contains a pattern, it must be enclosed in apostrophes. Symbolic links within the path name will not be followed. If the path name begins with the tilde character, then the path is assumed to be relative to the appropriate home directory.
|
|
</p>
|
|
<p>Additional information about path name patterns is in the Integrated file system information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Include or omit</b>
|
|
</p>
|
|
<p>The second element specifies whether names that match the path name should be included or omitted from the operation. Note that in determining whether a name matches a pattern, relative name patterns are always treated as relative to the current working directory.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The SUBTREE parameter specifies whether the subtrees are included or omitted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*INCLUDE</u></b></dt>
|
|
<dd>The objects that match the object name pattern are to be included in determining what journal entries are received unless overridden by an *OMIT specification.
|
|
</dd>
|
|
<dt><b>*OMIT</b></dt>
|
|
<dd>The objects that match the object name pattern are not to be included in determining what journal entries are received. This overrides an *INCLUDE specification and is intended to be used to omit a subset of a previously selected pattern.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.OBJFID"></a>
|
|
<h3>File identifier (OBJFID)</h3>
|
|
<p>Specifies a maximum of 300 file identifiers (FID) whose journal entries are to be received. FIDs are a unique identifier associated with integrated file system related objects. This field is input in hexadecimal format. Only objects whose FID identifies an object of type *STMF, *DIR or *SYMLNK that are in the "root" ('/'), QOpenSys, and user-defined file systems are supported. All other objects are ignored.
|
|
</p>
|
|
<p>Either the FILE parameter may be specified, or one or more of the object parameters (OBJ, OBJPATH, or OBJFID) may be specified, but not both.
|
|
</p>
|
|
<p>To determine which journal entries are to be received, based on the specified file identifier, the following is done:
|
|
</p>
|
|
<ul>
|
|
<li>If the journal is a local journal, and if the specified object currently exists on the system, the journal identifier is determined from the specified object. All journal entries in the specified receiver range for that journal identifier are received.
|
|
</li>
|
|
<li>If the journal is a remote journal, or if the specified object does not currently exist on the system, the specified receiver range is searched to determine all possible journal identifiers that are associated with the specified object. All journal entries in the specified receiver range for those journal identifiers are received.
|
|
</li>
|
|
</ul>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>The journal identifier is the unique identifier associated with the object when journaling is started for that object. The journal identifier stays constant, even if the object is renamed, moved or restored. See the Journal Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for more information.
|
|
</li>
|
|
<li>When specifying an object on this parameter, journal entries with the following journal code values are received only if they satisfy the values specified on the other parameters in addition to the object name specification:
|
|
<ul>
|
|
<li>Journal code B (integrated file system information entries).
|
|
</li>
|
|
<li>Journal code U (user-generated entries).
|
|
</li>
|
|
<li>Other journal codes, if *IGNOBJSLT is the second element of the journal code. If *ALLSLT is the second element of the journal code, no journal entries with that code are received.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
<dl>
|
|
<dt><b><i>file-identifier</i></b></dt>
|
|
<dd>Entries for objects identified with the FID are received.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.SUBTREE"></a>
|
|
<h3>Directory subtree (SUBTREE)</h3>
|
|
<p>Specifies whether the directory subtrees are included in determining the objects for which journal entries are to be received.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is only valid if one or more path names were specified on the OBJPATH parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>Only the objects that match the selection criteria are processed. The objects within selected directories are not implicitly processed.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All objects that meet the selection criteria are processed in addition to the entire subtree of each directory that matches the selection criteria. The subtree includes all sub-directories and the objects within those sub-directories.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.PATTERN"></a>
|
|
<h3>Name pattern (PATTERN)</h3>
|
|
<p>Specifies a maximum of 20 patterns to be used to include or omit objects for which journal entries are to be received.
|
|
</p>
|
|
<p>Only the last part of the path name will be considered for the name pattern match. Path name delimiters are not allowed in the name pattern. An asterisk (*) matches any number of characters and a question mark (?) matches a single character. If the path name is qualified or contains a pattern, it must be enclosed in apostrophes.
|
|
</p>
|
|
<p>If the Name Pattern parameter is not specified the default will be to match all patterns.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is only valid if one or more path names were specified on the OBJPATH parameter.
|
|
</p>
|
|
<p><b>Element 1: Pattern</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>'*'</u></b></dt>
|
|
<dd>All objects that match the input OBJPATH parameter are to be included.
|
|
</dd>
|
|
<dt><b><i>name-pattern</i></b></dt>
|
|
<dd>Specify the pattern to be used to include or omit objects for which journal entries are received. Only the last part of the path name will be considered for the name pattern match. Path name delimiters are not allowed in the name pattern.
|
|
</dd>
|
|
</dl>
|
|
<p>If the Name Pattern parameter is not specified the default will be to match all patterns.
|
|
</p>
|
|
<p>Additional information about path name patterns is in the Integrated file system information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p><b>Element 2: Include or omit</b>
|
|
</p>
|
|
<p>The second element specifies whether names that match the pattern should be included or omitted from the operation. Note that in determining whether a name matches a pattern, relative name patterns are always treated as relative to the current working directory.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The SUBTREE parameter specifies whether directory subtrees are included or omitted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*INCLUDE</u></b></dt>
|
|
<dd>The objects that match the object name pattern are included in the operation, unless overridden by an *OMIT specification.
|
|
</dd>
|
|
<dt><b>*OMIT</b></dt>
|
|
<dd>The objects that match the object name pattern are not to be included in the operation. This overrides an *INCLUDE specification and is intended to be used to omit a subset of a previously selected pattern.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.RCVRNG"></a>
|
|
<h3>Range of journal receivers (RCVRNG)</h3>
|
|
<p>Specifies the starting (first) and ending (last) journal receivers used in the search for the journal entries that are received. The system starts the search with the starting journal receiver (as specified by the first value) and proceeds through the receiver chain until the ending journal receiver (as specified by the last value) is processed.
|
|
</p>
|
|
<p>If a problem is found in the receiver chain (such as damaged or not-found receivers) before the search operation begins, the system tries to use the second of the dual receivers. If these receivers also are damaged or not found, the operation ends.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>The journal receiver that is currently attached when starting to receive journal entries is used.
|
|
</dd>
|
|
<dt><b>*CURCHAIN</b></dt>
|
|
<dd>The journal receiver chain that includes the journal receiver that is currently attached when starting to receive journal entries is used. This receiver chain does not cross a break in the chain. If there is a break in the chain, the receiver range is from the most recent break in the chain through the receiver that is attached when starting to receive journal entries.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Starting journal receiver</b>
|
|
</p>
|
|
<p><b>Qualifier 1: Starting journal receiver</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>starting-journal-receiver-name</i></b></dt>
|
|
<dd>Specify the name of the first journal receiver containing journal entries that are to be received.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the journal receiver. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library where the journal receiver is located.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Ending journal receiver</b>
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>The journal receiver that is currently attached when starting to receive journal entries is used.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Starting journal receiver</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>ending-journal-receiver-name</i></b></dt>
|
|
<dd>Specify the name of the last journal receiver containing journal entries that can be received. If the end of the receiver chain is reached before a receiver with this name is found, an error message is sent and no journal entries are received.
|
|
<p>
|
|
<b>Note: </b>The maximum number of receivers in the range is 1024. If more receivers than this maximum are specified, an exception is signaled, and no journal entries are received.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the journal receiver. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library where the journal receiver is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.FROMENTLRG"></a>
|
|
<h3>Starting large sequence number (FROMENTLRG)</h3>
|
|
<p>Specifies the first journal entry considered for reception.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>You can specify a value for either the <b>Starting sequence number (FROMENT)</b> parameter or the <b>Starting large sequence number (FROMENTLRG)</b> parameter, but not for both.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first journal entry in the specified journal receiver range is the first entry considered for reception.
|
|
</dd>
|
|
<dt><b><i>starting-sequence-number</i></b></dt>
|
|
<dd>Specify the sequence number of the first journal entry considered for reception. The possible range is 1 to 18,446,744,073,709,551,600.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.FROMTIME"></a>
|
|
<h3>Starting date and time (FROMTIME)</h3>
|
|
<p>Specifies the date and time of the first journal entry considered for reception. The starting date and time of the first journal entry created either at or after the specified starting date and time is the starting point for reception of the journal entries.
|
|
</p>
|
|
<p><b>Element 1: Starting date</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>starting-date</i></b></dt>
|
|
<dd>Specify a starting date.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Starting time</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>starting-time</i></b></dt>
|
|
<dd>Specify a starting time. The time can be specified in 24-hour format with or without a time separator:
|
|
<ul>
|
|
<li>With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
|
|
</li>
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where <b>hh</b> = hours, <b>mm</b> = minutes, and <b>ss</b> = seconds.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.TOENTLRG"></a>
|
|
<h3>Ending large sequence number (TOENTLRG)</h3>
|
|
<p>Specifies the last journal entry considered for reception.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>You can specify a value for either the <b>Ending sequence number (TOENT)</b> parameter or the <b>Ending large sequence number (TOENTLRG)</b> parameter, but not for both.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No journal entry is specified. Journal entries are passed to the exit program until the command is canceled (by a cancel request or a cancel job command) or until an end reason code (9) is set by the exit program. If there are no more entries to pass, the RCVJRNE command waits the number of seconds indicated on the DELAY parameter before trying to find more entries to pass.
|
|
<p>
|
|
<b>Note: </b>TOENTLRG(*NONE) is valid only if the RCVRNG parameter specifies a receiver that is currently attached when starting to receive journal entries.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The last journal entry in the journal receiver range specified is the last entry considered for reception.
|
|
</dd>
|
|
<dt><b><i>ending-sequence-number</i></b></dt>
|
|
<dd>Specify the sequence number of the final journal entry considered for reception. The possible range is 1 to 18,446,744,073,709,551,600.
|
|
<p>
|
|
<b>Note: </b>The values specified for the from and to prompts can be the same. For example, FROMENTLRG(234) and TOENTLRG(234) can be specified.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.TOTIME"></a>
|
|
<h3>Ending date and time (TOTIME)</h3>
|
|
<p>Specifies the date and time of the last journal entry considered for reception. The ending date and time of the journal entry created at or before the specified ending date and time is the ending point for reception of the journal entries.
|
|
</p>
|
|
<p><b>Element 1: Ending date</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>ending-date</i></b></dt>
|
|
<dd>Specify the date of the last entry received.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Ending time</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>ending-time</i></b></dt>
|
|
<dd>Specify the creation time of the last entry received. The time can be specified in 24-hour format with or without a time separator:
|
|
<ul>
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
|
|
</li>
|
|
<li>With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.NBRENT"></a>
|
|
<h3>Number of journal entries (NBRENT)</h3>
|
|
<p>Specifies the total number of journal entries that are received.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All journal entries included in the specified journal receiver range that satisfy the selection values are received.
|
|
</dd>
|
|
<dt><b><i>value</i></b></dt>
|
|
<dd>Specify the maximum number of journal entries be received. If the specified journal entry identified by the TOENTLRG, TOENT, or TOTIME parameter is reached before the value specified for NBRENT is met, the command ends normally.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.JRNCDE"></a>
|
|
<h3>Journal codes (JRNCDE)</h3>
|
|
<p>Specifies the journal code that is used to limit the entries being considered for reception.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The journal entries received are not limited to those containing a specified code.
|
|
</dd>
|
|
<dt><b>*CTL</b></dt>
|
|
<dd>The journal entries received are those written to control the journal functions. These journal entries have codes J or F.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Journal code value</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>journal-code</i></b></dt>
|
|
<dd>Specify the journal code to which journal entries are limited. Only journal entries with the specified journal code are received.
|
|
<p>An explanation of the journal codes that can be specified is in the Journal Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Journal code selection</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALLSLT</u></b></dt>
|
|
<dd>The journal entries with the specified journal code are received only if all other selection parameters are satisfied.
|
|
</dd>
|
|
<dt><b>*IGNFILSLT</b></dt>
|
|
<dd>Journal entries having the specified journal code are received only if all selection parameters, except the FILE parameter, are satisfied.
|
|
<p>
|
|
<b>Note: </b>This value is not valid for journal codes D, F, and R. This value is not valid if the OBJ, OBJPATH, or OBJFID parameters are specified.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*IGNOBJSLT</b></dt>
|
|
<dd>Journal entries having the specified journal code are received only if all selection parameters are satisfied except OBJ, OBJPATH, OBJFID, SUBTREE, and PATTERN.
|
|
<p>
|
|
<b>Note: </b>This value is not valid for journal codes B, D, E, F, Q, and R. This value is not valid if the FILE parameter is specified.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.ENTTYP"></a>
|
|
<h3>Journal entry types (ENTTYP)</h3>
|
|
<p>Specifies whether to limit the journal entries received to those of a specified journal entry type.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The journal entries that can be received are not limited to those of a specified journal entry type.
|
|
</dd>
|
|
<dt><b>*RCD</b></dt>
|
|
<dd>Only entries that have an entry type for record level operations are received. The following entry types are valid: BR, DL, DR, IL, PT, PX, UB, UP, and UR.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>entry-type</i></b></dt>
|
|
<dd>Specify the entry type that limits the journal entries received. Only journal entries that contain the specified entry type are received. Up to 300 valid entry types can be specified. More information on entry types is in the Journal Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the journal entries considered for reception based on their associated jobs.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The journal entries received are not limited to those for a specified job.
|
|
</dd>
|
|
<dt><b>*</b></dt>
|
|
<dd>The journal entries received are limited to those for the current job.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>job-identifier</i></b></dt>
|
|
<dd>Specify the job name, the user name, and the job number of the job to use. You can also specify that the job name only, or that the job name and the user name be used.
|
|
<dl>
|
|
<dt><b><i>job-name</i></b></dt>
|
|
<dd>Specify the job name of the job.
|
|
</dd>
|
|
<dt><b><i>user-name</i></b></dt>
|
|
<dd>Specify the user name of the job.
|
|
</dd>
|
|
<dt><b><i>job-number</i></b></dt>
|
|
<dd>Specify the system-assigned job number.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.PGM"></a>
|
|
<h3>Program (PGM)</h3>
|
|
<p>Specifies the journal entries considered for reception based on their associated programs.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The journal entries received are not limited to those created by a specified program.
|
|
</dd>
|
|
<dt><b><i>program-name</i></b></dt>
|
|
<dd>Specify the name of the program whose journal entries are considered for reception.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.USRPRF"></a>
|
|
<h3>User profile (USRPRF)</h3>
|
|
<p>Specifies that the journal entries considered for reception are limited to the journal entries created for the specified user profile.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The journal entries received are not limited to those for a specified user profile.
|
|
</dd>
|
|
<dt><b><i>user-profile-name</i></b></dt>
|
|
<dd>Specify the name of the user profile whose journal entries are considered for reception.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.CCIDLRG"></a>
|
|
<h3>Commit cycle large identifier (CCIDLRG)</h3>
|
|
<p>Specifies the journal entries considered for reception based on their associated commit cycle identifier. A commit cycle consists of all journal entries sharing the same commit cycle identifier. A journal entry's commit cycle identifier can be displayed by using the Display Journal (DSPJRN) command and entering option five.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>You can input a value for either the <b>Commit cycle identifier</b> field (CMTCYCID) or the <b>Commit cycle large identifier</b> field (CCIDLRG) but not for both.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The journal entries received are not limited to a specified commit cycle identifier.
|
|
</dd>
|
|
<dt><b><i>commit-cycle-identifier</i></b></dt>
|
|
<dd>Specify the commit cycle identifier of the journal entries to be considered for reception. The possible range is 1 to 18,446,744,073,709,551,600.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.DEPENT"></a>
|
|
<h3>Dependent entries (DEPENT)</h3>
|
|
<p>Specifies whether to receive the journal entries recording actions
|
|
</p>
|
|
<ul>
|
|
<li>that occur as a result of a trigger program
|
|
</li>
|
|
<li>on records that are part of a referential constraint
|
|
</li>
|
|
<li>that will be ignored during an Apply Journaled Changes (APYJRNCHG) or Remove Journaled Changes (RMVJRNCHG) operation.
|
|
</li>
|
|
</ul>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The journal entries relating to trigger programs, referential constraints and the entries which will be ignored by an Apply or Remove Journaled Changes operations are received.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>The journal entries relating to trigger programs, referential constraints and the entries which will be ignored by an Apply or Remove Journaled Changes operations are not received.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.ENTFMT"></a>
|
|
<h3>Entry format (ENTFMT)</h3>
|
|
<p>Specifies the format of the journal entries being received. For a description of what is represented by each of the fields in the journal entry, see the Journal Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If ENTFMT(*TYPE1) or ENTFMT(*TYPE2) is not specified, the NULLINDLEN parameter must be specified.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If the <b>Receiver size options</b> field (RCVSIZOPT) for the journal was specified as *MAXOPT3, the sequence number, commit cycle identifier, the count of entries applied or removed or relative record number fields can reach a maximum value of 18,446,744,073,709,551,600. The length of these fields in the ENTFMT(*TYPE1), ENTFMT(*TYPE2), ENTFMT(*TYPE3), and ENTFMT(*TYPE4) formats is defined to hold a 10 digit number. If a sequence number, commit cycle identifier, or count of entries applied or removed or relative record number larger than 10 digits is found and one of these ENTFMT options is specified, the field is set to -1 for that entry.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*TYPE1</u></b></dt>
|
|
<dd>The journal entries received are formatted to include the minimum information that can be specified. The information fields and the format of the information in each journal entry is shown below:
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Table 1 - *TYPE1 Journal Entry Format</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
Field Name : Length : From : To
|
|
=======================+==========+==========+==========
|
|
Entry Length : 5 : 1 : 5
|
|
-----------------------+----------+----------+----------
|
|
Sequence Number (2) : 10 : 6 : 15
|
|
-----------------------+----------+----------+----------
|
|
Journal Code : 1 : 16 : 16
|
|
-----------------------+----------+----------+----------
|
|
Journal Entry Type : 2 : 17 : 18
|
|
-----------------------+----------+----------+----------
|
|
Date : 6 : 19 : 24
|
|
-----------------------+----------+----------+----------
|
|
Time : 6 : 25 : 30
|
|
-----------------------+----------+----------+----------
|
|
Job Name : 10 : 31 : 40
|
|
-----------------------+----------+----------+----------
|
|
User Name : 10 : 41 : 50
|
|
-----------------------+----------+----------+----------
|
|
Job Number : 6 : 51 : 56
|
|
-----------------------+----------+----------+----------
|
|
Program Name : 10 : 57 : 66
|
|
-----------------------+----------+----------+----------
|
|
Object Name : 10 : 67 : 76
|
|
-----------------------+----------+----------+----------
|
|
Object Library : 10 : 77 : 86
|
|
-----------------------+----------+----------+----------
|
|
Member Name : 10 : 87 : 96
|
|
-----------------------+----------+----------+----------
|
|
Count/RRN (3) : 10 : 97 : 106
|
|
-----------------------+----------+----------+----------
|
|
Flag : 1 : 107 : 107
|
|
-----------------------+----------+----------+----------
|
|
Commit Cycle ID (4) : 10 : 108 : 117
|
|
-----------------------+----------+----------+----------
|
|
Incomplete data : 1 : 118 : 118
|
|
-----------------------+----------+----------+----------
|
|
Minimized Entry : 1 : 119 : 119
|
|
Specific Data : : :
|
|
-----------------------+----------+----------+----------
|
|
Reserved : 6 : 120 : 125
|
|
-----------------------+----------+----------+----------
|
|
Entry-Specific Data : N (1) : 126 : N+125
|
|
========================================================
|
|
Notes:
|
|
(1) The length of the entry-specific data field varies
|
|
from entry to entry. It is long enough to accommodate
|
|
all the entry-specific data in each received journal
|
|
entry.
|
|
(2) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the sequence number is larger than 10
|
|
digits.
|
|
(3) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the count of entries applied or removed
|
|
or relative record number is larger than 10 digits.
|
|
(4) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the commit cycle identifier is larger
|
|
than 10 digits.
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</dd>
|
|
<dt><b>*TYPE2</b></dt>
|
|
<dd>The journal entries received include the information returned when ENTFMT(*TYPE1) is specified, the user profile field, which gives the name of the user who caused the logging of the received journal entries, and the name of the system on which the entry was sent. The format for *TYPE2 journal entries is shown below:
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Table 2 - *TYPE2 Journal Entry Format</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
Field Name : Length : From : To
|
|
=======================+==========+==========+==========
|
|
Entry Length : 5 : 1 : 5
|
|
-----------------------+----------+----------+----------
|
|
Sequence Number (2) : 10 : 6 : 15
|
|
-----------------------+----------+----------+----------
|
|
Journal Code : 1 : 16 : 16
|
|
-----------------------+----------+----------+----------
|
|
Journal Entry Type : 2 : 17 : 18
|
|
-----------------------+----------+----------+----------
|
|
Date : 6 : 19 : 24
|
|
-----------------------+----------+----------+----------
|
|
Time : 6 : 25 : 30
|
|
-----------------------+----------+----------+----------
|
|
Job Name : 10 : 31 : 40
|
|
-----------------------+----------+----------+----------
|
|
User Name : 10 : 41 : 50
|
|
-----------------------+----------+----------+----------
|
|
Job Number : 6 : 51 : 56
|
|
-----------------------+----------+----------+----------
|
|
Program Name : 10 : 57 : 66
|
|
-----------------------+----------+----------+----------
|
|
Object Name : 10 : 67 : 76
|
|
-----------------------+----------+----------+----------
|
|
Object Library : 10 : 77 : 86
|
|
-----------------------+----------+----------+----------
|
|
Member Name : 10 : 87 : 96
|
|
-----------------------+----------+----------+----------
|
|
Count/RRN (3) : 10 : 97 : 106
|
|
-----------------------+----------+----------+----------
|
|
Flag : 1 : 107 : 107
|
|
-----------------------+----------+----------+----------
|
|
Commit Cycle ID (4) : 10 : 108 : 117
|
|
-----------------------+----------+----------+----------
|
|
User Profile : 10 : 118 : 127
|
|
-----------------------+----------+----------+----------
|
|
System Name : 8 : 128 : 135
|
|
-----------------------+----------+----------+----------
|
|
Incomplete data : 1 : 136 : 136
|
|
-----------------------+----------+----------+----------
|
|
Minimized Entry : 1 : 137 : 137
|
|
Specific Data : : :
|
|
-----------------------+----------+----------+----------
|
|
Reserved : 18 : 138 : 155
|
|
-----------------------+----------+----------+----------
|
|
Entry-Specific Data : N (1) : 156 : N + 155
|
|
========================================================
|
|
Notes:
|
|
(1) The length of the entry-specific data field varies
|
|
from entry to entry. It is long enough to accommodate
|
|
all the entry-specific data in each received journal
|
|
entry.
|
|
(2) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the sequence number is larger than 10
|
|
digits.
|
|
(3) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the count of entries applied or removed
|
|
or relative record number is larger than 10 digits.
|
|
(4) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the commit cycle identifier is larger
|
|
than 10 digits.
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</dd>
|
|
<dt><b>*TYPE3</b></dt>
|
|
<dd>The journal entries received include the information returned when ENTFMT(*TYPE2) is specified, and the null value indicators. The format of the received entries depends on the value specified on the NULLINDLEN parameter. The tables in the NULLINDLEN parameter description show the three formats for *TYPE3.
|
|
</dd>
|
|
<dt><b>*TYPE4</b></dt>
|
|
<dd>The journal entries received include the information returned when ENTFMT(*TYPE3) is specified, the journal identifier, the physical file trigger indicator, and the referential constraint indicator. The format of the received entries depends on the value specified on the NULLINDLEN parameter. The tables in the NULLINDLEN parameter description show the three formats for *TYPE4.
|
|
</dd>
|
|
<dt><b>*TYPEPTR</b></dt>
|
|
<dd>The journal entries received include the information as if ENTFMT(*JRNENTFMT) and JRNENTFMT(RJNE0100) were specified, and the entry specific data could contain pointers for specific journal entry types. The format of the received entries depends on the value specified on the NULLINDLEN parameter. The tables in the NULLINDLEN parameter description show the two formats for *TYPEPTR.
|
|
<p>
|
|
<b>Note: </b>NULLINDLEN(*VARLEN) and ENTFMT(*TYPEPTR) cannot be specified at the same time.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*JRNENTFMT</b></dt>
|
|
<dd>The format of the received journal entries is determined by the JRNENTFMT parameter. The RTNPTR parameter indicates if the received journal entries could contain pointers. The format of the received entries depends on the value specified on the NULLINDLEN parameter. The tables in the NULLINDLEN parameter description show the six formats for *JRNENTFMT.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.FMTMINDTA"></a>
|
|
<h3>Format minimized data (FMTMINDTA)</h3>
|
|
<p>Specifies whether entry specific data which has been minimized on field boundaries will be returned in a readable format.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The journal entries which have entry specific data that has been minimized on field boundaries will not be returned in a readable format. Therefore, the entry specific data may not be viewable.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The journal entries which have entry specific data that has been minimized on field boundaries will be returned in a readable format. Therefore, the entry specific data is viewable and may be used for auditing purposes. The fields that were changed are accurately reflected. The fields that were not changed and were not recorded, display default data and are indicated by a value of 'F9'X in the null value indicators field.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.NULLINDLEN"></a>
|
|
<h3>Null value indicators length (NULLINDLEN)</h3>
|
|
<p>Specifies the length, in bytes, used for the Null Value Indicators portion of the journal entry received by the user. This parameter is not valid if ENTFMT(*TYPE1) or ENTFMT(*TYPE2) is specified.
|
|
</p>
|
|
<p>Null value indicators are present in journal entries for record level operations as follows:
|
|
</p>
|
|
<ol>
|
|
<li>The corresponding physical file has null capable fields.
|
|
</li>
|
|
<li>The record image has been minimized in the entry specific data.
|
|
</li>
|
|
</ol>
|
|
<p>If the record image has not been minimized in the entry specific data, then there is one null value indicator per field in the physical file. Each indicator is one character long and can be either:
|
|
</p>
|
|
<ul>
|
|
<li>'F0'X = Corresponding field is not null.
|
|
</li>
|
|
<li>'F1'X = Corresponding field is null.
|
|
</li>
|
|
</ul>
|
|
<p>If the record image has been minimized on file field boundaries in the entry specific data and FMTMINDTA(*YES) was specified on the RCVJRNE command, then there is one null value indicator per field in the physical file. Each indicator is one character long and can be either:
|
|
</p>
|
|
<ul>
|
|
<li>'F0'X = Corresponding field is not null.
|
|
</li>
|
|
<li>'F1'X = Corresponding field is null.
|
|
</li>
|
|
<li>'F9'X = Corresponding field was not changed and the default value for the field is returned.
|
|
</li>
|
|
</ul>
|
|
<p>If the record image has been minimized on file field boundaries in the entry specific data and FMTMINDTA(*NO) was specified on the RCVJRNE command, then an internal value is returned for the null value indicator.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ENTFMT</u></b></dt>
|
|
<dd>The null value indicators field is long enough to include all of the null value indicators in the received journal entries. Since the number of null value indicators can vary from entry to entry, the length of the null value indicators field also varies with each entry.
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<p>If users select the *TYPE3 format, the following information is not available in this format:
|
|
</p>
|
|
<ol>
|
|
<li>Incomplete Data indicating if the journal entry data is incomplete due to either LOB fields or Byte Stream File write operations.
|
|
</li>
|
|
<li>Minimized Entry Specific Data indicating if the journal entry has minimized entry specific data because the journal had MINENTDTA specified for the object type of the journal entry.
|
|
</li>
|
|
</ol>
|
|
<p>See the Journal Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for more information on the incomplete data indicator, the minimized entry specific data indicator, and these journal entries.
|
|
</p>
|
|
<p>The format for *TYPE3 journal entries when NULLINDLEN(*ENTFMT) is specified is shown below:
|
|
</p>
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Table 3 - NULLINDLEN(*ENTFMT) Journal Entry Format for ENTFMT(*TYPE3)</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
Field Name : Length : From : To
|
|
=======================+==========+==========+==========
|
|
Entry Length : 5 : 1 : 5
|
|
-----------------------+----------+----------+----------
|
|
Sequence Number (5) : 10 : 6 : 15
|
|
-----------------------+----------+----------+----------
|
|
Journal Code : 1 : 16 : 16
|
|
-----------------------+----------+----------+----------
|
|
Journal Entry Type : 2 : 17 : 18
|
|
-----------------------+----------+----------+----------
|
|
Timestamp : 26 : 19 : 44
|
|
-----------------------+----------+----------+----------
|
|
Job Name : 10 : 45 : 54
|
|
-----------------------+----------+----------+----------
|
|
User Name : 10 : 55 : 64
|
|
-----------------------+----------+----------+----------
|
|
Job Number : 6 : 65 : 70
|
|
-----------------------+----------+----------+----------
|
|
Program Name : 10 : 71 : 80
|
|
-----------------------+----------+----------+----------
|
|
Object Name : 10 : 81 : 90
|
|
-----------------------+----------+----------+----------
|
|
Object Library : 10 : 91 : 100
|
|
-----------------------+----------+----------+----------
|
|
Member Name : 10 : 101 : 110
|
|
-----------------------+----------+----------+----------
|
|
Count/RRN (6) : 10 : 111 : 120
|
|
-----------------------+----------+----------+----------
|
|
Flag : 1 : 121 : 121
|
|
-----------------------+----------+----------+----------
|
|
Commit Cycle ID (7) : 10 : 122 : 131
|
|
-----------------------+----------+----------+----------
|
|
User Profile : 10 : 132 : 141
|
|
-----------------------+----------+----------+----------
|
|
System Name : 8 : 142 : 149
|
|
-----------------------+----------+----------+----------
|
|
Number of Null Value : 5 : 150 : 154
|
|
Indicators (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Null Value Indicators : M (2) : 155 : 154 + M
|
|
-----------------------+----------+----------+----------
|
|
Length of : 5 : 155 + M : 159 + M
|
|
Entry-Specific Data (3): : :
|
|
-----------------------+----------+----------+----------
|
|
Entry-Specific Data : N (4) : 160 + M : 159 + M
|
|
: : : + N
|
|
========================================================
|
|
Notes:
|
|
(1) This field contains the number of null value
|
|
indicators (in decimal digits) in the received journal
|
|
entry.
|
|
(2) The length of null value indicators can vary from
|
|
entry to entry and is designated by the variable M.
|
|
(3) This field contains the length of the entry-specific
|
|
data (in decimal digits) in the received journal entry.
|
|
(4) The length of entry-specific data can vary from
|
|
entry to entry and is designated by the variable N.
|
|
(5) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the sequence number is larger than 10
|
|
digits.
|
|
(6) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the count of entries applied or removed
|
|
or relative record number is larger than 10 digits.
|
|
(7) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the commit cycle identifier is larger
|
|
than 10 digits.
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<p>The format for *TYPE4 journal entries when NULLINDLEN(*ENTFMT) is specified is shown below:
|
|
</p>
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Table 4 - NULLINDLEN(*ENTFMT) Journal Entry Format for ENTFMT(*TYPE4)</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
Field Name : Length : From : To
|
|
=======================+==========+==========+==========
|
|
Entry Length : 5 : 1 : 5
|
|
-----------------------+----------+----------+----------
|
|
Sequence Number (5) : 10 : 6 : 15
|
|
-----------------------+----------+----------+----------
|
|
Journal Code : 1 : 16 : 16
|
|
-----------------------+----------+----------+----------
|
|
Journal Entry Type : 2 : 17 : 18
|
|
-----------------------+----------+----------+----------
|
|
Timestamp : 26 : 19 : 44
|
|
-----------------------+----------+----------+----------
|
|
Job Name : 10 : 45 : 54
|
|
-----------------------+----------+----------+----------
|
|
User Name : 10 : 55 : 64
|
|
-----------------------+----------+----------+----------
|
|
Job Number : 6 : 65 : 70
|
|
-----------------------+----------+----------+----------
|
|
Program Name : 10 : 71 : 80
|
|
-----------------------+----------+----------+----------
|
|
Object Name : 10 : 81 : 90
|
|
-----------------------+----------+----------+----------
|
|
Object Library : 10 : 91 : 100
|
|
-----------------------+----------+----------+----------
|
|
Member Name : 10 : 101 : 110
|
|
-----------------------+----------+----------+----------
|
|
Count/RRN (6) : 10 : 111 : 120
|
|
-----------------------+----------+----------+----------
|
|
Flag : 1 : 121 : 121
|
|
-----------------------+----------+----------+----------
|
|
Commit Cycle ID (7) : 10 : 122 : 131
|
|
-----------------------+----------+----------+----------
|
|
User Profile : 10 : 132 : 141
|
|
-----------------------+----------+----------+----------
|
|
System Name : 8 : 142 : 149
|
|
-----------------------+----------+----------+----------
|
|
Journal Identifier : 10 : 150 : 159
|
|
-----------------------+----------+----------+----------
|
|
Referential : 1 : 160 : 160
|
|
Constraint : : :
|
|
-----------------------+----------+----------+----------
|
|
Trigger : 1 : 161 : 161
|
|
-----------------------+----------+----------+----------
|
|
Incomplete data : 1 : 162 : 162
|
|
-----------------------+----------+----------+----------
|
|
Ignore during : 1 : 163 : 163
|
|
APYJRNCHG or RMVJRNCHG : : :
|
|
-----------------------+----------+----------+----------
|
|
Minimized Entry : 1 : 164 : 164
|
|
Specific Data : : :
|
|
-----------------------+----------+----------+----------
|
|
Reserved : 5 : 165 : 169
|
|
-----------------------+----------+----------+----------
|
|
Number of Null Value : 5 : 170 : 174
|
|
Indicators (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Null Value Indicators : M (2) : 175 : 174 + M
|
|
-----------------------+----------+----------+----------
|
|
Length of : 5 : 175 + M : 179 + M
|
|
Entry-Specific Data (3): : :
|
|
-----------------------+----------+----------+----------
|
|
Entry-Specific Data : N (4) : 180 + M : 179 + M
|
|
: : : + N
|
|
========================================================
|
|
Notes:
|
|
(1) This field contains the number of null value
|
|
indicators (in decimal digits) in the received journal
|
|
entry.
|
|
(2) The length of null value indicators can vary from
|
|
entry to entry and is designated by the variable M.
|
|
(3) This field contains the length of the entry-specific
|
|
data (in decimal digits) in the received journal entry.
|
|
(4) The length of entry-specific data can vary from
|
|
entry to entry and is designated by the variable N.
|
|
(5) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the sequence number is larger than 10
|
|
digits.
|
|
(6) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the count of entries applied or removed
|
|
or relative record number is larger than 10 digits.
|
|
(7) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the commit cycle identifier is larger
|
|
than 10 digits.
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<p>The format for *TYPEPTR or *JRNENTFMT journal entries when NULLINDLEN(*ENTFMT), JRNENTFMT(RJNE0100), and RTNPTR(*SYSMNG) are specified is shown below:
|
|
</p>
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Table 5 - NULLINDLEN(*ENTFMT) Journal Entry Format for ENTFMT(*TYPEPTR) or ENTFMT(*JRNENTFMT) when JRNENTFMT(RJNE0100) is specified</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
Field Name : Length : From : To
|
|
=======================+==========+==========+==========
|
|
Displacement to next : 4 : 0 : 3
|
|
journal entry's : : :
|
|
header (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 4 : 7
|
|
journal entry's null : : :
|
|
value indicators (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 8 : 11
|
|
journal entry's entry : : :
|
|
specific data (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Pointer handle (2) : 4 : 12 : 15
|
|
-----------------------+----------+----------+----------
|
|
Sequence Number : 20 : 16 : 35
|
|
-----------------------+----------+----------+----------
|
|
Journal Code : 1 : 36 : 36
|
|
-----------------------+----------+----------+----------
|
|
Entry Type : 2 : 37 : 38
|
|
-----------------------+----------+----------+----------
|
|
Time stamp : 26 : 39 : 64
|
|
-----------------------+----------+----------+----------
|
|
Job Name : 10 : 65 : 74
|
|
-----------------------+----------+----------+----------
|
|
User Name : 10 : 75 : 84
|
|
-----------------------+----------+----------+----------
|
|
Job Number : 6 : 85 : 90
|
|
-----------------------+----------+----------+----------
|
|
Program Name : 10 : 91 : 100
|
|
-----------------------+----------+----------+----------
|
|
Object : 30 : 101 : 130
|
|
-----------------------+----------+----------+----------
|
|
Count/RRN : 10 : 131 : 140
|
|
-----------------------+----------+----------+----------
|
|
Indicator Flag : 1 : 141 : 141
|
|
-----------------------+----------+----------+----------
|
|
Commit Cycle ID : 20 : 142 : 161
|
|
-----------------------+----------+----------+----------
|
|
User Profile : 10 : 162 : 171
|
|
-----------------------+----------+----------+----------
|
|
System Name : 8 : 172 : 179
|
|
-----------------------+----------+----------+----------
|
|
Journal Identifier : 10 : 180 : 189
|
|
-----------------------+----------+----------+----------
|
|
Referential Constraint : 1 : 190 : 190
|
|
-----------------------+----------+----------+----------
|
|
Trigger : 1 : 191 : 191
|
|
-----------------------+----------+----------+----------
|
|
Incomplete Data : 1 : 192 : 192
|
|
-----------------------+----------+----------+----------
|
|
Object Name Indicator : 1 : 193 : 193
|
|
-----------------------+----------+----------+----------
|
|
Ignore During APYJRNCHG: 1 : 194 : 194
|
|
or RMVJRNCHG : : :
|
|
-----------------------+----------+----------+----------
|
|
Minimized Entry : 1 : 195 : 195
|
|
Specific Data : : :
|
|
-----------------------+----------+----------+----------
|
|
Length Of Null Vallue : 4 : NVI Disp : NVI Disp
|
|
Indicators (1) : : (3) : + 3
|
|
-----------------------+----------+----------+----------
|
|
Null Value Indicators : M (4) : NVI Disp : NVI Disp
|
|
: : + 4 : + 3
|
|
: : : + M
|
|
-----------------------+----------+----------+----------
|
|
Length Of Entry : 5 : ESD Disp : ESD Disp
|
|
Specific Data : : (5) : + 4
|
|
-----------------------+----------+----------+----------
|
|
Reserved : 11 : ESD Disp : ESD Disp
|
|
: : + 5 : + 15
|
|
-----------------------+----------+----------+----------
|
|
Entry-Specific Data : N (6) : ESD Disp : ESD Disp
|
|
: : + 16 : + 15 + N
|
|
========================================================
|
|
Notes:
|
|
(1) This field is represented in BINARY(4).
|
|
(2) This field is represented in UNSIGNED BINARY(4).
|
|
(3) NVI Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's null
|
|
value indicator."
|
|
(4) The length of null value indicators can vary from
|
|
entry to entry and is designated by the variable M.
|
|
(5) ESD Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's entry
|
|
specific data."
|
|
(6) The length of entry-specific data can vary from
|
|
entry to entry and is designated by the variable N.
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<p>The format for *JRNENTFMT journal entries when NULLINDLEN(*ENTFMT) and JRNENTFMT(RJNE0200) are specified is shown below:
|
|
</p>
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Table 6 - NULLINDLEN(*ENTFMT) Journal Entry Format for ENTFMT(*JRNENTFMT) when JRNENTFMT(RJNE0200) is specified</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
Field Name : Length : From : To
|
|
=======================+==========+==========+==========
|
|
Displacement to next : 4 : 0 : 3
|
|
journal entry's : : :
|
|
header (5) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 4 : 7
|
|
journal entry's null : : :
|
|
value indicators (5) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 8 : 11
|
|
journal entry's entry : : :
|
|
specific data (5) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 12 : 15
|
|
journal entry's trans- : : :
|
|
action identifier (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 16 : 19
|
|
journal entry's logical: : :
|
|
unit of work (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 20 : 23
|
|
journal entry's : : :
|
|
receiver information(1): : :
|
|
-----------------------+----------+----------+----------
|
|
Sequence Number (1) : 8 : 24 : 31
|
|
-----------------------+----------+----------+----------
|
|
Unformatted Time stamp : 8 : 32 : 39
|
|
(1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Thread Identifier (1) : 8 : 40 : 47
|
|
-----------------------+----------+----------+----------
|
|
System Sequence : 8 : 48 : 55
|
|
Number (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Count/RRN (1) : 8 : 56 : 63
|
|
-----------------------+----------+----------+----------
|
|
Commit Cycle ID (1) : 8 : 64 : 71
|
|
-----------------------+----------+----------+----------
|
|
Pointer Handle (1) : 4 : 72 : 75
|
|
-----------------------+----------+----------+----------
|
|
Remote Port (1) : 2 : 76 : 77
|
|
-----------------------+----------+----------+----------
|
|
Arm Number (1) : 2 : 78 : 79
|
|
-----------------------+----------+----------+----------
|
|
Program Library : 2 : 80 : 81
|
|
ASP Number (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Remote Address : 16 : 82 : 97
|
|
-----------------------+----------+----------+----------
|
|
Journal Code : 1 : 98 : 98
|
|
-----------------------+----------+----------+----------
|
|
Entry Type : 2 : 99 : 100
|
|
-----------------------+----------+----------+----------
|
|
Job Name : 10 : 101 : 110
|
|
-----------------------+----------+----------+----------
|
|
User Name : 10 : 111 : 120
|
|
-----------------------+----------+----------+----------
|
|
Job Number : 6 : 121 : 126
|
|
-----------------------+----------+----------+----------
|
|
Program Name : 10 : 127 : 136
|
|
-----------------------+----------+----------+----------
|
|
Program Library Name : 10 : 137 : 146
|
|
-----------------------+----------+----------+----------
|
|
Program Library ASP : 10 : 147 : 156
|
|
Device Name : : :
|
|
-----------------------+----------+----------+----------
|
|
Object : 30 : 157 : 186
|
|
-----------------------+----------+----------+----------
|
|
User Profile : 10 : 187 : 196
|
|
-----------------------+----------+----------+----------
|
|
Journal Identifier : 10 : 197 : 206
|
|
-----------------------+----------+----------+----------
|
|
Address Family : 1 : 207 : 207
|
|
-----------------------+----------+----------+----------
|
|
System Name : 8 : 208 : 215
|
|
-----------------------+----------+----------+----------
|
|
Indicator Flag : 1 : 216 : 216
|
|
-----------------------+----------+----------+----------
|
|
Object Name Indicator : 1 : 217 : 217
|
|
-----------------------+----------+----------+----------
|
|
Referential Constraint : 1/8 : 218 1/8 : 218 1/8
|
|
(2) : : :
|
|
-----------------------+----------+----------+----------
|
|
Trigger (2) : 1/8 : 218 2/8 : 218 2/8
|
|
-----------------------+----------+----------+----------
|
|
Incomplete Data (2) : 1/8 : 218 3/8 : 218 3/8
|
|
-----------------------+----------+----------+----------
|
|
Ignore During APYJRNCHG: 1/8 : 218 4/8 : 218 4/8
|
|
or RMVJRNCHG (2) : : :
|
|
-----------------------+----------+----------+----------
|
|
Minimized Entry : 1/8 : 218 5/8 : 218 5/8
|
|
Specific Data (2) : : :
|
|
-----------------------+----------+----------+----------
|
|
File Type Indicator (2): 1/8 : 218 6/8 : 218 6/8
|
|
-----------------------+----------+----------+----------
|
|
Minimized on : 1/8 : 218 7/8 : 218 7/8
|
|
Field Boundaries (2) : : :
|
|
-----------------------+----------+----------+----------
|
|
Reserved (2) : 1/8 : 218 8/8 : 218 8/8
|
|
-----------------------+----------+----------+----------
|
|
Object Type : 10 : 219 : 228
|
|
-----------------------+----------+----------+----------
|
|
Reserved : 3 : 229 : 231
|
|
-----------------------+----------+----------+----------
|
|
Nested Commit Level (1): 4 : 232 : 235
|
|
-----------------------+----------+----------+----------
|
|
Transaction Format ID : 4 : XID Disp : XID Disp
|
|
: : (10) : + 3
|
|
-----------------------+----------+----------+----------
|
|
Length Of Global Trans-: 4 : XID Disp : XID Disp
|
|
action Identifier (5) : : + 4 : + 7
|
|
-----------------------+----------+----------+----------
|
|
Length Of Branch : 4 : XID Disp : XID Disp
|
|
Qualifier (5) : : + 8 : + 11
|
|
-----------------------+----------+----------+----------
|
|
Transaction Branch : 128 : XID Disp : XID Disp
|
|
Identifier : : + 12 : + 139
|
|
-----------------------+----------+----------+----------
|
|
Logical Unit Of Work : 39 : LUW Disp : LUW Disp
|
|
: : (3) : + 38
|
|
-----------------------+----------+----------+----------
|
|
Receiver Name : 10 : RCV Disp : RCV Disp
|
|
: : (4) : + 9
|
|
-----------------------+----------+----------+----------
|
|
Receiver Library Name : 10 : RCV Disp : RCV Disp
|
|
: : + 10 : + 19
|
|
-----------------------+----------+----------+----------
|
|
Receiver Library ASP : 10 : RCV Disp : RCV Disp
|
|
Device Name : : + 20 : + 29
|
|
-----------------------+----------+----------+----------
|
|
Receiver Library ASP : 2 : RCV Disp : RCV Disp
|
|
Number (5) : : + 30 : + 31
|
|
-----------------------+----------+----------+----------
|
|
Length Of Null Vallue : 4 : NVI Disp : NVI Disp
|
|
Indicators (5) : : (6) : + 3
|
|
-----------------------+----------+----------+----------
|
|
Null Value Indicators : M (7) : NVI Disp : NVI Disp
|
|
: : + 4 : + 3
|
|
: : : + M
|
|
-----------------------+----------+----------+----------
|
|
Length Of Entry : 5 : ESD Disp : ESD Disp
|
|
Specific Data : : (8) : + 4
|
|
-----------------------+----------+----------+----------
|
|
Reserved : 11 : ESD Disp : ESD Disp
|
|
: : + 5 : + 15
|
|
-----------------------+----------+----------+----------
|
|
Entry-Specific Data : N (9) : ESD Disp : ESD Disp
|
|
: : + 16 : + 15 + N
|
|
========================================================
|
|
Notes:
|
|
(1) This field is represented in UNSIGNED BINARY.
|
|
(2) This field is represented by a BIT.
|
|
(3) LUW Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's logical
|
|
unit of work."
|
|
(4) RCV Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's receiver
|
|
information."
|
|
(5) This field is represented in BINARY.
|
|
(6) NVI Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's null
|
|
value indicator."
|
|
(7) The length of null value indicators can vary from
|
|
entry to entry and is designated by the variable M.
|
|
(8) ESD Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's entry
|
|
specific data."
|
|
(9) The length of entry-specific data can vary from
|
|
entry to entry and is designated by the variable N.
|
|
(10) XID Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's
|
|
transaction identifier."
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</dd>
|
|
<dt><b><i>field-length</i></b></dt>
|
|
<dd>Specify the field length of the null value indicators portion of the received journal entry. Valid values range from 1 through 8000 characters.
|
|
<p>The format for *TYPE3 journal entries when NULLINDLEN(field-length) is specified is shown below:
|
|
</p>
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Table 7 - NULLINDLEN(field-length) Journal Entry Format for ENTFMT(*TYPE3)</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
Field Name : Length : From : To
|
|
=======================+==========+==========+==========
|
|
Entry Length : 5 : 1 : 5
|
|
-----------------------+----------+----------+----------
|
|
Sequence Number (3) : 10 : 6 : 15
|
|
-----------------------+----------+----------+----------
|
|
Journal Code : 1 : 16 : 16
|
|
-----------------------+----------+----------+----------
|
|
Journal Entry Type : 2 : 17 : 18
|
|
-----------------------+----------+----------+----------
|
|
Timestamp : 26 : 19 : 44
|
|
-----------------------+----------+----------+----------
|
|
Job Name : 10 : 45 : 54
|
|
-----------------------+----------+----------+----------
|
|
User Name : 10 : 55 : 64
|
|
-----------------------+----------+----------+----------
|
|
Job Number : 6 : 65 : 70
|
|
-----------------------+----------+----------+----------
|
|
Program Name : 10 : 71 : 80
|
|
-----------------------+----------+----------+----------
|
|
Object Name : 10 : 81 : 90
|
|
-----------------------+----------+----------+----------
|
|
Object Library : 10 : 91 : 100
|
|
-----------------------+----------+----------+----------
|
|
Member Name : 10 : 101 : 110
|
|
-----------------------+----------+----------+----------
|
|
Count/RRN (4) : 10 : 111 : 120
|
|
-----------------------+----------+----------+----------
|
|
Flag : 1 : 121 : 121
|
|
-----------------------+----------+----------+----------
|
|
Commit Cycle ID (5) : 10 : 122 : 131
|
|
-----------------------+----------+----------+----------
|
|
User Profile : 10 : 132 : 141
|
|
-----------------------+----------+----------+----------
|
|
System Name : 8 : 142 : 149
|
|
-----------------------+----------+----------+----------
|
|
Null Value Indicators : field : 150 : 149 +
|
|
: length : : field
|
|
: (1) : : length
|
|
-----------------------+----------+----------+----------
|
|
Entry-Specific Data : M (2) : 150 + : 149 + M +
|
|
: : field : field
|
|
: : length : length
|
|
========================================================
|
|
Notes:
|
|
(1) The length of the null value indicators field is the
|
|
length specified on the NULLINDLEN parameter.
|
|
(2) The length of the entry-specific data field varies
|
|
from entry to entry and is designated by the variable
|
|
M. This length accommodates all
|
|
the entry-specific data in each received journal entry.
|
|
(3) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the sequence number is larger than 10
|
|
digits.
|
|
(4) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the count of entries applied or removed
|
|
or relative record number is larger than 10 digits.
|
|
(5) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the commit cycle identifier is larger
|
|
than 10 digits.
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<p>The format for *TYPE4 journal entries when NULLINDLEN(field-length) is specified is shown below:
|
|
</p>
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Table 8 - NULLINDLEN(field-length) Journal Entry Format for ENTFMT(*TYPE4)</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
Field Name : Length : From : To
|
|
=======================+==========+==========+==========
|
|
Entry Length : 5 : 1 : 5
|
|
-----------------------+----------+----------+----------
|
|
Sequence Number (3) : 10 : 6 : 15
|
|
-----------------------+----------+----------+----------
|
|
Journal Code : 1 : 16 : 16
|
|
-----------------------+----------+----------+----------
|
|
Journal Entry Type : 2 : 17 : 18
|
|
-----------------------+----------+----------+----------
|
|
Timestamp : 26 : 19 : 44
|
|
-----------------------+----------+----------+----------
|
|
Job Name : 10 : 45 : 54
|
|
-----------------------+----------+----------+----------
|
|
User Name : 10 : 55 : 64
|
|
-----------------------+----------+----------+----------
|
|
Job Number : 6 : 65 : 70
|
|
-----------------------+----------+----------+----------
|
|
Program Name : 10 : 71 : 80
|
|
-----------------------+----------+----------+----------
|
|
Object Name : 10 : 81 : 90
|
|
-----------------------+----------+----------+----------
|
|
Object Library : 10 : 91 : 100
|
|
-----------------------+----------+----------+----------
|
|
Member Name : 10 : 101 : 110
|
|
-----------------------+----------+----------+----------
|
|
Count/RRN (4) : 10 : 111 : 120
|
|
-----------------------+----------+----------+----------
|
|
Flag : 1 : 121 : 121
|
|
-----------------------+----------+----------+----------
|
|
Commit Cycle ID (5) : 10 : 122 : 131
|
|
-----------------------+----------+----------+----------
|
|
User Profile : 10 : 132 : 141
|
|
-----------------------+----------+----------+----------
|
|
System Name : 8 : 142 : 149
|
|
-----------------------+----------+----------+----------
|
|
Journal Identifier : 10 : 150 : 159
|
|
-----------------------+----------+----------+----------
|
|
Referential : 1 : 160 : 160
|
|
Constraint : : :
|
|
-----------------------+----------+----------+----------
|
|
Trigger : 1 : 161 : 161
|
|
-----------------------+----------+----------+----------
|
|
Incomplete data : 1 : 162 : 162
|
|
-----------------------+----------+----------+----------
|
|
Ignore during : 1 : 163 : 163
|
|
APYJRNCHG or RMVJRNCHG : : :
|
|
-----------------------+----------+----------+----------
|
|
Minimized Entry : 1 : 164 : 164
|
|
Specific Data : : :
|
|
-----------------------+----------+----------+----------
|
|
Reserved : 5 : 165 : 169
|
|
-----------------------+----------+----------+----------
|
|
Null Value Indicators : field : 170 : 169 +
|
|
: length : : field
|
|
: (1) : : length
|
|
-----------------------+----------+----------+----------
|
|
Entry-Specific Data : M (2) : 170 + : 169 + M +
|
|
: : field : field
|
|
: : length : length
|
|
========================================================
|
|
Notes:
|
|
(1) The length of the null value indicators field is the
|
|
length specified on the NULLINDLEN parameter.
|
|
(2) The length of the entry-specific data field varies
|
|
from entry to entry and is designated by the variable
|
|
M. This length accommodates all
|
|
the entry-specific data in each received journal entry.
|
|
(3) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the sequence number is larger than 10
|
|
digits.
|
|
(4) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the count of entries applied or removed
|
|
or relative record number is larger than 10 digits.
|
|
(5) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the commit cycle identifier is larger
|
|
than 10 digits.
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<p>The format for *TYPEPTR or *JRNENTFMT journal entries when NULLINDLEN(field-length) and JRNENTFMT(RJNE0100) are specified is shown below:
|
|
</p>
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Table 9 - NULLINDLEN(field-length) Journal Entry Format for ENTFMT(*TYPEPTR) or ENTFMT(*JRNENTFMT) when JRNENTFMT(RJNE0100) is specified</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
Field Name : Length : From : To
|
|
=======================+==========+==========+==========
|
|
Displacement to next : 4 : 0 : 3
|
|
journal entry's : : :
|
|
header (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 4 : 7
|
|
journal entry's null : : :
|
|
value indicators (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 8 : 11
|
|
journal entry's entry : : :
|
|
specific data (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Pointer handle (2) : 4 : 12 : 15
|
|
-----------------------+----------+----------+----------
|
|
Sequence Number : 20 : 16 : 35
|
|
-----------------------+----------+----------+----------
|
|
Journal Code : 1 : 36 : 36
|
|
-----------------------+----------+----------+----------
|
|
Entry Type : 2 : 37 : 38
|
|
-----------------------+----------+----------+----------
|
|
Time stamp : 26 : 39 : 64
|
|
-----------------------+----------+----------+----------
|
|
Job Name : 10 : 65 : 74
|
|
-----------------------+----------+----------+----------
|
|
User Name : 10 : 75 : 84
|
|
-----------------------+----------+----------+----------
|
|
Job Number : 6 : 85 : 90
|
|
-----------------------+----------+----------+----------
|
|
Program Name : 10 : 91 : 100
|
|
-----------------------+----------+----------+----------
|
|
Object : 30 : 101 : 130
|
|
-----------------------+----------+----------+----------
|
|
Count/RRN : 10 : 131 : 140
|
|
-----------------------+----------+----------+----------
|
|
Indicator Flag : 1 : 141 : 141
|
|
-----------------------+----------+----------+----------
|
|
Commit Cycle ID : 20 : 142 : 161
|
|
-----------------------+----------+----------+----------
|
|
User Profile : 10 : 162 : 171
|
|
-----------------------+----------+----------+----------
|
|
System Name : 8 : 172 : 179
|
|
-----------------------+----------+----------+----------
|
|
Journal Identifier : 10 : 180 : 189
|
|
-----------------------+----------+----------+----------
|
|
Referential Constraint : 1 : 190 : 190
|
|
-----------------------+----------+----------+----------
|
|
Trigger : 1 : 191 : 191
|
|
-----------------------+----------+----------+----------
|
|
Incomplete Data : 1 : 192 : 192
|
|
-----------------------+----------+----------+----------
|
|
Object Name Indicator : 1 : 193 : 193
|
|
-----------------------+----------+----------+----------
|
|
Ignore During APYJRNCHG: 1 : 194 : 194
|
|
or RMVJRNCHG : : :
|
|
-----------------------+----------+----------+----------
|
|
Minimized Entry : 1 : 195 : 195
|
|
Specific Data : : :
|
|
-----------------------+----------+----------+----------
|
|
Null Value Indicators : field : NVI Disp : NVI Disp
|
|
: length : (4) : + field
|
|
: (3) : : length
|
|
: : : - 1
|
|
-----------------------+----------+----------+----------
|
|
Length Of Entry : 5 : ESD Disp : ESD Disp
|
|
Specific Data : : (5) : + 4
|
|
-----------------------+----------+----------+----------
|
|
Reserved : 11 : ESD Disp : ESD Disp
|
|
: : + 5 : + 15
|
|
-----------------------+----------+----------+----------
|
|
Entry-Specific Data : N (6) : ESD Disp : ESD Disp
|
|
: : + 16 : + 15 + N
|
|
========================================================
|
|
Notes:
|
|
(1) This field is represented in BINARY(4).
|
|
(2) This field is represented in UNSIGNED BINARY(4).
|
|
(3) The length of the null value indicators field is the
|
|
length specified on the NULLINDLEN parameter.
|
|
(4) NVI Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's null
|
|
value indicator."
|
|
(5) ESD Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's entry
|
|
specific data."
|
|
(6) The length of entry-specific data can vary from
|
|
entry to entry and is designated by the variable N.
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<p>The format for *JRNENTFMT journal entries when NULLINDLEN(field-length) and JRNENTFMT(RJNE0200) are specified is shown below:
|
|
</p>
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Table 10 - NULLINDLEN(field-length) Journal Entry Format for ENTFMT(*JRNENTFMT) when JRNENTFMT(RJNE0200) is specified</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
Field Name : Length : From : To
|
|
=======================+==========+==========+==========
|
|
Displacement to next : 4 : 0 : 3
|
|
journal entry's : : :
|
|
header (5) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 4 : 7
|
|
journal entry's null : : :
|
|
value indicators (5) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 8 : 11
|
|
journal entry's entry : : :
|
|
specific data (5) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 12 : 15
|
|
journal entry's trans- : : :
|
|
action identifier (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 16 : 19
|
|
journal entry's logical: : :
|
|
unit of work (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 20 : 23
|
|
journal entry's : : :
|
|
receiver information(1): : :
|
|
-----------------------+----------+----------+----------
|
|
Sequence Number (1) : 8 : 24 : 31
|
|
-----------------------+----------+----------+----------
|
|
Unformatted Time stamp : 8 : 32 : 39
|
|
(1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Thread Identifier (1) : 8 : 40 : 47
|
|
-----------------------+----------+----------+----------
|
|
System Sequence : 8 : 48 : 55
|
|
Number (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Count/RRN (1) : 8 : 56 : 63
|
|
-----------------------+----------+----------+----------
|
|
Commit Cycle ID (1) : 8 : 64 : 71
|
|
-----------------------+----------+----------+----------
|
|
Pointer Handle (1) : 4 : 72 : 75
|
|
-----------------------+----------+----------+----------
|
|
Remote Port (1) : 2 : 76 : 77
|
|
-----------------------+----------+----------+----------
|
|
Arm Number (1) : 2 : 78 : 79
|
|
-----------------------+----------+----------+----------
|
|
Program Library : 2 : 80 : 81
|
|
ASP Number (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Remote Address : 16 : 82 : 97
|
|
-----------------------+----------+----------+----------
|
|
Journal Code : 1 : 98 : 98
|
|
-----------------------+----------+----------+----------
|
|
Entry Type : 2 : 99 : 100
|
|
-----------------------+----------+----------+----------
|
|
Job Name : 10 : 101 : 110
|
|
-----------------------+----------+----------+----------
|
|
User Name : 10 : 111 : 120
|
|
-----------------------+----------+----------+----------
|
|
Job Number : 6 : 121 : 126
|
|
-----------------------+----------+----------+----------
|
|
Program Name : 10 : 127 : 136
|
|
-----------------------+----------+----------+----------
|
|
Program Library Name : 10 : 137 : 146
|
|
-----------------------+----------+----------+----------
|
|
Program Library ASP : 10 : 147 : 156
|
|
Device Name : : :
|
|
-----------------------+----------+----------+----------
|
|
Object : 30 : 157 : 186
|
|
-----------------------+----------+----------+----------
|
|
User Profile : 10 : 187 : 196
|
|
-----------------------+----------+----------+----------
|
|
Journal Identifier : 10 : 197 : 206
|
|
-----------------------+----------+----------+----------
|
|
Address Family : 1 : 207 : 207
|
|
-----------------------+----------+----------+----------
|
|
System Name : 8 : 208 : 215
|
|
-----------------------+----------+----------+----------
|
|
Indicator Flag : 1 : 216 : 216
|
|
-----------------------+----------+----------+----------
|
|
Object Name Indicator : 1 : 217 : 217
|
|
-----------------------+----------+----------+----------
|
|
Referential Constraint : 1/8 : 218 1/8 : 218 1/8
|
|
(2) : : :
|
|
-----------------------+----------+----------+----------
|
|
Trigger (2) : 1/8 : 218 2/8 : 218 2/8
|
|
-----------------------+----------+----------+----------
|
|
Incomplete Data (2) : 1/8 : 218 3/8 : 218 3/8
|
|
-----------------------+----------+----------+----------
|
|
Ignore During APYJRNCHG: 1/8 : 218 4/8 : 218 4/8
|
|
or RMVJRNCHG (2) : : :
|
|
-----------------------+----------+----------+----------
|
|
Minimized Entry : 1/8 : 218 5/8 : 218 5/8
|
|
Specific Data (2) : : :
|
|
-----------------------+----------+----------+----------
|
|
File Type Indicator (2): 1/8 : 218 6/8 : 218 6/8
|
|
-----------------------+----------+----------+----------
|
|
Minimized on : 1/8 : 218 7/8 : 218 7/8
|
|
Field Boundaries (2) : : :
|
|
-----------------------+----------+----------+----------
|
|
Reserved (2) : 1/8 : 218 8/8 : 218 8/8
|
|
-----------------------+----------+----------+----------
|
|
Object Type : 10 : 219 : 228
|
|
-----------------------+----------+----------+----------
|
|
Reserved : 3 : 229 : 231
|
|
-----------------------+----------+----------+----------
|
|
Nested Commit Level (1): 4 : 232 : 235
|
|
-----------------------+----------+----------+----------
|
|
Transaction Format ID : 4 : XID Disp : XID Disp
|
|
: : (10) : + 3
|
|
-----------------------+----------+----------+----------
|
|
Length Of Global Trans-: 4 : XID Disp : XID Disp
|
|
action Identifier (5) : : + 4 : + 7
|
|
-----------------------+----------+----------+----------
|
|
Length Of Branch : 4 : XID Disp : XID Disp
|
|
Qualifier (5) : : + 8 : + 11
|
|
-----------------------+----------+----------+----------
|
|
Transaction Branch : 128 : XID Disp : XID Disp
|
|
Identifier : : + 12 : + 139
|
|
-----------------------+----------+----------+----------
|
|
Logical Unit Of Work : 39 : LUW Disp : LUW Disp
|
|
: : (3) : + 38
|
|
-----------------------+----------+----------+----------
|
|
Receiver Name : 10 : RCV Disp : RCV Disp
|
|
: : (4) : + 9
|
|
-----------------------+----------+----------+----------
|
|
Receiver Library Name : 10 : RCV Disp : RCV Disp
|
|
: : + 10 : + 19
|
|
-----------------------+----------+----------+----------
|
|
Receiver Library ASP : 10 : RCV Disp : RCV Disp
|
|
Device Name : : + 20 : + 29
|
|
-----------------------+----------+----------+----------
|
|
Receiver Library ASP : 2 : RCV Disp : RCV Disp
|
|
Number (5) : : + 30 : + 31
|
|
-----------------------+----------+----------+----------
|
|
Null Value Indicators : field : NVI Disp : NVI Disp
|
|
: length : (7) : + field
|
|
: (6) : : length
|
|
: : : - 1
|
|
-----------------------+----------+----------+----------
|
|
Length Of Entry : 5 : ESD Disp : ESD Disp
|
|
Specific Data : : (8) : + 4
|
|
-----------------------+----------+----------+----------
|
|
Reserved : 11 : ESD Disp : ESD Disp
|
|
: : + 5 : + 15
|
|
-----------------------+----------+----------+----------
|
|
Entry-Specific Data : N (9) : ESD Disp : ESD Disp
|
|
: : + 16 : + 15 + N
|
|
========================================================
|
|
Notes:
|
|
(1) This field is represented in UNSIGNED BINARY.
|
|
(2) This field is represented by a BIT.
|
|
(3) LUW Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's logical
|
|
unit of work."
|
|
(4) RCV Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's receiver
|
|
information."
|
|
(5) This field is represented in BINARY.
|
|
(6) The length of the null value indicators field is the
|
|
length specified on the NULLINDLEN parameter.
|
|
(7) NVI Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's null
|
|
value indicator."
|
|
(8) ESD Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's entry
|
|
specific data."
|
|
(9) The length of entry-specific data can vary from
|
|
entry to entry and is designated by the variable N.
|
|
(10) XID Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's
|
|
transaction identifier."
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Field data format</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*VARLEN</b></dt>
|
|
<dd>The null value indicators field is a variable length field.
|
|
</dd>
|
|
<dt><b><i>field-length</i></b></dt>
|
|
<dd>Specify the field length of the null value indicators portion of the received journal entry. Valid values range from 1 through 8000 characters.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Variable length field length</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>maximum-field-length</i></b></dt>
|
|
<dd>Specify the maximum field length of the null value indicators portion of the received journal entry. Valid values range from 1 to 8000 characters. If a journal entry has more null value indicators than the value you specify and truncation results in the loss of a non 'F0'X indicator value, the RCVJRNE request is abnormally ended.
|
|
<p>You can specify this element only if you also specify *VARLEN on the first element of this parameter.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>NULLINDLEN(*VARLEN) and ENTFMT(*TYPEPTR) cannot be specified at the same time.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>NULLINDLEN(*VARLEN) and RTNPTR(*SYSMNG) or RTNPTR(*USRMNG) cannot be specified at the same time.
|
|
</p>
|
|
<p>The format for *TYPE3 journal entries when NULLINDLEN(*VARLEN field-length) is specified is shown below:
|
|
</p>
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Table 11 - NULLINDLEN(*VARLEN field-length) Journal Entry Format for ENTFMT(*TYPE3)</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
Field Name : Length : From : To
|
|
=======================+==========+==========+==========
|
|
Entry Length : 5 : 1 : 5
|
|
-----------------------+----------+----------+----------
|
|
Sequence Number (4) : 10 : 6 : 15
|
|
-----------------------+----------+----------+----------
|
|
Journal Code : 1 : 16 : 16
|
|
-----------------------+----------+----------+----------
|
|
Journal Entry Type : 2 : 17 : 18
|
|
-----------------------+----------+----------+----------
|
|
Timestamp : 26 : 19 : 44
|
|
-----------------------+----------+----------+----------
|
|
Job Name : 10 : 45 : 54
|
|
-----------------------+----------+----------+----------
|
|
User Name : 10 : 55 : 64
|
|
-----------------------+----------+----------+----------
|
|
Job Number : 6 : 65 : 70
|
|
-----------------------+----------+----------+----------
|
|
Program Name : 10 : 71 : 80
|
|
-----------------------+----------+----------+----------
|
|
Object Name : 10 : 81 : 90
|
|
-----------------------+----------+----------+----------
|
|
Object Library : 10 : 91 : 100
|
|
-----------------------+----------+----------+----------
|
|
Member Name : 10 : 101 : 110
|
|
-----------------------+----------+----------+----------
|
|
Count/RRN (5) : 10 : 111 : 120
|
|
-----------------------+----------+----------+----------
|
|
Flag : 1 : 121 : 121
|
|
-----------------------+----------+----------+----------
|
|
Commit Cycle ID (6) : 10 : 122 : 131
|
|
-----------------------+----------+----------+----------
|
|
User Profile : 10 : 132 : 141
|
|
-----------------------+----------+----------+----------
|
|
System Name : 8 : 142 : 149
|
|
-----------------------+----------+----------+----------
|
|
Number of Null Value : 2 : 150 : 151
|
|
Indicators (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Null Value Indicators : field : 152 : 151 +
|
|
: length : : field
|
|
: : : length
|
|
-----------------------+----------+----------+----------
|
|
Length of : 5 : 152 + : 156 +
|
|
Entry-Specific Data (2): : field : field
|
|
: : length : length
|
|
-----------------------+----------+----------+----------
|
|
Entry-Specific Data : M (3) : 157 + : 156 + M +
|
|
: : field : field
|
|
: : length : length
|
|
========================================================
|
|
Notes:
|
|
(1) This field contains the number of null value
|
|
indicators (in binary digits) in the received journal
|
|
entry.
|
|
(2) This field contains the length of the entry-specific
|
|
data (in decimal digits) in the received journal entry.
|
|
(3) The length of entry-specific data can vary from
|
|
entry to entry and is designated by the variable M.
|
|
(4) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the sequence number is larger than 10
|
|
digits.
|
|
(5) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the count of entries applied or removed
|
|
or relative record number is larger than 10 digits.
|
|
(6) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the commit cycle identifier is larger
|
|
than 10 digits.
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<p>The format for *TYPE4 journal entries when NULLINDLEN(*VARLEN field-length) is specified is shown below:
|
|
</p>
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Table 12 - NULLINDLEN(*VARLEN field-length) Journal Entry Format for ENTFMT(*TYPE4)</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
Field Name : Length : From : To
|
|
=======================+==========+==========+==========
|
|
Entry Length : 5 : 1 : 5
|
|
-----------------------+----------+----------+----------
|
|
Sequence Number (4) : 10 : 6 : 15
|
|
-----------------------+----------+----------+----------
|
|
Journal Code : 1 : 16 : 16
|
|
-----------------------+----------+----------+----------
|
|
Journal Entry Type : 2 : 17 : 18
|
|
-----------------------+----------+----------+----------
|
|
Timestamp : 26 : 19 : 44
|
|
-----------------------+----------+----------+----------
|
|
Job Name : 10 : 45 : 54
|
|
-----------------------+----------+----------+----------
|
|
User Name : 10 : 55 : 64
|
|
-----------------------+----------+----------+----------
|
|
Job Number : 6 : 65 : 70
|
|
-----------------------+----------+----------+----------
|
|
Program Name : 10 : 71 : 80
|
|
-----------------------+----------+----------+----------
|
|
Object Name : 10 : 81 : 90
|
|
-----------------------+----------+----------+----------
|
|
Object Library : 10 : 91 : 100
|
|
-----------------------+----------+----------+----------
|
|
Member Name : 10 : 101 : 110
|
|
-----------------------+----------+----------+----------
|
|
Count/RRN (5) : 10 : 111 : 120
|
|
-----------------------+----------+----------+----------
|
|
Flag : 1 : 121 : 121
|
|
-----------------------+----------+----------+----------
|
|
Commit Cycle ID (6) : 10 : 122 : 131
|
|
-----------------------+----------+----------+----------
|
|
User Profile : 10 : 132 : 141
|
|
-----------------------+----------+----------+----------
|
|
System Name : 8 : 142 : 149
|
|
-----------------------+----------+----------+----------
|
|
Journal Identifier : 10 : 150 : 159
|
|
-----------------------+----------+----------+----------
|
|
Referential : 1 : 160 : 160
|
|
Constraint : : :
|
|
-----------------------+----------+----------+----------
|
|
Trigger : 1 : 161 : 161
|
|
-----------------------+----------+----------+----------
|
|
Incomplete data : 1 : 162 : 162
|
|
-----------------------+----------+----------+----------
|
|
Ignore during : 1 : 163 : 163
|
|
APYJRNCHG or RMVJRNCHG : : :
|
|
-----------------------+----------+----------+----------
|
|
Minimized Entry : 1 : 164 : 164
|
|
Specific Data : : :
|
|
-----------------------+----------+----------+----------
|
|
Reserved : 5 : 165 : 169
|
|
-----------------------+----------+----------+----------
|
|
Number of Null Value : 2 : 170 : 171
|
|
Indicators (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Null Value Indicators : field : 172 : 171 +
|
|
: length : : field
|
|
: : : length
|
|
-----------------------+----------+----------+----------
|
|
Length of : 5 : 172 + : 176 +
|
|
Entry-Specific Data (2): : field : field
|
|
: : length : length
|
|
-----------------------+----------+----------+----------
|
|
Entry-Specific Data : M (3) : 177 + : 176 + M +
|
|
: : field : field
|
|
: : length : length
|
|
========================================================
|
|
Notes:
|
|
(1) This field contains the number of null value
|
|
indicators (in binary digits) in the received journal
|
|
entry.
|
|
(2) This field contains the length of the entry-specific
|
|
data (in decimal digits) in the received journal entry.
|
|
(3) The length of entry-specific data can vary from
|
|
entry to entry and is designated by the variable M.
|
|
(4) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the sequence number is larger than 10
|
|
digits.
|
|
(5) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the count of entries applied or removed
|
|
or relative record number is larger than 10 digits.
|
|
(6) When the RCVSIZOPT of the journal is *MAXOPT3, this field
|
|
will be set to -1 if the commit cycle identifier is larger
|
|
than 10 digits.
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<p>The format for *JRNENTFMT journal entries when NULLINDLEN(*VARLEN field-length) and JRNENTFMT(RJNE0100) are specified is shown below:
|
|
</p>
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Table 13 - NULLINDLEN(*VARLEN field-length) Journal Entry Format for ENTFMT(*JRNENTFMT) when JRNENTFMT(RJNE0100) is specified</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
Field Name : Length : From : To
|
|
=======================+==========+==========+==========
|
|
Displacement to next : 4 : 0 : 3
|
|
journal entry's : : :
|
|
header (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 4 : 7
|
|
journal entry's null : : :
|
|
value indicators (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 8 : 11
|
|
journal entry's entry : : :
|
|
specific data (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Pointer handle (2) : 4 : 12 : 15
|
|
-----------------------+----------+----------+----------
|
|
Sequence Number : 20 : 16 : 35
|
|
-----------------------+----------+----------+----------
|
|
Journal Code : 1 : 36 : 36
|
|
-----------------------+----------+----------+----------
|
|
Entry Type : 2 : 37 : 38
|
|
-----------------------+----------+----------+----------
|
|
Time stamp : 26 : 39 : 64
|
|
-----------------------+----------+----------+----------
|
|
Job Name : 10 : 65 : 74
|
|
-----------------------+----------+----------+----------
|
|
User Name : 10 : 75 : 84
|
|
-----------------------+----------+----------+----------
|
|
Job Number : 6 : 85 : 90
|
|
-----------------------+----------+----------+----------
|
|
Program Name : 10 : 91 : 100
|
|
-----------------------+----------+----------+----------
|
|
Object : 30 : 101 : 130
|
|
-----------------------+----------+----------+----------
|
|
Count/RRN : 10 : 131 : 140
|
|
-----------------------+----------+----------+----------
|
|
Indicator Flag : 1 : 141 : 141
|
|
-----------------------+----------+----------+----------
|
|
Commit Cycle ID : 20 : 142 : 161
|
|
-----------------------+----------+----------+----------
|
|
User Profile : 10 : 162 : 171
|
|
-----------------------+----------+----------+----------
|
|
System Name : 8 : 172 : 179
|
|
-----------------------+----------+----------+----------
|
|
Journal Identifier : 10 : 180 : 189
|
|
-----------------------+----------+----------+----------
|
|
Referential Constraint : 1 : 190 : 190
|
|
-----------------------+----------+----------+----------
|
|
Trigger : 1 : 191 : 191
|
|
-----------------------+----------+----------+----------
|
|
Incomplete Data : 1 : 192 : 192
|
|
-----------------------+----------+----------+----------
|
|
Object Name Indicator : 1 : 193 : 193
|
|
-----------------------+----------+----------+----------
|
|
Ignore During APYJRNCHG: 1 : 194 : 194
|
|
or RMVJRNCHG : : :
|
|
-----------------------+----------+----------+----------
|
|
Minimized Entry : 1 : 195 : 195
|
|
Specific Data : : :
|
|
-----------------------+----------+----------+----------
|
|
Length Of Null Value : 4 : NVI Disp : NVI Disp
|
|
Indicators (1) : : (3) : + 3
|
|
-----------------------+----------+----------+----------
|
|
Null Value Indicators : field : NVI Disp : NVI Disp
|
|
: length : + 4 : + 3
|
|
: : : + field
|
|
: : : length
|
|
-----------------------+----------+----------+----------
|
|
Length Of Entry : 5 : ESD Disp : ESD Disp
|
|
Specific Data : : (4) : + 4
|
|
-----------------------+----------+----------+----------
|
|
Reserved : 11 : ESD Disp : ESD Disp
|
|
: : + 5 : + 15
|
|
-----------------------+----------+----------+----------
|
|
Entry-Specific Data : M (5) : ESD Disp : ESD Disp
|
|
: : + 16 : + 15 + M
|
|
========================================================
|
|
Notes:
|
|
(1) This field is represented in BINARY(4).
|
|
(2) This field is represented in UNSIGNED BINARY(4).
|
|
(3) NVI Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's null
|
|
value indicator."
|
|
(4) ESD Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's entry
|
|
specific data."
|
|
(5) The length of entry-specific data can vary from
|
|
entry to entry and is designated by the variable M.
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<p>The format for *JRNENTFMT journal entries when NULLINDLEN(*VARLEN field-length) and JRNENTFMT(RJNE0200) are specified is shown below:
|
|
</p>
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Table 14 - NULLINDLEN(*VARLEN field-length) Journal Entry Format for ENTFMT(*JRNENTFMT) when JRNENTFMT(RJNE0200) is specified</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
Field Name : Length : From : To
|
|
=======================+==========+==========+==========
|
|
Displacement to next : 4 : 0 : 3
|
|
journal entry's : : :
|
|
header (5) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 4 : 7
|
|
journal entry's null : : :
|
|
value indicators (5) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 8 : 11
|
|
journal entry's entry : : :
|
|
specific data (5) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 12 : 15
|
|
journal entry's trans- : : :
|
|
action identifier (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 16 : 19
|
|
journal entry's logical: : :
|
|
unit of work (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Displacement to this : 4 : 20 : 23
|
|
journal entry's : : :
|
|
receiver information(1): : :
|
|
-----------------------+----------+----------+----------
|
|
Sequence Number (1) : 8 : 24 : 31
|
|
-----------------------+----------+----------+----------
|
|
Unformatted Time stamp : 8 : 32 : 39
|
|
(1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Thread Identifier (1) : 8 : 40 : 47
|
|
-----------------------+----------+----------+----------
|
|
System Sequence : 8 : 48 : 55
|
|
Number (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Count/RRN (1) : 8 : 56 : 63
|
|
-----------------------+----------+----------+----------
|
|
Commit Cycle ID (1) : 8 : 64 : 71
|
|
-----------------------+----------+----------+----------
|
|
Pointer Handle (1) : 4 : 72 : 75
|
|
-----------------------+----------+----------+----------
|
|
Remote Port (1) : 2 : 76 : 77
|
|
-----------------------+----------+----------+----------
|
|
Arm Number (1) : 2 : 78 : 79
|
|
-----------------------+----------+----------+----------
|
|
Program Library : 2 : 80 : 81
|
|
ASP Number (1) : : :
|
|
-----------------------+----------+----------+----------
|
|
Remote Address : 16 : 82 : 97
|
|
-----------------------+----------+----------+----------
|
|
Journal Code : 1 : 98 : 98
|
|
-----------------------+----------+----------+----------
|
|
Entry Type : 2 : 99 : 100
|
|
-----------------------+----------+----------+----------
|
|
Job Name : 10 : 101 : 110
|
|
-----------------------+----------+----------+----------
|
|
User Name : 10 : 111 : 120
|
|
-----------------------+----------+----------+----------
|
|
Job Number : 6 : 121 : 126
|
|
-----------------------+----------+----------+----------
|
|
Program Name : 10 : 127 : 136
|
|
-----------------------+----------+----------+----------
|
|
Program Library Name : 10 : 137 : 146
|
|
-----------------------+----------+----------+----------
|
|
Program Library ASP : 10 : 147 : 156
|
|
Device Name : : :
|
|
-----------------------+----------+----------+----------
|
|
Object : 30 : 157 : 186
|
|
-----------------------+----------+----------+----------
|
|
User Profile : 10 : 187 : 196
|
|
-----------------------+----------+----------+----------
|
|
Journal Identifier : 10 : 197 : 206
|
|
-----------------------+----------+----------+----------
|
|
Address Family : 1 : 207 : 207
|
|
-----------------------+----------+----------+----------
|
|
System Name : 8 : 208 : 215
|
|
-----------------------+----------+----------+----------
|
|
Indicator Flag : 1 : 216 : 216
|
|
-----------------------+----------+----------+----------
|
|
Object Name Indicator : 1 : 217 : 217
|
|
-----------------------+----------+----------+----------
|
|
Referential Constraint : 1/8 : 218 1/8 : 218 1/8
|
|
(2) : : :
|
|
-----------------------+----------+----------+----------
|
|
Trigger (2) : 1/8 : 218 2/8 : 218 2/8
|
|
-----------------------+----------+----------+----------
|
|
Incomplete Data (2) : 1/8 : 218 3/8 : 218 3/8
|
|
-----------------------+----------+----------+----------
|
|
Ignore During APYJRNCHG: 1/8 : 218 4/8 : 218 4/8
|
|
or RMVJRNCHG (2) : : :
|
|
-----------------------+----------+----------+----------
|
|
Minimized Entry : 1/8 : 218 5/8 : 218 5/8
|
|
Specific Data (2) : : :
|
|
-----------------------+----------+----------+----------
|
|
File Type Indicator (2): 1/8 : 218 6/8 : 218 6/8
|
|
-----------------------+----------+----------+----------
|
|
Minimized on : 1/8 : 218 7/8 : 218 7/8
|
|
Field Boundaries (2) : : :
|
|
-----------------------+----------+----------+----------
|
|
Reserved (2) : 1/8 : 218 8/8 : 218 8/8
|
|
-----------------------+----------+----------+----------
|
|
Object Type : 10 : 219 : 228
|
|
-----------------------+----------+----------+----------
|
|
Reserved : 3 : 229 : 231
|
|
-----------------------+----------+----------+----------
|
|
Nested Commit Level (1): 4 : 232 : 235
|
|
-----------------------+----------+----------+----------
|
|
Transaction Format ID : 4 : XID Disp : XID Disp
|
|
: : (9) : + 3
|
|
-----------------------+----------+----------+----------
|
|
Length Of Global Trans-: 4 : XID Disp : XID Disp
|
|
action Identifier (5) : : + 4 : + 7
|
|
-----------------------+----------+----------+----------
|
|
Length Of Branch : 4 : XID Disp : XID Disp
|
|
Qualifier (5) : : + 8 : + 11
|
|
-----------------------+----------+----------+----------
|
|
Transaction Branch : 128 : XID Disp : XID Disp
|
|
Identifier : : + 12 : + 139
|
|
-----------------------+----------+----------+----------
|
|
Logical Unit Of Work : 39 : LUW Disp : LUW Disp
|
|
: : (3) : + 38
|
|
-----------------------+----------+----------+----------
|
|
Receiver Name : 10 : RCV Disp : RCV Disp
|
|
: : (4) : + 9
|
|
-----------------------+----------+----------+----------
|
|
Receiver Library Name : 10 : RCV Disp : RCV Disp
|
|
: : + 10 : + 19
|
|
-----------------------+----------+----------+----------
|
|
Receiver Library ASP : 10 : RCV Disp : RCV Disp
|
|
Device Name : : + 20 : + 29
|
|
-----------------------+----------+----------+----------
|
|
Receiver Library ASP : 2 : RCV Disp : RCV Disp
|
|
Number (5) : : + 30 : + 31
|
|
-----------------------+----------+----------+----------
|
|
Length Of Null Value : 4 : NVI Disp : NVI Disp
|
|
Indicators (5) : : (6) : + 3
|
|
-----------------------+----------+----------+----------
|
|
Null Value Indicators : field : NVI Disp : NVI Disp
|
|
: length : + 4 : + 3
|
|
: : : + field
|
|
: : : length
|
|
-----------------------+----------+----------+----------
|
|
Length Of Entry : 5 : ESD Disp : ESD Disp
|
|
Specific Data : : (7) : + 4
|
|
-----------------------+----------+----------+----------
|
|
Reserved : 11 : ESD Disp : ESD Disp
|
|
: : + 5 : + 15
|
|
-----------------------+----------+----------+----------
|
|
Entry-Specific Data : M (8) : ESD Disp : ESD Disp
|
|
: : + 16 : + 15 + M
|
|
========================================================
|
|
Notes:
|
|
(1) This field is represented in UNSIGNED BINARY.
|
|
(2) This field is represented by a BIT.
|
|
(3) LUW Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's logical
|
|
unit of work."
|
|
(4) RCV Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's receiver
|
|
information."
|
|
(5) This field is represented in BINARY.
|
|
(6) NVI Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's null
|
|
value indicator."
|
|
(7) ESD Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's entry
|
|
specific data."
|
|
(8) The length of entry-specific data can vary from
|
|
entry to entry and is designated by the variable M.
|
|
(9) XID Disp is determined by the value in the field
|
|
labeled "Displacement to this journal entry's
|
|
transaction identifier."
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.DELAY"></a>
|
|
<h3>Delay time (DELAY)</h3>
|
|
<p>Specifies the number of seconds that the command processing program (CPP) waits for a new journal entry to arrive if the last entry has already been received. After the last entry in the journal is received and passed to the exit program, the CPP tries to receive the next entry. If no new journal entry exists, the exit program is passed a value of 0 in the first byte of the second parameter.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only when TOENTLRG(*NONE) and TOENT(*NONE) is specified, and the last receiver specified on the RCVRNG parameter identifies the journal receiver that is currently attached when journal entries are starting to be received.
|
|
</p>
|
|
<p>When the last entry on the journal has been passed to the exit program and no journal entries are currently available to be passed to the exit program, one of the following occurs:
|
|
</p>
|
|
<ul>
|
|
<li>If a number of seconds is specified for the first element in the list, the exit program is immediately called and a '0' is passed to the first byte of the second exit parameter indicating that no additional journal entries are currently available. When the exit program returns control to the command, the system delays for the specified number of seconds.
|
|
<p>When the delay time has expired, the system then checks whether any additional journal entries are available to be passed to the exit program. Any additional entries are passed to the exit program sequentially, until there are no more available. When there are no further journal entries available, the exit program is called, and a '0' is passed as the first byte of the second exit program parameter, indicating there are no more journal entries currently available. When the exit program returns control to the command, the system again delays for the specified number of seconds.
|
|
</p>
|
|
<p>If there are no new journal entries to pass to the exit program after the delay, the exit program is called, and a '0' is passed as the first byte of the second exit program parameter to indicate that no further journal entries are available. The exit program then passes the value '9' for the first byte of the second parameter, indicating that this command is to end.
|
|
</p>
|
|
</li>
|
|
<li>If *NEXTENT is specified for the first element in the list, then additional journal entries are passed to the exit program as they become available. When this option is used, the second element in the list indicates the maximum number of seconds between calls to the exit program. If there are no additional journal entries to pass after the specified maximum delay time, the exit program is called, and a '0' is passed to the first byte of the second exit program parameter, indicating that no additional journal entries are currently available.
|
|
<p>The maximum delay time can be either of the following:
|
|
</p>
|
|
<ul>
|
|
<li>The time between a call to the exit program passing the last currently available journal entry, and a subsequent call to the exit program indicating that no new journal entries are available.
|
|
</li>
|
|
<li>The time between calls to the exit program indicating that no additional journal entries are available.
|
|
</li>
|
|
</ul>
|
|
<p>If the exit program is called after the maximum delay has expired, it then can pass the value '9' for the first byte of the second parameter, indicating that this command should be ended.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<p>
|
|
<b>Note: </b>The previous description of the DELAY parameter assumes that the journal receiver that is currently attached at the beginning of the RCVJRNE command is still attached. If that journal receiver has been detached, the exit program is sent the reason code 3 after all journal entries have been received by the exit program and the RCVJRNE command ends.
|
|
</p>
|
|
<p><b>Element 1: Delay time value</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>30</u></b></dt>
|
|
<dd>The command delays 30 seconds before checking whether additional journal entries are available to be passed to the exit program.
|
|
</dd>
|
|
<dt><b>*NEXTENT</b></dt>
|
|
<dd>A fixed delay time is not used. Additional journal entries are passed to the exit program as they become available.
|
|
<p>
|
|
<b>Note: </b>If the RCVJRNE exit program causes any additional calls of the RCVJRNE command, those additional calls cannot specify DELAY(*NEXTENT) if a preceding call specified TOENTLRG(*NONE) or TOENT(*NONE).
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>INCENT(*ALL) and DELAY(*NEXTENT) cannot be specified at the same time.
|
|
</p>
|
|
</dd>
|
|
<dt><b><i>seconds</i></b></dt>
|
|
<dd>Specify the number of seconds that the command delays before checking whether additional journal entries are available to be passed to the exit program. Valid values range from 1 through 99999.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Maximum delay time value</b>
|
|
</p>
|
|
<p>This element indicates the maximum number of seconds between calls to the exit program when a fixed delay time is not specified on the first element. This element is valid only if *NEXTENT is specified for the first element.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*CLS</b></dt>
|
|
<dd>The process default wait time is used as the maximum number of seconds between calls to the exit program.
|
|
</dd>
|
|
<dt><b><i>seconds</i></b></dt>
|
|
<dd>Specify the maximum length of time between calls to the exit program, in seconds. Valid values range from 1 through 99999.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.BLKLEN"></a>
|
|
<h3>Block length (BLKLEN)</h3>
|
|
<p>Specifies 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. The EXITPGM parameter has further details about block mode semantics.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>At most one journal entry will be sent to the exit program.
|
|
</dd>
|
|
<dt><b>*CALC</b></dt>
|
|
<dd>One or more journal entries will be passed to the exit program in a block. The length of the block passed (the first parameter passed to the exit program) is determined by the system and will be optimal.
|
|
</dd>
|
|
<dt><b><i>block-length</i></b></dt>
|
|
<dd>Specify the length in kilobytes of the buffer passed to the exit program (EXITPGM parameter). Valid values range from 32 to 4000.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.JRNENTFMT"></a>
|
|
<h3>Journal entry format (JRNENTMFT)</h3>
|
|
<p>Specifies the format of the journal entries received by the exit program. The formats are described in the Retrieve Journal Entries (QjoRetrieveJournalEntries) API. See the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for the details associated with these formats.
|
|
</p>
|
|
<p>This parameter is only valid if ENTFMT(*JRNENTFMT) is also specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>RJNE0100</u></b></dt>
|
|
<dd>Received journal entries are in RJNE0100 format.
|
|
</dd>
|
|
<dt><b>RJNE0200</b></dt>
|
|
<dd>Received journal entries are in RJNE0200 format. While in block mode, a single block of entries will not be received from multiple receivers.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.RTNPTR"></a>
|
|
<h3>Return pointers (RTNPTR)</h3>
|
|
<p>Specifies whether the journal entries received include entry specific data that could contain pointers for specific journal entry types.
|
|
</p>
|
|
<p>This parameter is only valid if ENTFMT(*JRNENTFMT) is also specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>Received journal entries will not include pointers.
|
|
</dd>
|
|
<dt><b>*SYSMNG</b></dt>
|
|
<dd>Specifies that journal entries received include entry specific data that could contain pointers for specific journal entry types. The system will manage the releasing of the resources related to pointers that are received in the journal entries. The pointers, their associated pointer handles and any related storage will be released when the exit program returns control to the system.
|
|
<p>
|
|
<b>Note: </b>NULLINDLEN(*VARLEN) and RTNPTR(*SYSMNG) or RTNPTR(*USRMNG) cannot be specified at the same time.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*USRMNG</b></dt>
|
|
<dd>Specifies that journal entries received include entry specific data that could contain pointers for specific journal entry types. The user will manage the releasing of the resources related to pointers that are received in the journal entries. Neither the pointers, their associated pointer handles or any related storage will be released when the exit program returns control to the system. The user must use the Delete Pointer Handle (QjoDeletePointerHandle) API to release these resources. See the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for the details associated with this API.
|
|
<p>
|
|
<b>Note: </b>NULLINDLEN(*VARLEN) and RTNPTR(*SYSMNG) or RTNPTR(*USRMNG) cannot be specified at the same time.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.INCENT"></a>
|
|
<h3>Include entries (INCENT)</h3>
|
|
<p>Specifies whether only the confirmed or both the confirmed and unconfirmed, journal entries are received. This parameter only applies when receiving journal entries for output from a remote journal.
|
|
</p>
|
|
<p>Confirmed entries are those journal entries which have been sent to this remote journal and the state of the Input/Output (I/O) to auxiliary storage for the same journal entries on the local journal is known.
|
|
</p>
|
|
<p>Unconfirmed entries are those journal entries which have been sent to this remote journal, but the state of the Input/Output (I/O) to auxiliary storage for the same journal entries on the local journal is not known, or the object name information for those journal entries is not yet known to the remote journal. Unconfirmed journal entries can only exist within the attached receiver of a remote journal. This only applies if synchronous delivery mode is being used for a particular remote journal.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CONFIRMED</u></b></dt>
|
|
<dd>Only those journal entries which have been confirmed are received.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All confirmed and unconfirmed journal entries are received.
|
|
<p>
|
|
<b>Note: </b>INCENT(*ALL) and DELAY(*NEXTENT) cannot be specified at the same time.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.FROMENT"></a>
|
|
<h3>Starting sequence number (FROMENT)</h3>
|
|
<p>Specifies the first journal entry considered for reception.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>You can specify a value for either the <b>Starting sequence number (FROMENT)</b> parameter or the <b>Starting large sequence number (FROMENTLRG)</b> parameter, but not for both.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first journal entry in the specified journal receiver range is the first entry considered for reception.
|
|
</dd>
|
|
<dt><b><i>starting-sequence-number</i></b></dt>
|
|
<dd>Specify the sequence number of the first journal entry considered for reception. The possible range is 1 to 9,999,999,999.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.TOENT"></a>
|
|
<h3>Ending sequence number (TOENT)</h3>
|
|
<p>Specifies the last journal entry considered for reception.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>You can specify a value for either the <b>Ending sequence number (TOENT)</b> parameter or the <b>Ending large sequence number (TOENTLRG)</b> parameter, but not for both.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No journal entry is specified. Journal entries are passed to the exit program until the command is canceled (by a cancel request or a cancel job command) or until an end reason code (9) is set by the exit program. If there are no more entries to pass, the RCVJRNE command waits the number of seconds indicated on the DELAY parameter before trying to find more entries to pass.
|
|
<p>
|
|
<b>Note: </b>TOENT(*NONE) is valid only if the RCVRNG parameter specifies a receiver that is currently attached when starting to receive journal entries.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The last journal entry in the journal receiver range specified is the last entry considered for reception.
|
|
</dd>
|
|
<dt><b><i>ending-sequence-number</i></b></dt>
|
|
<dd>Specify the sequence number of the final journal entry considered for reception. The possible range is 1 to 9,999,999,999.
|
|
<p>
|
|
<b>Note: </b>The values specified for the from and to prompts can be the same. For example, FROMENT(234) and TOENT(234) can be specified.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCVJRNE.CMTCYCID"></a>
|
|
<h3>Commit cycle identifier (CMTCYCID)</h3>
|
|
<p>Specifies the journal entries considered for reception based on their associated commit cycle identifier. A commit cycle consists of all journal entries sharing the same commit cycle identifier. A journal entry's commit cycle identifier can be displayed by using the Display Journal (DSPJRN) command and entering option five.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>You can input a value for either the <b>Commit cycle identifier</b> field (CMTCYCID) or the <b>Commit cycle large identifier</b> field (CCIDLRG) but not for both.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The journal entries received are not limited to a specified commit cycle identifier.
|
|
</dd>
|
|
<dt><b><i>commit-cycle-identifier</i></b></dt>
|
|
<dd>Specify the commit cycle identifier of the journal entries to be considered for reception. The possible range is 1 to 9,999,999,999.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RCVJRNE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Receiving Journal Entries</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RCVJRNE JRN(APPLIB/JRN1) EXITPGM(MYLIB/RCVPGM)
|
|
FILE(APPLIB/FILE3) TOENT(*LAST) ENTFMT(*TYPE3)
|
|
NULLINDLEN(*ENTFMT)
|
|
</pre>
|
|
</p>
|
|
<p>This command receives journal entries from the journal receiver that is currently attached (when journal entries are starting to be received) to the journal JRN1 in library APPLIB and passes them one at a time to program RCVPGM in library MYLIB. Only entries with file-level information for the first member of file FILE3 in library APPLIB are received. The format of each entry passed to the exit program is shown in the "NULLINDLEN(*ENTFMT) Journal Entry Format for ENTFMT(*TYPE3)" table shown within the NULLINDLEN parameter description.
|
|
</p>
|
|
<p><b>Example 2: Receiving Journal Entries</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RCVJRNE JRN(JRNLIB/MYJRN) EXITPGM(RCVLIB/PGMA)
|
|
FILE(FILELIB/PFILEB MBRONE)
|
|
TOENT(*LAST) ENTFMT(*TYPE3) NULLINDLEN(*VARLEN 30)
|
|
</pre>
|
|
</p>
|
|
<p>This command receives journal entries with file-level information for member MBRONE of file PFILEB in library FILELIB from the journal receiver currently attached (when journal entries are starting to be received) to journal MYJRN in library JRNLIB and sends them one at a time to program PGMA in library RCVLIB. The format of each entry passed to the exit program is shown in the "NULLINDLEN(*VARLEN field-length) Journal Entry Format for ENTFMT(*TYPE3)" table at the end of the NULLINDLEN parameter description. The null value indicators portion of each received entry is 30 characters in length.
|
|
</p>
|
|
<p><b>Example 3: Receiving Journal Entries Using DELAY(*NEXTENT)</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RCVJRNE JRN(JRNLIB/MYJRN) EXITPGM(RCVLIB/PGMA)
|
|
RCVRNG(*CURCHAIN) TOENT(*NONE) DELAY(*NEXTENT)
|
|
</pre>
|
|
</p>
|
|
<p>This command receives all available journal entries from the chain of journal receivers, which includes the journal receiver that is attached at the start of receiving journal entries, associated with the journal MYJRN in the library JRNLIB. These journal entries are sent sequentially to exit program PGMA in library RCVLIB, as they become available. The maximum length of time between calls to the exit program is equal to the process default wait time value.
|
|
</p>
|
|
<p><b>Example 4: Receiving Journal Entries for Data Area, Data Queue, and Integrated File System Objects</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RCVJRNE JRN(LIBPROD/PRODJRN) EXITPGM(RCVLIB/PGMA)
|
|
OBJ((APPLIB/D1 *DTAARA) (APPLIB/D2 *DTAQ)
|
|
(APPLIB/D3 *FILE *NONE))
|
|
OBJPATH(('/mydirectory')) SUBTREE(*YES)
|
|
TOENT(*LAST) ENTFMT(*JRNENTFMT) JRNENTFMT(RJNE0200)
|
|
</pre>
|
|
</p>
|
|
<p>This command receives journal entries from the journal receiver currently attached (when journal entries are starting to be received) to journal PRODJRN in library LIBPROD and sends them one at a time to program PGMA in library RCVLIB. The format of each entry passed to the exit program is shown in the "NULLINDLEN(*ENTFMT) Journal Entry Format for ENTFMT(*JRNENTFMT) when JRNENTFMT(RJNE0200) is specified" table at the end of the NULLINDLEN parameter description. Only entries associated with the specified objects are converted. These objects are a data area in library APPLIB called D1, a data queue in library APPLIB called D2, and a database file D3 in library APPLIB, as well as the directory '/mydirectory' and all directories, stream files, and symbolic links within that directory or one of its subdirectories.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RCVJRNE.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF7002</b></dt>
|
|
<dd>File &1 in library &2 not a physical file.
|
|
</dd>
|
|
<dt><b>CPF7006</b></dt>
|
|
<dd>Member &3 not found in file &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF7007</b></dt>
|
|
<dd>Cannot allocate member &3 file &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF701B</b></dt>
|
|
<dd>Journal recovery of an interrupted operation failed.
|
|
</dd>
|
|
<dt><b>CPF705C</b></dt>
|
|
<dd>INCENT(*ALL) not allowed for a local journal.
|
|
</dd>
|
|
<dt><b>CPF7053</b></dt>
|
|
<dd>Values for RCVRNG parameter not correct; reason code &1.
|
|
</dd>
|
|
<dt><b>CPF7054</b></dt>
|
|
<dd>FROM and TO values not valid.
|
|
</dd>
|
|
<dt><b>CPF7055</b></dt>
|
|
<dd>Maximum number of objects exceeded.
|
|
</dd>
|
|
<dt><b>CPF7057</b></dt>
|
|
<dd>*LIBL not allowed with FILE(*ALL) or OBJ(*ALL).
|
|
</dd>
|
|
<dt><b>CPF706A</b></dt>
|
|
<dd>Significant null value indicator truncated.
|
|
</dd>
|
|
<dt><b>CPF706D</b></dt>
|
|
<dd>RCVJRNE exit program &1 in &2 failed.
|
|
</dd>
|
|
<dt><b>CPF7060</b></dt>
|
|
<dd>Object not found and not journaled in specified receiver range.
|
|
</dd>
|
|
<dt><b>CPF7061</b></dt>
|
|
<dd>Conversion of journal entries failed.
|
|
</dd>
|
|
<dt><b>CPF7062</b></dt>
|
|
<dd>No entries converted or received from journal &1.
|
|
</dd>
|
|
<dt><b>CPF7065</b></dt>
|
|
<dd>Entry type (ENTTYP) not valid for journal code (JRNCDE).
|
|
</dd>
|
|
<dt><b>CPF707B</b></dt>
|
|
<dd>DELAY(*NEXTENT) not allowed.
|
|
</dd>
|
|
<dt><b>CPF7074</b></dt>
|
|
<dd>RCVRNG for specified SEARCH not valid.
|
|
</dd>
|
|
<dt><b>CPF708C</b></dt>
|
|
<dd>DELAY(*NEXTENT) not allowed with INCENT(*ALL).
|
|
</dd>
|
|
<dt><b>CPF708D</b></dt>
|
|
<dd>Journal receiver found logically damaged.
|
|
</dd>
|
|
<dt><b>CPF709C</b></dt>
|
|
<dd>JOB, PGM, and USRPRF not valid for receiver range.
|
|
</dd>
|
|
<dt><b>CPF7096</b></dt>
|
|
<dd>Ending receiver for RCVRNG must identify an attached receiver.
|
|
</dd>
|
|
<dt><b>CPF70A9</b></dt>
|
|
<dd>OBJPATH parameter not valid for a remote journal.
|
|
</dd>
|
|
<dt><b>CPF70AC</b></dt>
|
|
<dd>File identifier &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9801</b></dt>
|
|
<dd>Object &2 in library &3 not found.
|
|
</dd>
|
|
<dt><b>CPF9802</b></dt>
|
|
<dd>Not authorized to object &2 in &3.
|
|
</dd>
|
|
<dt><b>CPF9803</b></dt>
|
|
<dd>Cannot allocate object &2 in library &3.
|
|
</dd>
|
|
<dt><b>CPF9809</b></dt>
|
|
<dd>Library &1 cannot be accessed.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF9822</b></dt>
|
|
<dd>Not authorized to file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9825</b></dt>
|
|
<dd>Not authorized to device &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCVJRNE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|