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

149 lines
5.6 KiB
HTML
Raw Permalink 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>Configure Distribution Service (CFGDSTSRV)</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="CFGDSTSRV.Top_Of_Page"></a>
<h2>Configure Distribution Service (CFGDSTSRV)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#CFGDSTSRV.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CFGDSTSRV.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CFGDSTSRV.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CFGDSTSRV"></a>
<p>The Configure Distribution Services (CFGDSTSRV) command changes the configuration of the distribution network. The user can add, change, remove, and display entries from the distribution queues table, the routing table, and the secondary system name table. A detailed description of configuring a distribution network is in the SNA Distribution Services book, SC41-5410.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>This command is shipped with public *EXCLUDE authority and the QPGMR and QSYSOPR user profiles have private authorities to use the command.
</li>
<li>Before this command is run for the first time, the QSNADS subsystem must be started to create the internal systems network architecture distribution services (SNADS) objects that this command uses.
</li>
<li>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. The internal value for a system name or distribution queue may differ from the characters shown by the CFGDSTSRV command depending on the language being used for the work station.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDSTSRV.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CFGDSTSRV.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="#CFGDSTSRV.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>
</table>
<table width="100%">
<tr><td align="right"><a href="#CFGDSTSRV.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CFGDSTSRV.OPTION"></a>
<h3>Menu option (OPTION)</h3>
<p>Specifies an option from the Configure Distribution Services menu that bypasses the initial menu and goes directly to the secondary displays. You can specify the distribution queues, the routing table, or the secondary system name table to be specified showing the Configure 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 Configure 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="#CFGDSTSRV.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CFGDSTSRV.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CFGDSTSRV OPTION(1)
</pre>
</p>
<p>This command shows the distribution queues' table entries.
</p>
<p>Configuration changes may be made to existing distribution queues, or additional distribution queues may be configured.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDSTSRV.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CFGDSTSRV.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>CPF8809</b></dt>
<dd>Errors detected on SNADS internal queues.
</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>
<dt><b>CPI8854</b></dt>
<dd>DSNX error while journaling.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDSTSRV.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>