mqsijoinmqpubsub command

Supported platforms

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

Purpose

Use the mqsijoinmqpubsub command to join this WebSphere Business Integration Message Broker broker to an MQSeries Publish/Subscribe broker network. The command identifies a specific MQSeries Publish/Subscribe broker to be the parent of the WebSphere Business Integration Message Broker broker.

This is an asynchronous command. Successful completion of this command indicates that the WebSphere Business Integration Message Broker broker has accepted the request, not that the required action has completed.

Use the mqsilistmqpubsub command to monitor the status of the asynchronous actions that result from this command.

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

Syntax

Parameters

brokername
(Required) The name of the broker that is to be joined to an MQSeries Publish/Subscribe broker.
-p ParentQueueManagerName
(Required) The name of the queue manager that hosts the MQSeries Publish/Subscribe broker to which this WebSphere Business Integration Message Broker broker is to be joined.

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

  • 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

Examples


mqsijoinmqpubsub WBRK_BROKER -p MQBroker1

Related concepts
Publish/Subscribe

Related tasks
Developing publish/subscribe applications

Related reference
Syntax preference
mqsiclearmqpubsub command
mqsilistmqpubsub command