Refreshing locally held information about a cluster

You are unlikely to need to refresh (discard) all locally held information about a cluster in normal circumstances but you might be asked to do this by your IBM® Support Center.

Before you begin

For large clusters, use of the REFRESH CLUSTER command can be disruptive to the cluster while it is in progress, and again at 27 day intervals thereafter when the cluster objects automatically send status updates to all interested queue managers. See Clustering: Using REFRESH CLUSTER best practices in the online product documentation.

Procedure

1. In the Navigator view (in the Queue Manager Clusters folder), right-click the queue manager, the click Refresh cluster membership... The Refresh Cluster Queue Managers dialog opens.
2. Select the scope of the refresh:
   • To refresh all of the queue manager's information about the cluster except for the following information, click Refresh cluster:
     • The queue manager's knowledge of all cluster queue managers and cluster queues that are locally defined is retained.
     • The queue manager's knowledge of all cluster queue managers that are full repositories is retained.
     • If the queue manager is a full repository, knowledge of the other cluster queue managers in the cluster is retained. Everything else is removed from the local copy of the repository and is rebuilt from the other full repositories in the cluster.

     In addition, to specify that objects representing full repository cluster queue managers are also refreshed, select Clear repository information. This option is available only to partial repository queue managers. We can, however, temporarily configure a full repository to be a partial repository so that we can refresh its repository too.

   • To refresh the queue manager in all of the clusters to which it belongs, click Refresh all clusters.

     In addition, to force the queue manager to restart its search for full repositories from the information in the local cluster-sender channel definitions, even if the cluster-sender channel connects the queue manager to several clusters, select Clear repository information.

3. Click OK.

Results

The queue manager's information about the cluster, or clusters, is refreshed.

For more information, see Distributed queuing and clusters in the IBM MQ online product documentation.