156 lines
6.4 KiB
HTML
156 lines
6.4 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 Resource Group (ENDCRG)</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="ENDCRG.Top_Of_Page"></a>
|
|
<h2>End Cluster Resource Group (ENDCRG)</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="#ENDCRG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ENDCRG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ENDCRG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ENDCRG"></a>
|
|
<p>The End Cluster Resource Group (ENDCRG) command disables resiliency of the specified cluster resource group. The cluster resource group status is set to Inactive if the resilency is ended on all nodes in the recovery domain. The resources associated with the cluster resource group are no longer resilient. That is, there is no failover or switchover action provided for these resources while the cluster resource group is ended.
|
|
</p>
|
|
<p>Ending a device cluster resource group will not change the ownership of devices. The devices remain on whatever nodes owns them at the time the command is run. Also, the devices are not varied off when the cluster resource group is ended.
|
|
</p>
|
|
<p>Ending a peer cluster resource group will end the access point for the cluster resources on all nodes defined as a peer node.
|
|
</p>
|
|
<p>If an exit program is specified for the cluster resource group, it is called with an action code of End on each active node in the recovery domain. When the exit program is called, the cluster resource group status is set to End Pending. Successful completion of the exit program sets the cluster resource group status to Inactive. In addition, for an application cluster resource group:
|
|
</p>
|
|
<ol>
|
|
<li>The current exit program job on the primary node will be cancelled with the *IMMED option.
|
|
</li>
|
|
<li>The takeover IP interface for the cluster resource group will be ended for the application cluster resource group.
|
|
</li>
|
|
</ol>
|
|
<p>If the exit program fails and the original state of the cluster resource group cannot be recovered, the cluster resource group status is set to Indoubt.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDCRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ENDCRG.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="#ENDCRG.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="#ENDCRG.CRG"><b>CRG</b></a></td>
|
|
<td valign="top">Cluster resource group</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDCRG.EXITPGMDTA"><b>EXITPGMDTA</b></a></td>
|
|
<td valign="top">Exit program data</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDCRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ENDCRG.CLUSTER"></a>
|
|
<h3>Cluster (CLUSTER)</h3>
|
|
<p>Specifies the cluster containing the cluster resource group.
|
|
</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="#ENDCRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDCRG.CRG"></a>
|
|
<h3>Cluster resource group (CRG)</h3>
|
|
<p>Specifies the cluster resource group 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 resource group to end.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDCRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDCRG.EXITPGMDTA"></a>
|
|
<h3>Exit program data (EXITPGMDTA)</h3>
|
|
<p>Specifies up to 256 bytes of data that is passed to the cluster resource group exit program when it is called. This parameter may contain any scalar data except pointers. For example, it can be used to provide state information. This data will be stored with the specified cluster resource group and copied to all nodes in the recovery domain. Pointers in this area will not resolve correctly on all nodes and should not be placed in the data. The data specified will replace the existing exit program data stored with the cluster resource group. If blanks are specified, then the exit program data stored with the cluster resource group will be cleared. This parameter must be set to *SAME if no exit program is specified for the cluster resource group.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The exit program data stored with the cluster resource group specified will be passed to the exit program.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the data that is to be passed to the exit program.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDCRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDCRG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
ENDCRG CLUSTER(MYCLUSTER) CRG(MYCRG)
|
|
EXITPGMDTA('important information')
|
|
</pre>
|
|
</p>
|
|
<p>This command ends resiliency of the cluster resource group called MYCRG in the cluster called MYCLUSTER. When the cluster resource group exit program is called, it will be passed the exit program data 'important information' on all active nodes in the recovery domain.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDCRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDCRG.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="#ENDCRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|