Open topic with navigation

TIBCO BusinessEvents® Enterprise Edition 6.3.1

# Transaction Error Handler Rule Function

You can create a transaction error handler Callback rule function that enables you to identify which post RTC transactions failed or which events were not sent out during the post RTC phase. The transaction error handler rule function is invoked each time a database transaction exception occurs, and each time a send event exception occurs.

The behavior of the transaction error handler is governed by running the rule function in a separate thread. The rule function is run in the separate thread in the following conditions:

1. The `Agent.agentclassname.enableParallelOps` property is set `true`. See TIBCO BusinessEvents Configuration Guide.
2. The `Agent.agentclassname.enableParallelOps` property is set `false` but the Concurrent RTC settings are enabled. See TIBCO BusinessEvents Configuration Guide.

The error handler rule function provides full details of the failed transactions. The transaction details provided in this Callback function can be used for audit trail purposes. The engine continues to retry the transaction or action as usual.

## To Register the Rule Function

To register the rule function, add the following property to the be-engine.tra / project CDD file at an appropriate level (for example, at the cluster level to affect all deployed engines). Set the value to the project path of the error handler rule function:

    be.engine.txn.error.function=projectPathToErrorHandlerRuleFunction

## Rule Function Signature

The required signature for the error handler rule function is:

    int Name (Object txns, int errorType, int errCode, String errMsg, long retryCount)

The return value must be 0 (zero).

The arguments are explained in Transaction Error Handler Rule Function Reference.

Subtopics

Did you find this helpful?

YesNo
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO BusinessEvents® Enterprise Edition

Copyright © 2004-2024. Cloud Software Group, Inc. All Rights Reserved.