Data Transformation Engine Services Guide

Chapter 20 – Adapter Return Codes
115
Chapter 20 – Adapter Return
Codes
Adapter return codes should be one of the following:
♦ 0 Success
♦ Negative Error
♦ Positive Warning
Errors should be returned when some severe problem has occurred (such as invalid
command, inability to connect to resource, error returned from the resource’s API).
Warnings should be returned when there was no failure condition in the code but
something occurred that might be undesirable. By returning a warning, the adapter is
giving the user an option to determine whether this should result in map failure or not; for
any card the user can specify ‘Fail on Adapter Warning’.
Examples of warnings from input cards are:
♦ “No messages were found” – if no messages meet the criteria in the timeout period.
♦ “One or more messages were removed from the queue but not processed”
Examples of warnings from output cards are:
♦ “No message was sent” – if there was no data and Create was specified.