+

Search Tips | Advanced Search

Configure IBM MQ for use with Salesforce push topics and platform events

Use this information to set up security and connections to Salesforce and the IBM MQ network by configuring and then running the IBM MQ Bridge to Salesforce.


Before starting

  • IBM MQ Bridge to Salesforce is available on Linux for x86-64 (64 bit). The bridge is not supported for connecting to queue managers that are running on IBM WebSphere MQ Version 6.0 and earlier.
  • IBM MQ Version 9.1.2 introduces further configuration options. The main change is that a queue manager can now support multiple bridge instances, where they have been configured appropriately. See Additional configuration options for IBM MQ Bridge to Salesforce for further information.
  • Install the MQSeriesSFBridge package. For more information, see Installing IBM MQ server on Linux.


Salesforce is a cloud based, customer relationship management platform. If we are using Salesforce to manage customer data and interactions, we can use the IBM MQ Bridge to Salesforce to subscribe to Salesforce push topics and platform events that can then be published to the IBM MQ queue manager. Applications that connect to that queue manager can consume the push topic and platform event data, in a useful way. We can also use the bridge to create event messages for platform events in Salesforce.

For an overview of the IBM MQ Bridge to Salesforce, see the diagram in Figure 1.

Figure 1. IBM MQ Bridge to Salesforce

Push topics are queries that you define to use the Force.com Streaming API to receive notifications for changes to records in Salesforce. For more information on configuring push topics and how to use the Streaming API, see Introducing Streaming API and Work with PushTopics.

Platform events are customizable event messages that can be defined to determine the event data that the Force.com platform produces or consumes. For more information on platform events and the difference between Salesforce events, see Enterprise messaging platform events and What is the difference between the Salesforce events.

We can monitor the data from the bridge in two ways, through the IBM MQ Console and by using the -p parameter with the amqsrua command. One set of data is published for the overall bridge status:

  • Total push topic messages that are processed in an interval (under the STATUS/PUSHTOPIC tree).
  • Number of push topics that are seen in this interval.
  • Total platform events that are processed in an interval (under the STATUS/PLATFORM tree).
  • Number of platform events that are seen in this interval.
  • Total number of IBM MQ created platform events that are processed in an interval (under the STATUS/MQPE tree).
  • Unique number of IBM MQ created platform events that are seen in this interval.
  • Failed number of publications of IBM MQ created platform events that are seen in this interval.

For each configured Salesforce topic, a further message is published. The IBM MQ topic uses the full Salesforce topic name and the /event or /topic in the object name:

  • Number of messages that are processed in an interval.

To configure the IBM MQ Console to monitor the bridge data, see the steps 9 and 10 in Configure the IBM MQ Bridge to Salesforce. For information on using the amqsrua command, see Monitor the IBM MQ Bridge to Salesforce.

Follow the steps in these tasks to configure and run the IBM MQ Bridge to Salesforce:

Parent topic: Configure IBM MQ


Related information

Last updated: 2020-10-04