In this article

Overview

This Snap is used to acknowledge the Java Message Service (JMS) messages read by a JMS consumer used in the upstream Snap. This Snap should always be used in conjunction with JMS Consumer Snap in a Pipeline. The JMS Consumer Snap should have the Acknowledgement mode set to CLIENT_ACKNOWLEDGE and Processing mode set to Synchronous.

Acknowledgment Modes:

Client Acknowledge: When a message is read, the client acknowledges the message.
Auto Acknowledge: The messages are acknowledged automatically (by user) after the message is read.

Learn more about Message Acknowledge Modes.

Snap Type

Read

Prerequisites

None.

Support for Ultra Pipelines

Works in Ultra Tasks.

Snap Views

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input

Document

Min:1
Max:1

Mapper
Structure
JSON Generator

This Snap optionally accepts the JMS MessageID of the JMS message consumed by JMS Consumer Snap upstream.

Output

Document

Min:0
Max:1

Filter
Mapper
JSON Formatter

This Snap writes the JMS MessageID received to output view if present.

Error

Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter while running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab. The available options are:

Stop Pipeline Execution: Stops the current pipeline execution when the Snap encounters an error.
Discard Error Data and Continue: Ignores the error, discards that record, and continues with the rest of the records.
Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Learn more about Error handling in Pipelines.

Snap Settings

Field

Field Type

Description

Label

Default Value: JMS Acknowledge
Example: JMS Acknowledge

String

Specify a unique name for the Snap.

Recover message

Default Value: Deselected

Checkbox

Select this option to explicitly place a message back in the JMS queue to recover messages.

If the Snap fails to read the JMS messages for processing, you can recover those messages by selecting the Recover message checkbox so that the Snap can read the messages additional times for further processing.

Snap Execution

Default Value: Validate & Execute
Example: Execute only

Dropdown list

Select one of the three modes in which the Snap executes. Available options are:

Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.
Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.
Disabled: Disables the Snap and all Snaps that are downstream from it.

Example

A Pipeline for JMS Acknowledge may look something like this:

Configure a Mapper Snap to join upstream Snaps to JMS Acknowledge:

The sample output of the JMS Acknowledge Snap may look like this:

Snap Pack History

Click to view/expand

