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

137 lines
5.3 KiB
HTML
Raw 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 Configuration (CHGCLUCFG)</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="CHGCLUCFG.Top_Of_Page"></a>
<h2>Change Cluster Configuration (CHGCLUCFG)</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="#CHGCLUCFG.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGCLUCFG.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGCLUCFG.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGCLUCFG"></a>
<p>The Change Cluster Configuration (CHGCLUCFG) command is used to tune cluster performance and configuration parameters. The command provides a base level of tuning support where the cluster will adjust to a predefined set of values identified for maximum, minimum, and normal timeout and messaging interval values. If an advanced level of tuning is desired, usually anticipated with the help of IBM support personnel, then individual parameters may be tuned over a predefined range of values using the Change Cluster Resource Services (QcstChgClusterResourceServices) API.
</p>
<p>Values for current settings may be retrieved using the Display Cluster Information (DSPCLUINF) command.
</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 called on a cluster node with a status of Active.
</li>
<li>The tuning parameters defined under the Change Cluster Resource Services (QcstChgClusterResourceServices) API must match exactly in both partitions for a merge to be allowed.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCLUCFG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGCLUCFG.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="#CHGCLUCFG.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="#CHGCLUCFG.LEVEL"><b>LEVEL</b></a></td>
<td valign="top">Level</td>
<td valign="top"><b><u>*NORMAL</u></b>, *MIN, *MAX</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGCLUCFG.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGCLUCFG.CLUSTER"></a>
<h3>Cluster (CLUSTER)</h3>
<p>Specifies the cluster for which the configuration and tuning will be changed.
</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="#CHGCLUCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCLUCFG.LEVEL"></a>
<h3>Level (LEVEL)</h3>
<p>Specifies the desired cluster communications configuration tuning sensitivity level. Provides a simple way to set cluster performance and configuration parameters.
</p>
<dl>
<dt><b><u>*NORMAL</u></b></dt>
<dd>Default values are used for cluster communications performance and configuration parameters. This setting may be used to return all parameters to the original default values.
</dd>
<dt><b>*MIN</b></dt>
<dd>Adjustments are made to cluster communications to increase the heartbeating interval and increase the various message timeout values. With fewer heartbeats and longer timeout values, the cluster will be slower to respond (minimum sensitivity) to communications failures.
</dd>
<dt><b>*MAX</b></dt>
<dd>Adjustments are made to cluster communications to decrease the heartbeating interval and decrease the various message timeout values. With more frequent heartbeats and shorter timeout values, the cluster will be quicker to respond (maximum sensitivity) to communications failures.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCLUCFG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGCLUCFG.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGCLUCFG CLUSTER(MYCLUSTER) LEVEL(*MIN)
</pre>
</p>
<p>This command changes the configuration and tuning level of the cluster MYCLUSTER. The tuning level is set to the minimum sensitivity level.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCLUCFG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGCLUCFG.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="#CHGCLUCFG.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>