Suspend Queue Manager Cluster
The Suspend Queue Manager Cluster (MQCMD_SUSPEND_Q_MGR_CLUSTER) command informs other queue managers in a cluster that the local queue manager is not available for processing, and cannot be sent messages. Its action can be reversed by the Resume Queue Manager Cluster (MQCMD_RESUME_Q_MGR_CLUSTER) command.
| HP Integrity NonStop Server | UNIX and Linux® | Windows |
|---|---|---|
| X | X | X |
Required parameters
ClusterName(MQCFST)- Cluster name (parameter identifier: MQCA_CLUSTER_NAME).
The name of the cluster for which availability is to be suspended.
The maximum length of the string is MQ_CLUSTER_NAME_LENGTH.
ClusterNamelist(MQCFST)- Cluster Namelist (parameter identifier: MQCA_CLUSTER_NAMELIST).
The name of the namelist specifying a list of clusters for which availability is to be suspended.
Optional parameters
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.
Mode(MQCFIN)- How the local queue manager is suspended from the cluster (parameter
identifier: MQIACF_MODE). The value can be:
- MQMODE_QUIESCE
- Other queue managers in the cluster are told not to send further messages to the local queue manager.
- MQMODE_FORCE
- All inbound and outbound channels to other queue managers in the cluster are stopped forcibly.
Note: This parameter was previously calledQuiesce(MQIACF_QUIESCE), with values MQQO_YES and MQQO_NO. The old names can still be used.
Error codes
This command might return the following error codes in the response format header, in addition to the values shown in Error codes applicable to all commands.
Reason(MQLONG)- The value can be:
- MQRCCF_CLUSTER_NAME_CONFLICT
- Cluster name conflict.
- MQRCCF_MODE_VALUE_ERROR
- Mode value not valid.