RESET CLUSTER

---

Use RESET CLUSTER to perform special operations on clusters.

Notes:

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

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

3. 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.

4. This command is not available within the reduced function form of WebSphere MQ for z/OS supplied with WebSphere Application Server.

Synonym: None

RESET CLUSTER
 
>>-RESET CLUSTER(clustername)--ACTION(FORCEREMOVE)-------------->
 
                       .-CMDSCOPE(' ')------------. (1)
>--+-QMNAME(qmname)-+--+--------------------------+------------->
   '-QMID(qmid)-----'  |                     (2)  |
                       '-CMDSCOPE(qmgr-name)------'
 
   .-QUEUES (NO)--.
>--+--------------+--------------------------------------------><
   '-QUEUES (YES)-'
 
 

Notes:

1. Valid only on z/OS.

2. Valid only on full function WebSphere MQ for z/OS when the queue manager is a member of a queue-sharing group.

 

Parameter descriptions

(clustername)

The name of the cluster to be reset. This is required.

ACTION(FORCEREMOVE)

Requests that the queue manager is forcibly removed from the cluster. This might be needed to ensure proper clean up after a queue manager has been deleted.

This action can be requested only by a repository queue manager.

CMDSCOPE

This parameter applies to z/OS only and specifies how the command is executed when the queue manager is a member of a queue-sharing group.

' '

The command is executed on the queue manager on which it was entered. This is the default value.

qmgr-name

The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group.

You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled.

QMID(qmid)

The identifier of the queue manager to be forcibly removed.

QMNAME(qmname)

The name of the queue manager to be forcibly removed.

QUEUES

Specifies whether cluster queues owned by the queue manager being force removed are removed from the cluster.

NO

Cluster queues owned by the queue manager being force removed are not removed from the cluster. This is the default.

YES

Cluster queues owned by the queue manager being force removed are removed from the cluster in addition to the cluster queue manager itself. The cluster queues are removed even if the cluster queue manager is not visible in the cluster, perhaps because it was previously force removed without the QUEUES option.

On z/OS, N and Y are accepted synonyms of NO and YES.

 

Usage notes

1. To avoid any ambiguity, it is preferable to use QMID rather than QMNAME. The queue manager identifier can be found by commands such as DISPLAY QMGR and DISPLAY CLUSQMGR.

   If QMNAME is used, and there is more than one queue manager in the cluster with that name, the command is not actioned.

2. If you use characters other than those listed in Rules for naming WebSphere MQ objects in your object or variable names, for example in QMID, enclose the name in quotes.

3. If you remove a queue manager from a cluster using this command, you can rejoin it to the cluster by issuing a REFRESH CLUSTER command. Wait at least 10 seconds before issuing a REFRESH CLUSTER command, because the repository ignores any attempt to rejoin the cluster within 10 seconds of a RESET CLUSTER command.

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.