228 lines
9.0 KiB
HTML
228 lines
9.0 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>Change CRG Device Entry (CHGCRGDEVE)</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="CHGCRGDEVE.Top_Of_Page"></a>
|
|
<h2>Change CRG Device Entry (CHGCRGDEVE)</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="#CHGCRGDEVE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGCRGDEVE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGCRGDEVE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGCRGDEVE"></a>
|
|
<p>The Change Cluster Resource Group Device Entry (CHGCRGDEVE) command changes information about one or more configuration objects in a device cluster resource group. You can change the configuration action to be taken when the cluster resource group is switched over to a backup system. The entry being changed is found by searching the current entries for a matching configuration object name and configuration object type.
|
|
</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 Change Device Entry on all active nodes in the recovery domain. The cluster resource group status is set to Change 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>The number of configuration object entries in the configuration object array cannot exceed 256.
|
|
</li>
|
|
<li>At least one node in the recovery domain must be active.
|
|
</li>
|
|
<li>If a server takeover IP address is specified, it must exist on all nodes in the recovery domain if the cluster resource group is active. The server takeover IP address must be unique. It can only be associated with a primary auxiliary storage pool.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCRGDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGCRGDEVE.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="#CHGCRGDEVE.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="#CHGCRGDEVE.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="5"><a href="#CHGCRGDEVE.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="5">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>
|
|
<tr>
|
|
<td valign="top">Element 3: Configuration object online</td>
|
|
<td valign="top">
|
|
<b><u>*SAME</u></b>, *OFFLINE, *ONLINE, *PRIMARY</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 4: Server takeover IP address</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCRGDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGCRGDEVE.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="#CHGCRGDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCRGDEVE.CRG"></a>
|
|
<h3>Cluster resource group (CRG)</h3>
|
|
<p>Specifies the cluster resource group which is to be changed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the device cluster resource group.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCRGDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCRGDEVE.CFGOBJ"></a>
|
|
<h3>Configuration object list (CFGOBJ)</h3>
|
|
<p>Specifies detailed information about the resilient devices to be changed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Element 1: Configuration object</b>
|
|
</p>
|
|
<p>Specifies the auxiliary storage pool device description which is in the cluster resource group.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The current configuration object is not changed.
|
|
</dd>
|
|
<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>This specifies the type of configuration object specified with configuration object name.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DEVD</u></b></dt>
|
|
<dd>Type of configuration object.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Configuration object online</b>
|
|
</p>
|
|
<p>Specifies what configuration action to take when the cluster resource group is switched over or failed over to a backup node. The configuration object can be varied on and the server takeover IP address will be started or left varied off and the server takeover IP address is left inactive when a device ownership is moved to another node. This attribute does <b>not</b> vary the device on or off or start the server takeover IP address when the cluster resource group is started or ended.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The current configuration object online value is not changed.
|
|
</dd>
|
|
<dt><b>*OFFLINE</b></dt>
|
|
<dd>Do not vary the configuration object on and do not start the server takeover IP address.
|
|
</dd>
|
|
<dt><b>*ONLINE</b></dt>
|
|
<dd>Vary the configuration object on and start the server takeover IP address.
|
|
</dd>
|
|
<dt><b>*PRIMARY</b></dt>
|
|
<dd>This is a secondary ASP. Vary on processing and starting of the server takeover IP address is determined by the corresponding primary ASP for this ASP group.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 4: Server takeover IP address</b>
|
|
</p>
|
|
<p>Specifies a takeover IP address for servers associated with the relational database name in the device description for an auxiliary storage pool. This element is optional and can only be specified for a primary auxiliary storage pool. If specified, the addresss must be presented in dotted decimal format. The specified address must exist on all nodes in the recovery domain if the cluster resource group is active. If not specified, or for a secondary or UDFS auxiliary storage pool, the element must be set to *NONE.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The current server takeover IP address is not changed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>There is no server takeover IP address associated with the relational database name in the device description for an auxiliary storage pool.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the server takeover IP address for the relational database name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCRGDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGCRGDEVE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGCRGDEVE CLUSTER(MYCLUSTER) CRG(MYCRG)
|
|
CFGOBJ((IASP01 *DEVD *ONLINE *NONE))
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the device list information for the configuration object IASP01 in the resilient device cluster resource group MYCRG in the cluster MYCLUSTER. The configuration action is now set to vary the configuration object online in the event of a failover or switchover.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCRGDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGCRGDEVE.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="#CHGCRGDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|