Change Cluster Configuration (CHGCLUCFG)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

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.

Values for current settings may be retrieved using the Display Cluster Information (DSPCLUINF) command.

Restrictions:

  1. You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
  2. This command cannot be called from a cluster resource group exit program.
  3. This command must be called on a cluster node with a status of Active.
  4. The tuning parameters defined under the Change Cluster Resource Services (QcstChgClusterResourceServices) API must match exactly in both partitions for a merge to be allowed.
Top

Parameters

Keyword Description Choices Notes
CLUSTER Cluster Name Required, Positional 1
LEVEL Level *NORMAL, *MIN, *MAX Optional
Top

Cluster (CLUSTER)

Specifies the cluster for which the configuration and tuning will be changed.

This is a required parameter.

name
Specify the name of the cluster.
Top

Level (LEVEL)

Specifies the desired cluster communications configuration tuning sensitivity level. Provides a simple way to set cluster performance and configuration parameters.

*NORMAL
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.
*MIN
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.
*MAX
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.
Top

Examples

CHGCLUCFG   CLUSTER(MYCLUSTER)  LEVEL(*MIN)

This command changes the configuration and tuning level of the cluster MYCLUSTER. The tuning level is set to the minimum sensitivity level.

Top

Error messages

*ESCAPE Messages

CPF1999
Errors occurred on command.
Top