80 lines
6.1 KiB
HTML
80 lines
6.1 KiB
HTML
|
<?xml version="1.0" encoding="UTF-8"?>
|
||
|
|
<!DOCTYPE html
|
||
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
|
<html lang="en-us" xml:lang="en-us">
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
|
<meta name="security" content="public" />
|
||
|
|
<meta name="Robots" content="index,follow" />
|
||
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
|
|
<meta name="DC.Type" content="concept" />
|
||
|
|
<meta name="DC.Title" content="Send your own journal entries" />
|
||
|
|
<meta name="abstract" content="Use the Send Journal Entry (SNDJRNE) command or the Send Journal Entry (QJOSJRNE) API to add your own entries to a journal. The system places these entries in the journal's attached journal receiver along with the system-created journal entries." />
|
||
|
|
<meta name="description" content="Use the Send Journal Entry (SNDJRNE) command or the Send Journal Entry (QJOSJRNE) API to add your own entries to a journal. The system places these entries in the journal's attached journal receiver along with the system-created journal entries." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakimanagejrn.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakiplnobjrn.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakiapywthtrig.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakicodes.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2004, 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2004, 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rzakisndjrne" />
|
||
|
|
<meta name="DC.Language" content="en-us" />
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
|
|
<title>Send your own journal entries</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakisndjrne"><a name="rzakisndjrne"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Send your own journal entries</h1>
|
||
|
|
<div><p>Use the Send Journal Entry (SNDJRNE) command or the Send Journal
|
||
|
|
Entry (QJOSJRNE) API to add your own entries to a journal. The system places
|
||
|
|
these entries in the journal's attached journal receiver along with the system-created
|
||
|
|
journal entries.</p>
|
||
|
|
<p>To help identify your entries, you can associate each entry with a particular
|
||
|
|
journaled object. If you use the QJOSJRNE API, you can include the commit
|
||
|
|
cycle identifier with the journal entry and send a larger amount of entry-specific
|
||
|
|
data.</p>
|
||
|
|
<p>You may add entries to the journal to identify significant events (such
|
||
|
|
as a checkpoint) or to help in the recovery of your applications. On the SNDJRNE
|
||
|
|
command, the data specified on the ENTDTA parameter becomes the <span class="uicontrol">Entry-Specific
|
||
|
|
Data</span> field in the journal entry, and the TYPE parameter value
|
||
|
|
becomes the <span class="uicontrol">entry type</span> field. On the QJOSJRNE API,
|
||
|
|
you use the entry data parameter to specify the entry-specific data and the
|
||
|
|
journal entry type parameter to specify the entry type. For both the command
|
||
|
|
and API deposits, the entries journal code is 'U'.</p>
|
||
|
|
<p><img src="./delta.gif" alt="Start of change" />The maximum user entry data size for the QJOSJRNE API is 15
|
||
|
|
MB, which is the maximum journal entry size for a journal that does not have
|
||
|
|
one of the receiver maximums chosen (RCVSIZOPT(*MAXOPT1/*MAXOPT2/*MAXOPT3)).
|
||
|
|
If the length of the entry data is greater than 32KB, then a pointer to the
|
||
|
|
entry data will be returned when retrieving the entry. If the retrieve interface
|
||
|
|
is expecting pointers, the data can be accessed through the pointer returned
|
||
|
|
on the retrieve. Otherwise, the data returned by the retrieve interface will
|
||
|
|
be *POINTER.<img src="./deltaend.gif" alt="End of change" /></p>
|
||
|
|
<p><img src="./delta.gif" alt="Start of change" />The QJOSJRNE API optionally returns the following values in
|
||
|
|
the location specified by the receiver variable:<img src="./deltaend.gif" alt="End of change" /></p>
|
||
|
|
<img src="./delta.gif" alt="Start of change" /><ul><li><img src="./delta.gif" alt="Start of change" />Number of bytes returned in the receiver variable<img src="./deltaend.gif" alt="End of change" /></li>
|
||
|
|
<li><img src="./delta.gif" alt="Start of change" />Number of bytes available that could have been returned in
|
||
|
|
the receiver variable<img src="./deltaend.gif" alt="End of change" /></li>
|
||
|
|
<li><img src="./delta.gif" alt="Start of change" />Sequence number of the journal entry that was just deposited<img src="./deltaend.gif" alt="End of change" /></li>
|
||
|
|
<li><img src="./delta.gif" alt="Start of change" />Journal receiver name<img src="./deltaend.gif" alt="End of change" /></li>
|
||
|
|
<li><img src="./delta.gif" alt="Start of change" />Journal receiver library<img src="./deltaend.gif" alt="End of change" /></li>
|
||
|
|
<li><img src="./delta.gif" alt="Start of change" />Independent Auxiliary Storage Pool (IASP) name <img src="./deltaend.gif" alt="End of change" /></li>
|
||
|
|
</ul><img src="./deltaend.gif" alt="End of change" />
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakimanagejrn.htm" title="Provides tasks to manage your journaling environment.">Manage journals</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="rzakiplnobjrn.htm" title="When you plan which objects to journal, consider the following:">Plan which objects to journal</a></div>
|
||
|
|
<div><a href="rzakiapywthtrig.htm" title="The system does not call trigger programs when it is applying or removing journal entries.">Journaled changes with trigger programs</a></div>
|
||
|
|
<div><a href="rzakicodes.htm" title="This topic provides a description of all of the journal codes and categories.">Journal code descriptions</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|