172 lines
5.9 KiB
HTML
172 lines
5.9 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>Hold Distribution Queue (HLDDSTQ)</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="HLDDSTQ.Top_Of_Page"></a>
|
|
<h2>Hold Distribution Queue (HLDDSTQ)</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="#HLDDSTQ.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#HLDDSTQ.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#HLDDSTQ.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="HLDDSTQ"></a>
|
|
<p>The Hold Distribution Queue (HLDDSTQ) command prevents a distribution queue from being sent.
|
|
</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>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="#HLDDSTQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="HLDDSTQ.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="#HLDDSTQ.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="#HLDDSTQ.PTY"><b>PTY</b></a></td>
|
|
<td valign="top">Priority</td>
|
|
<td valign="top">*NORMAL, *HIGH</td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#HLDDSTQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="HLDDSTQ.DSTQ"></a>
|
|
<h3>Distribution queue (DSTQ)</h3>
|
|
<p>Specifies the name of the distribution queue that is held. The queue must have been previously configured using the Configure Distribution Services (CFGDSTSRV) command 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="#HLDDSTQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="HLDDSTQ.PTY"></a>
|
|
<h3>Priority (PTY)</h3>
|
|
<p>Specifies whether the normal priority or high priority portion of the specified queue is held.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NORMAL</b></dt>
|
|
<dd>The normal priority queue is for those distributions with a service level of data low.
|
|
</dd>
|
|
<dt><b>*HIGH</b></dt>
|
|
<dd>The high priority queue is for those distributions with a service level of fast, status, or data high.
|
|
<p>
|
|
<b>Note: </b>This value is not valid for a SystemView distribution services (SVDS) type of distribution queue.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#HLDDSTQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="HLDDSTQ.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Holding the Normal Priority Portion of a Queue</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
HLDDSTQ DSTQ(CHICAGO) PTY(*NORMAL)
|
|
</pre>
|
|
</p>
|
|
<p>This command holds the normal priority portion of the CHICAGO distribution queue.
|
|
</p>
|
|
<p><b>Example 2: Holding the High Priority Portion of a Queue</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
HLDDSTQ DSTQ(ATLANTA) PTY(*HIGH)
|
|
</pre>
|
|
</p>
|
|
<p>This command holds the high priority portion of the ATLANTA distribution queue.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#HLDDSTQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="HLDDSTQ.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>CPF8805</b></dt>
|
|
<dd>Special value for System name/Group not permitted or not used correctly.
|
|
</dd>
|
|
<dt><b>CPF8806</b></dt>
|
|
<dd>Value &1 not valid for system name or system group.
|
|
</dd>
|
|
<dt><b>CPF881C</b></dt>
|
|
<dd>High priority queue not allowed for *SVDS distribution queue &1
|
|
</dd>
|
|
<dt><b>CPF8812</b></dt>
|
|
<dd>Error occurred while processing distribution queues.
|
|
</dd>
|
|
<dt><b>CPF8816</b></dt>
|
|
<dd>QSNADS communications subsystem is not active.
|
|
</dd>
|
|
<dt><b>CPF8817</b></dt>
|
|
<dd>Distribution queue is held.
|
|
</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>
|
|
<dt><b>CPF9847</b></dt>
|
|
<dd>Error occurred while closing file &1 in library &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#HLDDSTQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|