mqsiclearmqpubsub command

Supported platforms

  • Windows 2000, Windows XP
  • UNIX platforms
  • z/OS through the BIPJCMPS utility; see z/OS utility jobs

Purpose

Use the mqsiclearmqpubsub command to remove an MQSeries Publish/Subscribe broker as a neighbor of this WebSphere Business Integration Event Broker broker.

This command removes knowledge of the MQSeries Publish/Subscribe broker from the WebSphere Business Integration Event Broker broker identified on this command. To complete this action you must also issue the MQSeries Publish/Subscribe command clrmqbrk against the MQSeries Publish/Subscribe broker. When both clear commands have completed, all publish/subscribe traffic between the two brokers ceases.

Use this command only if you are integrating this WebSphere Business Integration Event Broker broker with an MQSeries Publish/Subscribe broker network. Before you issue this command you must ensure that the WebSphere Business Integration Event Broker broker is ready to receive and process messages on queue SYSTEM.BROKER.INTER.BROKER.COMMUNICATIONS (that is, you must restart the broker after creating this queue.)

Syntax

Parameters

brokername
(Required) The name of the broker from which knowledge of an MQSeries Publish/Subscribe neighbor broker is to be removed.
-n NeighborQueueManagerName
(Required) The name of the queue manager that hosts the MQSeries Publish/Subscribe broker for which the association as a neighbor is being removed.

Authorization

The user ID used to invoke this command must have put and inq authority to the queue SYSTEM.BROKER.INTER.BROKER.COMMUNICATIONS.

On UNIX platforms, the user ID must be a member of the mqbrkrs group.

Responses

This command returns the following responses:
  • BIP8013 Component does not exist
  • BIP8056 Unknown queue manager
  • BIP8057 Queue manager error
  • BIP8059 Queue manager not available
  • BIP8060 Queue error
  • BIP8061 No reply received
  • BIP8064 Internal broker error
  • BIP8066 Invalid broker name
  • BIP8070 Database exception
  • BIP8072 Database exception

Examples

mqsiclearmqpubsub WBRK_BROKER -n MQBroker1
Related concepts
Publish/Subscribe