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

157 lines
5.7 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Remove Distribution Queue (RMVDSTQ)</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="RMVDSTQ.Top_Of_Page"></a>
<h2>Remove Distribution Queue (RMVDSTQ)</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="#RMVDSTQ.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVDSTQ.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVDSTQ.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVDSTQ"></a>
<p>The Remove Distribution Queue (RMVDSTQ) command allows you to remove a distribution queue entry from the distribution services queue table. Distribution queues are used to store distributions before they are sent or forwarded to other systems.
</p>
<p>The RMVDSTQ command does not provide interactive display support. This is provided by the Configure Distribution Services (CFGDSTSRV) command. More information about configuring a distribution network is in the SNA Distribution Services book, SC41-5410.
</p>
<p>Distribution queue names are translated to the graphic character set and code page 930 500, using the job's coded character set identifier (CCSID).
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>This command is shipped with public *EXCLUDE authority, and the QPGMR and QSYSOPR user profiles have private authorities to use the command.
</li>
</ul>
<ul>
<li>The following distribution queues cannot be removed:
<ul>
<li>Queues referred to in the routing table
</li>
<li>Queues that contain distributions waiting to be sent
</li>
<li>DLS (document library services) queues that have remote libraries configured to use them
</li>
<li>SVDS (IBM System Manager for i5/OS distribution services) queues when a receiver is active or when distributions have been received and the sender has not acknowledged receiving confirmation.
</li>
</ul>
</li>
</ul>
<ul>
<li>Messages that report errors about distribution queues may display or print different characters than you entered for the distribution queue name because of internal system transformations. Similarly (depending on the language used for the work station), the internal value for a distribution queue name may differ from the characters shown for the Work with Distribution Queue (WRKDSTQ) command. An error may be reported if the character-string value specified for the <b>Distribution queue</b> prompt (DSTQ parameter) does not match the rules for an internal distribution queue value or if it does not match the internal value for any defined distribution queue (ignoring case differences).
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDSTQ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVDSTQ.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="#RMVDSTQ.DSTQ"><b>DSTQ</b></a></td>
<td valign="top">Distribution queue</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVDSTQ.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVDSTQ.DSTQ"></a>
<h3>Distribution queue (DSTQ)</h3>
<p>Specifies the name of the distribution queue entry to be removed.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDSTQ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVDSTQ.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
RMVDSTQ DSTQ(CHICAGO)
</pre>
</p>
<p>This command removes the distribution queue entry named CHICAGO.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDSTQ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVDSTQ.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF8802</b></dt>
<dd>Distribution queue &amp;1 was not found.
</dd>
<dt><b>CPF8807</b></dt>
<dd>Error occurred while using QSNADS journal.
</dd>
<dt><b>CPF8809</b></dt>
<dd>Errors detected on SNADS internal queues.
</dd>
<dt><b>CPF881B</b></dt>
<dd>Distributions are being received for distribution queue &amp;1
</dd>
<dt><b>CPF8826</b></dt>
<dd>Distribution queue entries exist for distribution queue &amp;1.
</dd>
<dt><b>CPF8827</b></dt>
<dd>Routing table entries exist for distribution queue &amp;1.
</dd>
<dt><b>CPF8828</b></dt>
<dd>Remote document library entries exist for *DLS distribution queue &amp;1.
</dd>
<dt><b>CPF8833</b></dt>
<dd>Distribution queue &amp;1 already exists.
</dd>
<dt><b>CPF8849</b></dt>
<dd>Queue &amp;1 in use by another distribution services function.
</dd>
<dt><b>CPF9845</b></dt>
<dd>Error occurred while opening file &amp;1.
</dd>
<dt><b>CPF9846</b></dt>
<dd>Error while processing file &amp;1 in library &amp;2.
</dd>
<dt><b>CPF9847</b></dt>
<dd>Error occurred while closing file &amp;1 in library &amp;2.
</dd>
<dt><b>CPF9899</b></dt>
<dd>Error occurred during processing of command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDSTQ.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>