Data Transformation Engine IBM WebSphere MQ Adapter Reference Guide

Chapter 2 - Command Aliases GET > Source Settings
IBM WebSphere MQ Adapter Reference Guide
11
Source > Transaction > OnFailure Setting
Use the OnFailure setting with adapter sources to select the rollback or commit
behavior if the map does not successfully complete. The default value is Rollback.
Value Description
Rollback If the map does not complete successfully, sources retrieved
through the messaging adapter are not deleted.
Commit The adapter behaves as if the map was successful and the action
specified by the OnSuccess setting is taken.
For example, if the Source > Transaction > OnSuccess setting is Delete and
the Source > Transaction > OnFailure setting is Rollback and the map
succeeds, the messages processed on the input queue are deleted. If the map
fails, the messages are rolled back and left on the input queue.
However, if the Source > Transaction > OnSuccess setting is Delete and
Source > Transaction > OnFailure setting is Commit, there is no IBM
WebSphere MQ transaction syncpoint control activation. The message remains
deleted, regardless of whether the map is completed. The point is that if the
Source > Transaction > OnFailure setting is not Rollback, a message can be
deleted even if a map fails.
Source > Transaction > Scope Setting
Use the Scope setting to specify when to check for success (OnSuccess) or
failure (OnFailure) at the completion of the processing of either a map, burst, or
card. This is so that the rollback and retry actions can be performed as specified.
The default value is Map.
Value Description
Map Check for success or failure at the completion of each map. If the map
successfully completes, use the OnSuccess setting. If the map fails,
use the OnFailure setting.
Burst Check for success or failure at the completion of each burst. If the
burst is successful, use the OnSuccess setting. If the burst fails, use
the OnFailure setting.