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

467 lines
19 KiB
HTML
Raw 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 Attributes (WRKJRNA)</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="WRKJRNA.Top_Of_Page"></a>
<h2>Work with Journal Attributes (WRKJRNA)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#WRKJRNA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#WRKJRNA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#WRKJRNA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="WRKJRNA"></a>
<p>The Work with Journal Attributes (WRKJRNA) command displays or prints the creation and operational attributes of a journal, including the name of the journal receiver currently attached to the journal. From the primary display, options or functions can be selected to display the names of all objects currently journaled to the journal, the names of all remote journals currently associated with this journal and detailed information about a remote journal, the receiver directory, or detailed information about a journal receiver; or to delete receivers from the receiver directory.
</p>
<p>The command can also be used to generate an output file that lists journaled objects.
</p>
<p>If output is printed with the job's spooled printer output with DETAIL(*OUTPUT) specified, all of the information that is optionally displayed is printed except:
</p>
<ul>
<li>Detailed information about journal receivers; for that information, use the Display Journal Receiver Attributes (DSPJRNRCVA) command.
</li>
<li>Detailed information about the relational database directory entries associated with any remote journals.
</li>
</ul>
<p>When OUTPUT(*PRINT) is chosen, the DETAIL parameter can be used to subset the information printed. Specifying one or more of the values of *CURATR, *RCVDIR, *RMTJRN, *JRNFILE, *JRNAP, *JRNDTAQ, *JRNDTAARA, and *JRNIFS is allowed.
</p>
<p>If output is directed to an output file, then only the journaled object information is written to the output file. When OUTPUT(*OUTFILE) is chosen, the DETAIL parameter can be used to subset the information sent to the output file. Specifying one or more of the values of *JRNFILE, *JRNAP, *JRNDTAQ, *JRNDTAARA, *JRNIFS and *IMPLICIT is allowed.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJRNA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKJRNA.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="#WRKJRNA.JRN"><b>JRN</b></a></td>
<td valign="top">Journal</td>
<td valign="top">Single values: *INTSYSJRN<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 1</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="#WRKJRNA.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT, *OUTFILE</td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#WRKJRNA.DETAIL"><b>DETAIL</b></a></td>
<td valign="top">Detail</td>
<td valign="top">Single values: <b><u>*OUTPUT</u></b><br>Other values (up to 8 repetitions): *CURATR, *RCVDIR, *RMTJRN, *JRNFILE, *JRNAP, *JRNDTAARA, *JRNDTAQ, *JRNIFS, *IMPLICIT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#WRKJRNA.OUTFILE"><b>OUTFILE</b></a></td>
<td valign="top">File to receive output</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: File to receive output</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="#WRKJRNA.OUTMBR"><b>OUTMBR</b></a></td>
<td valign="top">Output member options</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Member to receive output</td>
<td valign="top">
<i>Name</i>, <b><u>*FIRST</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Replace or add records</td>
<td valign="top">
<b><u>*REPLACE</u></b>, *ADD</td>
</tr>
<tr>
<td valign="top"><a href="#WRKJRNA.JRNID"><b>JRNID</b></a></td>
<td valign="top">Journal identification number</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#WRKJRNA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="WRKJRNA.JRN"></a>
<h3>Journal (JRN)</h3>
<p>Specifies the journal whose attributes are to be displayed.
</p>
<p>This is a required parameter.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*INTSYSJRN</b></dt>
<dd>The internal system journal associated with the journal specified on the JRNID parameter is used. Internal system journals are not stored in libraries.
<p>
<b>Note: </b>You must have all object (*ALLOBJ) special authority to specify JRN(*INTSYSJRN).
</p>
<p>
<b>Note: </b>If the *INTSYSJRN value is specified, then OUTPUT(*OUTFILE) can not be specified and DETAIL(*OUTPUT) must be specified.
</p>
<p>
<b>Note: </b>If the *INTSYSJRN value is specified, the OUTFILE and DETAIL parameters cannot be specified.
</p>
</dd>
</dl>
<p><b>Qualifier 1: Journal</b>
</p>
<dl>
<dt><b><i>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="#WRKJRNA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKJRNA.OUTPUT"></a>
<h3>Output (OUTPUT)</h3>
<p>Specifies where the output from the command is sent.
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
</dd>
</dl>
<dl>
<dt><b>*PRINT</b></dt>
<dd>The output is printed with the job's spooled output.
</dd>
</dl>
<dl>
<dt><b>*OUTFILE</b></dt>
<dd>The output is directed to the database file specified for the <b>File to receive output (OUTFILE)</b> parameter.
</dd>
</dl>
<p>
<b>Note: </b>File QPDSPJNA is used for printed output. File QAWRKJRNA is the model output file. The format name is QJOWRKJRNA.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJRNA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKJRNA.DETAIL"></a>
<h3>Detail (DETAIL)</h3>
<p>Specifies the type of information that is directed to the printer file or output file.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*OUTPUT</u></b></dt>
<dd>The information sent to the printer file or output file will depend on what value was specified on the OUTPUT parameter. When *OUTPUT is selected, then the DETAIL parameter may not have any other values.
<p>If OUTPUT(*PRINT) was selected, then DETAIL(*OUTPUT) will have the same meaning as selecting all of the following parameter values for DETAIL: *CURATR, *RCVDIR, *RMTJRN, *JRNFILE, *JRNAP, *JRNDTAQ, *JRNDTAARA, and *JRNIFS.
</p>
<p>If OUTPUT(*OUTFILE) was selected, then DETAIL(*OUTPUT) will have the same meaning as selecting all of the following parameter values for DETAIL: *JRNFILE, *JRNAP, *JRNDTAQ, *JRNDTARA and *JRNIFS.
</p>
</dd>
</dl>
<p><b>Other values (up to 8 repetitions)</b>
</p>
<dl>
<dt><b>*CURATR</b></dt>
<dd>The printer file will contain the creation and operational attributes of the journal. This value is not valid with OUTPUT(*OUTFILE).
</dd>
<dt><b>*RCVDIR</b></dt>
<dd>The printer file will contain the names of the journal receivers currently associated with the journal. This entry will also contain some attribute information about the journal receiver. This value is not valid with OUTPUT(*OUTFILE).
</dd>
<dt><b>*RMTJRN</b></dt>
<dd>The printer file will contain the current remote journal related attributes of this journal and information about the remote journal(s) that are currently associated with this journal. This value is not valid with OUTPUT(*OUTFILE).
</dd>
<dt><b>*JRNFILE</b></dt>
<dd>The printer file or output file will contain the list of the physical file names and the library names of the files for all files being journaled. Additionally, the printer file will have a count of files and a count of members journaled to this journal.
</dd>
<dt><b>*JRNAP</b></dt>
<dd>The printer file or output file will contain the list of the file names and the library names of the files for all access paths being journaled. Additionally, the printer file will have a count of files and a count of access paths journaled to this journal.
</dd>
<dt><b>*JRNDTAARA</b></dt>
<dd>The printer file or output file will contain the list of data area names and the library names of the data areas for all data areas being journaled. Additionally, the printer file will have a count of data areas journaled to this journal.
</dd>
<dt><b>*JRNDTAQ</b></dt>
<dd>The printer file or output file will contain the list of the data queue names and the library names of the data queues for all data queues being journaled. Additionally, the printer file will have a count of data queues journaled to this journal.
</dd>
<dt><b>*JRNIFS</b></dt>
<dd>The printer file or output file will contain the list of the integrated file system objects for all integrated file system objects being journaled. Additionally, the printer file will have a count of integrated file system objects journaled to this journal.
</dd>
<dt><b>*IMPLICIT</b></dt>
<dd>The output file will contain the list of all objects implicitly journaled to the journal. This will contain objects such as journal receivers, commit definitions, and objects needed for system recovery purposes. This value is not valid with OUTPUT(*PRINT).
<p>
<b>Note: </b>This value must be specified on the DETAIL parameter to get this information.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJRNA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKJRNA.OUTFILE"></a>
<h3>File to receive output (OUTFILE)</h3>
<p>Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.
</p>
<p><b>Qualifier 1: File to receive output</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the database file to which the command output is directed.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
<p>
<b>Note: </b>If a new file is created, the system uses QAWRKJRNA in QSYS with the format name QJOWRKJRNA as a model.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJRNA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKJRNA.OUTMBR"></a>
<h3>Member to receive output (OUTMBR)</h3>
<p>Specifies the name of the database file member that receives the output of the command.
</p>
<p><b>Element 1: Member to receive output</b>
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the <b>File to receive output (OUTFILE)</b> parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the file member that receives the output. If it does not exist, the system creates it.
</dd>
</dl>
<p><b>Element 2: Replace or add records</b>
</p>
<dl>
<dt><b><u>*REPLACE</u></b></dt>
<dd>The system clears the existing member and adds the new records.
</dd>
</dl>
<dl>
<dt><b>*ADD</b></dt>
<dd>The system adds the new records to the end of the existing records.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJRNA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKJRNA.JRNID"></a>
<h3>Journal identification number (JRNID)</h3>
<p>Specifies the five-character journal identification number (ID) of the internal system journal (*INTSYSJRN) to be displayed. Journal IDs are assigned by the system. The first two characters represent the journal type, and the last three characters are the auxiliary storage pool (ASP) identifier.
</p>
<p>
<b>Note: </b>The JRNID parameter can be specified only if JRN(*INTSYSJRN) is specified.
</p>
<p>Following is a listing of journal types:
</p>
<dl>
<dt><b>Journal Types</b></dt>
<dd><b>
</b></dd>
<dt><b>10</b></dt>
<dd>System-managed access-path protection (SMAPP)
</dd>
<dt><b>20</b></dt>
<dd>Directory
</dd>
<dt><b>30</b></dt>
<dd>Spool
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJRNA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKJRNA.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Simple Command Example</b>
</p>
<p>
<pre>
WRKJRNA JRN(MYLIB/JRNLA)
</pre>
</p>
<p>This command allows you to work with the current journal attributes of JRNLA in library MYLIB.
</p>
<p><b>Example 2: More Complex Commands for *PRINT</b>
</p>
<p>
<pre>
WRKJRNA JRN(YOURLIB2/JRNLB) OUTPUT(*PRINT)
DETAIL(*OUTPUT)
WRKJRNA JRN(YOURLIB2/JRNLB) OUTPUT(*PRINT)
DETAIL(*CURATR *RCVDIR *JRNFILE *JRNAP
*JRNDTAQ *JRNDTAARA *JRNIFS *RMTJRN)
</pre>
</p>
<p>These two commands print information related to the journal JRNLB in library YOURLIB2. Specifically they will print journal attribute information, information about the receivers associated with the journal, remote journal information, a list of files being journaled, a list of access paths being journaled, a list of data queues being journaled, a list of data areas being journaled and a list of integrated file system objects being journaled.
</p>
<p><b>Example 3: More Complex Commands for *OUTFILE</b>
</p>
<p>
<pre>
WRKJRNA JRN(YOURLIB3/JRNLC) OUTPUT(*OUTFILE)
OUTFILE(YOURLIB3/MYOUTFILE)
DETAIL(*OUTPUT)
WRKJRNA JRN(YOURLIB3/JRNLC) OUTPUT(*OUTFILE)
OUTFILE(YOURLIB3/MYOUTFILE)
DETAIL(*JRNFILE *JRNAP *JRNDTAQ
*JRNDTAARA *JRNIFS)
</pre>
</p>
<p>These two commands create an output file named MYOUTFILE in library YOURLIB3 that contains information related to the journal JRNLC in library YOURLIB3. Specifically the information written to the output file includes a list of files being journaled, a list of access paths being journaled, a list of data queues being journaled, a list of data areas being journaled and a list of integrated file system objects being journaled.
</p>
<p><b>Example 4: Selecting Specific Information to Print</b>
</p>
<p>
<pre>
WRKJRNA JRN(YOURLIB4/JRNLD) OUTPUT(*PRINT)
DETAIL(*CURATR *JRNFILE)
</pre>
</p>
<p>This command prints information related to the journal JRNLD in library YOURLIB4. The information will be a subset of information about the journal. Specifically the information will be the journal attributes and a list of files being journaled.
</p>
<p><b>Example 5: Selecting Specific Information to Output to a File</b>
</p>
<p>
<pre>
WRKJRNA JRN(YOURLIB5/JRNLE) OUTPUT(*OUTFILE)
OUTFILE(YOURLIB5/MYOUTFILE)
DETAIL(*JRNFILE *JRNDTAARA *IMPLICIT)
</pre>
</p>
<p>This command creates an output file named MYOUTFILE in library YOURLIB5 that contains information related to the journal JRNLE in library YOURLIB5. The information will be a subset of information about the journal. Specifically the information about journaled files, journaled data areas and objects being implicitly journaled to this journal.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJRNA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKJRNA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF69A7</b></dt>
<dd>DETAIL value specified not allowed with OUTPUT value.
</dd>
<dt><b>CPF69A9</b></dt>
<dd>Internal error detected, error code &amp;2.
</dd>
<dt><b>CPF70FF</b></dt>
<dd>Internal system journal function failed.
</dd>
<dt><b>CPF701B</b></dt>
<dd>Journal recovery of an interrupted operation failed.
</dd>
<dt><b>CPF702C</b></dt>
<dd>An attached receiver has previously been destroyed.
</dd>
<dt><b>CPF706B</b></dt>
<dd>Not authorized to specify JRN(*INTSYSJRN).
</dd>
<dt><b>CPF706C</b></dt>
<dd>Value &amp;1 for JRNID parameter not valid.
</dd>
<dt><b>CPF708D</b></dt>
<dd>Journal receiver found logically damaged.
</dd>
<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>CPF9803</b></dt>
<dd>Cannot allocate object &amp;2 in library &amp;3.
</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>CPF9860</b></dt>
<dd>Error occurred during output file processing.
</dd>
<dt><b>CPF9871</b></dt>
<dd>Error occurred while processing.
</dd>
<dt><b>CPF9875</b></dt>
<dd>Resources exceeded on ASP &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJRNA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>