238 lines
8.1 KiB
HTML
238 lines
8.1 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>Remove Remote Journal (RMVRMTJRN)</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="RMVRMTJRN.Top_Of_Page"></a>
|
|
<h2>Remove Remote Journal (RMVRMTJRN)</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="#RMVRMTJRN.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RMVRMTJRN.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RMVRMTJRN.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RMVRMTJRN"></a>
|
|
<p>The Remove Remote Journal (RMVRMTJRN) command disassociates a remote journal on the specified target system from the specified journal on the source system. The journal on the source system may be either a local journal or another remote journal.
|
|
</p>
|
|
<p>The remote journal, and any associated journal receivers, are not deleted from the target system by the command processing. No processing is performed on the target system for the command. The remote journal that remains on the target system may later be added back to the remote journal definition for the journal on the source system by using the Add Remote Journal (ADDRMTJRN) command or the Add Remote Journal (QjoAddRemoteJournal) API.
|
|
</p>
|
|
<p>It is the responsibility of the user to delete the remote journal and any associated journal receivers from the target system, if so desired.
|
|
</p>
|
|
<p>Once a remote journal association has been removed from a journal, all of the journal receivers that are currently in the journal's receiver directory on the source system will no longer be protected from deletion even if the journal entries have not yet been replicated to the remote journal.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>The command must be called from the source system for a local or remote journal.
|
|
</li>
|
|
<li>The remote journal on the specified target system cannot have a journal state of *ACTIVE.
|
|
</li>
|
|
<li>The specified relational database (RDB) directory entry must meet the following rules:
|
|
<ul>
|
|
<li>The communications protocol must be one of the remote journal function supported protocols.
|
|
</li>
|
|
<li>The remote location name in the RDB cannot refer to the *LOCAL database.
|
|
</li>
|
|
<li>The RDB cannot use an application requester driver program (*ARDPGM) to locate the target system.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVRMTJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RMVRMTJRN.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"><a href="#RMVRMTJRN.RDB"><b>RDB</b></a></td>
|
|
<td valign="top">Relational database</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RMVRMTJRN.SRCJRN"><b>SRCJRN</b></a></td>
|
|
<td valign="top">Source journal</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Source 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" rowspan="3"><a href="#RMVRMTJRN.TGTJRN"><b>TGTJRN</b></a></td>
|
|
<td valign="top">Target journal</td>
|
|
<td valign="top">Single values: <b><u>*SRCJRN</u></b><br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Target journal</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr></table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVRMTJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RMVRMTJRN.RDB"></a>
|
|
<h3>Relational database (RDB)</h3>
|
|
<p>The name of the relational database directory entry that contains the remote location name of the target system.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>relational-database-entry-name</i></b></dt>
|
|
<dd>Specify a maximum of 18 characters for the name of the relational database directory entry.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVRMTJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVRMTJRN.SRCJRN"></a>
|
|
<h3>Source journal (SRCJRN)</h3>
|
|
<p>Specifies the journal on the source system from which the remote journal is being removed. The journal on the source system may be either a local journal or a remote journal.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Source journal</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>source-journal-name</i></b></dt>
|
|
<dd>Specify the name of the source journal from which the target journal is being removed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<p>The name of the source journal can be qualified by one of the following library values:
|
|
</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 thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<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="#RMVRMTJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVRMTJRN.TGTJRN"></a>
|
|
<h3>Target journal (TGTJRN)</h3>
|
|
<p>Specifies the remote journal on the target system.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SRCJRN</u></b></dt>
|
|
<dd>The target journal name is exactly the same as the source journal name.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Target journal</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>target-journal-name</i></b></dt>
|
|
<dd>Specify the target journal that is being removed from the source journal.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<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="#RMVRMTJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVRMTJRN.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Removing a Remote Journal Whose Name is the Same as the Source Journal.</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVRMTJRN SRCJRN(RMTLIB/JOURNAL) RDB(CHICAGO)
|
|
TGTJRN(*SRCJRN)
|
|
</pre>
|
|
</p>
|
|
<p>This command removes remote journal JOURNAL in library RMTLIB identified by relational database directory entry, CHICAGO, from the source journal JOURNAL in library RMTLIB.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVRMTJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVRMTJRN.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF6981</b></dt>
|
|
<dd>Remote journal &1 in &2 not removed.
|
|
</dd>
|
|
<dt><b>CPF6982</b></dt>
|
|
<dd>Relational database directory entry &1 not valid.
|
|
</dd>
|
|
<dt><b>CPF6992</b></dt>
|
|
<dd>Remote journal &1 in &2 not removed.
|
|
</dd>
|
|
<dt><b>CPF9801</b></dt>
|
|
<dd>Object &2 in library &3 not found.
|
|
</dd>
|
|
<dt><b>CPF9802</b></dt>
|
|
<dd>Not authorized to object &2 in &3.
|
|
</dd>
|
|
<dt><b>CPF9803</b></dt>
|
|
<dd>Cannot allocate object &2 in library &3.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF9830</b></dt>
|
|
<dd>Cannot assign library &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVRMTJRN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|