156 lines
6.0 KiB
HTML
156 lines
6.0 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>End Cluster Node (ENDCLUNOD)</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="ENDCLUNOD.Top_Of_Page"></a>
|
|
<h2>End Cluster Node (ENDCLUNOD)</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="#ENDCLUNOD.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ENDCLUNOD.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ENDCLUNOD.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ENDCLUNOD"></a>
|
|
<p>The End Cluster Node (ENDCLUNOD) command is used to end Cluster Resource Services on one or all the nodes in the membership list of an existing cluster. The status of each node that is ended is set to Inactive. In order to restart Cluster Resource Services on nodes that have been ended, the Start Cluster Node (STRCLUNOD) command is used.
|
|
</p>
|
|
<p>When a node in the cluster is ended, it is not removed from the cluster membership list.
|
|
</p>
|
|
<p>This command can be called on the node which is to be ended, or it can be called on any node in the cluster which has a status of Active. If this command is called when the cluster is partitioned, only nodes in the partition running the command will process the request.
|
|
</p>
|
|
<p>The cluster resource group exit program on the node being ended will be called with an action code of End Node. The exit program on all other nodes in the recovery domain will be called with an action code of Failover. If all the nodes in the cluster are being ended, cluster resource group exit programs will not be called with an indication to failover.
|
|
</p>
|
|
<p>The recovery domain of cluster resource groups on the node that had ended will indicate a node status of Active even though the node is inactive. For all the other nodes in the recovery domain, the status of the node will be Inactive. If the node being ended is the primary node for an active device cluster resource group, ownership of the hardware associated with the cluster resource group will be moved to a backup node. If the cluster resource group is not active, there are no backup nodes, or all backup nodes are either inactive or in a different cluster partition, the ownership of the hardware is left with the node being ended.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
|
|
</li>
|
|
<li>This command cannot be called from a cluster resource group exit program.
|
|
</li>
|
|
<li>The node being ended must be active.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDCLUNOD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ENDCLUNOD.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="#ENDCLUNOD.CLUSTER"><b>CLUSTER</b></a></td>
|
|
<td valign="top">Cluster</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDCLUNOD.NODE"><b>NODE</b></a></td>
|
|
<td valign="top">Node identifier</td>
|
|
<td valign="top"><i>Name</i>, *ALL</td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDCLUNOD.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Option</td>
|
|
<td valign="top"><b><u>*IMMED</u></b>, *CNTRLD</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDCLUNOD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ENDCLUNOD.CLUSTER"></a>
|
|
<h3>Cluster (CLUSTER)</h3>
|
|
<p>Specifies the cluster that contains the node or nodes 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 cluster.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDCLUNOD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDCLUNOD.NODE"></a>
|
|
<h3>Node identifier (NODE)</h3>
|
|
<p>Specifies the node identifier(s) to be ended.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>End all active nodes in the cluster.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the node to be ended.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDCLUNOD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDCLUNOD.OPTION"></a>
|
|
<h3>Option (OPTION)</h3>
|
|
<p>Specifies the method to end the node.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*IMMED</u></b></dt>
|
|
<dd>Immediate. The request to end Cluster Resource Services on the node will be processed immediately.
|
|
</dd>
|
|
<dt><b>*CNTRLD</b></dt>
|
|
<dd>Controlled. Pending cluster resource group actions will complete before the request to end Cluster Resource Services is processed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDCLUNOD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDCLUNOD.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
ENDCLUNOD CLUSTER(MYCLUSTER) NODE(NODE01) OPTION(*IMMED)
|
|
</pre>
|
|
</p>
|
|
<p>This command ends Cluster Resource Services on node NODE01 for cluster MYCLUSTER. The request is processed immediately without waiting for any pending cluster resource group actions to complete.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDCLUNOD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="ENDCLUNOD.ERROR.MESSAGES">Error messages</a></h3>Unknown
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDCLUNOD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|