XML Transaction Error Codes

Exception handling should be provided for HostApplicationError and TransactionErrorCode. TransactionErrorCode can be returned in any XML Select transaction. TransactionErrorCode is returned in the following situations:

• A request was not sent successfully.

• A response was not received successfully.

• The Host returned an error code in the response headers.

The following are some errors returned when using an XML transaction. Some errors occur due to user error and other errors are returned by the host.

Request Errors

XMLTRANS_E_FilterXmlIsMalformed: "Invalid Filter: Malformed XML"

XMLTRANS_E_RequestXmlIsMalformed: "Invalid Request: Request XML is Malformed"

MLTRANS_E_UntranslatableFilterTags: "Invalid Filter: Untranslatable Tags"

XMLTRANS_E_NoProcedureSpecifiedInRequestXml: "Invalid Request: No Procedure Specified in request XML"

XMLTRANS_E_CantLoadDefinitionLibraryForProcedure: "Request cannot be translated: definition library not found"

XMLTRANS_E_CantFindDefinitionForNwbInRequest: "Invalid Request: Cannot find definition for NWB"

XMLTRANS_E_CantFindDefinitionForKlrInRequest: "Invalid Request: Cannot find definition for KLR"

XMLTRANS_E_CantFindDefinitionForDataRecordInRequest: "Invalid Request: Cannot Find Definition for Data Record in Request"

XMLTRANS_E_RequestKlrIsNotMappedToDataRecord: "Invalid Request: Request KLR is not mapped to data record"

XMLTRANS_E_InvalidKlrHeaderDelimiterValueInRequestData: "Invalid Request: Invalid KLR Header Delimiter Value in request data"

XMLTRANS_E_InvalidKlrHeaderLevelValueInRequestData: "Invalid Request: Invalid KLR Header Level Value In Request Data"

XMLTRANS_E_UntranslatableRequestTags: "Invalid Request: Untranslatable Request Tags"

Response Errors

XMLTRANS_E_OutOfDataInKlrHeader: "Error parsing Response: Out Of Data In Klr Header"

XMLTRANS_E_OutOfData: "Error parsing Response: Out Of Data"

XMLTRANS_E_CannotFindNumericControllingField: "Error translating XML: Cannot Find Numeric Controlling Field"

XMLTRANS_E_CantFindStringControllingField: "Error translating XML: Cannot Find String Controlling Field"

XMLTRANS_E_DataIsTooLongForField: "Error translating XML: Data is too long for field"

XMLTRANS_E_DataGrowsBlockLargerThanSpecifierCanAcommodate: "Error translating XML: Data grows block larger than specifier can accomodate"

XMLTRANS_E_DataExceedsMaxValueOfNumericSpecifier: "Error translating XML: Data exceeds max value of numeric specifier"

XMLTRANS_E_TimedOutWaitingForMutex: "Error parsing Response: Timed out waiting for mutex"

XMLTRANS_E_UnsupportedDefinitionLibraryFormat: "Error translating XML: Unsupported definition library format"

XMLTRANS_E_InvalidDataInKlrHeader: "Error parsing Response: Invalid data in KLR Header"

Miscellaneous Errors

When the following error, report it to API support:
RPC_E_SERVERFAULT: "XML Select has thrown an uncaught C++ exception"

This error usually means that there are no GTIDs available, but sometimes this error occurs when there is no problem.
E_FAIL: "XML Select operation failed, this could mean there are no GTIDs available to complete the request"