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

184 lines
6.5 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>Remove CRG Device Entry (RMVCRGDEVE)</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="RMVCRGDEVE.Top_Of_Page"></a>
<h2>Remove CRG Device Entry (RMVCRGDEVE)</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="#RMVCRGDEVE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVCRGDEVE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVCRGDEVE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVCRGDEVE"></a>
<p>The Remove Cluster Resource Group Device Entry (RMVCRGDEVE) command removes one or more configuration objects from a device cluster resource group. All configuration object entries can be removed but at least one configuration object entry must exist before the Start Cluster Resource Group (STRCRG) command can be called.
</p>
<p>Ownership of the hardware associated with the configuration object being removed is not affected. The hardware is still owned by whatever node owned it before this command was called.
</p>
<p>If an exit program is specified for the cluster resource group, the cluster resource group exit program is called with an action code of Remove Device Entry on all active nodes in the recovery domain. The cluster resource group status is set to Remove Device Entry Pending. If the exit program completes successfully, the cluster resource group status is reset to its value at the time the command was called. If the exit program fails and the cluster resource group cannot be restored to its original condition, the cluster resource group status is set to Indoubt.
</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>Cluster Resource Services must be active on the node processing the request.
</li>
<li>At least one node in the recovery domain must be active.
</li>
<li>If the cluster resource group is Active, the last device entry cannot be removed. The cluster resource group must be ended first.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVCRGDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVCRGDEVE.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="#RMVCRGDEVE.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="#RMVCRGDEVE.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" rowspan="3"><a href="#RMVCRGDEVE.CFGOBJ"><b>CFGOBJ</b></a></td>
<td valign="top">Configuration object list</td>
<td valign="top">Values (up to 256 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Required, Positional 3</td>
</tr>
<tr>
<td valign="top">Element 1: Configuration object</td>
<td valign="top">
<i>Name</i></td>
</tr>
<tr>
<td valign="top">Element 2: Configuration object type</td>
<td valign="top">
<b><u>*DEVD</u></b></td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVCRGDEVE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVCRGDEVE.CLUSTER"></a>
<h3>Cluster (CLUSTER)</h3>
<p>Specifies the cluster to which the cluster resource group belongs.
</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 cluster resource group.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVCRGDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVCRGDEVE.CRG"></a>
<h3>Cluster resource group (CRG)</h3>
<p>Specifies the cluster resource group from which device list entries are being removed.
</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 which contains the device list entries.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVCRGDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVCRGDEVE.CFGOBJ"></a>
<h3>Configuration object list (CFGOBJ)</h3>
<p>Specifies the resilient devices that are to be removed from the cluster resource group.
</p>
<p>You can specify up to 256 values for this parameter.
</p>
<p>This is a required parameter.
</p>
<p><b>Element 1: Configuration object</b>
</p>
<p>Specifies the auxiliary storage pool device description object which will be removed from the device list of the cluster resource group.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the configuration object.
</dd>
</dl>
<p><b>Element 2: Configuration object type</b>
</p>
<p>Specifies the object type of the configuration object specified for element 1.
</p>
<dl>
<dt><b><u>*DEVD</u></b></dt>
<dd>Type of configuration object is a device description.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVCRGDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVCRGDEVE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
RMVCRGDEVE CLUSTER(MYCLUSTER) CRG(MYCRG)
CFGOBJ((IASP01 *DEVD))
</pre>
</p>
<p>This command removes configuration object IASP01 from an existing cluster resource group MYCRG in cluster MYCLUSTER.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVCRGDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVCRGDEVE.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="#RMVCRGDEVE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>