Running the IBM MQ Bridge to Salesforce

Run the IBM MQ Bridge to Salesforce to connect to Salesforce and IBM MQ. When connected, the bridge can create subscriptions to Salesforce topics and republish messages to the IBM MQ topic. The bridge can also create event messages for Salesforce platform events.


Before starting

You completed configuration steps in task:

.


About this task

Use the configuration file that you created in the previous task, to run the IBM MQ Bridge to Salesforce. If we have not included all the required parameters in your configuration file, make sure to include them in command line.


Procedure

  1. Define the push topics or platform events in Salesforce that we want to subscribe to or the platform event that we want to create event messages for.
  2. Start the IBM MQ Bridge to Salesforce to connect to Salesforce and your queue manager. If we are running the bridge to subscribe to Salesforce events, include the name of the push topic or platform event that you defined in step 1. 
    runmqsfb -f new_config.cfg -r logFile -p PushtopicName -e eventName
    When the bridge is connected, the following messages are returned:

    • If we are using the bridge to subscribe to Salesforce push topic and platform events:
      Successful connection to queue manager QM1
Warning: Subscribing to MQ-created platform events is not enabled.
Successful login to Salesforce at https://eu11.salesforce.com
Ready to process events.
    • If we are using the bridge to create event messages for Salesforce platform events:
      Successful connection to queue manager QM1
Successful login to Salesforce at https://eu11.salesforce.com
Successful subscription to '/sf/mqtosfb/event/+' for MQ-created platform events
Ready to process events.

  3. Optional: Troubleshoot the connection to your queue manager and to Salesforce if the messages that are returned after you run the bridge indicate that a connection was not successful.
    1. Issue the command in debug mode with the debug option 1. 
      runmqsfb -f new_config.cfg -r logFile -p PushtopicName -e eventName -d 1
      The bridge steps through the connection set up and shows the processing messages in terse mode.
    2. Issue the command in debug mode with the debug option 2. 
      runmqsfb -f new_config.cfg -r logFile -p PushtopicName -e eventName -d 2
      The bridge steps through the connection set up and shows the processing messages in verbose mode. Full output is written to your log file.

  4. Generate events by using the Salesforce interface to modify records in the database.
  5. Go to the IBM MQ Console to see changes to push topics appear in the widget you configured in the previous task.


What to do next

Use the MQSFB_EXTRA_JAVA_OPTIONS variable to pass in JVM properties, for example, to enable IBM MQ tracing. For more information, see Tracing the IBM MQ Bridge to Salesforce.

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


Related information