Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Testing JMS connectivity and capability

Updated on April 6, 2022

After you integrate Pega Platform as a Java Messaging Service (JMS) publisher or receiver, you can test the Pega Platform JMS capabilities through JMS-related forms. You can test JMS messaging whether Pega Platform acts as the publisher or receiver client.

  1. Test connectivity of the JNDI server used in your JMS model.
    1. In the navigation pane of Dev Studio, click RecordsIntegration-ResourcesJNDI Server and reopen the JNDI server you created.
    2. If you use an external or internal JNDI server for your JMS resource, reference the JNDI server environment information in the Initial Context Factory and Provider URL.
    3. Restart the environment.
      For Pega Cloud, you request a restart of your environment in My Support Portal.
    4. In the navigation pane of Dev Studio, click RecordsIntegration-ResourcesJNDI Server and reopen the JNDI server you created again.
    5. Click Test connectivity.
    6. In the Connection status page, confirm the results and values of the connections to the JNDI server.
  2. Send a test message from Pega Platform to your receiver destination.
    1. In the navigation pane of Dev Studio, click RecordsIntegration-ResourcesJNDI Server and reopen the JNDI server you created.
    2. Click JMS explorer.
    3. In the Connection status page, confirm the results and values of the connections to the JNDI server.
    4. In the Destination field, enter the queue or topic that you use in your JMS model.
    5. Click Put Messages.
    6. Optional: To identify the message, in the Correlation ID field, enter a unique identifier.
    7. To override the order that your application uses to send a JMS message, in the Priority field, enter a value from 0 (lowest priority) to 9 (highest priority).
    8. To specify what kind of message you want to send, in the Message Type list, select the type of message.
    9. To receive a reply receipt, in the Reply To Queue Name, enter the name of the destination to receive a reply receipt.
    10. Optional: To include any additional property headers in the JMS message, in the Property Name field, enter your headers.
    11. In the Message Data field, enter the test message that you want to send to your destination.
    12. Click Submit.
    13. In the JMS Message section of the result window, confirm that the JMS message is sent.
    14. In your JMS model destination queue, confirm that the message Pega Platform sent to your queue has been received.
  3. View all of the artifacts associated with the JNDI server of your JMS data model.
    1. In the navigation pane of Dev Studio, click RecordsIntegration-ResourcesJNDI Server and reopen the JNDI server you created.
    2. Click Browse tree.
    3. View all the artifacts that are associated with your JNDI server that form your JMS data model.
  4. View messages that you send to a destination.
    1. In the navigation pane of Dev Studio, click RecordsIntegration-ConnectorsConnect JMS and reopen the Connect JMS rule you created.
    2. In the Response section, select the destination name of your JMS model queue or topic.
    3. Click Message Queue.
    4. In the result window, view any message that you sent to the destination.
  • Previous topic Configuring Pega Platform as a JMS publisher
  • Next topic Configuring Pega Platform as a Java Messaging Service receiver

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us