[V9.0.2 Mar 2017][Linux]

Configuring 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]Linux® for System x (64 bit). The bridge is not supported for connecting to queue managers that are running on IBM WebSphere® MQ 6.0 and earlier.
  • Install the MQSeriesSFBridge package. For more information, see Installing 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 9.0.2 you 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.

[V9.0.4 Oct 2017]From IBM MQ 9.0.4, you 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
The diagram shows the Salesforce environment that contains push topics and platform events and a separate IBM MQ environment that contains the IBM MQ Bridge to Salesforce, the queue manager and an application. The IBM MQ Bridge to Salesforce box has a subscribe arrow that connects to the push topic/platform event box in Salesforce and another publish arrow that comes back from Salesforce. On the other side, the IBM MQ Bridge to Salesforce has a publish arrow that goes to the queue manager box. The application box has a subscribe arrow to the queue manager box.

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.

You 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.
  • [V9.0.4 Oct 2017]Total number of IBM MQ created platform events that are processed in an interval (under the STATUS/MQPE tree).
  • [V9.0.4 Oct 2017]Unique number of IBM MQ created platform events that are seen in this interval.
  • [V9.0.4 Oct 2017]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 Configuring the IBM MQ Bridge to Salesforce. For information on using the amqsrua command, see Monitoring the IBM MQ Bridge to Salesforce.

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