331 lines
12 KiB
HTML
331 lines
12 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 Physical File (STRJRNPF)</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="STRJRNPF.Top_Of_Page"></a>
|
|
<h2>Start Journal Physical File (STRJRNPF)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>Conditional
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#STRJRNPF.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRJRNPF.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRJRNPF.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRJRNPF"></a>
|
|
<p>The Start Journal Physical File (STRJRNPF) command is used to start journaling changes made to a specific database physical file to a specific journal. Changes in new members added to the file are also journaled.
|
|
</p>
|
|
<p>The user can specify that only the after image or both the before and after images of records in the journaled physical file be journaled. Before images are necessary to remove journaled changes using the Remove Journaled Changes (RMVJRNCHG) command. In addition, the system will automatically capture the before images for a database file if the file is opened under commitment control. For more information about commitment control, see the Database information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p>After journaling begins for the file, and after any new members are added to the file, the user should run the Save Changed Object (SAVCHGOBJ) command with OBJTYPE(*FILE) and OBJJRN(*YES) specified. The file must be saved because journaled changes cannot be applied to a version of the file that was saved before journaling was in effect.
|
|
</p>
|
|
<p>When the file being journaled is a distributed file, the STRJRNPF command is also distributed if journaling was successfully started locally. Even if the distribution request fails, the local file remains journaled.
|
|
</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>Other objects - Start Journal Object (STRJRNOBJ)
|
|
</li>
|
|
</ul>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>The file must not be journaling changes to another journal.
|
|
</li>
|
|
<li>Overrides are not applied to files specified on the FILE parameter.
|
|
</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 topic.
|
|
</li>
|
|
<li>In multithreaded jobs, this command is not threadsafe for distributed files and fails for distributed files that use relational databases of type *SNA.
|
|
</li>
|
|
<li>If the file has Large Object (LOB) columns, and the total of the LOB columns plus the record size is greater than 15,761,440 bytes, then the file can only be journaled to a journal with RCVSIZOPT(*MAXOPT2) or RCVSIZOPT(*MAXOPT3) specified.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJRNPF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRJRNPF.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="#STRJRNPF.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">Physical file to be journaled</td>
|
|
<td valign="top">Values (up to 50 repetitions): <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Physical file to be journaled</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" rowspan="3"><a href="#STRJRNPF.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 2</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="#STRJRNPF.IMAGES"><b>IMAGES</b></a></td>
|
|
<td valign="top">Record images</td>
|
|
<td valign="top"><b><u>*AFTER</u></b>, *BOTH</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRJRNPF.OMTJRNE"><b>OMTJRNE</b></a></td>
|
|
<td valign="top">Journal entries to be omitted</td>
|
|
<td valign="top"><b><u>*NONE</u></b>, *OPNCLO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJRNPF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRJRNPF.FILE"></a>
|
|
<h3>Physical file to be journaled (FILE)</h3>
|
|
<p>Specifies a maximum of 50 physical files whose changes are written to the journal.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Physical file to be journaled</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>file-name</i></b></dt>
|
|
<dd>Specify the name of a physical file.
|
|
</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="#STRJRNPF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRJRNPF.JRN"></a>
|
|
<h3>Journal (JRN)</h3>
|
|
<p>Specifies the journal that will receive the file change journal entries.
|
|
</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.
|
|
</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="#STRJRNPF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRJRNPF.IMAGES"></a>
|
|
<h3>Record images (IMAGES)</h3>
|
|
<p>Specifies the kinds of record images to be written to the journal for changes to records in the file.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*AFTER</u></b></dt>
|
|
<dd>Only <i>after</i> images are written to the journal for changes to records in this file.
|
|
</dd>
|
|
<dt><b>*BOTH</b></dt>
|
|
<dd>The system writes both <i>before</i> and <i>after</i> images to the journal for changes to records in this file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJRNPF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRJRNPF.OMTJRNE"></a>
|
|
<h3>Journal entries to be omitted (OMTJRNE)</h3>
|
|
<p>Specifies the journal entries that are omitted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No journal entries are omitted.
|
|
</dd>
|
|
<dt><b>*OPNCLO</b></dt>
|
|
<dd><i>Open</i> and <i>close</i> entries are omitted. <i>Open</i> and <i>close</i> operations on the specified file members do not create <i>open</i> and <i>close</i> journal entries. This prevents the use of TOJOBO and TOJOBC entries on the Apply Journaled Changes (APYJRNCHG) an Remove Journaled Changes (RMVJRNCHG) commands, but it saves some storage space in the attached receivers.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJRNPF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRJRNPF.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
STRJRNPF FILE(MYFILE) JRN(MYLIB/JRNLA)
|
|
</pre>
|
|
</p>
|
|
<p>This command journals all changes to all members of file MYFILE (as found using the library search list) to journal JRNLA in library MYLIB. Only the <i>after</i> images of updated records are written to the journal.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJRNPF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRJRNPF.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF6971</b></dt>
|
|
<dd>Damage prevents object &1 from being journaled.
|
|
</dd>
|
|
<dt><b>CPF6979</b></dt>
|
|
<dd>Journal &1 in library &2 is unusable.
|
|
</dd>
|
|
<dt><b>CPF700D</b></dt>
|
|
<dd>File &1 in library &2 not journaled.
|
|
</dd>
|
|
<dt><b>CPF7002</b></dt>
|
|
<dd>File &1 in library &2 not a physical file.
|
|
</dd>
|
|
<dt><b>CPF7003</b></dt>
|
|
<dd>Entry not journaled to journal &1. Reason code &3.
|
|
</dd>
|
|
<dt><b>CPF7004</b></dt>
|
|
<dd>Maximum number of objects journaled to journal &1.
|
|
</dd>
|
|
<dt><b>CPF7011</b></dt>
|
|
<dd>Not enough storage or resources.
|
|
</dd>
|
|
<dt><b>CPF703C</b></dt>
|
|
<dd>DDL transaction prevents journaling operation.
|
|
</dd>
|
|
<dt><b>CPF703D</b></dt>
|
|
<dd>DDL transaction prevents journaling operation.
|
|
</dd>
|
|
<dt><b>CPF703E</b></dt>
|
|
<dd>DDL transaction prevents journaling operation.
|
|
</dd>
|
|
<dt><b>CPF7030</b></dt>
|
|
<dd>Object of type *&3 already being journaled.
|
|
</dd>
|
|
<dt><b>CPF7031</b></dt>
|
|
<dd>Cannot allocate member &3 file &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF7033</b></dt>
|
|
<dd>Start or end journaling failed for member &3.
|
|
</dd>
|
|
<dt><b>CPF7034</b></dt>
|
|
<dd>Logical damage of file &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF7035</b></dt>
|
|
<dd>Object &1 in &2 already known to journal.
|
|
</dd>
|
|
<dt><b>CPF704B</b></dt>
|
|
<dd>Journaling started locally but distributed requests failed.
|
|
</dd>
|
|
<dt><b>CPF705A</b></dt>
|
|
<dd>Operation failed due to remote journal.
|
|
</dd>
|
|
<dt><b>CPF708D</b></dt>
|
|
<dd>Journal receiver found logically damaged.
|
|
</dd>
|
|
<dt><b>CPF7084</b></dt>
|
|
<dd>Object of type *&6 could not be journaled.
|
|
</dd>
|
|
<dt><b>CPF709D</b></dt>
|
|
<dd>Cannot start journaling object of type *&7.
|
|
</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>CPF9812</b></dt>
|
|
<dd>File &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF9822</b></dt>
|
|
<dd>Not authorized to file &1 in library &2.
|
|
</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="#STRJRNPF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|