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

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


Before you begin

  • IBM MQ Bridge to Salesforce is available on Linux for System x (64 bit). The bridge is not supported for connecting to queue managers that are running on IBM WebSphere MQ Version 6.0 and earlier.
  • Install the MQSeriesSFBridge package. For more information, see Install IBM MQ server on Linux.


About this task

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

From IBM MQ Version 9.0.4, 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 Working 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 the next task 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: