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

125 lines
8.7 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="Automatically Start Journaling" />
<meta name="abstract" content="Using a data area named QDFTJRN, you can automatically start journaling when a non-integrated file system object (data area, data queue, or file) is created, moved, or restored into the library, thus, ensuring the very first change to the object will be recorded in the journal and that no lock on the user's part prevents journaling from starting in the library. The QDFTJRN data area must exist in the library where the object is being added." />
<meta name="description" content="Using a data area named QDFTJRN, you can automatically start journaling when a non-integrated file system object (data area, data queue, or file) is created, moved, or restored into the library, thus, ensuring the very first change to the object will be recorded in the journal and that no lock on the user's part prevents journaling from starting in the library. The QDFTJRN data area must exist in the library where the object is being added." />
<meta name="DC.Relation" scheme="URI" content="rzakistrjrnl.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakistrjrn.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="rzakiautostrjrnl" />
<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>Automatically Start Journaling</title>
</head>
<body id="rzakiautostrjrnl"><a name="rzakiautostrjrnl"><!-- --></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">Automatically Start Journaling</h1>
<div><p>Using a data area named QDFTJRN, you can automatically start journaling
when a non-integrated file system object (data area, data queue, or file)
is created, moved, or restored into the library, thus, ensuring the very first
change to the object will be recorded in the journal and that no lock on the
user's part prevents journaling from starting in the library. The QDFTJRN
data area must exist in the library where the object is being added. </p>
<div class="note"><span class="notetitle">Note:</span> <ul><li>The QDFTJRN data area must be created by the user.</li>
<li>To automatically start journaling for integrated file system objects,
see the discussion of journal inheritance in <a href="rzakistrjrn.htm">Journal
integrated file system objects</a>. </li>
</ul>
</div>
<p><img src="./delta.gif" alt="Start of change" />If a data area called QDFTJRN exists 1) in the same library
into which the data area, data queue, or physical file is created, or 2) in
the same schema that the SQL table is created into, and 3) the user (in either
instance) is authorized to the data area, journaling will be started to the
journal named in the data area if all the following are true: <img src="./deltaend.gif" alt="End of change" /></p>
<ul><li><img src="./delta.gif" alt="Start of change" />The identified library for the data area, data
queue, or physical file or identified schema for the SQL table must not be
QSYS, QSYS2, QRECOVERY, QSPL, QRCL, QRPLOBJ, QGPL, QTEMP, or any of the independent
auxiliary storage pool (IASP) equivalents to these libraries. (An iASP equivalent
of QRPLOBJ, for example, is QRPLxxxxx where 'xxxxx' is the number of a primary
auxiliary storage pool (ASP).) <img src="./deltaend.gif" alt="End of change" /></li>
<li>The journal specified in the data area must exist and the user must be
authorized to start journaling to the journal. </li>
</ul>
<p><img src="./delta.gif" alt="Start of change" />See the table below for a detailed description of the values
within the data area.<img src="./deltaend.gif" alt="End of change" /></p>
<p><img src="./delta.gif" alt="Start of change" />When creating SQL tables within a schema, the QSQJRN journal
within the schema is used to start journaling the tables. To start journaling
the tables to a different journal than QSQJRN within the schema, create the
QDFTJRN data area in the schema and specify a different journal name inside
the QDFTJRN data area.<img src="./deltaend.gif" alt="End of change" /></p>
<p>This table shows formats of the QDFTJRN data area.</p>
<div class="tablenoborder"><img src="./delta.gif" alt="Start of change" /><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr valign="bottom"><th align="center" valign="bottom" width="14.921465968586386%" id="d0e45">Offset</th>
<th align="center" valign="bottom" width="16.49214659685864%" id="d0e47">Field</th>
<th align="center" valign="bottom" width="14.659685863874344%" id="d0e49">Format</th>
<th align="center" valign="bottom" width="53.92670157068062%" id="d0e51">Description</th>
</tr>
</thead>
<tbody><tr><td valign="top" width="14.921465968586386%" headers="d0e45 ">1</td>
<td valign="top" width="16.49214659685864%" headers="d0e47 ">Library name</td>
<td valign="top" width="14.659685863874344%" headers="d0e49 ">Char (10)</td>
<td valign="top" width="53.92670157068062%" headers="d0e51 ">Name of the library that contains the journal.</td>
</tr>
<tr><td valign="top" width="14.921465968586386%" headers="d0e45 ">11</td>
<td valign="top" width="16.49214659685864%" headers="d0e47 ">Journal name</td>
<td valign="top" width="14.659685863874344%" headers="d0e49 ">Char (10)</td>
<td valign="top" width="53.92670157068062%" headers="d0e51 ">Name of the journal to use to automatically start journaling.</td>
</tr>
<tr><td valign="top" width="14.921465968586386%" headers="d0e45 ">21</td>
<td colspan="3" valign="top" headers="d0e47 d0e49 d0e51 ">Repeat the set of Object type and Option
as needed:</td>
</tr>
<tr><td valign="top" width="14.921465968586386%" headers="d0e45 ">&nbsp;</td>
<td valign="top" width="16.49214659685864%" headers="d0e47 ">Object type</td>
<td valign="top" width="14.659685863874344%" headers="d0e49 ">Char (10)</td>
<td valign="top" width="53.92670157068062%" headers="d0e51 "><p><strong>Object type value:</strong></p>
<ul class="simple"><li>*FILE = database files or SQL tables</li>
<li>*DTAARA = data areas</li>
<li>*DTAQ = data queues</li>
<li>*ALL = all journal eligible objects which are not in an integrated file
system</li>
<li>*NONE = no objects</li>
</ul>
</td>
</tr>
<tr><td valign="top" width="14.921465968586386%" headers="d0e45 ">&nbsp;</td>
<td valign="top" width="16.49214659685864%" headers="d0e47 ">Option</td>
<td valign="top" width="14.659685863874344%" headers="d0e49 ">Char (10)</td>
<td valign="top" width="53.92670157068062%" headers="d0e51 "><p><strong>Option:</strong></p>
<ul class="simple"><li>*CREATE = Start journaling when an object is created into the library</li>
<li> *MOVE = Start journaling when an object is moved into the library </li>
<li>*RESTORE = Start journaling when an object is restored into the library</li>
<li> *ALLOPR = Start journaling in all cases possible</li>
</ul>
</td>
</tr>
</tbody>
</table>
<img src="./deltaend.gif" alt="End of change" /></div>
<div class="note"><span class="notetitle">Note:</span> The values in the data area must be in upper case.</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakistrjrnl.htm" title="This topic provides information about how to start journaling for all object types.">Start journaling</a></div>
</div>
<div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="rzakistrjrn.htm" title="You can journal the following integrated file system objects if they are in the &#34;root&#34;(/), QOpenSys, and user-defined file systems:">Journal integrated file system objects</a></div>
</div>
</div>
<img src="./deltaend.gif" alt="End of change" /></body>
</html>