1608 lines
49 KiB
HTML
1608 lines
49 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">
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
|
<title>Retrieve Journal Receiver Information (QjoRtvJrnReceiverInformation)
|
|
API</title>
|
|
<!-- Begin Header Records -->
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<!-- JC1 SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
|
|
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
|
|
<!-- Change History: -->
|
|
<!-- YYMMDD USERID Change description -->
|
|
<!-- 040927 trschmid added '2' to MINENTDTA for files -->
|
|
<!--File Edited April 2001 -->
|
|
<!--End Header Records -->
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body>
|
|
<a name="Top_Of_Page"></a>
|
|
<!-- Java sync-link -->
|
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
|
</script>
|
|
|
|
<h2>Retrieve Journal Receiver Information (QjoRtvJrnReceiverInformation)
|
|
API</h2>
|
|
|
|
<div class="box" style="width: 75%;">
|
|
<br>
|
|
Required Parameter Group:<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
<table width="100%">
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">1</td>
|
|
<td align="left" valign="top" width="50%">Receiver variable</td>
|
|
<td align="left" valign="top" width="20%">Output</td>
|
|
<td align="left" valign="top" width="20%">Char(*)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">2</td>
|
|
<td align="left" valign="top">Length of receiver variable</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Binary(4)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">3</td>
|
|
<td align="left" valign="top">Qualified journal receiver name</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(20)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">Format name</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(8)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Omissible Parameter:<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
<table width="100%">
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">5</td>
|
|
<td align="left" valign="top" width="50%">Error code</td>
|
|
<td align="left" valign="top" width="20%">I/O</td>
|
|
<td align="left" valign="top" width="20%">Char(*)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Service Program Name: QJOURNAL<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Header File: QSYSINC/H.QJOURNAL<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Default Public Authority: *USE<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Threadsafe: Yes<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
</div>
|
|
|
|
<p>The Retrieve Journal Receiver Information (QjoRtvJrnReceiverInformation) API
|
|
provides access to journal-receiver-related information to help manage a
|
|
journal environment, including a remote journal environment.</p>
|
|
|
|
<p>Various types of journal receiver information are provided by the API,
|
|
similar to information reported using the Display Journal Receiver Attributes
|
|
(DSPJRNRCVA) CL command.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Authorities and Locks</h3>
|
|
|
|
<dl>
|
|
<dt><em>Journal Receiver Authority</em></dt>
|
|
|
|
<dd>*OBJOPR and some data authority other than *EXECUTE</dd>
|
|
|
|
<dt><em>Journal Receiver Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE</dd>
|
|
|
|
<dt><em>Journal Authority</em></dt>
|
|
|
|
<dd>*OBJOPR</dd>
|
|
|
|
<dt><em>Journal Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE</dd>
|
|
|
|
<dt><em>Service Program Authority</em></dt>
|
|
|
|
<dd>*EXECUTE</dd>
|
|
|
|
<dt><em>Journal Receiver Lock</em></dt>
|
|
|
|
<dd>*SHRRD</dd>
|
|
|
|
<dt><em>Journal Lock</em></dt>
|
|
|
|
<dd>*SHRRD</dd>
|
|
</dl>
|
|
|
|
<p>For the following authorities and locks:</p>
|
|
|
|
<ul>
|
|
<li>Journal Authority</li>
|
|
|
|
<li>Journal Library Authority</li>
|
|
|
|
<li>Journal Lock</li>
|
|
</ul>
|
|
|
|
<p>These are required only if the journal receiver has ever been associated
|
|
with a journal, and that journal is on the system.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Required Parameter Group</h3>
|
|
|
|
<dl>
|
|
<dt><strong>Receiver variable</strong></dt>
|
|
|
|
<dd>OUTPUT; CHAR(*)
|
|
|
|
<p>The receiver variable that is to receive the information requested. You can
|
|
specify the size of the area smaller than the format requested as long as you
|
|
specify the length of receiver variable parameter correctly. As a result, the
|
|
API returns only the data the area can hold.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Length of receiver variable</strong></dt>
|
|
|
|
<dd>INPUT; BINARY(4)
|
|
|
|
<p>The length of the receiver variable provided. The length of receiver
|
|
variable parameter may be specified up to the size of the receiver variable
|
|
specified in the user program. If the length of receiver variable parameter
|
|
specified is larger than the allocated size of the receiver variable specified
|
|
in the user program, the results are not predictable. The minimum length is 8
|
|
bytes.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Qualified journal receiver name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(20)
|
|
|
|
<p>The name of the journal receiver and its library from which the journal
|
|
receiver attributes and information is to be retrieved. The first 10 characters
|
|
contain the journal receiver name, and the second 10 characters contain the
|
|
library name. The special values supported for the library name follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
|
<td align="left" valign="top">Library list</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
|
<td align="left" valign="top">Current library</td>
|
|
</tr>
|
|
</table>
|
|
</dd>
|
|
|
|
<dt><strong>Format name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(8)
|
|
|
|
<p>The format RRCV0100 is the only supported format that is used by this API.
|
|
For more information, see <a href="#HDRRRCIFMT">RRCV0100 Format</a>.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Omissible Parameter</h3>
|
|
|
|
<dl>
|
|
<dt><strong>Error code</strong></dt>
|
|
|
|
<dd>I/O; CHAR(*)
|
|
|
|
<p>The structure in which to return error information. For the format of the
|
|
structure, see <a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>. If this
|
|
parameter is omitted, diagnostic and escape messages are issued to the
|
|
application.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRRRCIFMT">RRCV0100 Format</a></h3>
|
|
|
|
<p>The structure of the information returned is determined by the specified
|
|
format name. For detailed descriptions of the fields, see <a href=
|
|
"#HDRRRCVIFL">Field Descriptions</a>.</p>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Bytes returned</td>
|
|
</tr>
|
|
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Bytes available</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Journal receiver name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">18</td>
|
|
<td align="center" valign="top">12</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Journal receiver library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">28</td>
|
|
<td align="center" valign="top">1C</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Journal name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">38</td>
|
|
<td align="center" valign="top">26</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Journal library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">48</td>
|
|
<td align="center" valign="top">30</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Threshold</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">52</td>
|
|
<td align="center" valign="top">34</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Size</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">56</td>
|
|
<td align="center" valign="top">38</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Auxiliary storage pool (ASP)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">60</td>
|
|
<td align="center" valign="top">3C</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Number of journal entries</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">64</td>
|
|
<td align="center" valign="top">40</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Maximum entry-specific data length</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">68</td>
|
|
<td align="center" valign="top">44</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Maximum null value indicators</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">72</td>
|
|
<td align="center" valign="top">48</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">First sequence number</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">76</td>
|
|
<td align="center" valign="top">4C</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Minimize entry specific data for data areas</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">77</td>
|
|
<td align="center" valign="top">4D</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Minimize entry specific data for files</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">78</td>
|
|
<td align="center" valign="top">4E</td>
|
|
<td align="left" valign="top">CHAR(2)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">80</td>
|
|
<td align="center" valign="top">50</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Last sequence number</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">84</td>
|
|
<td align="center" valign="top">54</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">88</td>
|
|
<td align="center" valign="top">58</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Status</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">89</td>
|
|
<td align="center" valign="top">59</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Receiver size option *MINFIXLEN</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">90</td>
|
|
<td align="center" valign="top">5A</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Receiver maximums option</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">91</td>
|
|
<td align="center" valign="top">5B</td>
|
|
<td align="left" valign="top">CHAR(4)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">95</td>
|
|
<td align="center" valign="top">5F</td>
|
|
<td align="left" valign="top">CHAR(13)</td>
|
|
<td align="left" valign="top">Attached date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">108</td>
|
|
<td align="center" valign="top">6C</td>
|
|
<td align="left" valign="top">CHAR(13)</td>
|
|
<td align="left" valign="top">Detached date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">121</td>
|
|
<td align="center" valign="top">79</td>
|
|
<td align="left" valign="top">CHAR(13)</td>
|
|
<td align="left" valign="top">Saved date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">134</td>
|
|
<td align="center" valign="top">86</td>
|
|
<td align="left" valign="top">CHAR(50)</td>
|
|
<td align="left" valign="top">Text</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">184</td>
|
|
<td align="center" valign="top">B8</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Pending transactions</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">185</td>
|
|
<td align="center" valign="top">B9</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Remote journal type</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">186</td>
|
|
<td align="center" valign="top">BA</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Local journal name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">196</td>
|
|
<td align="center" valign="top">C4</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Local journal library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">206</td>
|
|
<td align="center" valign="top">CE</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Local journal system</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">214</td>
|
|
<td align="center" valign="top">D6</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Local journal receiver library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">224</td>
|
|
<td align="center" valign="top">E0</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Source journal name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">234</td>
|
|
<td align="center" valign="top">EA</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Source journal library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">244</td>
|
|
<td align="center" valign="top">F4</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Source journal system</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">252</td>
|
|
<td align="center" valign="top">FC</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Source journal receiver library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">262</td>
|
|
<td align="center" valign="top">106</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Redirected journal receiver library</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">272</td>
|
|
<td align="center" valign="top">110</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Dual journal receiver name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">282</td>
|
|
<td align="center" valign="top">11A</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Dual journal receiver library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">292</td>
|
|
<td align="center" valign="top">124</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Previous journal receiver name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">302</td>
|
|
<td align="center" valign="top">12E</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Previous journal receiver library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">312</td>
|
|
<td align="center" valign="top">138</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Previous dual journal receiver name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">322</td>
|
|
<td align="center" valign="top">142</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Previous dual journal receiver library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">332</td>
|
|
<td align="center" valign="top">14C</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Next journal receiver name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">342</td>
|
|
<td align="center" valign="top">156</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Next journal receiver library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">352</td>
|
|
<td align="center" valign="top">160</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Next dual journal receiver name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">362</td>
|
|
<td align="center" valign="top">16A</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Next dual journal receiver library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">372</td>
|
|
<td align="center" valign="top">174</td>
|
|
<td align="left" valign="top">CHAR(20)</td>
|
|
<td align="left" valign="top">Number of journal entries - long</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">392</td>
|
|
<td align="center" valign="top">188</td>
|
|
<td align="left" valign="top">CHAR(20)</td>
|
|
<td align="left" valign="top">Maximum entry-specific data length - long</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">412</td>
|
|
<td align="center" valign="top">19C</td>
|
|
<td align="left" valign="top">CHAR(20)</td>
|
|
<td align="left" valign="top">First sequence number - long</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">432</td>
|
|
<td align="center" valign="top">1B8</td>
|
|
<td align="left" valign="top">CHAR(20)</td>
|
|
<td align="left" valign="top">Last sequence number - long</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">452</td>
|
|
<td align="center" valign="top">1C4</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">ASP device name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">462</td>
|
|
<td align="center" valign="top">1CE</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Local journal ASP group name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">472</td>
|
|
<td align="center" valign="top">1D8</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Source journal ASP group name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">482</td>
|
|
<td align="center" valign="top">1E2</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Fixed length data *JOB</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">483</td>
|
|
<td align="center" valign="top">1E3</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Fixed length data *USR</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">484</td>
|
|
<td align="center" valign="top">1E4</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Fixed length data *PGM</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">485</td>
|
|
<td align="center" valign="top">1E5</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Fixed length data *PGMLIB</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">486</td>
|
|
<td align="center" valign="top">1E6</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Fixed length data *SYSSEQ</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">487</td>
|
|
<td align="center" valign="top">1E7</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Fixed length data *RMTADR</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">488</td>
|
|
<td align="center" valign="top">1E8</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Fixed length data *THD</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">489</td>
|
|
<td align="center" valign="top">1E9</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Fixed length data *LUW</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">490</td>
|
|
<td align="center" valign="top">1EA</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Fixed length data *XID</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">491</td>
|
|
<td align="center" valign="top">1EB</td>
|
|
<td align="left" valign="top">CHAR(21)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRRRCVIFL">Field Descriptions</a></h3>
|
|
|
|
<p><strong>Attached date and time.</strong> The date and time that this journal
|
|
receiver was attached to the journal. For a journal receiver attached to a
|
|
*REMOTE journal, this is the date and time that the journal receiver was
|
|
attached on the local system. This field is in the CYYMMDDHHMMSS format as
|
|
follows:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>C</em></td>
|
|
<td align="left" valign="top">Century, where 0 indicates years 19<em>xx</em> and 1 indicates years
|
|
20<em>xx</em>.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>YY</em></td>
|
|
<td align="left" valign="top">Year</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>MM</em></td>
|
|
<td align="left" valign="top">Month</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>DD</em></td>
|
|
<td align="left" valign="top">Day</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>HH</em></td>
|
|
<td align="left" valign="top">Hour</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>MM</em></td>
|
|
<td align="left" valign="top">Minute</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>SS</em></td>
|
|
<td align="left" valign="top">Second</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Auxiliary storage pool (ASP).</strong> The number of the auxiliary
|
|
storage pool to which storage for the object is allocated.</p>
|
|
|
|
<p><strong>ASP device
|
|
name.</strong> The name of the independent auxiliary storage pool (ASP) device
|
|
to which storage for the object is allocated. *SYSBAS is used to indicate the
|
|
system ASP and all basic user ASPs.</p>
|
|
|
|
<p><strong>Bytes available.</strong> The number of bytes of data available to
|
|
be returned. All available data is returned if enough space is provided.</p>
|
|
|
|
<p><strong>Bytes returned.</strong> The number of bytes of data returned.</p>
|
|
|
|
<p><strong>Detached date and time.</strong> The date and time that this journal
|
|
receiver was detached from the journal. For a journal receiver attached to a
|
|
*REMOTE journal, this is the date and time that the journal receiver was
|
|
detached on the local system. This field is in the CYYMMDDHHMMSS format, which
|
|
is described in the attached date and time field description.</p>
|
|
|
|
<p><strong>Dual journal receiver library name.</strong> The name of the library
|
|
that contains the dual journal receiver.</p>
|
|
|
|
<p>This field is blank if there is no dual receiver.</p>
|
|
|
|
<p><strong>Dual journal receiver name.</strong> The journal receiver that was
|
|
attached at the same time as the journal receiver.</p>
|
|
|
|
<p>This field is blank if there is no dual receiver.</p>
|
|
|
|
<p><strong>First sequence number.</strong> The journal sequence number of the
|
|
first journal entry in this journal receiver.</p>
|
|
|
|
<p>This field will be -1 if the value could not fit in the specified Binary(4)
|
|
field. The complete value will be in the First sequence number - long
|
|
field.</p>
|
|
|
|
<p><strong>First sequence number - long.</strong> This is the same field as
|
|
First sequence number except the information is in a Char(20) field which is
|
|
treated as Zoned(20,0).</p>
|
|
|
|
<p> <strong>Fixed length data
|
|
*JOB.</strong> Indicates whether the job name will be stored when journal
|
|
entries are deposited.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>blank</em></td>
|
|
<td align="left" valign="top">Blank is returned when the journal is a remote
|
|
journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will not
|
|
include the job name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will
|
|
include the job name.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Fixed length data *LUW.</strong> Indicates whether the logical unit
|
|
of work identifier will be stored when journal entries are deposited.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>blank</em></td>
|
|
<td align="left" valign="top">Blank is returned when the journal is a remote
|
|
journal</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will not
|
|
include the logical unit of work identifier.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal may
|
|
include the logical unit of work identifier.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Fixed length data *PGM.</strong> Indicates whether the program name
|
|
will be stored when journal entries are deposited.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>blank</em></td>
|
|
<td align="left" valign="top">Blank is returned when the journal is a remote
|
|
journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will not
|
|
include the program name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will
|
|
include the program name.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Fixed length data *PGMLIB.</strong> Indicates whether the program
|
|
library name will be stored when journal entries are deposited.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>blank</em></td>
|
|
<td align="left" valign="top">Blank is returned when the journal is a remote
|
|
journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will not
|
|
include the program library name and the library ASP information.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will
|
|
include the program library name and the library ASP information.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Fixed length data *RMTADR.</strong> Indicates whether the remote
|
|
address will be stored when journal entries are deposited.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>blank</em></td>
|
|
<td align="left" valign="top">Blank is returned when the journal is a remote
|
|
journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will not
|
|
include the remote address.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal may
|
|
include the remote address.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Fixed length data *SYSSEQ.</strong> Indicates whether the system
|
|
sequence number will be stored when journal entries are deposited.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>blank</em></td>
|
|
<td align="left" valign="top">Blank is returned when the journal is a remote
|
|
journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will not
|
|
include the system sequence number.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will
|
|
include the system sequence number.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Fixed length data *THD.</strong> Indicates whether the thread
|
|
identifier will be stored when journal entries are deposited.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>blank</em></td>
|
|
<td align="left" valign="top">Blank is returned when the journal is a remote
|
|
journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will not
|
|
include the thread identifier.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will
|
|
include the thread identifier.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Fixed length data *USR.</strong> Indicates whether the user name
|
|
will be stored when journal entries are deposited.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>blank</em></td>
|
|
<td align="left" valign="top">Blank is returned when the journal is a remote
|
|
journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will not
|
|
include the user name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will
|
|
include the user name.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Fixed length data *XID.</strong> Indicates whether the transaction
|
|
identifier will be stored when journal entries are deposited.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>blank</em></td>
|
|
<td align="left" valign="top">Blank is returned when the journal is a remote
|
|
journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal will not
|
|
include the transaction identifier.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Journal entries deposited to the journal may
|
|
include the transaction identifier.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<p><strong>Journal library name.</strong> The name of the library in which the
|
|
journal is stored.</p>
|
|
|
|
<p>This field is blank if this journal receiver is not yet associated with any
|
|
journal.</p>
|
|
|
|
<p><strong>Journal name.</strong> The name of the journal.</p>
|
|
|
|
<p>This field is *NONE if this journal receiver is not yet associated with any
|
|
journal.</p>
|
|
|
|
<p><strong>Journal receiver library name.</strong> The name of the library that
|
|
contains the journal receiver.</p>
|
|
|
|
<p><strong>Journal receiver name.</strong> The name of the journal
|
|
receiver.</p>
|
|
|
|
<p><strong>Last sequence number.</strong> The journal sequence number of the
|
|
last journal entry in this journal receiver.</p>
|
|
|
|
<p>This field will be -1 if the value could not fit in the specified Binary(4)
|
|
field. The complete value will be in the Last sequence number - long field.</p>
|
|
|
|
<p><strong>Last sequence number - long.</strong> This is the same field as Last
|
|
sequence number except the information is in a Char(20) field which is treated
|
|
as Zoned(20,0).</p>
|
|
|
|
<p><strong>Local journal ASP
|
|
group name.</strong> The name of the independent auxiliary storage pool (ASP)
|
|
group of the local journal. *SYSBAS is used to indicate the system ASP and all
|
|
basic user ASPs. The local journal is the journal that is the initiator of the
|
|
original journal deposit that has been replicated downstream to this
|
|
journal.</p>
|
|
|
|
<p>This field is blank if there is no local journal.</p>
|
|
|
|
<p><strong>Local journal library name.</strong> The library name of the local
|
|
journal. The local journal is the journal that is the initiator of the original
|
|
journal deposit that has been replicated downstream to this journal.</p>
|
|
|
|
<p>This field is blank if there is no local journal.</p>
|
|
|
|
<p><strong>Local journal name.</strong> The journal name of the local journal.
|
|
The local journal is the journal that is the initiator of the original journal
|
|
deposit that has been replicated downstream to this journal.</p>
|
|
|
|
<p>This field is blank if there is no local journal.</p>
|
|
|
|
<p>This field is *NONE if this journal receiver is not yet associated with any
|
|
journal.</p>
|
|
|
|
<p><strong>Local journal receiver library name.</strong> The library name of
|
|
the local journal receiver that is associated with the local journal. The local
|
|
journal is the journal that is the initiator of the original journal deposit
|
|
that has been replicated downstream to this journal.</p>
|
|
|
|
<p>This field is blank if there is no local journal.</p>
|
|
|
|
<p>This field is *NONE if this journal receiver is not yet associated with any
|
|
journal.</p>
|
|
|
|
<p><strong>Local journal system.</strong> The system name of the local journal.
|
|
The local journal is the journal that is the initiator of the original journal
|
|
deposit that has been replicated downstream to this journal.</p>
|
|
|
|
<p>This system name is determined when the remote journal is activated by using
|
|
the Change Remote Journal (CHGRMTJRN) command or by calling the Change Journal
|
|
State (QjoChangeJournalState) API. The name is based on the current system name
|
|
at that time as seen by using the Display Network Attributes (DSPNETA)
|
|
command.</p>
|
|
|
|
<p>This field is blank if there is no local journal.</p>
|
|
|
|
<p><strong>Maximum entry-specific data length.</strong> The length in bytes of
|
|
the longest entry-specific data among all journal entries in this journal
|
|
receiver.</p>
|
|
|
|
<p>This field will be -1 if the value could not fit in the specified Binary(4)
|
|
field. The complete value will be in the Maximum entry-specific data length -
|
|
long field.</p>
|
|
|
|
<p><strong>Maximum entry-specific data length - long.</strong> This is the same
|
|
field as Maximum entry-specific data length except the information is in a
|
|
Char(20) field which is treated as Zoned(20,0).</p>
|
|
|
|
<p><strong>Maximum null value indicators.</strong> The maximum number of null
|
|
value indicators among all journal entries in this journal receiver.</p>
|
|
|
|
<p><strong>Minimize entry specific data for data areas.</strong> Whether the
|
|
receiver was attached when MINENTDTA(*DTAARA) was in effect for the journal.
|
|
Possible values follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Journal entries for data areas will have complete
|
|
entry specific data.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Journal entries for data areas may have minimized
|
|
entry specific data.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>If this journal receiver is associated with a remote journal, then the value
|
|
for this field was determined by the local journal.</p>
|
|
|
|
<p><strong>Minimize entry specific data for files.</strong> Whether the
|
|
receiver was attached when MINENTDTA(*FILE) was in effect for the journal.
|
|
Possible values follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Journal entries for files will have complete
|
|
entry specific data.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Journal entries for files may have minimized
|
|
entry specific data.
|
|
<img src="v5r4adelta.gif" alt="Start of change">
|
|
The minimizing does not occur on field boundaries.
|
|
Therefore, the entry specific data may not be viewable and may not be used for
|
|
auditing purposes.
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">Journal entries for files may have minimized
|
|
entry specific data. The minimizing occurs on
|
|
field boundaries. Therefore, the entry specific data will be viewable and
|
|
may be used for auditing purposes.
|
|
<img src="v5r4adeltaend.gif" alt="End of change">
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>If this journal receiver is associated with a remote journal, then the value
|
|
for this field was determined by the local journal.</p>
|
|
|
|
<p><strong>Next dual journal receiver library name.</strong> The library name
|
|
of the next dual journal receiver that is associated with this journal
|
|
receiver.</p>
|
|
|
|
<p>This field is blank if there is no next dual journal receiver, or if the
|
|
specified journal receiver is currently associated with a remote journal.</p>
|
|
|
|
<p><strong>Next dual journal receiver name.</strong> The name of the next dual
|
|
journal receiver that is associated with this journal receiver.</p>
|
|
|
|
<p>This field is blank if there is no next dual journal receiver, or if the
|
|
specified journal receiver is currently associated with a remote journal.</p>
|
|
|
|
<p><strong>Next journal receiver library name.</strong> The library name of the
|
|
next journal receiver that is associated with this journal receiver.</p>
|
|
|
|
<p>This field is blank if there is no next journal receiver, or if the
|
|
specified journal receiver is currently associated with a remote journal.</p>
|
|
|
|
<p><strong>Next journal receiver name.</strong> The name of the next journal
|
|
receiver that is associated with this journal receiver.</p>
|
|
|
|
<p>This field is blank if there is no next journal receiver, or if the
|
|
specified journal receiver is currently associated with a remote journal.</p>
|
|
|
|
<p><strong>Number of journal entries.</strong> The number of journal entries
|
|
that are contained in this journal receiver.</p>
|
|
|
|
<p>This field will be -1 if the value could not fit in the specified Binary(4)
|
|
field. The complete value will be in the Number of journal entries - long
|
|
field.</p>
|
|
|
|
<p><strong>Number of journal entries - long.</strong> This is the same field as
|
|
Number of journal entries except the information is in a Char(20) field which
|
|
is treated as Zoned(20,0).</p>
|
|
|
|
<p><strong>Pending transactions.</strong> Whether the journal receiver contains
|
|
journal entries for commitment control transactions that have not yet been
|
|
committed or rolled back. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The journal receiver does not contain entries for
|
|
pending commitment control transactions.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The journal receiver contains entries for pending
|
|
commitment control transactions.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Previous dual journal receiver library name.</strong> The library
|
|
name of the previous dual journal receiver that is associated with this journal
|
|
receiver.</p>
|
|
|
|
<p>This field is blank if there is no previous dual journal receiver, or if the
|
|
specified journal receiver is currently associated with a remote journal.</p>
|
|
|
|
<p><strong>Previous dual journal receiver name.</strong> The name of the
|
|
previous dual journal receiver that is associated with this journal
|
|
receiver.</p>
|
|
|
|
<p>This field is blank if there is no previous dual journal receiver, or if the
|
|
specified journal receiver is currently associated with a remote journal.</p>
|
|
|
|
<p><strong>Previous journal receiver library name.</strong> The library name of
|
|
the previous journal receiver that is associated with this journal
|
|
receiver.</p>
|
|
|
|
<p>This field is blank if there is no previous journal receiver, or if the
|
|
specified journal receiver is currently associated with a remote journal.</p>
|
|
|
|
<p><strong>Previous journal receiver name.</strong> The name of the previous
|
|
journal receiver that is associated with this journal receiver.</p>
|
|
|
|
<p>This field is blank if there is no previous journal receiver, or if the
|
|
specified journal receiver is currently associated with a remote journal.</p>
|
|
|
|
<p><strong>Receiver maximums option.</strong> Indicates the journal receiver
|
|
sequence number and size option for this journal receiver. Possible values
|
|
follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>blank</em></td>
|
|
<td align="left" valign="top">The journal receiver has not yet been attached to
|
|
any journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The journal receiver has a maximum journal
|
|
receiver size of approximately 1.9 gigabytes and a maximum sequence number of
|
|
2,147,483,136.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The journal receiver has a maximum journal
|
|
receiver size of approximately one terabyte (1,099,511,627,776 bytes) and a
|
|
maximum sequence number of 9,999,999,999. Additionally, the maximum size of the
|
|
journal entry that can be deposited is 15,761,440 bytes. This occurs if this
|
|
receiver was attached when RCVSIZOPT(*MAXOPT1) was in effect for the journal.
|
|
These journal receivers cannot be saved and restored to any releases prior to
|
|
V4R5M0, nor can they be replicated to any remote journals on any systems at
|
|
releases prior to V4R5M0.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">The journal receiver has a maximum journal
|
|
receiver size of approximately one terabyte (1,099,511,627,776 bytes) and a
|
|
maximum sequence number of 9,999,999,999. This occurs if this receiver was
|
|
attached when RCVSIZOPT(*MAXOPT2) was in effect for the journal. Additionally,
|
|
the maximum size of the journal entry which can be deposited is 4,000,000,000
|
|
bytes. These journal receivers cannot be saved and restored to any releases
|
|
prior to V5R1M0, nor can they be replicated to any remote journals on any
|
|
systems at releases prior to V5R1M0.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>3</em></td>
|
|
<td align="left" valign="top">The journal receiver has a maximum journal
|
|
receiver size of approximately one terabyte (1,099,511,627,776 bytes) and a
|
|
maximum sequence number of 18,446,744,073,709,551,600. This occurs if this
|
|
receiver was
|
|
attached when RCVSIZOPT(*MAXOPT3) was in effect for the journal. Additionally,
|
|
the maximum size of the journal entry which can be deposited is 4,000,000,000
|
|
bytes. These journal receivers cannot be saved and restored to any releases
|
|
prior to V5R3M0, nor can they be replicated to any remote journals on any
|
|
systems at releases prior to V5R3M0.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>If this journal receiver is associated with a remote journal, then the value
|
|
for this field was determined by the local journal.</p>
|
|
|
|
<p> <strong>Receiver size option
|
|
*MINFIXLEN.</strong> The size
|
|
of the journal entries that are deposited into the attached journal receivers
|
|
is reduced by the automatic removal of all fixed length data such as job name,
|
|
system sequence number, and so on. This option is applicable only for local journals
|
|
and is blank for remote journals.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>blank</em></td>
|
|
<td align="left" valign="top">Blank is returned when the journal is a remote
|
|
journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The journal entries in the receiver include all
|
|
of the fixed length data such as job name, system sequence number, and so on.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The journal entries in the receiver do not
|
|
include any fixed length data such as job name, system sequence number, and so on.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<p><strong>Redirected journal receiver library.</strong> If this journal
|
|
receiver was attached to a remote journal, this field is the *TYPE1 receiver
|
|
library redirection that was in effect when this journal receiver was
|
|
attached.</p>
|
|
|
|
<p>This field is blank if this journal receiver was attached to a local
|
|
journal, or if the journal receiver was attached to a remote journal with no
|
|
*TYPE1 receiver library redirection.</p>
|
|
|
|
<p>This field is *NONE if this journal receiver is not yet associated with any
|
|
journal.</p>
|
|
|
|
<p><strong>Remote journal type.</strong> If this journal receiver was attached
|
|
to a remote journal, this field is the remote journal type for that journal,
|
|
when this journal receiver was attached. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>blank</em></td>
|
|
<td align="left" valign="top">The journal receiver has not yet been attached to
|
|
any journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The journal receiver was attached to a local
|
|
journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The journal receiver was attached to a *TYPE1
|
|
remote journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">The journal receiver was attached to a *TYPE2
|
|
remote journal.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Reserved.</strong> The bytes reserved to align binary fields or for
|
|
future use.</p>
|
|
|
|
<p><strong>Saved date and time.</strong> The date and time that the journal
|
|
receiver was last saved. This value reflects when the receiver was saved from
|
|
the system it exists on (either the source or target system time). This field
|
|
is in the CYYMMDDHHMMSS format, which is described in the attached date and
|
|
time field description.</p>
|
|
|
|
<p><strong>Size.</strong> The number of kilobytes of auxiliary disk storage
|
|
used by this journal receiver.</p>
|
|
|
|
<p><strong>Source journal ASP
|
|
group name.</strong> The name of the independent auxiliary storage pool (ASP)
|
|
group of the source journal. *SYSBAS is used to indicate the system ASP and all
|
|
basic user ASPs. The source journal is the journal that is directly upstream of
|
|
this journal.</p>
|
|
|
|
<p>This field is blank if there is no source journal.</p>
|
|
|
|
<p><strong>Source journal library name.</strong> The library name of the source
|
|
journal. The source journal is the journal that is directly upstream of this
|
|
remote journal.</p>
|
|
|
|
<p>This field is blank if there is no source journal.</p>
|
|
|
|
<p><strong>Source journal name.</strong> The journal name of the source
|
|
journal. The source journal is the journal that is directly upstream of this
|
|
remote journal.</p>
|
|
|
|
<p>This field is blank if there is no source journal.</p>
|
|
|
|
<p>This field is *NONE if this journal receiver is not yet associated with any
|
|
journal.</p>
|
|
|
|
<p><strong>Source journal receiver library name.</strong> The library name of
|
|
the source journal receiver that is associated with the source journal. The
|
|
source journal is the journal that is directly upstream of this remote
|
|
journal.</p>
|
|
|
|
<p>This field is blank if there is no source journal.</p>
|
|
|
|
<p>This field is *NONE if this journal receiver is not yet associated with any
|
|
journal.</p>
|
|
|
|
<p><strong>Source journal system.</strong> The system name of the source
|
|
journal. The source journal is the journal that is directly upstream of this
|
|
remote journal.</p>
|
|
|
|
<p>This system name is determined when the remote journal is activated by using
|
|
the Change Remote Journal (CHGRMTJRN) command or by calling the Change Journal
|
|
State (QjoChangeJournalState) API, and is based on the current system name at
|
|
that time as seen by using the Display Network Attributes (DSPNETA)
|
|
command.</p>
|
|
|
|
<p>This field is blank if there is no source journal.</p>
|
|
|
|
<p><strong>Status.</strong> The status of the journal receiver. The status can
|
|
be one of the following:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The journal receiver is currently attached to the
|
|
journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">The journal receiver is online. The journal
|
|
receiver has not been saved, and it has been detached from the journal.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>3</em></td>
|
|
<td align="left" valign="top">The journal receiver was saved after it was
|
|
detached. The journal receiver storage was not freed when it was saved.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>4</em></td>
|
|
<td align="left" valign="top">The journal receiver was saved after it was
|
|
detached. The journal receiver storage was freed when it was saved.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>5</em></td>
|
|
<td align="left" valign="top">The journal receiver status is partial for one of
|
|
the following reasons:
|
|
|
|
<ul>
|
|
<li>It was restored from a version that was saved while it was attached to the
|
|
journal. Additional journal entries may have been written that were not
|
|
restored.</li>
|
|
|
|
<li>It was one of a pair of dual journal receivers, and it was found damaged
|
|
while attached to the journal. The journal receiver has since been detached.
|
|
This journal receiver is considered partial because additional journal entries
|
|
may have been written to the dual journal receiver.</li>
|
|
|
|
<li>It is associated with a remote journal and it does not contain all the
|
|
journal entries that are in the associated journal receiver attached to the
|
|
source journal.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>6</em></td>
|
|
<td align="left" valign="top">The journal receiver status is empty, since the
|
|
receiver has never been attached to a journal.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Text.</strong> The text description of the journal receiver.</p>
|
|
|
|
<p><strong>Threshold.</strong> An auxiliary disk storage space threshold value
|
|
(in kilobytes) for the journal receiver. If the threshold value is exceeded
|
|
during journaling and the journal has the MNGRCV(*USER) attribute, a message
|
|
(CPF7099) is sent to the message queue that is specified on the Create Journal
|
|
(CRTJRN) or the Change Journal (CHGJRN) command. If the journal has the
|
|
MNGRCV(*SYSTEM) attribute, the system creates and attaches a new journal
|
|
receiver, detaches the old journal receiver when the threshold is reached, and
|
|
sends message CPF7020 to the journal message queue. This option is applicable
|
|
only for local journals and is zero for remote journals.<br>
|
|
</p>
|
|
|
|
<h3>Error Messages</h3>
|
|
|
|
<table width="100%" cellpadding="3">
|
|
<tr>
|
|
<th align="left" valign="top">Message ID</th>
|
|
<th align="left" valign="top">Error Message Text</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td width="15%" valign="top">CPF24B4 E</td>
|
|
<td width="85%" valign="top">Severe error while addressing parameter list.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3CF1 E</td>
|
|
<td valign="top">Error code parameter not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3C21 E</td>
|
|
<td valign="top">Format name &1 is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3C24 E</td>
|
|
<td valign="top">Length of the receiver variable is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3C90 E</td>
|
|
<td valign="top">Literal value cannot be changed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF6948 E</td>
|
|
<td valign="top">Length of the receiver variable &1 is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF701A E</td>
|
|
<td valign="top">Journal receiver not eligible for operation.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF701B E</td>
|
|
<td valign="top">Journal recovery of interrupted operation failed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF8100 E</td>
|
|
<td valign="top">All CPF81xx messages could be returned. xx is from 01 to
|
|
FF.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9801 E</td>
|
|
<td valign="top">Object &2 in library &3 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9802 E</td>
|
|
<td valign="top">Not authorized to object &2 in &3.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9803 E</td>
|
|
<td valign="top">Cannot allocate object &2 in library &3.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9804 E</td>
|
|
<td valign="top">Object &2 in library &3 damaged.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9810 E</td>
|
|
<td valign="top">Library &1 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9820 E</td>
|
|
<td valign="top">Not authorized to use library &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9872 E</td>
|
|
<td valign="top">Program or service program &1 in library &2 ended.
|
|
Reason code &3.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<hr>
|
|
API introduced: V4R2
|
|
|
|
<hr>
|
|
<table cellpadding="2" cellspacing="2" align="center">
|
|
<tr align="center">
|
|
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
|
|
"jc1.htm">Journal and Commit APIs</a> | <a href="aplist.htm">APIs by
|
|
category</a></td>
|
|
</tr>
|
|
</table>
|
|
</body>
|
|
</html>
|
|
|