ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaki_5.4.0.1/rzakiaddprocess.htm

147 lines
10 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="Add remote journal process" />
<meta name="abstract" content="Adding a remote journal creates a remote journal on a target system or independent disk pool and associates that remote journal with the journal on the source system. This occurs if this is the first time the remote journal is being established for a journal. The journal on the source system can be either a local or remote journal." />
<meta name="description" content="Adding a remote journal creates a remote journal on a target system or independent disk pool and associates that remote journal with the journal on the source system. This occurs if this is the first time the remote journal is being established for a journal. The journal on the source system can be either a local or remote journal." />
<meta name="DC.Relation" scheme="URI" content="rzakirconcepts.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakiredirect.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakirattributes.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakitwotypes.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakirnetworks.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakisynch.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakiaddremj.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="rzakiaddprocess" />
<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>Add remote journal process</title>
</head>
<body id="rzakiaddprocess"><a name="rzakiaddprocess"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Add remote journal process</h1>
<div><p>Adding a remote journal creates a remote journal on a target system
or independent disk pool and associates that remote journal with the journal
on the source system. This occurs if this is the first time the remote journal
is being established for a journal. The journal on the source system can be
either a local or remote journal.</p>
<p>If a remote journal environment has previously been established, adding
a remote journal re-associates the remote journal on the target system with
the journal on the source system.</p>
<p>You can establish and associate a remote journal on a target system with
a journal on the source system by one of the following methods:</p>
<ul><li>iSeries™ Navigator.</li>
<li>Add Remote Journal (QjoAddRemoteJournal) API on the source system.</li>
<li>Add Remote Journal (ADDRMTJRN) command on the source system.</li>
</ul>
<div class="section"><h4 class="sectiontitle">What happens during add remote journal processing</h4><p>Some
of the processing which takes place as part of adding a remote journal is
as follows:</p>
<ul><li>A check is performed on the target system to verify that the user profile
adding the remote journal exists. A user profile with the same name as the
user profile which is adding a remote journal must exist on the target system.
If the profile does not exist on the target system, then an exception is signaled,
and the processing ends.</li>
<li>A check is performed to verify that the target system has a library by
the same name as the library for the journal on the source system. If the
library does not exist on the target system, then an exception is signaled,
and the processing ends.</li>
<li>A check is performed on the target system to determine if a journal by
the same qualified name as the journal on the source system already exists.
If a journal already exists, it can be used for the remainder of the add remote
journal processing if it meets the following conditions: <ol><li>It is a remote journal.</li>
<li>It was previously associated with this same source journal or part of
the same remote journal network.</li>
<li>The type of the remote journal matches the specified remote journal type.</li>
</ol>
</li>
<li>If a journal was found, but does not meet the above criteria, then an
exception is signaled, and the processing ends. Otherwise, the remote journal
is used for the rest of the add remote journal processing.</li>
<li>If no journal is found on the specified target system, then a remote journal
is created on the target system. The new remote journal has the same configuration,
authority, and audit characteristics of the source journal. The journal that
is created has a journal type of *REMOTE.</li>
</ul>
<p>The creation of the journal on the target system is performed as though
the journal was being saved and restored to the target system. Therefore,
the ownership of the journal on a target system will follow the same rules
as with the existing save and restore functions. If the user profile which
owns the journal on the source system is on the target system, then that profile
will own the created journal on the target system. If the user profile does
not exist on the target system, then the profile QDFTOWN will own the journal
on the target system.</p>
<p>Additionally, if the remote journal is created,
the values for the journal attributes of text, journal message queue, delete
receivers value, and delete receiver delay time will be taken from what is
specified on the API invocation. After the remote journal has been created,
these values can be changed by using the Change Journal (CHGJRN) command for
the remote journal on the remote system. After the remote journal is created,
any changes to these attributes on the source journal will not cause equivalent
changes to the remote journal. See Remote journal attributes for more information.</p>
<p>When
adding the remote journal, you must specify the type of remote journal to
add. The remote journal type influences the library redirection rules and
other operational characteristics for the journal. See Types of remote journals
for more information.</p>
</div>
<div class="section"><h4 class="sectiontitle">Guidelines for adding a remote journal</h4><p>The following
are guidelines for adding a remote journal:</p>
<ul><li>You can only associate a remote journal with a single source journal.<div class="note"><span class="notetitle">Note:</span> The
same remote journal can then have additional remote journals that are associated
with it that are located on other target systems. This is the cascade configuration
that is shown in Network configurations for remote journals.</div>
</li>
<li>The remote journal will only have its attached receiver populated with
journal entries that are replicated from the corresponding journal receiver
on the source system. No journal entries can be directly deposited to a remote
journal.</li>
<li>A maximum of 255 remote journals can be associated with a single journal
on a source system. This can be any combination of asynchronously maintained
or synchronously maintained remote journals. </li>
</ul>
<p>Synchronous and asynchronous delivery mode has more information.
Library redirection with remote journals and Remote journal attributes provide
more concepts about the add remote journal process. Add remote journals provides
the steps for adding a remote journal.</p>
</div>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="rzakiredirect.htm">Library redirection with remote journals</a></strong><br />
<span class="uicontrol">Library redirection</span> provides a means for
remote journals and any of their associated journal receivers to optionally
reside in differently named libraries on the target system from the corresponding
local journal and journal receivers on the local system.</li>
<li class="ulchildlink"><strong><a href="rzakirattributes.htm">Remote journal attributes</a></strong><br />
When a remote journal is created by the add remote journal processing, the remote journal's initial attributes are defined by the add request and the source journal.</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakirconcepts.htm" title="Remote journal management helps to efficiently replicate journal entries to one or more systems. You can use remote journal management with application programs to maintain a data replica. A data replica is a copy of the original data that resides on another iSeries server or independent disk pool. The original data resides on a primary system. Applications make changes to the original data during normal operations.">Remote journal concepts</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rzakitwotypes.htm" title="The two types of remote journals are *TYPE1 and *TYPE2. The two types identify operational characteristics of a remote journal and its associated journal receivers. The following table is an overview of the different remote journal types and their characteristics. There are no performance differences between the types of remote journals.">Types of remote journals</a></div>
<div><a href="rzakirnetworks.htm" title="This topic describes various network configuration for remote journals.">Network configurations for remote journals</a></div>
<div><a href="rzakisynch.htm" title="The terms asynchronously maintained and synchronously maintained both describe a remote journal function delivery mode for journal entry replication.">Synchronous and asynchronous delivery mode for remote journals</a></div>
</div>
<div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="rzakiaddremj.htm" title="This topic provides instructions for adding a remote journal.">Add remote journals</a></div>
</div>
</div>
</body>
</html>