Change Cluster Version (CHGCLUVER)

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

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.

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.

This command will not cause the cluster resource group exit program to be called.

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 invoked from a cluster node with a status of Active.
  4. This command cannot be used if the cluster is in a partitioned state.
  5. 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.
Top

Parameters

Keyword Description Choices Notes
CLUSTER Cluster Name Required, Positional 1
Top

Cluster (CLUSTER)

Specifies the cluster being adjusted.

This is a required parameter.

name
Specify the name of the cluster that is to be changed.
Top

Examples

CHGCLUVER   CLUSTER(MYCLUSTER)

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.

Top

Error messages

*ESCAPE Messages

CPF1999
Errors occurred on command.
Top