friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/crtadmdmn.htm

175 lines
7.4 KiB
HTML
Raw Blame History

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Create Cluster Admin Domain (CRTADMDMN)</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="CRTADMDMN.Top_Of_Page"></a>
<h2>Create Cluster Admin Domain (CRTADMDMN)</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="#CRTADMDMN.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTADMDMN.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTADMDMN.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTADMDMN"></a>
<p>The Create Cluster Administrative Domain (CRTADMDMN) command creates a peer cluster resource group object which represents the cluster administrative domain. The cluster administrative domain provides synchronization of monitored resources across the active nodes in the domain. The cluster nodes which are defined within the cluster administrative domain will participate in the synchronization process. The cluster administrative domain name is the name of the cluster resource group which is being created. The nodes defined in the domain node list are the nodes in the recovery domain of the cluster resource group. Successful completion of this command results in a new job started in the QSYSWRK subsystem. This job has the same name as the name of the cluster administrative domain being created.
</p>
<p>To add nodes to the cluster administrative domain use the Add CRG Node Entry (ADDCRGNODE) command. To remove nodes from the cluster administrative domain use the Remove CRG Node Entry (RMVCRGNODE) command. To start the cluster administrative domain use the Start Cluster Resource Group (STRCRG) command. To end the cluster administrative domain use the End Cluster Resource Group (ENDCRG) command.
</p>
<p>This command will do the following:
</p>
<ul>
<li>Create the cluster administrative domain on all nodes in the defined administrative domain. The cluster administrative domain may be accessed by a cluster resource group command running on any node in the cluster.
</li>
<li>Provide users a single system image of the cluster administrative domain. That is, any changes made to the cluster resource group object representing the cluster administrative domain will be made on all nodes in the administrative domain. Likewise, any changes made to system entities and attributes enrolled to the cluster administrative domain will be propagated to all active nodes in the administrative domain once the cluster resource group is started.
</li>
<li>The cluster resource group CRG is owned by the QCLUSTER user profile. To use the cluster resouce group commands with the cluster administrative domain you will need to be authorized to the cluster resource group and to the QCLUSTER user profile.
</li>
</ul>
<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 cluster administrative domain name cannot begin with QCST.
</li>
<li>Cluster Resource Services must be active on the node processing the request.
</li>
<li>All nodes in the administrative domain must be in the cluster with a status of Active.
</li>
<li>Each node can be specified only once in the administrative domain.
</li>
<li>A node can be specified in one cluster administrative domain within a cluster.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTADMDMN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTADMDMN.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="#CRTADMDMN.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="#CRTADMDMN.ADMDMN"><b>ADMDMN</b></a></td>
<td valign="top">Cluster administrative domain</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CRTADMDMN.DMNNODL"><b>DMNNODL</b></a></td>
<td valign="top">Admin domain node list</td>
<td valign="top">Values (up to 128 repetitions): <i>Name</i></td>
<td valign="top">Required, Positional 3</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTADMDMN.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTADMDMN.CLUSTER"></a>
<h3>Cluster (CLUSTER)</h3>
<p>Specifies the cluster containing the cluster administrative domain which 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 cluster.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTADMDMN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTADMDMN.ADMDMN"></a>
<h3>Cluster administrative domain (ADMDMN)</h3>
<p>Specifies the cluster administrative domain to be created.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the cluster administrative domain.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTADMDMN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTADMDMN.DMNNODL"></a>
<h3>Admin domain node list (DMNNODL)</h3>
<p>Specifies the list of nodes that compose the administrative domain. Nodes in the administrative domain must be unique cluster nodes. Each node must be active in the cluster.
</p>
<p>You can specify up to 128 nodes for the administrative domain.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of an active cluster node.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTADMDMN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTADMDMN.COMMAND.EXAMPLES">Examples</a> </h3>
<p>Creating a Cluster Administrative Domain With a Three-Node Administrative Domain
</p>
<p>
<pre>
CRTADMDMN CLUSTER(MYCLUSTER) ADMDMN(MYDOMAIN)
DMNNODL(NODE01 NODE02 NODE03)
</pre>
</p>
<p>This command creates a peer cluster resource group object representing the cluster administrative domain called MYDOMAIN in the cluster called MYCLUSTER. The administrative domain consists of three nodes, NODE01, NODE02 and NODE03. The cluster resource group commands can be used to change the attributes of this cluster administrative domain.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTADMDMN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTADMDMN.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFBBB4</b></dt>
<dd>Create cluster administrative domain failed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTADMDMN.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink