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

158 lines
5.3 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 Device Domain Entry (RMVDEVDMNE)</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="RMVDEVDMNE.Top_Of_Page"></a>
<h2>Remove Device Domain Entry (RMVDEVDMNE)</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="#RMVDEVDMNE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVDEVDMNE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVDEVDMNE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVDEVDMNE"></a>
<p>The Remove Device Domain Entry (RMVDEVDMNE) command is used to remove a cluster node from a device domain. The removed node will no longer be able to be in the recovery domain for a device cluster resource group.
</p>
<p>A node which has been removed from a device domain will most likely need to be IPLed before it can be added to any device domain. One example of this situation would be if a device description for an auxiliary storage pool has been varied on since the last IPL.
</p>
<p>This command can be called on any node in the cluster which has a status of Active.
</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 to be removed cannot be in the recovery domain of any device cluster resource group.
</li>
<li>The node to be removed and at least one other member of the device domain must be active. On certain conditions, all current members of the device domain must be active.
</li>
<li>This command will fail if any member of the device domain from which the node being removed has a status of Partition.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDEVDMNE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVDEVDMNE.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="#RMVDEVDMNE.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="#RMVDEVDMNE.DEVDMN"><b>DEVDMN</b></a></td>
<td valign="top">Device domain</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#RMVDEVDMNE.NODE"><b>NODE</b></a></td>
<td valign="top">Node identifier</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 3</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVDEVDMNE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVDEVDMNE.CLUSTER"></a>
<h3>Cluster (CLUSTER)</h3>
<p>Specifies the cluster that contains the node.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the cluster which contains the node.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDEVDMNE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVDEVDMNE.DEVDMN"></a>
<h3>Device domain (DEVDMN)</h3>
<p>Specifies the device domain from which the node is to be removed.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the device domain from which the node is to be removed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDEVDMNE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVDEVDMNE.NODE"></a>
<h3>Node identifier (NODE)</h3>
<p>Specifies the cluster node which will be removed from the device domain.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the node.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDEVDMNE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVDEVDMNE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
RMVDEVDMNE CLUSTER(MYCLUSTER) DEVDMN(MYDOMAIN) NODE(NODE01)
</pre>
</p>
<p>This command removes the node NODE01 from the device domain MYDOMAIN in cluster MYCLUSTER. If the cluster membership list is NODE01, NODE02, and NODE03 and all three nodes were in the same device domain, then nodes NODE02 and NODE03 still belong to device domain MYDOMAIN.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDEVDMNE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVDEVDMNE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF1999</b></dt>
<dd>Errors occurred on command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVDEVDMNE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>