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

136 lines
4.7 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>Remove Secondary System Name (RMVDSTSYSN)</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="RMVDSTSYSN.Top_Of_Page"></a>
<h2>Remove Secondary System Name (RMVDSTSYSN)</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="#RMVDSTSYSN.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVDSTSYSN.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVDSTSYSN.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVDSTSYSN"></a>
<p>The Remove Distribution Secondary System Name (RMVDSTSYSN) command allows you to remove an entry from the distribution services secondary system name table. The table contains the names of all alternate (or alias) system names for which the local system receives and may redirect distributions. When an alternate system name is removed from the table, this system no longer receives distributions for the alternate system.
</p>
<p>Interactive display support is provided by the Configure Distribution Services (CFGDSTSRV) command. More information about configuring a distribution network is in the SNA Distribution Services book, SC41-5410.
</p>
<p>System names and group 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>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDSTSYSN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVDSTSYSN.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="3"><a href="#RMVDSTSYSN.SYSNAME"><b>SYSNAME</b></a></td>
<td valign="top">Secondary system name</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Element 1: System name</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: System group</td>
<td valign="top">
<i>Character value</i></td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVDSTSYSN.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVDSTSYSN.SYSNAME"></a>
<h3>Secondary system name (SYSNAME)</h3>
<p>Specifies the system name and group name of the secondary system name table entry to be removed.
</p>
<p>You can specify a maximum of 8 characters for the system name and a maximum of 8 characters for the group name.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDSTSYSN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVDSTSYSN.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
RMVDSTSYSN SYSNAME(SYS2LAJ1 ROCHESTR)
</pre>
</p>
<p>This command removes the system named SYS2LAJ1 ROCHESTR from the distribution services secondary system name table.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDSTSYSN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVDSTSYSN.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF8807</b></dt>
<dd>Error occurred while using QSNADS journal.
</dd>
<dt><b>CPF8818</b></dt>
<dd>Secondary system name table entry &amp;1 &amp;2 not found.
</dd>
<dt><b>CPF8835</b></dt>
<dd>System name/Group &amp;1 &amp;2 already specified.
</dd>
<dt><b>CPF8837</b></dt>
<dd>System name/Group &amp;1 &amp;2 in use by another distribution services function.
</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>CPF9899</b></dt>
<dd>Error occurred during processing of command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDSTSYSN.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>