Cluster queue manager name (-CQMN)

Use the Cluster Queue Manager Name adapter command (-CQMN) to put messages to a queue accessible from a cluster queue manager.

-CQMN [cluster_manager_name]

where cluster_manager_name is the optional name of the cluster queue manager upon which the target queue exists. If cluster_manager_name is not specified, IBM® MQ selects the queue manager from the cluster.

To put a message to a specific instance of a cluster queue (that is, a queue instance that resides on a particular queue manager), specify the name of that queue manager as the argument for the Cluster Queue Manager Name adapter command (-CQMN). This forces the local queue manager to send the message to the specified destination queue manager.

The Cluster Queue Manager Name adapter command (-CQMN) must be accompanied by the Queue Name adapter command (-QN) and the local Queue Manager Name adapter command (-QMN).

If the argument to -QN is the name of a cluster queue and the -CQMN argument is not supplied, the actual destination of messages sent using the queue handle returned by the MQOPEN call is chosen by the queue manager (or by a cluster workload exit if one exists) according to the value of the DefBind queue attribute. This attribute may have one of two values:

  • If MQOO_BIND_ON_OPEN is specified, the queue manager selects a particular instance of the cluster queue during the processing of the MQOPEN call, and all messages put using this queue handle are sent to that instance.
  • If MQOO_BIND_NOT_FIXED is specified, the queue manager may choose a different instance of the destination queue (residing on a different queue manager in the cluster) on each successive MQPUT call that uses this queue handle.

For more information about setting these options, see "MQOPENoptions (-MQOO)" .