Close popover

Table of Contents

Configuring Pega Platform as a JMS publisher

Configure Pega Platform as a message publisher client in your Java Messaging Service (JMS) model

  • Finish the import by clicking Next.

  • ">
  • Optional:

    To import all the requisite JAR files for your JMS vendor into Pega Platform, repeat substeps 4b through 2e.

  • Import the JAR file into the CodeSet by restarting your environment.

    For Pega Cloud, you request a restart of your environment in My Support Portal.

  • To use an JNDI server instance for your JMS resource, create a JNDI server data instance by clicking the rule that references the context factory and provider URL of the JMS resource:

    1. In the header of Dev Studio,, click Create Integration-Resources JNDI Server .

    2. If you use an external or internal JNDI server for your JMS resource, reference the JNDI server environment information that you created in step 1 in the JNDI Server form.

    3. Restart the environment.

      For Pega Cloud, you request a restart of your environment in My Support Portal.

    4. Test connectivity on the form before continuing your JMS integration.

    5. Optional:

      For Pega Cloud, to create an internal JNDI server or resource reference for use with your JMS model to make it compatible with a Pega Cloud deployment, create a request that states that you need an internal JNDI server with your regional Pega Support representative by selecting New Request in My Support Portal.

      The Pega Cloud Services team creates an internal JNDI service reference for you to use in your instance of Pega Platform.

    For more information about the environment tab of the JNDI Server data instance form, see JNDI Server form - Completing the Environment tab.

  • Create a Producer Model that determines the messaging characteristics of the connector as a JMS producer:

    1. In the header of Dev Studio,, click Create Integration-Resources JMS Producer Model .

    2. In the JMS Producer Model form, configure the JMS Producer Model.

      For more information about completing the form, including determining whether the message should remain in queue until confirmed as received, or whether the JMS model uses point-to-point or publish/subscribe messaging. see About JMS Producer Model data instances.

  • Create a Connect JMS rule that references the JNDI server or resource reference:

    1. On the Service tab, in the Resource name resolution list, select the type of JMS resource that you created in steps 1 and 2.

    2. Enter the resource reference or JNDI server information in the associated fields.

    3. In the JMS Producer Model list, select the JMS Producer Model that you created in step 3.

    4. In the Request section, in the Destination name field, enter the JMS resource for the queue or topic to receive messages.

    5. In the Response section, in the Destination name field, enter the JMS resource for a temporary queue to hold response messages.

      For more information about configuring the Connect JMS rule, see Connect JMS form – Completing the Service tab.

  • On the Request tab, in the Message data section, in the Data type list, select the primitive Java data type that you plan to send with the message:

    1. In the Map from field, select whether you mapped your message to the Clipboard, or enter a constant value to send.

    2. In the Map from key field, select a property that contains your message.

      For more information about completing the Request tab for the Connect JMS rule, see Connect JMS form – Completing the Request tab.

  • On the Response tab, in the Data type list, select the data type you want to use as a response from your queue or topic upon receiving the message.

    1. In the Message Key field, enter the external name for the response.

    2. In the Map to and Map to key fields, enter the elements to which you want to map the response.

      For more information about completing the Response tab of the Connect JMS rule , see Connect JMS form – Completing the Response tab.

  • Create an activity that runs the property or key that contains the message:

    1. In the header of Dev Studio, click Create Technical Activity .

    2. On the Steps tab, in the Label field, enter a descriptive name for the rule instance.

    3. In the Apply to field, select the class to which this activity applies.

    4. Click Create and open.

    5. On the Steps tab, in the Method list, select Property-Set.

    6. Click the Expand icon.

    7. In the Properties Name field, enter the property that you selected in the Connect JMS rule that you created in step 4.

    8. In the Properties Value field, enter the message that you want to send through JMS.

      Ensure that the message corresponds to the data type selected in the Connect JMS rule.
    9. Click Add a step.

    10. In the Method list for the new step, select Connect-JMS.

    11. Click the Expand Method Parameters icon.

    12. In the Value field, select the name of the Connect JMS rule that you created in step 4.

    13. Click Save.

    14. In the Actions list, select Run.

    15. In the Run Activity window, send the message from Pega Platform by selecting Run.

  • The message appears in your message queue or topic.
    Test JMS messaging when you integrate Pega Platform as your JMS publisher. For more information, see Testing JMS connectivity and capability.
    Suggest Edit

    Have a question? Get answers now.

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