The Change Cluster Version (CHGCLUVER) command is used to adjust the current version of the cluster and the PowerHA product. The current cluster version is the version at which the nodes in the cluster are actively communicating with each other. The current PowerHA version is the version at which the nodes in the cluster managed by the PowerHA product are actively communicating with each other. In addition, these values determine what nodes can join into the cluster and the cluster's and PowerHA product's ability to use new functions supported by the nodes' potential versions. The values are initially set when the cluster is created. This command can be used to adjust the current cluster version to be one version greater than the existing current cluster version. This command can also be used to adjust the current PowerHA version to be one version or one modification level greater than the existing current PowerHA version. To view the current cluster and PowerHA versions, use the Display Cluster Information (DSPCLUINF) command.

This command can only be used to adjust to a higher cluster or PowerHA version. The only way to change the cluster or PowerHA version 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:

• You must have input/output system configuration (*IOSYSCFG) special authority on all nodes in the cluster to run this command.
• When adjusting the current cluster version, this command cannot be called from a cluster resource group exit program.
• This command must be invoked from a cluster node with a status of Active.
• This command cannot be used if the cluster is in a partitioned state.
• The current cluster version cannot be set higher than the lowest potential node version in the cluster. Likewise, the current PowerHA version cannot be set higher than the lowest PowerHA potential version of any node in the cluster. To view the potential node and PowerHA versions, use the Display Cluster Information (DSPCLUINF) command.

Parameters

Keyword	Description	Choices	Notes
CLUSTER	Cluster	Name	Required, Positional 1
CLUVER	Cluster version	*UP1VER, *SAME	Optional
HAVER	PowerHA version	*SAME, *UP1VER, *UP1MOD	Optional

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.

Cluster version (CLUVER)

Specifies the way in which the current cluster version is to be adjusted.

*UP1VER

The current cluster version is incremented by one version.

*SAME

The current cluster version is not changed.

PowerHA version (HAVER)

Specifies the way in which the current PowerHA version is to be adjusted.

*SAME

The current PowerHA version is not changed.

*UP1VER

The current PowerHA version is incremented by one version.

*UP1MOD

The current PowerHA version is incremented by one modification level.

Examples

CHGCLUVER   CLUSTER(MYCLUSTER) CLUVER(*UP1VER) HAVER(*SAME)

This command adjusts 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. The current PowerHA version will remain unchanged.

CHGCLUVER   CLUSTER(MYCLUSTER) CLUVER(*SAME) HAVER(*UP1VER)

This command adjusts the current PowerHA version of cluster MYCLUSTER by one version. If the current PowerHA version was 2.0, it is set to 3.0 as a result of this command. The current cluster version will remain unchanged.

CHGCLUVER   CLUSTER(MYCLUSTER) CLUVER(*SAME) HAVER(*UP1MOD)

This command adjusts the current PowerHA version of cluster MYCLUSTER by one modification level. If the current PowerHA version was 2.0, it is set to 2.1 as a result of this command. The current cluster version will remain unchanged.

Error messages

*ESCAPE Messages

HAE0013

Cluster or PowerHA version of cluster &1 not changed.

HAE004B

Current PowerHA version cannot be set to &1.