Release	Snap Pack Version	Date	Type	Updates
November 2024	439patches29329	16 Dec 2024	Latest	Fixed an issue with the JMS Consumer Snap that displays `ExecutionException` when the Snap captures a connection error. Now, it routes the connection error to the error view.
November 2024	main29029	13 Nov 2024	Stable	Updated and certified against the current SnapLogic Platform release.
August 2024	main27765	21 Aug 2024	Stable	Updated and certified against the current SnapLogic Platform release.
May 2024	main26341	08 May 2024	Stable	Updated and certified against the current SnapLogic Platform release.
February 2024	main25112	14 Feb 2024	Stable	Updated and certified against the current SnapLogic Platform release.
November 2023	main23721	08 Nov 2023	Stable	Updated and certified against the current SnapLogic Platform release.
August 2023	main22460	16 Aug 2023	Stable	Updated and certified against the current SnapLogic Platform release.
May 2023	main21015	10 May 2023	Stable	Upgraded with the latest SnapLogic Platform release.
February 2023	432patches20479	12 Apr 2023	Latest	Fixed an issue where the JMS Producer Snap was previously only writing headers to the WebLogic queue. Now the Snap writes the entire document.
February 2023	main19844	09 Feb 2023	Stable	Upgraded with the latest SnapLogic Platform release.
November 2022	main18944	10 Nov 2022	Stable	Upgraded with the latest SnapLogic Platform release.
August 2022	main17386	11 Aug 2022	Stable	Upgraded with the latest SnapLogic Platform release.
4.29	main15993	14 May 2022	Stable	Upgraded with the latest SnapLogic Platform release.
4.28	main14627	12 Feb 2022	Stable	Upgraded with the latest SnapLogic Platform release.
4.27	main12833	13 Nov 2021	Stable	Upgraded with the latest SnapLogic Platform release.
4.26	main11181	14 Aug 2021	Stable	Upgraded with the latest SnapLogic Platform release.
4.25	main9554	08 May 2021	Stable	Upgraded with the latest SnapLogic Platform release.
4.24 Patch	4.24patches9098	07 Apr 2021	Latest	Enhances the JMS account in the JMS Snap Pack by updating the JNDI properties (`java.naming.security.principal, java.naming.security.credentials`) with username and password, to support the requirements of certain JMS servers.
4.24 Patch	424patches9104	06 Apr 2021	Latest	Fixes an issue in the JMS Consumer Snap, where different JMS SQS accounts interfere with each other while running on the same jcc node by using the `AWSStaticCredentialProvider` instead of the `SystemPropertiesCredentialsProvider`.
4.24	main8556	13 Feb 2021	Stable	Upgraded with the latest SnapLogic Platform release.
4.23	main7430	14 Nov 2020	Stable	Upgraded with the latest SnapLogic Platform release.
4.22 Patch	422patches6992	09 Oct 2020	Latest	Fixes the JMS Snap Pack by replacing JMS class loader for Oracle AQ (Advance Queuing).
4.22	main6403	12 Sep 2020	Stable	Upgraded with the latest SnapLogic Platform release.
4.21	snapsmrc542	09 May 2020	Stable	Upgraded with the latest SnapLogic Platform release.
4.20 Patch	jms8824	06 May 2020	Latest	Fixes an issue in the JMS Consumer Snap due to which the Snap does not release the memory even after Pipeline termination, leading to huge memory spikes.
4.20 Patch	jms8810	20 Apr 2020	Latest	Fixes the connection leak issue in the JMS Producer Snap.
4.20 Patch	jms8765	18 Mar 2020	Latest	Fixes an issue with the JMS Consumer Snap that fails to successfully create durable subscribers when run in asynchronous mode.
4.20	snapsmrc535	08 Feb 2020	Stable	Upgraded with the latest SnapLogic Platform release.
4.19 Patch	jms8420	16 Dec 2019	Latest	Adds the following properties to the JMS Consumer and JMS Producer Snaps to enable retry and reconnect features: Number of retries: Defines the number of times the Snap must re-attempt an operation before throwing a connection/network error. Retry interval (milliseconds): Defines the time in milliseconds the Snap must wait between subsequent retries upon a connection/network error. Enables the JMS Producer Snap to clean up stale connections. Fixes the JMS Acknowledge Snap where the Snap fails unexpectedly without providing a reason.
4.19	snaprsmrc528	14 Nov 2019	Stable	Upgraded with the latest SnapLogic Platform release.
4.18 Patch	jms7865	01 Oct 2019	Latest	Fixed an issue with the JMS Consumer Snap that reinserts failed messages in the JMS queue without checking for duplicate messages.
4.18	snapsmrc523	10 Aug 2019	Stable	Upgraded with the latest SnapLogic Platform release.
4.17	ALL7402	11 Jun 2019	Latest	Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.
4.17	snapsmrc515	11 Jun 2019	Latest	Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box.
4.16	snapsmrc508	16 Feb 2019	Stable	Upgraded with the latest SnapLogic Platform release.
4.15	snapsmrc500	15 Dec 2018	Stable	Added HornetQ support for the JMS Producer and JMS Consumer Snaps.
4.14	snapsmrc490	11 Aug 2018	Stable	Upgraded with the latest SnapLogic Platform release.
4.13	snapsmrc486	12 May 2018	Stable	Upgraded with the latest SnapLogic Platform release.
4.12	snapsmrc480	17 Feb 2018	Stable	Upgraded with the latest SnapLogic Platform release.
4.11	snapsmrc465	11 Nov 2017	Stable	Upgraded with the latest SnapLogic Platform release.
4.10	snapsmrc414	12 Aug 2017	Stable	Upgraded with the latest SnapLogic Platform release.
4.9 Patch	jms3305	20 Jul 2017	Latest	Elegant error & resolution messaging for bad ConnectionFactory and bad connectionFactoryNames JNDI property
4.9	snapsmrc405	13 May 2017	Stable	Upgraded with the latest SnapLogic Platform release.
4.8 Patch	jms2702	13 Apr 2017	Latest	Addressed an issue with the JMS Acknowledge Snap failing to exit in Ultra mode.
4.8 Patch	jms2883	26 Feb 2017	Latest	Addressed multiple issues regarding messages being consumed or acknowledged in JMS Consumer and Acknowledge Snaps.
4.8	snapsmrc398	11 Feb 2017	Stable	Upgraded with the latest SnapLogic Platform release.
4.7	snapsmrc382	23 Nov 2016	Stable	Upgraded with the latest SnapLogic Platform release.
4.6	snapsmrc362	13 Aug 2016	Stable	Upgraded with the latest SnapLogic Platform release.
4.5.1	snapsmrc344	18 May 2016	Stable	Upgraded with the latest SnapLogic Platform release.
4.5	snapsmrc344	18 May 2016	Stable	Resolved an issue in JMS Consumer Snap that occurred when the Snap is set with the SQS account on a client_acknowledge mode. Resolved an issue in JMS Consumer Snap that occurred when the Snap was used in the middle of a pipeline.
4.4		13 Feb 2016	Stable	JMS Producer: The file header is now passed through to the output view. JMS Acknowledge: JMS MessageID is now optional for the input. JMS Consumer: Expressions are now supported for Client ID and Subscription Name.

JMS Acknowledge

Overview

Snap Type

Prerequisites

Support for Ultra Pipelines

Snap Views

Snap Settings

Example

snapsmrc486

snapsmrc480

snapsmrc414

snapsmrc398

snapsmrc382

snapsmrc344

snapsmrc344