282 lines
8.9 KiB
HTML
282 lines
8.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>End Journal Physical File (ENDJRNPF)</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="ENDJRNPF.Top_Of_Page"></a>
|
||
|
|
<h2>End Journal Physical File (ENDJRNPF)</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="#ENDJRNPF.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#ENDJRNPF.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#ENDJRNPF.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="ENDJRNPF"></a>
|
||
|
|
<p>The End Journal Physical File (ENDJRNPF) command is used to end journaling of changes for a specific physical file and all of its members.
|
||
|
|
</p>
|
||
|
|
<p>All physical files currently being journaled to a specific journal may also have journaling stopped.
|
||
|
|
</p>
|
||
|
|
<p>When the file for which journaling is ended is a distributed file, an attempt is made to distribute the ENDJRNPF command if journaling was successfully ended locally. Even if the distribution request fails, the local file is not journaled. In addition, if a journal and file name are specified, and the file is distributed, an attempt to distribute the ENDJRNPF request is made even if the file is not journaled locally.
|
||
|
|
</p>
|
||
|
|
<p>For other ways to end journaling see the following commands:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Access paths - End Journal Access Path (ENDJRNAP)
|
||
|
|
</li>
|
||
|
|
<li>Integrated file system objects - End Journal (ENDJRN)
|
||
|
|
</li>
|
||
|
|
<li>Other objects - End Journal Object (ENDJRNOBJ)
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Members in the files specified on the command cannot be in use for any reason at the time the command is running.
|
||
|
|
</li>
|
||
|
|
<li>Overrides are not applied to the files listed in the FILE parameter.
|
||
|
|
</li>
|
||
|
|
<li>If FILE(*ALL) is specified, a journal name must be specified.
|
||
|
|
</li>
|
||
|
|
<li>If a journal name and a list of file names are specified, all files must be currently journaled to the indicated journal.
|
||
|
|
</li>
|
||
|
|
<li>The specified journal must be a local journal.
|
||
|
|
</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>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ENDJRNPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="ENDJRNPF.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="#ENDJRNPF.FILE"><b>FILE</b></a></td>
|
||
|
|
<td valign="top">Journaled physical file</td>
|
||
|
|
<td valign="top">Single values: *ALL<br>Other 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: Journaled physical file</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="#ENDJRNPF.JRN"><b>JRN</b></a></td>
|
||
|
|
<td valign="top">Journal</td>
|
||
|
|
<td valign="top">Single values: <b><u>*FILE</u></b><br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional, 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></table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ENDJRNPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="ENDJRNPF.FILE"></a>
|
||
|
|
<h3>Journaled physical file (FILE)</h3>
|
||
|
|
<p>Specifies a maximum of 50 physical files for which changes will no longer be journaled.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All physical files currently being journaled to the specified journal no longer have their changes journaled.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Journaled physical file</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>file-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the physical database file for which changes will no longer 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="#ENDJRNPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ENDJRNPF.JRN"></a>
|
||
|
|
<h3>Journal (JRN)</h3>
|
||
|
|
<p>Specifies the name of the journal to which changes in the indicated files are currently being journaled.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FILE</u></b></dt>
|
||
|
|
<dd>The journal is determined by the system from the specified file names.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Journal</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>journal-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the journal to which changes in the specified files are currently being 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="#ENDJRNPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ENDJRNPF.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ENDJRNPF FILE(MYLIB/MYFILE)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command stops the journaling of all changes to all members of file MYFILE in library MYLIB. Changes made after this command is run are not journaled.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ENDJRNPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ENDJRNPF.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF6959</b></dt>
|
||
|
|
<dd>Object &1 is not currently journaled.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6970</b></dt>
|
||
|
|
<dd>Access paths built over file &1 are being journaled.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF7002</b></dt>
|
||
|
|
<dd>File &1 in library &2 not a physical file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF703B</b></dt>
|
||
|
|
<dd>Implicit end of access path journaling failed.
|
||
|
|
</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>CPF7031</b></dt>
|
||
|
|
<dd>Cannot allocate member &3 file &1 in &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF7032</b></dt>
|
||
|
|
<dd>ENDJRNPF or ENDJRNAP command failed.
|
||
|
|
</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>CPF704C</b></dt>
|
||
|
|
<dd>Journaling ended locally but distributed requests failed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF704D</b></dt>
|
||
|
|
<dd>ENDJRNPF command 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>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="#ENDJRNPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|