278 lines
9.9 KiB
HTML
278 lines
9.9 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Start Journal Object (STRJRNOBJ)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="STRJRNOBJ.Top_Of_Page"></a>
|
|
<h2>Start Journal Object (STRJRNOBJ)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>Yes
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#STRJRNOBJ.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRJRNOBJ.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRJRNOBJ.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRJRNOBJ"></a>
|
|
<p>The Start Journal Object (STRJRNOBJ) command is used to start journaling changes (made to an object or list of objects) to a specific journal. The object types which are supported through this interface are Data Areas (*DTAARA) and Data Queues (*DTAQ). For more information about journal entries which can be sent, see the Journal Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p>Additionally, the user can specify that only the after image or both the before and the after images of an object of type *DTAARA be journaled. Before images are necessary to remove journaled changes using the Remove Journaled Changes (RMVJRNCHG) command.
|
|
</p>
|
|
<p>After journaling begins for the object, the user should save the journaled object to preserve its journal attribute information. Also, the object must be saved because, for example, journaled changes cannot be applied to a version of the object that was saved before journaling was in effect.
|
|
</p>
|
|
<p>For other ways to start journaling see the following commands:
|
|
</p>
|
|
<ul>
|
|
<li>Access paths - Start Journal Access Path (STRJRNAP)
|
|
</li>
|
|
<li>Integrated file system objects - Start Journal (STRJRN)
|
|
</li>
|
|
<li>Physical files - Start Journal Physical File (STRJRNPF)
|
|
</li>
|
|
</ul>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>The object must not be journaling changes to another journal.
|
|
</li>
|
|
<li>The maximum number of objects that can be associated with one journal is either 250,000 or 10,000,000. To get 10,000,000, the value of *MAX10M must have been specified for the JRNOBJLMT parameter on either the Create Journal (CRTJRN) command or on the Change Journal (CHGJRN) command. If the number of objects is larger than this maximum, journaling does not start.
|
|
</li>
|
|
<li>The specified journal must be a local journal. Although all object types which can be journaled to a local journal can also have their changes sent to a remote journal, this is accomplished by a two step process. First start journaling to the local journal. Then connect the local journal to a remote instance. To initiate such a connection, use the Add Remote Journal (ADDRMTJRN) command or the Add Remote Journal (QjoAddRemoteJournal) API. For information about remote journaling, see the Journal Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</li>
|
|
<li>The specified journal and object must reside in the same Auxiliary Storage Pool (ASP).
|
|
</li>
|
|
<li>For data areas, only local external data area objects may be journaled. The special data areas (*LDA, *GDA, and *PDA) and DDM data areas cannot be journaled.
|
|
</li>
|
|
<li>For data queues, only local data queues are supported. DDM data queues cannot be journaled.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJRNOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRJRNOBJ.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STRJRNOBJ.OBJ"><b>OBJ</b></a></td>
|
|
<td valign="top">Object</td>
|
|
<td valign="top">Values (up to 300 repetitions): <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Object</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#STRJRNOBJ.OBJTYPE"><b>OBJTYPE</b></a></td>
|
|
<td valign="top">Object type</td>
|
|
<td valign="top">*DTAARA, *DTAQ</td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STRJRNOBJ.JRN"><b>JRN</b></a></td>
|
|
<td valign="top">Journal</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Journal</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#STRJRNOBJ.IMAGES"><b>IMAGES</b></a></td>
|
|
<td valign="top">Images</td>
|
|
<td valign="top"><b><u>*AFTER</u></b>, *BOTH</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJRNOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRJRNOBJ.OBJ"></a>
|
|
<h3>Object (OBJ)</h3>
|
|
<p>Specifies a maximum of 300 qualified object names for which changes are to be journaled.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Object</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>object-name</i></b></dt>
|
|
<dd>Specify the name of the object for which changes are to be journaled.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJRNOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRJRNOBJ.OBJTYPE"></a>
|
|
<h3>Object type (OBJTYPE)</h3>
|
|
<p>Specifies the object type for which changes are to be journaled.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DTAARA</b></dt>
|
|
<dd>Changes for data area objects are to be journaled.
|
|
</dd>
|
|
<dt><b>*DTAQ</b></dt>
|
|
<dd>Changes for data queue objects are to be journaled.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJRNOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRJRNOBJ.JRN"></a>
|
|
<h3>Journal (JRN)</h3>
|
|
<p>Specifies the journal that receives the journaled changes.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Journal</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>journal-name</i></b></dt>
|
|
<dd>Specify the name of the journal that receives the journaled changes.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJRNOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRJRNOBJ.IMAGES"></a>
|
|
<h3>Images (IMAGES)</h3>
|
|
<p>Specifies the kinds of images that are written to the journal receiver for changes to objects.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*AFTER</u></b></dt>
|
|
<dd>Only <i>after</i> images are generated for changes to objects.
|
|
</dd>
|
|
<dt><b>*BOTH</b></dt>
|
|
<dd>The system generates both <i>before</i> and <i>after</i> images to the journal for changes to objects.
|
|
<p>
|
|
<b>Note: </b>The value *BOTH is only valid for *DTAARA objects.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJRNOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRJRNOBJ.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
STRJRNOBJ OBJ(DTALIB/MYDTAARA) OBJTYPE(*DTAARA)
|
|
JRN(MYLIB/JRNLA)
|
|
</pre>
|
|
</p>
|
|
<p>This command journals all changes to data area MYDTAARA in library DTALIB to journal JRNLA in library MYLIB. Only the <i>after</i> images of updates are written to the journal.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJRNOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRJRNOBJ.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF6979</b></dt>
|
|
<dd>Journal &1 in library &2 is unusable.
|
|
</dd>
|
|
<dt><b>CPF700A</b></dt>
|
|
<dd>&1 of &2 objects have started journaling.
|
|
</dd>
|
|
<dt><b>CPF705A</b></dt>
|
|
<dd>Operation failed due to remote journal.
|
|
</dd>
|
|
<dt><b>CPF9801</b></dt>
|
|
<dd>Object &2 in library &3 not found.
|
|
</dd>
|
|
<dt><b>CPF9802</b></dt>
|
|
<dd>Not authorized to object &2 in &3.
|
|
</dd>
|
|
<dt><b>CPF9803</b></dt>
|
|
<dd>Cannot allocate object &2 in library &3.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF9825</b></dt>
|
|
<dd>Not authorized to device &1.
|
|
</dd>
|
|
<dt><b>CPF9830</b></dt>
|
|
<dd>Cannot assign library &1.
|
|
</dd>
|
|
<dt><b>CPF9873</b></dt>
|
|
<dd>ASP status is preventing access to object.
|
|
</dd>
|
|
<dt><b>CPF9875</b></dt>
|
|
<dd>Resources exceeded on ASP &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJRNOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|