216 lines
17 KiB
HTML
216 lines
17 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="Receiver size options for journals" />
|
|||
|
|
<meta name="abstract" content="A journal receiver holds journal entries that you might use for recovery and entries that the system might use for recovery. For example, you might use record level entries, such as database record changes, and file level entries, such as the entry for opening or closing a file. Also, the system writes entries that you never see or use, such as entries for explicitly journaled access paths, for SMAPP, or for commitment control." />
|
|||
|
|
<meta name="description" content="A journal receiver holds journal entries that you might use for recovery and entries that the system might use for recovery. For example, you might use record level entries, such as database record changes, and file level entries, such as the entry for opening or closing a file. Also, the system writes entries that you never see or use, such as entries for explicitly journaled access paths, for SMAPP, or for commitment control." />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakiplnjrnsu.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakieffectsperform.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakijrnsysperform.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakiguivsgs.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakiplnuseaux.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakidiskarm.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakireducesize.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakithreshold.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakimanorsysmng.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/crtjrn.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/chgjrn.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/dspjrnrcva.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/apyjrnchg.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/apyjrnchgx.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/cmpjrnimg.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/dspjrn.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/rcvjrne.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/rmvjrnchg.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/rtvjrne.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="../apis/QJORJRNE.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakiintrusion.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakiintrusion.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="rzakisizeoptions" />
|
|||
|
|
<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>Receiver size options for journals</title>
|
|||
|
|
</head>
|
|||
|
|
<body id="rzakisizeoptions"><a name="rzakisizeoptions"><!-- --></a>
|
|||
|
|
<img src="./delta.gif" alt="Start of change" /><!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|||
|
|
<h1 class="topictitle1">Receiver size options for journals</h1>
|
|||
|
|
<div><p>A journal receiver holds journal entries that you might use for
|
|||
|
|
recovery and entries that the system might use for recovery. For example,
|
|||
|
|
you might use record level entries, such as database record changes, and file
|
|||
|
|
level entries, such as the entry for opening or closing a file. Also, the
|
|||
|
|
system writes entries that you never see or use, such as entries for explicitly
|
|||
|
|
journaled access paths, for SMAPP, or for commitment control.</p>
|
|||
|
|
<p>When you create a journal with the Create Journal (CRTJRN) command, the
|
|||
|
|
Change Journal (CHGJRN) command, or iSeries™ Navigator, you can specify options
|
|||
|
|
that will limit the data that gets deposited into these journal entries, or
|
|||
|
|
increases the maximum allowable size for the journal receiver. These options
|
|||
|
|
are as follows:</p>
|
|||
|
|
<ul><li>The RCVSIZOPT parameter of the CRTJRN command</li>
|
|||
|
|
<li>The RCVSIZOPT parameter of the CHGJRN command</li>
|
|||
|
|
<li>The <span class="uicontrol">Advanced Journal Attributes</span> dialog box of iSeries Navigator</li>
|
|||
|
|
<li>The <span class="uicontrol">Journal Properties</span> dialog box of iSeries Navigator</li>
|
|||
|
|
</ul>
|
|||
|
|
<div class="note"><span class="notetitle">Note:</span> Specifying *SYSDFT for the RCVSIZOPT parameter is the same as specifying
|
|||
|
|
RCVSIZOPT(*MAXOPT2 *RMVINTENT).</div>
|
|||
|
|
<p>The following subtopics explain the benefits of some of the values for
|
|||
|
|
receiver size options.</p>
|
|||
|
|
<div class="section"><h4 class="sectiontitle">Remove internal entries</h4><p>When you specify to remove
|
|||
|
|
internal entries the system periodically removes internal journal entries
|
|||
|
|
from the attached journal receiver when it no longer needs them for recovery
|
|||
|
|
purposes. Removing internal entries may have a very slight impact on system
|
|||
|
|
performance, because the system has to manage these internal entries separately
|
|||
|
|
and periodically remove them.</p>
|
|||
|
|
<p>To remove internal entries specify the
|
|||
|
|
RCVSIZOPT(*RMVINTENT) parameter. The iSeries Navigator equivalent to the RCVSIZOPT(*RMVINTENT)
|
|||
|
|
parameter is <span class="uicontrol">Remove internal entries</span> in the <span class="uicontrol">Advanced
|
|||
|
|
Journal Attributes</span> or <span class="uicontrol">Journal Properties</span> dialog.</p>
|
|||
|
|
<p>Specifying
|
|||
|
|
to remove internal entries has these benefits:</p>
|
|||
|
|
<ul><li>It reduces the impact that SMAPP may have on journal receivers for user-created
|
|||
|
|
journals.</li>
|
|||
|
|
<li>It reduces the size of journal receivers that are on the system.</li>
|
|||
|
|
<li>It reduces the amount of time and media required to save journal receivers,
|
|||
|
|
because unnecessary entries are not saved.</li>
|
|||
|
|
<li>It reduces the time that it takes to apply journal entries, because the
|
|||
|
|
system does not have to evaluate unnecessary entries.</li>
|
|||
|
|
<li>It reduces the communications overhead if the remote journal function
|
|||
|
|
is being used because unnecessary entries are not sent.</li>
|
|||
|
|
</ul>
|
|||
|
|
</div>
|
|||
|
|
<div class="section"><h4 class="sectiontitle">Minimize fixed-length portion of entries</h4><p>Minimizing
|
|||
|
|
the fixed-length portion of entries has the following effects:</p>
|
|||
|
|
<ul><li>All information selectable by the FIXLENDTA parameter is not deposited
|
|||
|
|
in the entries.</li>
|
|||
|
|
<li>Minimizing the fixed-length portion of entries reduces auxiliary storage
|
|||
|
|
space and some CPU time as well.</li>
|
|||
|
|
<li>When you view journal entries with this information removed, the displayed
|
|||
|
|
value is *OMITTED, blanks, or zeros, depending on the type of data.</li>
|
|||
|
|
<li>To determine if a journal receiver was attached to a journal while minimizing
|
|||
|
|
the fixed-length portion of entries, use the Display Journal Receiver Attributes
|
|||
|
|
DSPJRNRCVA command display.</li>
|
|||
|
|
<li>Do not use minimize the fixed-length portion of entries if you require
|
|||
|
|
an audit trail.</li>
|
|||
|
|
<li>Minimizing the fixed-length portion of entries limits the selection criteria
|
|||
|
|
you can use on the following: <ul><li>Apply Journaled Changes (APYJRNCHG) command</li>
|
|||
|
|
<li>Apply Journaled Changes Extend (APYJRNCHGX) command</li>
|
|||
|
|
<li>Compare Journal Images (CMPJRNIMG) command</li>
|
|||
|
|
<li>Display Journal (DSPJRN) command</li>
|
|||
|
|
<li>Receive Journal Entry (RCVJRNE) command</li>
|
|||
|
|
<li>Remove Journaled Changes (RMVJRNCHG) command</li>
|
|||
|
|
<li>Retrieve Journal Entry (RTVJRNE) command</li>
|
|||
|
|
<li>Retrieve Journal Entries (QjoRetrieveJournalEntries) API</li>
|
|||
|
|
</ul>
|
|||
|
|
</li>
|
|||
|
|
<li>Minimizing the fixed-length portion of entries reduces the communications
|
|||
|
|
overhead if the remote journal function is being used because unnecessary
|
|||
|
|
data is not sent.</li>
|
|||
|
|
</ul>
|
|||
|
|
<p>To minimize the fixed-length portion of entries specify RCVSIZOPT(*MINFIXLEN).
|
|||
|
|
The iSeries Navigator
|
|||
|
|
equivalent to RCVSIZOPT(*MINFIXLEN) is <span class="uicontrol">Minimize fixed portion of
|
|||
|
|
entries</span> in the <span class="uicontrol">Advanced Journal Attributes</span> or <span class="uicontrol">Journal
|
|||
|
|
Properties</span> dialog.</p>
|
|||
|
|
<p>If you are using minimizing the fixed-length
|
|||
|
|
portion of entries, you cannot use the FIXLENDTA parameter. See Fixed-length
|
|||
|
|
options for journal entries for more information about the FIXLENDTA parameter.</p>
|
|||
|
|
</div>
|
|||
|
|
<div class="section"><h4 class="sectiontitle">Maximum receiver-size options</h4><p>Use the following
|
|||
|
|
options to specify the maximum allowable size for your journal receivers and
|
|||
|
|
to specify the largest allowable sequence numbers for journal entries. There
|
|||
|
|
is no iSeries Navigator
|
|||
|
|
equivalent to the following options.</p>
|
|||
|
|
<dl><dt class="dlterm"><img src="./delta.gif" alt="Start of change" />RCVSIZOPT(*SYSDFT)<img src="./deltaend.gif" alt="End of change" /></dt>
|
|||
|
|
<dd>Using RCVSIZOPT(*SYSDFT) is currently the same as specifying RCVSIZOPT(*RMVINTENT
|
|||
|
|
*MAXOPT2). This the default. </dd>
|
|||
|
|
<dt class="dlterm" id="rzakisizeoptions__maxopt1"><a name="rzakisizeoptions__maxopt1"><!-- --></a><img src="./delta.gif" alt="Start of change" />RCVSIZOPT(*MAXOPT1)<img src="./deltaend.gif" alt="End of change" /></dt>
|
|||
|
|
<dd>Use RCVSIZOPT(*MAXOPT1) to set the maximum size of a journal receiver
|
|||
|
|
attached to your journal to approximately one terabyte (1 099 511 627 776
|
|||
|
|
bytes) and a maximum sequence number of 9 999 999 999. Additionally,
|
|||
|
|
the maximum size of the journal entry which can be deposited is 15 761 440
|
|||
|
|
bytes.</dd>
|
|||
|
|
<dt class="dlterm">RCVSIZOPT(*MAXOPT2)</dt>
|
|||
|
|
<dd>Use RCVSIZOPT(*MAXOPT2) to set the maximum size of a journal
|
|||
|
|
receiver attached to your journal to approximately one terabyte (1 099 511 627 776
|
|||
|
|
bytes) and a maximum sequence number of 9 999 999 999. However,
|
|||
|
|
with RCVSIZOPT(*MAXOPT2), the system can deposit a journal entry as large
|
|||
|
|
as 4 000 000 000 bytes. </dd>
|
|||
|
|
<dt class="dlterm">RCVSIZOPT(*MAXOPT3)</dt>
|
|||
|
|
<dd> Use RCVSIZOPT(*MAXOPT3) to set the maximum size of a journal receiver
|
|||
|
|
attached to your journal to approximately one terabyte (1 099 511 627 776
|
|||
|
|
bytes). In addition, with RCVSIZOPT(*MAXOPT3) the journal receiver can have
|
|||
|
|
a maximum sequence number of 18 446 744 073 709 551 600.
|
|||
|
|
With RCVSIZOPT(*MAXOPT3), the system can deposit a journal entry as large
|
|||
|
|
as 4 000 000 000 bytes. You cannot save or restore these journal
|
|||
|
|
receivers to any releases before V5R3M0. Nor can you replicate them to any
|
|||
|
|
remote journals on any systems at a release before V5R3M0.<p>If you use RCVSIZOPT(*MAXOPT3)
|
|||
|
|
you must use the FROMENTLRG and TOENTLRG parameters to specify a journal entry
|
|||
|
|
sequence number larger than 9 999 999 999 when you perform
|
|||
|
|
the following commands:</p>
|
|||
|
|
<ul><li>APYJRNCHG</li>
|
|||
|
|
<li>APYJRNCHGX</li>
|
|||
|
|
<li>CMPJRNIMG</li>
|
|||
|
|
<li>DSPJRN</li>
|
|||
|
|
<li>RCVJRNE</li>
|
|||
|
|
<li>RMVJRNCHG</li>
|
|||
|
|
<li>RTVJRNE</li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</div>
|
|||
|
|
<div class="section"><h4 class="sectiontitle">Recovery count</h4><p><img src="./delta.gif" alt="Start of change" />A value of *SYSDFT resets
|
|||
|
|
the journal's recovery count to the system default journal recovery count.
|
|||
|
|
The Work with journal attributes (WRKJRNA) command will indicate the Journal
|
|||
|
|
recovery count on the panel display and in the printed output. A value of
|
|||
|
|
*SYSDFT will be displayed if the system default journal recovery count is
|
|||
|
|
being used.<img src="./deltaend.gif" alt="End of change" /></p>
|
|||
|
|
<p>The Retrieve Journal Information (QjoRetrieveJournalInformation)
|
|||
|
|
API will also return the Journal Recovery Count. A value of ‘0’ will be returned
|
|||
|
|
if the system default journal recovery count is being used.</p>
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
<div>
|
|||
|
|
<div class="familylinks">
|
|||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakiplnjrnsu.htm" title="The following topics provide information to plan configuration for journals. They provide information about each option that you can select for journal.">Plan setup for journals</a></div>
|
|||
|
|
</div>
|
|||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
|||
|
|
<div><a href="rzakieffectsperform.htm" title="System-managed access-path protection (SMAPP) is designed to have minimal affect to your system. Though it is minimal, SMAPP does affect your system's processor performance and auxiliary storage.">Effects of SMAPP on performance and storage</a></div>
|
|||
|
|
<div><a href="rzakijrnsysperform.htm" title="Journal management prevents transactions from being lost if your system ends abnormally or has to be recovered. To do this, journal management writes changes to journaled objects immediately to the journal receiver in auxiliary storage. This increases the disk activity on your system and can have a noticeable affect on system performance. Journaling also increases the overhead associated with opening objects and closing objects.">Journal management and system performance</a></div>
|
|||
|
|
<div><a href="rzakiguivsgs.htm" title="There are two environments that you can use for journal management: iSeries Navigator and the character-based interface. iSeries Navigator provides a graphical interface for journaling that is easy to use and does not require the use of control language (CL) commands. The character-based interface requires the use of CL commands or APIs, but has more functionality than iSeries Navigator.">iSeries Navigator versus the character-based interface for journaling objects</a></div>
|
|||
|
|
<div><a href="rzakiplnuseaux.htm" title="If you are journaling an object, journal management writes a copy of every object change to the journal receiver. It writes additional entries for object level activity, such as opening and closing the object, adding a member, or changing an object attribute. If you have a busy system and journal many objects, your journal receivers can quickly become very large.">Plan for journal use of auxiliary storage</a></div>
|
|||
|
|
<div><a href="rzakidiskarm.htm" title="Journaling affects the disk arms that store the journal receiver.">Frequently asked questions about journaling and disk arm usage</a></div>
|
|||
|
|
<div><a href="rzakireducesize.htm" title="Reduce the size of journal entries by methods such as journaling after-images only, or specifying certain journaling options including the Fixed Length Data (FIXLENDTA) option on the Create Journal (CRTJRN) and Change Journal (CHGJRN) commands.">Methods to reduce the storage that journal receivers use</a></div>
|
|||
|
|
<div><a href="rzakithreshold.htm" title="When you create a journal receiver with iSeries Navigator or the Create Journal Receiver (CRTJRNRCV) command, you specify a disk space threshold that indicates when you want the system to warn you or take action.">Threshold (disk space) for journal receivers</a></div>
|
|||
|
|
<div><a href="rzakimanorsysmng.htm" title="When you create a journal with iSeries Navigator or the Create Journal (CRTJRN) command, you can select to have either system managed or user managed journal receivers.">Manual versus system journal-receiver management</a></div>
|
|||
|
|
<div><a href="rzakiintrusion.htm" title="You can use the Fixed Length Data (FIXLENDTA) parameter of Create Journal (CRTJRN) and Change Journal (CHGJRN) commands to audit security related activity for journaled objects on your system.">Fixed-length options for journal entries</a></div>
|
|||
|
|
</div>
|
|||
|
|
<div class="relref"><strong>Related reference</strong><br />
|
|||
|
|
<div><a href="../cl/crtjrn.htm">Create Journal (CRTJRN) command</a></div>
|
|||
|
|
<div><a href="../cl/chgjrn.htm">Change Journal (CHGJRN) command</a></div>
|
|||
|
|
<div><a href="../cl/dspjrnrcva.htm">Display Journal Receiver Attributes (DSPJRNRCVA) command</a></div>
|
|||
|
|
<div><a href="../cl/apyjrnchg.htm">Apply Journaled Changes (APYJRNCHG) command</a></div>
|
|||
|
|
<div><a href="../cl/apyjrnchgx.htm">Apply Journaled Changes Extend (APYJRNCHGX) command</a></div>
|
|||
|
|
<div><a href="../cl/cmpjrnimg.htm">Compare Journal Images (CMPJRNIMG) command</a></div>
|
|||
|
|
<div><a href="../cl/dspjrn.htm">Display Journal (DSPJRN) command</a></div>
|
|||
|
|
<div><a href="../cl/rcvjrne.htm">Receive Journal Entry (RCVJRNE) command</a></div>
|
|||
|
|
<div><a href="../cl/rmvjrnchg.htm">Remove Journaled Changes (RMVJRNCHG) command</a></div>
|
|||
|
|
<div><a href="../cl/rtvjrne.htm">Retrieve Journal Entry (RTVJRNE) command</a></div>
|
|||
|
|
<div><a href="../apis/QJORJRNE.htm">Retrieve Journal Entries (QjoRetrieveJournalEntries) API</a></div>
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
<img src="./deltaend.gif" alt="End of change" /></body>
|
|||
|
|
</html>
|