--- schema_version: "1" id: cccb25be7a502d5da82d443f5466aa61a311e3bfe46a6fd486833a08b21f494b title: Publish Messages Using JMS Connector collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/jms-connector/1.10/jms-publish.md canonical_url: https://docs.mulesoft.com/jms-connector/1.10/jms-publish source_site: docs.mulesoft.com content_type: documentation content_hash: 411672e7ececcd6160e72d0dead5be41289b1278b42798fb62b24bf40c4b7374 description: MuleSoft Documentation Site release: "1.10" latest: false --- --- product: JMS Connector version: 1.10 keywords: jms, connector, publish --- # Publish Messages Using JMS Connector > For the full documentation index, see: https://docs.mulesoft.com/llms.txt The Anypoint Connector for JMS (JMS Connector) **Publish** operation enables you to create a new JMS message and send it to the specified destination, whether it is a queue or a topic. Using the operation, you can configure not only the content of the message, but also any necessary headers. ## Publish a Message to a Queue The **Publish** operation publishes whatever is in the message payload to the specified queue. In the following example, you configure the operation to publish a message to a queue specified in the **Destination** field: 1. In your Studio flow, select the **Publish** operation. 2. Set the **Destination** field to the queue name, for example, `invoiceQueue`. ![In the Publish configuration screen](/mulesoft/current/en-us/jms-connector/1.10/_images/jms-publish-config-1.png) Figure 1. Publish operation configuration to a queue In the XML editor, the `` and `destination` configurations look like this: ```xml ``` If you must transform the payload because it is not in the correct format, you could place a DataWeave transformation before the **Publish** operation, but that would cause the message payload to change and impact the operation placed after the transformation. To avoid this impact, place the DataWeave transformation inside the **Publish** operation. The transformation generates the content to publish without affecting the message in transit. In the following example, you configure the transformation inside the operation: 1. In your Studio flow, select the **Publish** operation. 2. Set the **Destination** field to the queue name, for example, `invoiceQueue`. 3. In the **Body** field, set the following DataWeave transformation: ```DataWeave %dw 2.0 output application/json --- payload.payments ``` ![In the Publish configuration screen](/mulesoft/current/en-us/jms-connector/1.10/_images/jms-publish-config-2.png) Figure 2. Publish operation configuration with DataWeave Transformation In the XML editor, the `` configuration looks like this: ```xml #[%dw 2.0 output application/json --- payload.payments ] ``` ## Publish a Message to a Topic The **Publish** operation can also publish a message to a specified topic destination. Because all the configurations of the operation and the message are identical, you just need only to configure the **Destination type** field to **TOPIC**. In the following example, you configure the operation to publish a message to a topic destination: 1. In your Studio flow, select the **Publish** operation. 2. Set the **Destination** field to the queue name, for example, .Publish operation configuration to a topic destination image::jms-publish-config-3.png\[In the Publish configuration screen, set the Destination type field to TOPIC\] In the XML editor, the `` and `destinationType` configurations look like this: ```xml #[%dw 2.0 output application/json --- payload.payments ] ``` ## Customize Message Delivery Each JMS message has a set of headers that enables you to communicate metadata such as the time to live or message priority. ### Configure a Priority Queue To configure a priority queue, set the **Priority** field to a value different from the default: 1. In your Studio flow, select the **Publish** operation. 2. Set the **Destination** field to the queue name, for example, `priorityQueue`. 3. In the **Publish Configuration** section, set the **Priority** field to `attributes.queryParams.priority`. ![In the Publish configuration screen](/mulesoft/current/en-us/jms-connector/1.10/_images/jms-publish-config-4.png) Figure 3. Publish operation Priority configuration In the XML editor, the `` and `priority` configurations look like this: ```xml ``` ### Configure a Time To Live Every JMS message published is sent with a time-to-live header that declares how long the message is available for consumption it before it expires. In the operation, configure the **Time to live** and **Time to live unit** fields: 1. In your Studio flow, select the **Publish** operation. 2. Set the **Destination** field to the queue name, for example `vars.destination`. 3. In the **Publish Configuration** section, set the **Time to live** field to `vars.timeToLive`. 4. Set the **Time to live unit** field to **SECONDS**. ![In the Publish configuration screen](/mulesoft/current/en-us/jms-connector/1.10/_images/jms-publish-config-5.png) Figure 4. Publish operation Time to live configuration In the XML editor, the `timeToLive` and `timeToLiveUnit` configurations looks like this: ```xml ``` If you are using the JMS 2.0 specification, you can also control the message delivery delay, which is how long to wait before making the message available to consumers. In the operation, configure the **Delivery delay** and **Delivery delay unit** fields: 1. In your Studio flow, select the **Publish** operation. 2. Set the **Destination** field to the queue name, for example, `vars.destination`. 3. Set the **Delivery delay** field to `${msgInitialDelay}`. 4. Set the **Delivery delay unit** field to **MILLISECONDS**. ![In the Publish configuration screen](/mulesoft/current/en-us/jms-connector/1.10/_images/jms-publish-config-6.png) Figure 5. Publish operation Delivery Delay configuration In the XML editor, the `deliveryDelay` and `deliveryDelayUnit` configurations look like this: ```xml ``` ## Configure a Reply Destination When you require an asynchronous reply to the sent message, the **Publish** operation enables you to declare any reply-to destination in the **Reply to** field. The reply destination is communicated as a JMS header to the consumer of the message. In the following example, you configure the reply-to destination: 1. In your Studio flow, select the **Publish** operation. 2. Set the **Destination** field to the queue name, for example, `vars.destination`. 3. Set the **Reply to** field to **Edit inline**. 4. Set the **Destination name** field to `${completionEventsDestination}`. 5. Set the **Destination type** field to **TOPIC**. ![In the Publish configuration screen, set the Reply To to Edit inline, set a name for the Destination name field, and set the Destination type field to TOPIC.](/mulesoft/current/en-us/jms-connector/1.10/_images/jms-publish-config-7.png) Figure 6. Publish operation Reply To configuration In the XML editor, the ``, `destination` and `destinationType` configurations look like this: ```xml ``` ## Configure the Correlation ID The **Publish** operation enables you to configure a correlation ID for the outgoing message in the **Correlation ID** field. First you must configure whether you want to send the correlation ID when publishing the message. If so, configure the **Send correlation id** field to any of the following options: - **ALWAYS** Always sends the header - **NEVER** Never sends the header - **AUTO** The default value, which uses the application configuration Then you can either use the correlation ID of the event that is sending the message, or you can configure your own custom correlation ID in the message builder: 1. In your Studio flow, select the **Publish** operation. 2. Set the **Destination** field to the queue name, for example, `attributes.headers.replyTo.destination`. 3. Set the **Send correlation id** field to **ALWAYS**. 4. Set the **Correlation ID** field to `attributes.headers.correlationId`. ![In the Publish configuration screen](/mulesoft/current/en-us/jms-connector/1.10/_images/jms-publish-config-8.png) Figure 7. Publish operation Correlation ID configuration In the XML editor, the `endCorrelationId` and `correlationId` configurations look like this: ```xml ``` ## Configure Message Properties Use properties in your JMS message to do things like establishing compatibility with other messaging systems or creating custom message selectors Some of these properties are well-known JMS standards, but others depend on the implementation or custom user configurations. The **Publish** operation enables you to configure all these properties directly in the message. ### Configure User Properties Whenever you must set a property for an outgoing message, configure the **Properties** field in the message and perform an inline declaration of a map using DataWeave: 1. In your Studio flow, select the **Publish** operation. 2. Set the **Destination** field to the queue name, for example, `${bridgeDestination}`. 3. Set the **Destination type** field to **TOPIC**. 4. Set the **Body** field to `"bridged_" ++ payload`. 5. Set the **Properties** field to the following DataWeave code: ```DataWeave { AUTH_TYPE: 'jwt', AUTH_TOKEN: attributes.queryParams.token } ``` ![In the Publish configuration screen](/mulesoft/current/en-us/jms-connector/1.10/_images/jms-publish-config-9.png) Figure 8. Publish operation Properties configuration In the XML editor, the `` and `` configurations look like this: ```xml #["bridged_" ++ payload] #[{ AUTH_TYPE: 'jwt', AUTH_TOKEN: attributes.queryParams.token }] ``` ### Configure JMSX Properties The JMS spec includes JMSX properties, a set well-known properties that contain metadata about the message. In the following example, you configure these properties in the **JMSX Properties** field of the message: 1. In your Studio flow, select the **Publish** operation. 2. Set the **Destination** field to the queue name, for example, `${bridgeDestination}`. 3. Set the **Destination type** field to **TOPIC**. 4. Set the **Body** field to `"bridged_" ++ payload`. 5. Set the **JMSX Properties** field to **Edit inline**. 6. Set the **Jmsx group id** field to `vars.currentGroup`. 7. Set the **Jmsx user id** field to `${username}`. ![In the Publish configuration screen](/mulesoft/current/en-us/jms-connector/1.10/_images/jms-publish-config-10.png) Figure 9. Publish operation JMSX Properties configuration In the XML editor, the ``, `jmsxGroupID` and `jmsxUserID` configurations look like this: ```xml #["bridged_" ++ payload] ``` ## See Also [Publish Messages and Consume Replies](https://docs.mulesoft.com/jms-connector/1.10/jms-publish-consume)