Reset Cluster
The Reset Cluster (MQCMD_RESET_CLUSTER) command forces a queue manager to leave a cluster.
| HP Integrity NonStop Server | IBM® i | UNIX and Linux® | Windows | z/OS® |
|---|---|---|---|---|
 |
|
|
|
|
Required parameters
ClusterName(MQCFST)- Cluster name (parameter identifier: MQCA_CLUSTER_NAME).
The name of the cluster to be reset.
The maximum length of the string is MQ_CLUSTER_NAME_LENGTH.
QMgrIdentifier(MQCFST)- Queue manager identifier (parameter identifier: MQCA_Q_MGR_IDENTIFIER).
This parameter is the unique identifier of the queue manager to be forcibly removed from the cluster. Only one of
QMgrIdentifierandQMgrNamecan be specified. UseQMgrIdentifierin preference toQmgrName, becauseQmgrNamemight not be unique.
QMgrName(MQCFST)- Queue manager name (parameter identifier: MQCA_Q_MGR_NAME).
This parameter is the name of the queue manager to be forcibly removed from the cluster. Only one of
QMgrIdentifierandQMgrNamecan be specified. UseQMgrIdentifierin preference toQmgrName, becauseQmgrNamemight not be unique.
Action(MQCFIN)- Action (parameter identifier: MQIACF_ACTION).
Specifies the action to take place. This parameter can be requested only by a repository queue manager.
The value can be any of the following values:- MQACT_FORCE_REMOVE
- Requests that a queue manager is forcibly removed from a cluster.
Optional parameters
![[z/OS]](ngzos.gif)
-
CommandScope(MQCFST) - Command scope (parameter identifier: MQCACF_COMMAND_SCOPE). This parameter applies to z/OS only.
Specifies how the command is executed when the queue manager is a member of a queue-sharing group. You can specify one of the following:
- blank (or omit the parameter altogether). The command is executed on the queue manager on which it was entered.
- a queue manager name. The command is executed on the queue manager you specify, providing it is active within the queue sharing group. If you specify a queue manager name other than the queue manager on which it was entered, you must be using a queue-sharing group environment, and the command server must be enabled.
The maximum length is MQ_QSG_NAME_LENGTH.
RemoveQueues(MQCFIN)- Whether cluster queues are removed from the cluster (parameter identifier: MQIACF_REMOVE_QUEUES).
This parameter indicates whether the cluster queues that belong to the queue manager being removed from the cluster are to be removed from the cluster. This parameter can be specified even if the queue manager identified by the
QMgrNameparameter is not currently in the cluster.The value can be any of the following values:- MQCFO_REMOVE_QUEUES_YES
- Remove queues belonging to the queue manager being removed from the cluster.
- MQCFO_REMOVE_QUEUES_NO
- Do not remove queues belonging to the queue manager being removed. MQCFO_REMOVE_QUEUES_NO is the default.
Error codes
This command might return the following error code in the response format header, in addition to the values shown in Error codes applicable to all commands.
Reason(MQLONG)- The value can be any of the following values:
- MQRCCF_ACTION_VALUE_ERROR
- Value not valid.