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

116 lines
4.2 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>Change Cluster Version (CHGCLUVER)</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="CHGCLUVER.Top_Of_Page"></a>
<h2>Change Cluster Version (CHGCLUVER)</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="#CHGCLUVER.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGCLUVER.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGCLUVER.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGCLUVER"></a>
<p>The Change Cluster Version (CHGCLUVER) command is used to adjust the current version of the cluster. The current cluster version is the version at which the nodes in the cluster are actively communicating with each other. In addition, this value determines what nodes can join into the cluster and the cluster's ability to use new functions supported by the nodes potential node version. It is initially set when the cluster is created. This command adjusts the cluster version to be one level greater than the existing value. To view the current cluster version, use the Display Cluster Information (DSPCLUINF) command.
</p>
<p>This command can only be used to adjust to a higher version. The only way to change the cluster to a lower version is to delete and recreate the cluster at the lower version.
</p>
<p>This command will not cause the cluster resource group exit program to be called.
</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>This command must be invoked from a cluster node with a status of Active.
</li>
<li>This command cannot be used if the cluster is in a partitioned state.
</li>
<li>The cluster version cannot be set higher than the lowest potential node version in the cluster. To view the potential node versions, use the Display Cluster Information (DSPCLUINF) command.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCLUVER.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGCLUVER.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="#CHGCLUVER.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>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGCLUVER.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGCLUVER.CLUSTER"></a>
<h3>Cluster (CLUSTER)</h3>
<p>Specifies the cluster being adjusted.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the cluster that is to be changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCLUVER.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGCLUVER.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGCLUVER CLUSTER(MYCLUSTER)
</pre>
</p>
<p>This command adjust the current version of cluster MYCLUSTER. If the current cluster version level was 2, it is set to 3 as a result of this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCLUVER.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGCLUVER.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="#CHGCLUVER.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>