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

159 lines
5.9 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>End CHT Server (ENDCHTSVR)</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="ENDCHTSVR.Top_Of_Page"></a>
<h2>End CHT Server (ENDCHTSVR)</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="#ENDCHTSVR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ENDCHTSVR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ENDCHTSVR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ENDCHTSVR"></a>
<p>The End Clustered Hash Table Server (ENDCHTSVR) command is used to end the specified clustered hash table server on the cluster nodes specified by the NODE parameter. This will remove the specified nodes from the clustered hash table domain. If all of the cluster nodes defined in the clustered hash table domain are specified on the NODE parameter the server job will be ended on all cluster nodes and the clustered hash table server will be deleted from the cluster.
</p>
<p>The clustered hash table server was started using the Start Clustered Hash Table Server (STRCHTSVR) command. If the clustered hash table server has any active connections, any future requests from those connections fail.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>Cluster Resource Services must be active on the local node.
</li>
<li>All nodes specified in the NODE parameter must have Cluster Resource Services active.
</li>
<li>If an authorization list was specified when the server was started, the requesting user must have change (*CHANGE) authority to the authorization list to end the server.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDCHTSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ENDCHTSVR.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="#ENDCHTSVR.SERVER"><b>SERVER</b></a></td>
<td valign="top">Server</td>
<td valign="top"><i>Communications name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#ENDCHTSVR.NODE"><b>NODE</b></a></td>
<td valign="top">Node</td>
<td valign="top">Single values: *ALL<br>Other values (up to 20 repetitions): <i>Communications name</i>, <b><u>*LOCAL</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ENDCHTSVR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ENDCHTSVR.SERVER"></a>
<h3>Server (SERVER)</h3>
<p>Specifies the clustered hash table server to be ended.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the clustered hash table server to be ended.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDCHTSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDCHTSVR.NODE"></a>
<h3>Node (NODE)</h3>
<p>Specifies which nodes will end the clustered hash table server. The nodes specified will be removed from the clustered hash table domain. If all nodes in the clustered hash table domain are specified, the server will no longer exist in the cluster. Nodes in this list must be unique. The nodes must be active in the cluster.
</p>
<dl>
<dt><b><u>*LOCAL</u></b></dt>
<dd> The clustered hash table server will be ended on the local node only. *LOCAL can be specified only once in the list of nodes specified.
</dd>
<dt><b>*ALL</b></dt>
<dd> The clustered hash table server will be ended on all cluster nodes in the clustered hash table domain. If specified, *ALL must be the only value in the list.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the nodes to process the end request. Up to 20 cluster nodes can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDCHTSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDCHTSVR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Ending a Clustered Hash Table Server on the Local Node</b>
</p>
<p>
<pre>
ENDCHTSVR SERVER(CT0)
</pre>
</p>
<p>This command ends the clustered hash table server CT0 on the local node only.
</p>
<p><b>Example 2: Ending a Clustered Hash Table Server on One of two Nodes in the Clustered Hash Table Domain</b>
</p>
<p>Domain for clustered hash table CT1 is FRED and BARNEY.
</p>
<p>
<pre>
ENDCHTSVR SERVER(CT1) NODE(FRED)
</pre>
</p>
<p>This command ends the clustered hash table server CT1 on cluster node FRED. The clustered hash table server is still active on BARNEY.
</p>
<p><b>Example 3: Ending a Clustered Hash Table Server on All Nodes</b>
</p>
<p>Domain for clustered hash table CT2 is FRED and BARNEY.
</p>
<p>
<pre>
ENDCHTSVR SERVER(CT2) NODE(*ALL)
</pre>
</p>
<p>This command ends the clustered hash table server named CT2 on the local node (i.e. BARNEY) and node FRED. The clustered hash table will not exist in the cluster after this command runs.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDCHTSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDCHTSVR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFBD03</b></dt>
<dd>End clustered hash table server failed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDCHTSVR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>