193 lines
8.3 KiB
HTML
193 lines
8.3 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>Initialize Distribution Queue (INZDSTQ)</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="INZDSTQ.Top_Of_Page"></a>
|
||
|
|
<h2>Initialize Distribution Queue (INZDSTQ)</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="#INZDSTQ.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#INZDSTQ.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#INZDSTQ.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="INZDSTQ"></a>
|
||
|
|
<p>The Initialize Distribution Queue (INZDSTQ) command resets the status of a distribution queue and the entries on the queue. It also optionally clears all distributions on the queue. This command applies to both the normal and high priority sections of the specified queue.
|
||
|
|
</p>
|
||
|
|
<p><b>Attention:</b> Initializing a distribution queue can result in the loss or duplication of distributions in the network, depending on the status of the distributions in transit at the time this command is run.
|
||
|
|
</p>
|
||
|
|
<p>Initializing a distribution queue includes the following:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>If a SNADS (Systems Network Architecture (SNA) distribution services) sender job is active for the queue, the job is ended. This job cancelation takes effect immediately. Distribution queues being sent are interrupted.
|
||
|
|
</li>
|
||
|
|
<li>If the queue type is a SystemView distribution services (SVDS) queue type and a receiver job is active for this connection, the job is ended. This job cancelation takes effect immediately. All partially received distributions are discarded.
|
||
|
|
</li>
|
||
|
|
<li>If the distribution queue is to be cleared, all distributions on the queue are deleted as specified on the <b>Clear queue entries</b> prompt (CLEAR parameter).
|
||
|
|
</li>
|
||
|
|
<li>If the queue is not cleared, the distributions on the queue that do not have "Held" status are set to "Ready." Distributions with a status of "Held" remain held.
|
||
|
|
</li>
|
||
|
|
<li>The queue status is set to "Ready" unless the queue is in the "Held" status.
|
||
|
|
</li>
|
||
|
|
<li>If the QSNADS system is active, a SNADS sender job is submitted for the queue following the same rules used to start the QSNADS subsystem.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<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>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="#INZDSTQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="INZDSTQ.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="#INZDSTQ.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>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#INZDSTQ.CLEAR"><b>CLEAR</b></a></td>
|
||
|
|
<td valign="top">Clear queue entries</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES, *PURGE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZDSTQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="INZDSTQ.DSTQ"></a>
|
||
|
|
<h3>Distribution queue (DSTQ)</h3>
|
||
|
|
<p>Specifies the name of the distribution queue to initialize. The queue must be previously configured using the Configure Distribution Services (CFGDSTSRV) or the Add Distribution Queue (ADDDSTQ) command.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZDSTQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="INZDSTQ.CLEAR"></a>
|
||
|
|
<h3>Clear queue entries (CLEAR)</h3>
|
||
|
|
<p>Specifies whether distributions on the queue are deleted.
|
||
|
|
</p>
|
||
|
|
<p><b>Attention:</b> Using the *PURGE value results in the loss of distributions with no trace.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Distributions on the queue are not deleted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Distributions on the queue are deleted. Each deleted distribution is logged and, if the distribution originator requested notification, a notification is sent to the originator or to the report destination specified in the distribution.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>System Network Architecture distribution services (SNADS) status distributions and distribution reports are used to report information about a distribution back to the originator. Status report distributions never result in another status report distribution. If a status report distribution is deleted, no notification is sent.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PURGE</b></dt>
|
||
|
|
<dd>Distributions on the queue are deleted. Deleted distributions are not logged and no notification is sent to the originator or to the report destination specified in the distribution.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZDSTQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="INZDSTQ.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Initializing a Distribution Queue</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
INZDSTQ DSTQ('SYSTEMA APPN')
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Connection information is about to be changed for system 'SYSTEMA APPN' by a central site administrator. This command initializes the queue to avoid error conditions that can be encountered by the Change Distribution Queue (CHGDSTQ) command. Distributions on the queue are not deleted.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Initializing and Clearing a Distribution Queue</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
INZDSTQ DSTQ('ERRORQ') CLEAR(*YES)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command clears the distribution queue ERRORQ that is being used as a repository for distributions that would have resulted in routing errors. Distributions that are deleted are logged, and the originators of the distributions are notified.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Initializing and Purging a Distribution Queue</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
INZDSTQ DSTQ('TESTQ') CLEAR(*PURGE)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command clears the distribution queue TESTQ that is being used for testing a new batch application. Distributions are deleted but not logged, and the originators are not notified.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZDSTQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="INZDSTQ.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF8802</b></dt>
|
||
|
|
<dd>Distribution queue &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>CPF8812</b></dt>
|
||
|
|
<dd>Error occurred while processing distribution queues.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8849</b></dt>
|
||
|
|
<dd>Queue &1 in use by another distribution services function.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9845</b></dt>
|
||
|
|
<dd>Error occurred while opening file &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9846</b></dt>
|
||
|
|
<dd>Error while processing file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZDSTQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|