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.
Notes:
- 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(R) 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.)
- Issuing REFRESH CLUSTER does not correct mistakes in cluster definitions,
nor is it necessary to issue the command after such mistakes have been corrected.
- On UNIX systems, the command is valid only on AIX, HP-UX, Linux,
and Solaris.
- On z/OS, the command fails if the channel initiator has not been started.
- 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:
- Valid only when the queue manager is a member of a queue-sharing
group.
- Valid only on z/OS.