ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/wrkjrn.htm

178 lines
6.1 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Work with Journal (WRKJRN)</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="WRKJRN.Top_Of_Page"></a>
<h2>Work with Journal (WRKJRN)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#WRKJRN.PARAMETERS.TABLE">Parameters</a><br>
<a href="#WRKJRN.COMMAND.EXAMPLES">Examples</a><br>
<a href="#WRKJRN.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="WRKJRN"></a>
<p>The Work with Journals (WRKJRN) command shows you a menu from which options for journal operations can be selected. From the primary menu, options can be selected to:
</p>
<ul>
<li>Display the status of the journal
</li>
<li>Perform forward or back-out object recovery
</li>
<li>Recover damaged journals and journal receivers
</li>
<li>Associate journal receivers with a journal.
</li>
</ul>
<p>All of these options are supported for local journals. For remote journals, only the associate journal receivers option is supported.
</p>
<p>See the Journal Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for details on the specific options.
</p>
<p>If forward or back-out recovery needs to be performed for a large number of objects, you should consider using the Apply Journaled Changes (APYJRNCHG) or the Remove Journaled Changes (RMVJRNCHG) command. These commands allow you to specify groups of objects such as all objects in a library, all objects in multiple libraries, all objects journaled to the journal, or all objects in a directory subtree.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJRN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKJRN.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="#WRKJRN.JRN"><b>JRN</b></a></td>
<td valign="top">Journal</td>
<td valign="top">Single values: <b><u>*PROMPT</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Journal</td>
<td valign="top"><i>Generic name, name</i>, *ALL</td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, *ALL, *CURLIB, <b><u>*LIBL</u></b></td>
</tr></table>
<table width="100%">
<tr><td align="right"><a href="#WRKJRN.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="WRKJRN.JRN"></a>
<h3>Journal (JRN)</h3>
<p>Specifies the journals to be shown on the Work with Journals display.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*PROMPT</u></b></dt>
<dd>The Specify Journal Name display will be shown to allow for journal selection prior to displaying the Work with Journals display.
</dd>
</dl>
<p><b>Qualifier 1: Journal</b>
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All journals in the specified library will be shown.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the journal to be shown. A generic name is a character string that contains one or more characters followed by an asterisk (*). If a generic name is specified, all journals that have names with the same prefix as the generic name are shown.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the journal to be shown.
</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. All journals in these libraries with the specified journal name are shown.
</dd>
<dt><b>*ALL</b></dt>
<dd>All libraries on the system, including QSYS, and all libraries on any Independent Auxiliary Storage Pool (ASP) associated with the job, are searched.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
</dd>
<dt><b><i>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="#WRKJRN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKJRN.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Show Specify Journal Name Panel</b>
</p>
<p>
<pre>
WRKJRN
</pre>
</p>
<p>This command displays the Specify Journal Name panel. Once a journal name and library are specified, the Work with Journals panel is shown.
</p>
<p><b>Example 2: Show Journals That Match Generic Name</b>
</p>
<p>
<pre>
WRKJRN JRN(*LIBL/ABC*)
</pre>
</p>
<p>This command displays the Work with Journals panel and includes all journals whose names begin with 'ABC' and are found in libraries within the library list.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJRN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKJRN.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF9801</b></dt>
<dd>Object &amp;2 in library &amp;3 not found.
</dd>
<dt><b>CPF9802</b></dt>
<dd>Not authorized to object &amp;2 in &amp;3.
</dd>
<dt><b>CPF9809</b></dt>
<dd>Library &amp;1 cannot be accessed.
</dd>
<dt><b>CPF9810</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF9820</b></dt>
<dd>Not authorized to use library &amp;1.
</dd>
<dt><b>CPF9825</b></dt>
<dd>Not authorized to device &amp;1.
</dd>
<dt><b>CPF9871</b></dt>
<dd>Error occurred while processing.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJRN.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>