Testing JMS connectivity and capability

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 Records Integration-Resources JNDI 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 Records Integration-Resources JNDI 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 Records Integration-Resources JNDI 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 your that 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 Records Integration-Resources JNDI 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 Records Integration-Connectors Connect 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.