196 lines
12 KiB
HTML
196 lines
12 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="Naming conventions for journal receivers" />
|
||
|
|
<meta name="abstract" content="When you create a journal receiver either with iSeries Navigator or the Create Journal Receiver (CRTJRNRCV) command, you assign a name to the journal receiver." />
|
||
|
|
<meta name="description" content="When you create a journal receiver either with iSeries Navigator or the Create Journal Receiver (CRTJRNRCV) command, you assign a name to the journal receiver." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakiplnrcv.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakimanorsysmng.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="rzakinamercv" />
|
||
|
|
<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>Naming conventions for journal receivers</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakinamercv"><a name="rzakinamercv"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Naming conventions for journal receivers</h1>
|
||
|
|
<div><p>When you create a journal receiver either with iSeries™ Navigator
|
||
|
|
or the Create Journal Receiver (CRTJRNRCV) command, you assign a name to the
|
||
|
|
journal receiver.</p>
|
||
|
|
<p>When you use iSeries Navigator
|
||
|
|
or the Change Journal (CHGJRN) command to detach the current journal receiver
|
||
|
|
and create and attach a new receiver, you can assign a name or have the system
|
||
|
|
generate one. If you use system journal-receiver management, the system generates
|
||
|
|
the name when it detaches a receiver and creates and attaches a new one.</p>
|
||
|
|
<p>If you plan to have more than one journal on your system, use a naming
|
||
|
|
convention that links each journal with its associated receiver.</p>
|
||
|
|
<p>To simplify recovery and avoid confusion, make each journal receiver name
|
||
|
|
unique for your entire system, not unique within a library. If you have two
|
||
|
|
journal receivers with the same name in different libraries and they both
|
||
|
|
become damaged, the reclaim storage operation renames both journal receivers
|
||
|
|
when they are placed in the QRCL library. When you use the Move Object (MOVOBJ)
|
||
|
|
command for a journal or journal receiver in the QRCL library, you can move
|
||
|
|
an object from QRCL back to its original library. You cannot change the name
|
||
|
|
of the journal or the journal receiver.</p>
|
||
|
|
<p>When you detach the receiver from the journal and attach a new one, you
|
||
|
|
can have the system generate the name for the new receiver by incrementing
|
||
|
|
the previous receiver name. If you use system change-journal management by
|
||
|
|
specifying MNGRCV(*SYSTEM) for the journal, the system also generates a new
|
||
|
|
receiver name when it changes journal receivers. The default for the Create
|
||
|
|
Journal (CRTJRN) command is to use system change-journal management.</p>
|
||
|
|
<p>The following table shows the rules the system uses to generate a new receiver
|
||
|
|
name. It applies these rules in the sequence shown in the table.</p>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="33.33333333333333%" id="d0e38">Current name</th>
|
||
|
|
<th valign="top" width="33.33333333333333%" id="d0e40">System action</th>
|
||
|
|
<th valign="top" width="33.33333333333333%" id="d0e42">Example</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" width="33.33333333333333%" headers="d0e38 ">Last 4 characters are numeric.</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e40 ">Adds 1</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e42 ">DSTR0001 to DSTR0002</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.33333333333333%" headers="d0e38 ">Last character is not numeric.</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e40 ">Truncates the name to 6 characters, if necessary. Adds 0001</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e42 ">DSTRCVR to DSTRCV0001</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.33333333333333%" headers="d0e38 ">Last character is numeric. Last non-numeric character is in position
|
||
|
|
5 or less.</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e40 ">Adds 1</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e42 ">DSTR01 to DSTR02</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.33333333333333%" headers="d0e38 ">Last character is numeric. Last non-numeric character is in position
|
||
|
|
6 or higher.</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e40 ">Truncates to 6 characters, if necessary. Adds 0001.</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e42 ">DSTRCVR01 to DSTRCV0001</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<p>If you restore a journal to your system, the system creates a new journal
|
||
|
|
receiver and attaches it to the journal. The system generates a name for the
|
||
|
|
new journal receiver based on the name of the journal receiver that was attached
|
||
|
|
when the journal was saved. The following table shows the rules the system
|
||
|
|
uses to generate a new receiver name when you restore a journal:</p>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="33.33333333333333%" id="d0e82">Current name</th>
|
||
|
|
<th valign="top" width="33.33333333333333%" id="d0e84">System action</th>
|
||
|
|
<th valign="top" width="33.33333333333333%" id="d0e86">Example</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" width="33.33333333333333%" headers="d0e82 ">Last 4 or more characters are numeric.</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e84 ">Adds 1 to the leftmost digit of the numeric portion.</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e86 ">DSTR0001 to DSTR1001</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.33333333333333%" headers="d0e82 ">Last character is not numeric.</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e84 ">Truncates to six characters, if necessary. Adds 1000.</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e86 ">DSTRCVR to DSTRCV1000.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.33333333333333%" headers="d0e82 ">Ending numeric portion is less than 4 digits.</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e84 ">Pads the left portion of the numeric portion with zeroes to create
|
||
|
|
a 4-digit suffix. Adds 1 to the leftmost digit.</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e86 ">DSTRCV01 to DSTRCV1001.</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<p>If the name generated by the system is the same as the name of a journal
|
||
|
|
receiver already on the system, the system adds 1 to the name until it creates
|
||
|
|
a name that is not a duplicate. For example, assume a journal receiver named
|
||
|
|
RCV1 was attached when the journal was saved. When the journal is restored,
|
||
|
|
the system attempts to create a new journal receiver named RCV1001. If that
|
||
|
|
name already exists, the system tries the name RCV1002.</p>
|
||
|
|
<p>The following table shows examples of how the system generates new receiver
|
||
|
|
names:</p>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="33.33333333333333%" id="d0e121">Last journal receiver known to the system<sup>1</sup></th>
|
||
|
|
<th valign="top" width="33.33333333333333%" id="d0e125">Created by change journal<sup>2</sup></th>
|
||
|
|
<th valign="top" width="33.33333333333333%" id="d0e129">Created by restoring journal</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" width="33.33333333333333%" headers="d0e121 ">A</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e125 ">A0001</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e129 ">A1000</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.33333333333333%" headers="d0e121 ">ABCDEF</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e125 ">ABCDEF0001</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e129 ">ABCDEF1000</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.33333333333333%" headers="d0e121 ">ABCDEFG</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e125 ">ABCDEF0001<sup>3</sup></td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e129 ">ABCDEF1000<sup>3</sup></td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.33333333333333%" headers="d0e121 ">ABCDEF1234</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e125 ">ABCDEF1235</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e129 ">ABCDEF2234</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.33333333333333%" headers="d0e121 ">A0001</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e125 ">A0002</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e129 ">A1001</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.33333333333333%" headers="d0e121 ">A1</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e125 ">A2</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e129 ">A1001</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.33333333333333%" headers="d0e121 ">A9</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e125 ">A10</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e129 ">A1009</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.33333333333333%" headers="d0e121 ">ABCDEF7</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e125 ">ABCDEF0001<sup>3</sup></td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e129 ">ABCDEF1007<sup>3</sup></td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.33333333333333%" headers="d0e121 ">ABCDEF9999</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e125 ">Error<sup>4</sup></td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e129 ">ABCDEF0999</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="33.33333333333333%" headers="d0e121 ">A1B15</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e125 ">A1B16</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e129 ">A1B1015</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td colspan="3" valign="top" headers="d0e121 d0e125 d0e129 "> <div class="note"><span class="notetitle">Notes:</span> <p><sup>1</sup>If
|
||
|
|
the journal exists on the system, the last journal receiver known to the system
|
||
|
|
is the journal receiver that is currently attached. If the journal does not
|
||
|
|
exist, the last journal receiver known to the system is the journal receiver
|
||
|
|
that was attached when the journal was saved.</p>
|
||
|
|
<p><sup>2</sup>Either when
|
||
|
|
a user issues the CHGJRN command with JRNRCV(*GEN) or when the journal is
|
||
|
|
changed by system change-journal management.</p>
|
||
|
|
<p><sup>3</sup>The last character
|
||
|
|
of the current name is dropped because it exceeds 6 characters.</p>
|
||
|
|
<p><sup>4</sup>If
|
||
|
|
the journal is set up as MNGRCV(*SYSTEM), the receiver name wraps around to
|
||
|
|
0's (ABCDEF0000). If the journal is set up as MNGRCV(*USER), an error occurs
|
||
|
|
because adding 1 to 9999 causes an overflow condition.</p>
|
||
|
|
</div>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakiplnrcv.htm" title="The following topics provide information to plan configuration for journal receivers. They provide information about each option that you can select for journal receivers.">Plan setup for journal receivers</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<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>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|