147 lines
10 KiB
HTML
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>
|