Data Transformation Engine IBM WebSphere MQ Adapter Reference Guide

Chapter 3 - IBM WebSphere MQ Commands MQSeries AdapterSource Settings
IBM WebSphere MQ Adapter Reference Guide
22
message is rolled back, and is left on the input queue. If Rollback is set and the
map succeeds, the transaction is committed.
If Rollback is not set, there is no MQSeries transaction syncpoint control
activation. The message remains deleted, regardless of the completion status of
the map.
AdapterSource > OnFailure
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 AdapterSource > OnSuccess is set to Delete, AdapterSource
> OnFailure is set to 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 AdapterSource > OnSuccess is set to Delete, and AdapterSource
> OnFailure is set to Commit, there is no MQSeries transaction syncpoint control
activation. The message remains deleted, regardless of whether the map is
completed. The point is that if AdapterSource > OnFailure is not set for
Rollback, a message can be deleted even if a map fails.
AdapterSource > AdapterRetry
Use the AdapterRetry settings to specify the adapter response to a failure to
establish a connection to a queue manager or queue. AdapterRetry settings
include Switch, MaxAttempts, and Interval(Secs).
If adapter errors occur (for example, failure to attach to a queue) and retry is
specified (Switch is set to ON), the adapter process is retried at the interval
specified in Interval(Secs) up to as many times as requested in the
MaxAttempts value.