232 lines
10 KiB
HTML
232 lines
10 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>Start Cluster Resource Group (STRCRG)</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="STRCRG.Top_Of_Page"></a>
|
||
|
|
<h2>Start Cluster Resource Group (STRCRG)</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="#STRCRG.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#STRCRG.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#STRCRG.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="STRCRG"></a>
|
||
|
|
<p>The Start Cluster Resource Group (STRCRG) command enables resiliency for the specified cluster resource group on the specified recovery domain nodes. This command can be used to change the cluster resource group from a status of Indoubt or Inactive to Active.
|
||
|
|
</p>
|
||
|
|
<p>This command will do the following for all cluster resource group types:
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>Set the cluster resource group status to Start Pending.
|
||
|
|
</li>
|
||
|
|
<li>For primary-backup model cluster resource groups if the current recovery domain has more than one backup node and some backup nodes are not active, the recovery domain may be reordered so that all active backup nodes are ordered before inactive backup nodes. If the inactive backup nodes are already ordered after active backup nodes or if there are no inactive backup nodes, this command will not change the recovery domain.
|
||
|
|
</li>
|
||
|
|
<li>Call the exit program on all active nodes in the recovery domain with an action code of Start, if an exit program is specified for the cluster resource group.
|
||
|
|
</li>
|
||
|
|
<li>Set the cluster resource group status to Active if the exit program is successful on all active nodes in the recovery domain.
|
||
|
|
</li>
|
||
|
|
<li>If the exit program is unsuccessful on any active node in the recovery domain when processing the Undo action code, the status of the cluster resource group will be set to Indoubt on all nodes.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p>This command will do the following for application cluster resource groups:
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>Verify the takeover IP address has been configured on all nodes in the recovery domain except replicates.
|
||
|
|
</li>
|
||
|
|
<li>Start the TCP/IP interface on the primary node.
|
||
|
|
</li>
|
||
|
|
<li>If the exit program is unsuccessful on any active node in the recovery domain, the exit program job on the primary node will be cancelled and the Takeover IP address will be ended on the primary node.
|
||
|
|
<p>For an application cluster resource group, the exit program on the primary node is not expected to complete. The status of the cluster resource group will be set to Active when the exit program job has been started on the primary and the exit program has completed successfully on all other nodes in the recovery domain.
|
||
|
|
</p>
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p>This command will do the following for device cluster resource groups:
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>The cluster resource group must have at least one configuration object entry.
|
||
|
|
</li>
|
||
|
|
<li>The configuration objects specified for the cluster resource group must exist on all active nodes in the recovery domain and the resource name specified in a configuration object must be the same on all active nodes in the recovery domain.
|
||
|
|
</li>
|
||
|
|
<li>If a data base name has been specified for a configuration object, it must be the same on all active nodes in the recovery domain.
|
||
|
|
</li>
|
||
|
|
<li>If a server takeover IP address is specified, it must exist on all nodes in the recovery domain.
|
||
|
|
</li>
|
||
|
|
<li>The primary node must be the current owner of all input/output processors or high-speed link I/O bridges for the devices in the cluster resource group.
|
||
|
|
</li>
|
||
|
|
<li>The IOP or high-speed link I/O bridge controlling the devices specified in the cluster resource group must be accessible by all active nodes in the cluster resource group's recovery domain.
|
||
|
|
</li>
|
||
|
|
<li>Starting the cluster resource group will not vary on the configuration objects or start the server takeover IP address.
|
||
|
|
</li>
|
||
|
|
<li>All members of an auxiliary storage pool group must be configured in the cluster resource group.
|
||
|
|
</li>
|
||
|
|
<li>A value of *PRIMARY for the device's configuration object online' attribute can be specified only for a secondary auxiliary storage pool.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p>This command will do the following for peer cluster resource groups:
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>All nodes that are designated with a peer role will be an active access point upon successful completion of this command.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<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 running the command.
|
||
|
|
</li>
|
||
|
|
<li>For primary-backup module cluster resource groups, the status of the node currently assigned the role of primary must have a membership status of Active.
|
||
|
|
</li>
|
||
|
|
<li>For peer model cluster resource groups:
|
||
|
|
<ul>
|
||
|
|
<li>At least one node must be designated as a peer node or the cluster resource group cannot be started.
|
||
|
|
</li>
|
||
|
|
<li>At least one peer node must have a membership status of Active.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>The cluster resource group status must be either Inactive or Indoubt.
|
||
|
|
</li>
|
||
|
|
<li>For a device cluster resource group:
|
||
|
|
<ol>
|
||
|
|
<li>The cluster resource group must have at least one configuration object entry.
|
||
|
|
</li>
|
||
|
|
<li>The configuration objects specified for the cluster resource group must exist on all active nodes in the recovery domain and the resource name specified in a configuration object must be the same on all active nodes in the recovery domain.
|
||
|
|
</li>
|
||
|
|
<li>The primary node must be the current owner of all input/output processors or high-speed link I/O bridges for the devices in the cluster resource group.
|
||
|
|
</li>
|
||
|
|
<li>Hardware configuration must be complete so that the physical hardware has been associated with the configuration object. In particular for auxiliary storage pools, the disk units must have been assigned.
|
||
|
|
</li>
|
||
|
|
<li>The input/output processor or high-speed link I/O bridge controlling the devices specified in the cluster resource group must be accessible by all active nodes in the cluster resource group's recovery domain.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRCRG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="STRCRG.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="#STRCRG.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="#STRCRG.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="#STRCRG.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="#STRCRG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="STRCRG.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="#STRCRG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRCRG.CRG"></a>
|
||
|
|
<h3>Cluster resource group (CRG)</h3>
|
||
|
|
<p>Specifies the cluster resource group to be started.
|
||
|
|
</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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRCRG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRCRG.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 to be passed to the exit program.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRCRG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRCRG.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRCRG CLUSTER(MYCLUSTER) CRG(MYCRG)
|
||
|
|
EXITPGMDTA('important information')
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command enables resiliency of the cluster resource group MYCRG in the cluster MYCLUSTER. The exit program, when called, is passed 'important information' in the exit program data field. The cluster resource group will be ACTIVE as a result of this command.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRCRG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRCRG.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="#STRCRG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|