358 lines
14 KiB
HTML
358 lines
14 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>End Journal (ENDJRN)</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="ENDJRN.Top_Of_Page"></a>
|
|
<h2>End Journal (ENDJRN)</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="#ENDJRN.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ENDJRN.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ENDJRN.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ENDJRN"></a>
|
|
<p>The End Journal (ENDJRN) command is used to end the journaling of changes for an object or list of objects. The object types which are supported through this interface are Data Areas (*DTAARA), Data Queues (*DTAQ), Byte Stream Files (*STMF), Directories (*DIR), and Symbolic Links (*SYMLNK). Only objects of type *STMF, *DIR, or *SYMLNK that are in the "root" (/), QOpenSys, and user-defined file systems are supported.
|
|
</p>
|
|
<p>All objects of the supported types that are currently being journaled to a specific journal may also have journaling stopped.
|
|
</p>
|
|
<p>For other ways to end journaling see the following commands:
|
|
</p>
|
|
<ol>
|
|
<li>Access Paths - End Journal Access Path (ENDJRNAP)
|
|
</li>
|
|
<li>Physical Files - End Journal Physical File (ENDJRNPF)
|
|
</li>
|
|
<li>Other Objects - End Journal Object (ENDJRNOBJ)
|
|
</li>
|
|
</ol>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>Objects specified on the command cannot be in use for any reason at the time the command is running.
|
|
</li>
|
|
<li>If OBJ(*ALL) is specified, a journal name must be specified (JRN parameter).
|
|
</li>
|
|
<li>If a journal name and a list of object names are specified, all objects must be currently journaled to the indicated journal.
|
|
</li>
|
|
<li>The specified journal must be a local journal.
|
|
</li>
|
|
<li>At least one of parameter OBJ or OBJFID must be specified.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ENDJRN.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="#ENDJRN.OBJ"><b>OBJ</b></a></td>
|
|
<td valign="top">Objects</td>
|
|
<td valign="top">Single values: *ALL<br>Other values (up to 300 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Name</td>
|
|
<td valign="top">
|
|
<i>Path name</i>, <b><u>*</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Include or omit</td>
|
|
<td valign="top">
|
|
<b><u>*INCLUDE</u></b>, *OMIT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDJRN.OBJFID"><b>OBJFID</b></a></td>
|
|
<td valign="top">File identifier</td>
|
|
<td valign="top">Values (up to 300 repetitions): <i>Hexadecimal value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDJRN.SUBTREE"><b>SUBTREE</b></a></td>
|
|
<td valign="top">Directory subtree</td>
|
|
<td valign="top"><b><u>*NONE</u></b>, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#ENDJRN.PATTERN"><b>PATTERN</b></a></td>
|
|
<td valign="top">Name pattern</td>
|
|
<td valign="top">Values (up to 20 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Pattern</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Include or omit</td>
|
|
<td valign="top">
|
|
<b><u>*INCLUDE</u></b>, *OMIT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDJRN.JRN"><b>JRN</b></a></td>
|
|
<td valign="top">Journal</td>
|
|
<td valign="top"><i>Path name</i>, <b><u>*OBJ</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ENDJRN.OBJ"></a>
|
|
<h3>Objects (OBJ)</h3>
|
|
<p>Specifies a maximum of 300 object path names for which changes will no longer be journaled. Only objects whose path name identifies an object of type *STMF, *DIR, *SYMLNK, *DTAARA or *DTAQ are supported.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All objects of the supported type that are currently being journaled to the indicated journal are to stop having their changes journaled. If *ALL is specified parameter OBJFID must not be specified.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>'object-path-name'</i></b></dt>
|
|
<dd>Specify the path name of the object for which changes are no longer journaled.
|
|
<p>A pattern can be specified in the last part of the path name. An asterisk (*) matches any number of characters and a question mark (?) matches a single character. If the path name is qualified or contains a pattern, it must be enclosed in apostrophes. Symbolic links within the path name will not be followed. If the path name begins with the tilde character, then the path is assumed to be relative to the appropriate home directory.
|
|
</p>
|
|
<p>Additional information about path name patterns is in the Integrated file system information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Include or omit</b>
|
|
</p>
|
|
<p>The second element specifies whether names that match the pattern should be included or omitted from the operation. Note that in determining whether a name matches a pattern, relative name patterns are always treated as relative to current working directory.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*INCLUDE</u></b></dt>
|
|
<dd>The objects that match the object name pattern are to stop having their changes journaled unless overridden by an *OMIT specification.
|
|
</dd>
|
|
<dt><b>*OMIT</b></dt>
|
|
<dd>The objects that match the object name pattern are not to be included with the objects that are to stop having their changes journaled. This overrides an *INCLUDE specification and is intended to be used to omit a subset of a previously selected path.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDJRN.OBJFID"></a>
|
|
<h3>File identifier (OBJFID)</h3>
|
|
<p>Specifies a maximum of 300 file identifiers (FID) for which changes are no longer journaled. FIDs are a unique identifier associated with integrated file system related objects. This field is input in hexadecimal format. Only objects whose FID identifies on object of type *STMF, *DIR, *SYMLNK, *DTAARA or *DTAQ are supported.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>file-identifier</i></b></dt>
|
|
<dd>Objects identified with the FID are no longer journaled.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDJRN.SUBTREE"></a>
|
|
<h3>Directory subtree (SUBTREE)</h3>
|
|
<p>Specifies whether the objects in directory subtrees are to stop having their changes journaled.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is ignored unless object-path-name is a directory object.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is ignored if the OBJFID parameter is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>Only the objects that match the selection criteria are processed. The objects within selected directories are not implicitly processed.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All objects that meet the selection criteria are processed in addition to the entire subtree of each directory that matches the selection criteria. The subtree includes all sub-directories and the objects within those sub-directories.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDJRN.PATTERN"></a>
|
|
<h3>Name pattern (PATTERN)</h3>
|
|
<p>Specifies a maximum of 20 patterns to be used to include or omit objects for the end journal operation.
|
|
</p>
|
|
<p>Only the last part of the path name will be considered for the name pattern match. Path name delimiters are not allowed in the name pattern. An asterisk (*) matches any number of characters and a question mark (?) matches a single character. If the path name is qualified or contains a pattern, it must be enclosed in apostrophes. Symbolic links within the path name will not be followed.
|
|
</p>
|
|
<p>If this parameter is not specified, the default will be to match all patterns.
|
|
</p>
|
|
<p>Additional information about path name patterns is in the Integrated file system information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is ignored if the OBJFID parameter is specified.
|
|
</p>
|
|
<p><b>Element 1: Name pattern</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>'*'</u></b></dt>
|
|
<dd>All objects that match the input OBJ parameter are to be included into the end journal operation or omitted from the end journal operation.
|
|
</dd>
|
|
<dt><b><i>name-pattern</i></b></dt>
|
|
<dd>Specify the pattern to either include or omit objects for the end journal operation. Only the last part of the path name will be considered for the name pattern match. Path name delimiters are not allowed in the name pattern.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Include or omit</b>
|
|
</p>
|
|
<p>The second element specifies whether names that match the pattern should be included or omitted from the operation. Note that in determining whether a name matches a pattern, relative name patterns are always treated as relative to the current working directory.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The SUBTREE parameter specifies whether directory subtrees are included or omitted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*INCLUDE</u></b></dt>
|
|
<dd>The objects that match the object name pattern are to stop having their changes journaled unless overridden by an *OMIT specification.
|
|
</dd>
|
|
<dt><b>*OMIT</b></dt>
|
|
<dd>The objects that match the object name pattern are not to be included with the objects that are to stop having their changes journaled. This overrides an *INCLUDE specification and is intended to be used to omit a subset of a previously selected pattern.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDJRN.JRN"></a>
|
|
<h3>Journal (JRN)</h3>
|
|
<p>Specifies the journal to which changes are currently being journaled.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*OBJ</u></b></dt>
|
|
<dd>The journal is determined by the system from the specified object path name or object file identifier.
|
|
</dd>
|
|
<dt><b><i>journal-path-name</i></b></dt>
|
|
<dd>Specify the path name of the journal to which changes are currently being journaled.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDJRN.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: End All Non-Database Journaling</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDJRN OBJ(*ALL) JRN('/qsys.lib/mylib.lib/myjrn.jrn')
|
|
</pre>
|
|
</p>
|
|
<p>This command stops the journaling of all changes to all objects of type *DIR, *STMF, *SYMLNK, *DTAARA and *DTAQ to journal /qsys.lib/mylib.lib/myjrn.jrn.
|
|
</p>
|
|
<p><b>Example 2: End Journaling with Omit of Directory</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDJRN OBJ(('/mypath' *INCLUDE) ('/mypath/myobject' *OMIT))
|
|
</pre>
|
|
</p>
|
|
<p>This command stops the journaling of all changes to all first-level objects in directory /mypath except object /mypath/myobject. Object /mypath/myobject will continue to be journaled.
|
|
</p>
|
|
<p><b>Example 3: End Journaling with Pattern Selection</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDJRN OBJ(('/mypath' *INCLUDE) ('/mypath/mysubdir' *OMIT))
|
|
SUBTREE(*ALL) PATTERN(('*.txt' *INCLUDE))
|
|
</pre>
|
|
</p>
|
|
<p>This command stops the journaling of all changes to all objects in directory /mypath of type *DIR, *STMF, and *SYMLNK that match pattern '*.txt'. Any objects within directory /mypath/mysubdir will continue to be journaled.
|
|
</p>
|
|
<p><b>Example 4: End Journaling using File Identifiers</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDJRN OBJFID(00000000000000007E09BDB000000009
|
|
00000000000000009E09BDB00000000A)
|
|
</pre>
|
|
</p>
|
|
<p>This command stops the journaling of all changes to the objects of type *DIR, *STMF, *SYMLNK, *DTAARA or *DTAQ represented by the specified file identifiers.
|
|
</p>
|
|
<p><b>Example 5: End Journaling on a set of Data Areas</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDJRN OBJ(('/qsys.lib/mylib.lib/mydata*.dtaara'))
|
|
JRN('/qsys.lib/mylib.lib/myjrn.jrn')
|
|
</pre>
|
|
</p>
|
|
<p>This command stops the journaling of all changes to the objects of type *DTAARA in library MYLIB that begin with the characters 'MYDATA'.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDJRN.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPFA0D4</b></dt>
|
|
<dd>File system error occurred. Error number &1.
|
|
</dd>
|
|
<dt><b>CPF700B</b></dt>
|
|
<dd>&1 of &2 objects have ended 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="#ENDJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|