191 lines
6.7 KiB
HTML
191 lines
6.7 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>Work with Distribution Queue (WRKDSTQ)</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="WRKDSTQ.Top_Of_Page"></a>
|
||
|
|
<h2>Work with Distribution Queue (WRKDSTQ)</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="#WRKDSTQ.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#WRKDSTQ.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#WRKDSTQ.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="WRKDSTQ"></a>
|
||
|
|
<p>The Work with Distribution Queue (WRKDSTQ) command displays and controls the distribution requests on the Systems Network Architecture distribution services (SNADS) distribution queues. A detailed description of SNADS 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>Before this command is run for the first time, the QSNADS subsystem must have been previously started to create the internal SNADS objects that this command uses.
|
||
|
|
</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="#WRKDSTQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="WRKDSTQ.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="2"><a href="#WRKDSTQ.QUEUE"><b>QUEUE</b></a></td>
|
||
|
|
<td valign="top">Distribution</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="2">Optional, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Queue</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#WRKDSTQ.OUTPUT"><b>OUTPUT</b></a></td>
|
||
|
|
<td valign="top">Output</td>
|
||
|
|
<td valign="top"><b><u>*</u></b>, *PRINT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKDSTQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="WRKDSTQ.QUEUE"></a>
|
||
|
|
<h3>Distribution (QUEUE)</h3>
|
||
|
|
<p>Specifies the name of the distribution queue that is shown or printed. The queue specified must have been previously configured using the Configure Distribution Services (CFGDSTSRV) command or the Add Distribution Queue (ADDDSTQ) command.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All SNADS distribution queues are shown or printed, in alphabetic order, by queue name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>distribution-queue-name</i></b></dt>
|
||
|
|
<dd>Specify a particular SNADS distribution queue.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKDSTQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="WRKDSTQ.OUTPUT"></a>
|
||
|
|
<h3>Output (OUTPUT)</h3>
|
||
|
|
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PRINT</b></dt>
|
||
|
|
<dd>The output is printed with the job's spooled output.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKDSTQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="WRKDSTQ.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Working With All Distribution Queues</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
WRKDSTQ
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command allows the user to work with the status and contents of all distribution queues. The normal and high priority portions of each distribution queue are shown or printed.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Printing Information</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
WRKDSTQ OUTPUT(*PRINT)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command prints information on all distribution queues. The status of the normal and priority portions of the distribution queues are printed followed by a list of the distribution requests on the normal and high priority portions of each distribution queue.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKDSTQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="WRKDSTQ.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>CPF8806</b></dt>
|
||
|
|
<dd>Value &1 not valid for system name or system group.
|
||
|
|
</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>CPF8813</b></dt>
|
||
|
|
<dd>No entries exist.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8819</b></dt>
|
||
|
|
<dd>Special value for distribution queue name not permitted.
|
||
|
|
</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>
|
||
|
|
<dt><b>CPF9850</b></dt>
|
||
|
|
<dd>Override of printer file &1 not allowed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#WRKDSTQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|