311 lines
13 KiB
HTML
311 lines
13 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>Delete Journal Receiver (DLTJRNRCV)</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="DLTJRNRCV.Top_Of_Page"></a>
|
|
<h2>Delete Journal Receiver (DLTJRNRCV)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>Conditional
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#DLTJRNRCV.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DLTJRNRCV.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DLTJRNRCV.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DLTJRNRCV"></a>
|
|
<p>The Delete Journal Receiver (DLTJRNRCV) command deletes the specified journal receivers from the system, which frees the storage space allocated to the journal receivers. Exit point QIBM_QJO_DLT_JRNRCV is provided for the DLTJRNRCV command. See the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for more information.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>The journal receiver must not be attached to a journal at the time the command is issued.
|
|
</li>
|
|
<li>If an attempt is made to delete a journal receiver that is attached to a remote journal, and that remote journal is not actively receiving journal entries or replicating journal entries, and DLTOPT(*IGNINQMSG) is not specified, an inquiry message (CPA705E) is sent to the requesting workstation. If the request is made from a batch job, the message is sent to the system operator. This inquiry message can be automatically replied to. For more information, refer to the INQMSGRPY parameter of the Create Job Description (CRTJOBD) command.
|
|
</li>
|
|
<li>The journal receiver must not be in the middle of a chain of online receivers unless it is damaged or if its dual receiver is damaged. (The receivers must be deleted in the same order in which they were detached, to prevent gaps from occurring in the range of receivers).
|
|
</li>
|
|
<li>If an attempt is made to delete a journal receiver that has not been saved and DLTOPT(*IGNINQMSG) is not specified, an inquiry message (CPA7025) is sent to the requesting work station. If the request is made from a batch job, the message is sent to the system operator. This inquiry message can be replied to automatically. For more information, refer to the INQMSGRPY parameter on the Create Job Description (CRTJOBD) command.
|
|
</li>
|
|
<li>The user must have *ALLOBJ and *SECADM authority in order to specify the *IGNEXITPGM special value.
|
|
</li>
|
|
<li>This command is conditionally threadsafe if exit programs are registered for exit point QIBM_QJO_DLT_JRNRCV as follows:
|
|
<ul>
|
|
<li>If no exit programs are registered or DLTOPT(*IGNEXITPGM) is specified, the command is threadsafe.
|
|
</li>
|
|
<li>If all exit programs are threadsafe and registered to run in a multithreaded job, the command is threadsafe.
|
|
</li>
|
|
<li>If any exit program is registered to not run in a multithreaded job and is being attempted to run in a multithreaded job, the command will fail and the journal receiver will not be deleted.
|
|
</li>
|
|
</ul>
|
|
<p>Use the MLTTHDACN parameter on the ADDEXITPGM command to specify whether an exit program can run in a multithreaded job. See the ADDEXITPGM command for more information.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTJRNRCV.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DLTJRNRCV.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="#DLTJRNRCV.JRNRCV"><b>JRNRCV</b></a></td>
|
|
<td valign="top">Journal receiver</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Journal receiver</td>
|
|
<td valign="top"><i>Generic name, name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB, *USRLIBL, *ALL, *ALLUSR</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#DLTJRNRCV.DLTOPT"><b>DLTOPT</b></a></td>
|
|
<td valign="top">Option</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 3 repetitions): *IGNINQMSG, *IGNEXITPGM, *IGNTGTRCV</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTJRNRCV.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DLTJRNRCV.JRNRCV"></a>
|
|
<h3>Journal receiver (JRNRCV)</h3>
|
|
<p>Specifies the name and library of the journal receiver or receivers being deleted.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Journal receiver</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>journal-receiver-name</i></b></dt>
|
|
<dd>Specify the name and library of the journal receiver being deleted. If *LIBL or *USRLIBL is specified for the library name, only the first journal receiver found to have this name is deleted. If *ALLUSR or *ALL is specified for the library name, journal receiver objects by the name specified can be deleted from multiple libraries.
|
|
</dd>
|
|
<dt><b><i>generic*-journal-receiver-name</i></b></dt>
|
|
<dd>Specify the generic name of the journal receiver being deleted. A generic name is a character string that contains one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name.
|
|
</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>*USRLIBL</b></dt>
|
|
<dd>If a current library entry exists in the library list for the current thread, the current library and the libraries in the user portion of the library list are searched. If there is no current library entry, only the libraries in the user portion of the library list are searched.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ALLUSR</b></dt>
|
|
<dd>All user libraries are searched. All libraries with names that do not begin with the letter Q are searched except for the following:
|
|
<p>
|
|
<pre>
|
|
#CGULIB #DSULIB #SEULIB
|
|
#COBLIB #RPGLIB
|
|
#DFULIB #SDALIB
|
|
</pre>
|
|
</p>
|
|
<p>Although the following Qxxx libraries are provided by IBM, they typically contain user data that changes frequently. Therefore, these libraries are considered user libraries and are also searched:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
QDSNX QRCLxxxxx QUSRIJS QUSRVxRxMx
|
|
QGPL QSRVAGT QUSRINFSKR
|
|
QGPL38 QSYS2 QUSRNOTES
|
|
QMGTC QSYS2xxxxx QUSROND
|
|
QMGTC2 QS36F QUSRPOSGS
|
|
QMPGDATA QUSER38 QUSRPOSSA
|
|
QMQMDATA QUSRADSM QUSRPYMSVR
|
|
QMQMPROC QUSRBRM QUSRRDARS
|
|
QPFRDATA QUSRDIRCL QUSRSYS
|
|
QRCL QUSRDIRDB QUSRVI
|
|
</pre>
|
|
</p>
|
|
<ol>
|
|
<li>'xxxxx' is the number of a primary auxiliary storage pool (ASP).
|
|
</li>
|
|
<li>A different library name, in the format QUSRVxRxMx, can be created by the user for each previous release supported by IBM to contain any user commands to be compiled in a CL program for the previous release. For the QUSRVxRxMx user library, VxRxMx is the version, release, and modification level of a previous release that IBM continues to support.
|
|
</li>
|
|
</ol>
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All libraries in the system, including QSYS, are 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="#DLTJRNRCV.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DLTJRNRCV.DLTOPT"></a>
|
|
<h3>Option (DLTOPT)</h3>
|
|
<p>Specifies whether additional checking should not be done before a journal receiver is deleted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>The journal receiver delete is attempted without ignoring any of the protective checks which are done before a journal receiver is deleted.
|
|
</dd>
|
|
<dt><b>*IGNTGTRCV</b></dt>
|
|
<dd>The system does not verify that all remote journals associated with this journal that are immediately downstream on a target system have full copies of this journal receiver. The delete operation continues even if any of those remote journals does not have a full copy. This protection on a journal receiver only applies beginning when the remote journal was added using the Add Remote Journal (QjoAddRemoteJournal) API, until it is removed using the Remove Remote Journal (QjoRemoveRemoteJournal) API, or until the journal is deleted. For more information about APIs, see the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</dd>
|
|
<dt><b>*IGNINQMSG</b></dt>
|
|
<dd>Ignore inquiry message. Inquiry message CPA7025 is not presented to the user, even if this receiver has not been fully saved (for example, a save after the receiver was detached). Also, inquiry message CPA705E is not presented to the user even if the receiver is attached to a remote journal. The delete operation continues.
|
|
</dd>
|
|
<dt><b>*IGNEXITPGM</b></dt>
|
|
<dd>Ignore user exit programs. Any user exit programs registered for exit point QIBM_QJO_DLT_JRNRCV are not called and not included in the decision as to whether this journal receiver can be deleted.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTJRNRCV.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DLTJRNRCV.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
DLTJRNRCV JRNRCV(MYLIB/JRNRCLA)
|
|
</pre>
|
|
</p>
|
|
<p>This command deletes the journal receiver JRNRCLA in library MYLIB from the system.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTJRNRCV.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DLTJRNRCV.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2105</b></dt>
|
|
<dd>Object &1 in &2 type *&3 not found.
|
|
</dd>
|
|
<dt><b>CPF2110</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF2113</b></dt>
|
|
<dd>Cannot allocate library &1.
|
|
</dd>
|
|
<dt><b>CPF2114</b></dt>
|
|
<dd>Cannot allocate object &1 in &2 type *&3.
|
|
</dd>
|
|
<dt><b>CPF2117</b></dt>
|
|
<dd>&4 objects type *&3 deleted. &5 objects not deleted.
|
|
</dd>
|
|
<dt><b>CPF2125</b></dt>
|
|
<dd>No objects deleted.
|
|
</dd>
|
|
<dt><b>CPF2160</b></dt>
|
|
<dd>Object type *&1 not eligible for requested function.
|
|
</dd>
|
|
<dt><b>CPF2176</b></dt>
|
|
<dd>Library &1 damaged.
|
|
</dd>
|
|
<dt><b>CPF2182</b></dt>
|
|
<dd>Not authorized to library &1.
|
|
</dd>
|
|
<dt><b>CPF2189</b></dt>
|
|
<dd>Not authorized to object &1 in &2 type *&3.
|
|
</dd>
|
|
<dt><b>CPF70ED</b></dt>
|
|
<dd>Receiver not deleted due to exit program, reason code &7.
|
|
</dd>
|
|
<dt><b>CPF701B</b></dt>
|
|
<dd>Journal recovery of an interrupted operation failed.
|
|
</dd>
|
|
<dt><b>CPF7022</b></dt>
|
|
<dd>Cannot delete journal receiver &1 while attached.
|
|
</dd>
|
|
<dt><b>CPF7023</b></dt>
|
|
<dd>Cannot delete journal receiver &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF7024</b></dt>
|
|
<dd>Receiver &1 in &2 not deleted. Reason code, &3.
|
|
</dd>
|
|
<dt><b>CPF7025</b></dt>
|
|
<dd>Delete of receiver &1 in &2 canceled.
|
|
</dd>
|
|
<dt><b>CPF705B</b></dt>
|
|
<dd>No authority to specify OPTION(*IGNEXITPGM).
|
|
</dd>
|
|
<dt><b>CPF705E</b></dt>
|
|
<dd>Delete of receiver &1 in &2 canceled.
|
|
</dd>
|
|
<dt><b>CPF705F</b></dt>
|
|
<dd>Receiver not replicated to &8 remote journals.
|
|
</dd>
|
|
<dt><b>CPF707C</b></dt>
|
|
<dd>Cannot delete journal receiver &1, reason code &5.
|
|
</dd>
|
|
<dt><b>CPF707D</b></dt>
|
|
<dd>Journal receiver &1 in library &2 not deleted.
|
|
</dd>
|
|
<dt><b>CPF707E</b></dt>
|
|
<dd>Journal receiver &1 in library &2 not deleted.
|
|
</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>CPF9825</b></dt>
|
|
<dd>Not authorized to device &1.
|
|
</dd>
|
|
<dt><b>CPF9830</b></dt>
|
|
<dd>Cannot assign library &1.
|
|
</dd>
|
|
<dt><b>CPF9873</b></dt>
|
|
<dd>ASP status is preventing access to object.
|
|
</dd>
|
|
<dt><b>CPF9875</b></dt>
|
|
<dd>Resources exceeded on ASP &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTJRNRCV.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|