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.
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.
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.
Follow the steps in these tasks to configure and run the IBM MQ Bridge to Salesforce:
Configure the IBM MQ Bridge to Salesforce
We can configure IBM MQ and enter IBM MQ Bridge to Salesforce parameters to create the configuration file and connect Salesforce push topics and platform events to the IBM MQ queue manager.
Additional configuration options for IBM MQ Bridge to Salesforce
IBM MQ Version 9.2.0 additional configuration options are available that permit two major classes of additional topology, dealing with "inbound" (events generated from Salesforce, being published to IBM MQ applications) and "outbound" (IBM MQ applications publishing events that are sent to Salesforce) work. In addition, there is a change to the way in which tracing and logging work.