507 lines
21 KiB
HTML
507 lines
21 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>Change Remote Journal (CHGRMTJRN)</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="CHGRMTJRN.Top_Of_Page"></a>
|
||
|
|
<h2>Change Remote Journal (CHGRMTJRN)</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="#CHGRMTJRN.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CHGRMTJRN.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CHGRMTJRN.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CHGRMTJRN"></a>
|
||
|
|
<p>The Change Remote Journal (CHGRMTJRN) command is used to change the journal state for remote journals.
|
||
|
|
</p>
|
||
|
|
<p>This command is used on the source system for a remote journal that is associated with a source-system journal, to change the state of the remote journal from *ACTIVE to *INACTIVE or from *INACTIVE to *ACTIVE. A journal state of *ACTIVE for a remote journal indicates that journal entries can be received from the associated journal on the source system. A journal state of *INACTIVE for a remote journal indicates that the journal is not ready to receive journal entries from a source journal. This command also allows additional attributes that are associated with the journal state to be set.
|
||
|
|
</p>
|
||
|
|
<p>The Change Journal (CHGJRN) command can be used to modify the other journal attributes of remote journals, such as the journal message queue, deleting receivers, and text.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>A user profile must exist on the target system by the same name as the user profile that is running this command on the source system. This restriction is irrespective of the selected communications protocol.
|
||
|
|
</li>
|
||
|
|
<li>Synchronous delivery mode is not supported when a remote journal is specified for the source system journal name parameter.
|
||
|
|
</li>
|
||
|
|
<li>The journal state of the remote journal to be activated cannot already be *ACTIVE.
|
||
|
|
</li>
|
||
|
|
<li>The journal state of the remote journal to be inactivated cannot already be *INACTIVE.
|
||
|
|
</li>
|
||
|
|
<li>If the remote journal state is *CTLINACT, then the remote journal cannot be inactivated by specifying a INACTOPT(*CNTRLD).
|
||
|
|
</li>
|
||
|
|
<li>The remote journal to be activated cannot already be replicating journal entries to other remote journals.
|
||
|
|
</li>
|
||
|
|
<li>A journal receiver that was one of a pair of dual receivers cannot be replicated.
|
||
|
|
</li>
|
||
|
|
<li>A journal receiver that was never attached to a journal after Version 4 Release 2 Modification 0 has been installed cannot be replicated because all of the required information is not contained within the receiver.
|
||
|
|
</li>
|
||
|
|
<li>The specified relational database directory entry (RDB) 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="#CHGRMTJRN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CHGRMTJRN.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="#CHGRMTJRN.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="#CHGRMTJRN.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="#CHGRMTJRN.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><tr>
|
||
|
|
<td valign="top"><a href="#CHGRMTJRN.JRNSTATE"><b>JRNSTATE</b></a></td>
|
||
|
|
<td valign="top">Journal state</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *ACTIVE, *INACTIVE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGRMTJRN.DELIVERY"><b>DELIVERY</b></a></td>
|
||
|
|
<td valign="top">Delivery</td>
|
||
|
|
<td valign="top"><b><u>*ASYNC</u></b>, *SYNC</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CHGRMTJRN.STRJRNRCV"><b>STRJRNRCV</b></a></td>
|
||
|
|
<td valign="top">Starting journal receiver</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ATTACHED</u></b>, *SRCSYS<br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Starting journal receiver</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="#CHGRMTJRN.SNDTSKPTY"><b>SNDTSKPTY</b></a></td>
|
||
|
|
<td valign="top">Sending task priority</td>
|
||
|
|
<td valign="top">1-99, <b><u>*SYSDFT</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGRMTJRN.INACTOPT"><b>INACTOPT</b></a></td>
|
||
|
|
<td valign="top">How to make inactive</td>
|
||
|
|
<td valign="top"><b><u>*CNTRLD</u></b>, *IMMED</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRMTJRN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CHGRMTJRN.RDB"></a>
|
||
|
|
<h3>Relational database (RDB)</h3>
|
||
|
|
<p>Specifies the name of the relational database directory entry that contains the remote location name of the target system. This name should match the name of the *LOCAL relational database directory entry on the target system.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>relational-database-entry</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="#CHGRMTJRN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGRMTJRN.SRCJRN"></a>
|
||
|
|
<h3>Source journal (SRCJRN)</h3>
|
||
|
|
<p>Specifies the name of the source journal that is associated with the remote journal that is being changed, and the library in which it resides.
|
||
|
|
</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 source journal that is associated with the remote journal that is being changed.
|
||
|
|
</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 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>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library in which the journal resides.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRMTJRN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGRMTJRN.TGTJRN"></a>
|
||
|
|
<h3>Target journal (TGTJRN)</h3>
|
||
|
|
<p>Specifies the remote journal on the target system that is being changed.
|
||
|
|
</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 name of the target journal that is being changed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library in which the journal resides.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRMTJRN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGRMTJRN.JRNSTATE"></a>
|
||
|
|
<h3>Journal state (JRNSTATE)</h3>
|
||
|
|
<p>Specifies whether the remote journal is ready to receive journal entries from a source journal.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ACTIVE</b></dt>
|
||
|
|
<dd>The remote journal is ready to receive journal entries from a source journal.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*INACTIVE</b></dt>
|
||
|
|
<dd>The remote journal is not ready to receive journal entries from a source journal.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRMTJRN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGRMTJRN.DELIVERY"></a>
|
||
|
|
<h3>Delivery (DELIVERY)</h3>
|
||
|
|
<p>Specifies whether journal entries are replicated synchronously or asynchronously when the remote journal is activated.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is only valid when JRNSTATE(*ACTIVE) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ASYNC</u></b></dt>
|
||
|
|
<dd>Journal entries are replicated asynchronously.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYNC</b></dt>
|
||
|
|
<dd>Journal entries are replicated synchronously.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRMTJRN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGRMTJRN.STRJRNRCV"></a>
|
||
|
|
<h3>Starting journal receiver (STRJRNRCV)</h3>
|
||
|
|
<p>The journal receiver where the replication of journal entries from the source system to the target system starts.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is only valid when JRNSTATE(*ACTIVE) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ATTACHED</u></b></dt>
|
||
|
|
<dd>The replication of journal entries starts with the journal receiver that is currently attached to the remote journal on the target system. The journal entries are replicated from the corresponding journal receiver that is associated with the journal on the source system. The replication starts with the journal entries that follow the last journal entry that currently exists in the attached journal receiver on the target system. If the remote journal on the target system does not have an attached journal receiver, the journal receiver that is currently attached to the journal on the source system is created on the target system and attached to the remote journal on the target system. Then journal entries are replicated starting with the first journal entry in the journal receiver that is currently attached to the journal on the source system. If the journal on the source system does not have an attached journal receiver, which is only possible in the case of a remote journal that is associated with another remote journal, no journal entries can be replicated and an error is returned.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SRCSYS</b></dt>
|
||
|
|
<dd>The replication of journal entries starts with the journal receiver that is currently attached to the journal on the source system. If the corresponding journal receiver exists and is attached to the remote journal on the target system, journal entries are replicated starting with the journal entries that follow the last journal entry that currently exists in the attached journal receiver on the target system. Otherwise, if the corresponding journal receiver exists but is not attached to the remote journal on the target system, no journal entries can be replicated and an error is returned. If the corresponding journal receiver does not exist on the target system, the journal receiver is created on the target system and attached to the remote journal on the target system. Then journal entries are replicated starting with the first journal entry in the journal receiver that is currently attached to the journal on the source system. If the journal on the source system does not have an attached journal receiver, which is only possible in the case of a remote journal that is associated with another remote journal, no journal entries can be replicated and an error is returned.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>starting-journal-receiver-name</i></b></dt>
|
||
|
|
<dd>Specify the journal receiver where the replication of journal should start. If the corresponding journal receiver exists and is attached to the remote journal on the target system, journal entries are replicated starting with the journal entries that follow the last journal entry that currently exists in the attached journal receiver on the target system. Otherwise, if the corresponding journal receiver exists but is not attached to the remote journal on the target system, no journal entries can be replicated and an error is returned. If the corresponding journal receiver does not exist on the target system, then the journal receiver is created on the target system and attached to the remote journal on the target system. Then journal entries are replicated starting with the first journal entry in the specified journal receiver on the source system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The name of the starting journal receiver 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="#CHGRMTJRN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGRMTJRN.SNDTSKPTY"></a>
|
||
|
|
<h3>Sending task priority (SNDTSKPTY)</h3>
|
||
|
|
<p>Specifies the priority of the sending task on the source system for asynchronously maintained remote journals. The priority is a value from 1 (highest priority) through 99 (lowest priority), which represents the importance of the task when it competes with other tasks for machine resources. This value represents the relative (not absolute) importance of the task.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is only valid when JRNSTATE(*ACTIVE) and DELIVERY(*ASYNC) are specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYSDFT</u></b></dt>
|
||
|
|
<dd>The system chooses a value for the sending task priority that is higher than the highest priority a user may specify (higher than priority 1).
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>sending-task-priority</i></b></dt>
|
||
|
|
<dd>Specify a value between 1 and 99 for the priority of the sending task on the source system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRMTJRN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGRMTJRN.INACTOPT"></a>
|
||
|
|
<h3>How to make inactive (INACTOPT)</h3>
|
||
|
|
<p>Specifies how the replication of journal entries should be ended when the remote journal is inactivated.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is only valid when JRNSTATE(*INACTIVE) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CNTRLD</u></b></dt>
|
||
|
|
<dd>A controlled inactivate of journal entry replication is performed. A controlled inactivate means that the system should replicate all journal entries already queued to be sent from the source system to the target system before inactivating the remote journal. No additional journal entries are queued after a request to perform a controlled inactivate. A controlled inactivate is not possible when a journal is in catch-up, or when it is being synchronously maintained. In both of these cases, the request to perform a controlled inactivate is implicitly changed by the system to an immediate inactivate request.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IMMED</b></dt>
|
||
|
|
<dd>An immediate inactivate of journal entry replication is performed. An immediate inactivate means that the system will not continue to replicate any journal entries that are already queued before inactivating the remote journal.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRMTJRN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGRMTJRN.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Activating a Remote Journal to be Maintained Asynchronously</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGRMTJRN RDB(CHICAGO)
|
||
|
|
SRCJRN(LCLLIB/JOURNAL1) TGTJRN(RMTLIB/JOURNAL1)
|
||
|
|
JRNSTATE(*ACTIVE) DELIVERY(*ASYNC)
|
||
|
|
SNDTSKPTY(*SYSDFT)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command activates remote journal JOURNAL1 in library RMTLIB so that journal entries will be replicated from source journal JOURNAL1 in library LCLLIB to remote journal JOURNAL1 in library RMTLIB. The replication will occur asynchronously, and the system will set the priority of the sending task.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Inactivating a Remote Journal</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGRMTJRN RDB(CHICAGO) SRCJRN(LCLLIB/JOURNAL1)
|
||
|
|
TGTJRN(RMTLIB/JOURNAL1)
|
||
|
|
JRNSTATE(*INACTIVE) INACTOPT(*IMMED)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command inactivates remote journal JOURNAL1 in library RMTLIB so that journal entries will no longer be replicated from source journal JOURNAL1 in library LCLLIB to remote journal JOURNAL1 in library RMTLIB. The inactivation will occur immediately.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRMTJRN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGRMTJRN.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF69A2</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF69A3</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF694D</b></dt>
|
||
|
|
<dd>Unexpected journal receiver &8 found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF694F</b></dt>
|
||
|
|
<dd>Communications failure. Reason code &10.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF696F</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF697A</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF697B</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF697C</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF697D</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF697E</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF697F</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6973</b></dt>
|
||
|
|
<dd>Systems or journal environments not compatible.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6974</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF698A</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF698B</b></dt>
|
||
|
|
<dd>Unexpected journal receiver attached to &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF698C</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF698D</b></dt>
|
||
|
|
<dd>Journal &1 not a remote journal.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF698E</b></dt>
|
||
|
|
<dd>Journal &1 not associated with source journal.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF698F</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6982</b></dt>
|
||
|
|
<dd>Relational database directory entry &1 not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF699A</b></dt>
|
||
|
|
<dd>Unexpected journal receiver &8 found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF699E</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6993</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6994</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6995</b></dt>
|
||
|
|
<dd>Unexpected journal receiver &8 found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6996</b></dt>
|
||
|
|
<dd>Replication of journal entries ended.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6997</b></dt>
|
||
|
|
<dd>Unexpected journal receiver &8 found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6998</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6999</b></dt>
|
||
|
|
<dd>State of journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF70A3</b></dt>
|
||
|
|
<dd>Remote journal &1 in &2 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF70DB</b></dt>
|
||
|
|
<dd>Remote journal function failed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF70D9</b></dt>
|
||
|
|
<dd>Changing journal state not allowed. Reason code &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF701B</b></dt>
|
||
|
|
<dd>Journal recovery of an interrupted operation failed.
|
||
|
|
</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>CPF9814</b></dt>
|
||
|
|
<dd>Device &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="#CHGRMTJRN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|