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

175 lines
6.1 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>Display Distribution Services (DSPDSTSRV)</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="DSPDSTSRV.Top_Of_Page"></a>
<h2>Display Distribution Services (DSPDSTSRV)</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="#DSPDSTSRV.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPDSTSRV.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPDSTSRV.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPDSTSRV"></a>
<p>The Display Distribution Services (DSPDSTSRV) command shows or prints the distribution queues table, routing table, or secondary system name table defined for the local system. A detailed description of the Systems Network Architecture service (SNADS) network is in the SNA Distribution Services book, SC41-5410.
</p>
<p>
<b>Note: </b>This command does not allow changes to the SNADS network. Changes to the network can be made using the Configure Distribution Services (CFGDSTSRV) command.
</p>
<p><b>Restriction:</b> Messages that report errors about system names or distribution queues may show or print different characters than the user entered because of internal system transformations.
</p>
<p>The internal value for a system name or distribution queue may differ from the characters shown by the DSPDSTSRV command, depending on the language used for the work station.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTSRV.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPDSTSRV.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="#DSPDSTSRV.OPTION"><b>OPTION</b></a></td>
<td valign="top">Menu option</td>
<td valign="top"><b><u>*SELECT</u></b>, 1, 2, 3</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#DSPDSTSRV.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="#DSPDSTSRV.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPDSTSRV.OPTION"></a>
<h3>Menu option (OPTION)</h3>
<p>Specifies an option from the Display Distribution Services menu that bypasses the initial menu and goes directly to the secondary displays. The list of distribution queues, the routing table, or the secondary system name table can be specified without showing the Display Distribution Services menu.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SELECT</u></b></dt>
<dd>The menu is not bypassed. The option is selected from the Display Distribution Services menu.
</dd>
<dt><b>1</b></dt>
<dd>The distribution queues function is selected. This function identifies all the distribution queues for systems adjacent to your system.
</dd>
<dt><b>2</b></dt>
<dd>The routing table function is selected. This function describes explicit or default entries for the destination systems in the SNADS network to which distribution queue entries can be routed.
</dd>
<dt><b>3</b></dt>
<dd>The secondary system name table function is selected. This function lists all the names by which your system is known.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTSRV.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDSTSRV.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="#DSPDSTSRV.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPDSTSRV.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
DSPDSTSRV OUTPUT(*PRINT)
</pre>
</p>
<p>This command prints the current SNADS configuration status.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTSRV.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPDSTSRV.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>CPF8805</b></dt>
<dd>Special value for System name/Group not permitted or not used correctly.
</dd>
<dt><b>CPF8806</b></dt>
<dd>Value &amp;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>CPF8808</b></dt>
<dd>SNADS cannot allocate more queue space.
</dd>
<dt><b>CPF8809</b></dt>
<dd>Errors detected on SNADS internal queues.
</dd>
<dt><b>CPF8813</b></dt>
<dd>No entries exist.
</dd>
<dt><b>CPF8814</b></dt>
<dd>Queue &amp;1 not found.
</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>CPF9850</b></dt>
<dd>Override of printer file &amp;1 not allowed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTSRV.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>