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

161 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>Add Device Domain Entry (ADDDEVDMNE)</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="ADDDEVDMNE.Top_Of_Page"></a>
<h2>Add Device Domain Entry (ADDDEVDMNE)</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="#ADDDEVDMNE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDDEVDMNE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDDEVDMNE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDDEVDMNE"></a>
<p>The Add Device Domain Entry (ADDDEVDMNE) command is used to add a cluster node to the membership list of a device domain. There is no command to create a device domain. The device domain will be created when the first cluster node is added to it. Once the node is a member of a device domain, it can be added to the recovery domain of device cluster resource groups.
</p>
<p>This command can be called from a program running on any node in the cluster which has a status of Active.
</p>
<p>This command requires that Operating System option 41, HA Switchable Resources, is installed and a valid license key exists on all cluster nodes that will be in the device domain.
</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 added and at least one current member of the device domain must be Active. On certain conditions, all current members of the device domain must be Active.
</li>
<li>A node can only be a member of one device domain.
</li>
<li>This command will fail if any member of the device domain to which the node being added has a status of Partition.
</li>
<li>The command will fail if it is the first node being added to the device domain and any node in the cluster has a status of Partition.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDEVDMNE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDDEVDMNE.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="#ADDDEVDMNE.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="#ADDDEVDMNE.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="#ADDDEVDMNE.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="#ADDDEVDMNE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDDEVDMNE.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="#ADDDEVDMNE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDEVDMNE.DEVDMN"></a>
<h3>Device domain (DEVDMN)</h3>
<p>Specifies the device domain to which the node is being added. If the device domain does not currently exist, it will be created.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the device domain to which the node is being added.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDEVDMNE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDEVDMNE.NODE"></a>
<h3>Node identifier (NODE)</h3>
<p>Specifies the cluster node to be added to 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 cluster node.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDEVDMNE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDDEVDMNE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
ADDDEVDMNE CLUSTER(MYCLUSTER) DEVDMN(MYDOMAIN)
NODE(NODE01)
</pre>
</p>
<p>Consider a cluster with a cluster membership list of NODE01, NODE02, and NODE03 and no existing device domains. This command creates the device domain MYDOMAIN and adds node NODE01 to the device domain membership list. Nodes NODE02 and NODE03 do not belong to any device domain.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDEVDMNE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDDEVDMNE.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="#ADDDEVDMNE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>