Home

 

REFRESH CLUSTER

 

Compaq NSK HP OpenVMS i5/OS UNIX systems Windows z/OS
X X X X X CR

For an explanation of the symbols in the z/OS column, see Using commands in z/OS.

Use REFRESH CLUSTER to discard all locally held cluster information (including any autodefined channels that are in doubt), and force it to be rebuilt. This enables you to perform a "cold-start" on the cluster.

  1. It is not normally necessary to issue a REFRESH CLUSTER command except in one of the following circumstances:

    • Messages have been removed from either the SYSTEM.CLUSTER.COMMAND.QUEUE, or from another queue manager's SYSTEM.CLUSTER.TRANSMIT.QUEUE, where the destination queue is SYSTEM.CLUSTER.COMMAND.QUEUE on the queue manager in question.

    • Issuing a REFRESH CLUSTER command has been recommended by IBM Service.

    • The CLUSRCVR channels were removed from a cluster, or their CONNAMEs were altered on two or more full repository queue managers while they could not communicate.

    • The same name has been used for a CLUSRCVR channel on more than one queue manager in a cluster, and as a result, messages destined for one of the queue managers have been delivered to another. In this case, the duplicates should be removed, and then a REFRESH CLUSTER command should be issued on the single remaining queue manager that has the CLUSRCVR definition.

    • RESET CLUSTER ACTION(FORCEREMOVE) was issued in error.

    • The queue manager has been restarted from an earlier point in time than it last finished, (for example, by restoring backed up data.)

  2. Issuing REFRESH CLUSTER does not correct mistakes in cluster definitions, nor is it necessary to issue the command after such mistakes have been corrected.

  3. On UNIX systems, the command is valid only on AIX, HP-UX, Linux, and Solaris.

  4. On z/OS, the command fails if the channel initiator has not been started.

  5. On z/OS, any errors are reported to the console on the system where the channel initiator is running; they are not reported to the system that issued the command.

Synonym: REF CLUSTER 







REFRESH CLUSTER

>>-REFRESH CLUSTER--(generic-clustername)----------------------->

   .-CMDSCOPE(' ')-----------------. (2)  .-REPOS (NO)--.   
>--+-------------------------------+------+-------------+------><
   |                           (1) |      '-REPOS (YES)-'   
   '-CMDSCOPE--(--qmgr-name--)-----'                        
Notes:

  1. Valid only when the queue manager is a member of a queue-sharing group.

  2. Valid only on z/OS.

 

Parent topic:

The MQSC commands


sc12660_


 

Home