Resource manager failures

When a resource manager fails, the effect of the failure on each UR it has expressed interest in is determined by several factors: the state of the UR, the failure action specified by the resource manager when it expressed interest, and, sometimes, whether the interest is protected or unprotected. Table 1 lists the possible UR states and the effect a resource manager failure would have on the UR.

If multiple resource managers fail, or if a failing resource manager has multiple interests in a UR, Table 1 might show different actions for the same UR. In that case, the action for a protected interest overrides the actions for an unprotected interest.

Table 1. UR States and Failure Actions
UR state at time of failure	Action
In-reset	If the failure action specified for the UR is standard, RRS performs backout processing for the UR when commit is requested. If the failure action is forget, RRS takes no action.
In-flight	If the failure action specified for the UR is standard, RRS performs backout processing for the UR. If the failure action is forget, RRS takes no action.
In-state-check	If the failure action specified for the UR is standard, RRS performs backout processing for the UR and returns RR_BACKED_OUT_OUTCOME_PENDING to the application. If the failure action is forget, RRS continues as if the resource manager was not associated with the UR. Note that a forget failure action is only valid for unprotected interests.
In-prepare	If the failure action specified for the UR is standard, RRS performs backout processing for the UR and returns RR_BACKED_OUT_OUTCOME_PENDING to the application. If the failure action is forget, RRS continues as if the resource manager was not associated with the UR. Note that a forget failure action is only valid for unprotected interests.
In-doubt	When the UR state is resolved, RRS performs commit or backout processing.
In-commit	RRS returns RR_COMMITTED_OUTCOME_PENDING to the application. For an unprotected interest, RRS returns RR_OK.
In-backout	RRS returns RR_BACKED_OUT_OUTCOME_PENDING to the application. If the failing resource manager had an unprotected interest, RRS returns RR_BACKED_OUT.
In-end, in-completion, or in-forget with a commit collective vote	RRS returns RR_COMMITTED_OUTCOME_PENDING to the application. If the failing resource manager had an unprotected interest, RRS returns RR_OK.
In-end, in-completion, or in-forget with a backout collective vote	RRS returns RR_BACKED_OUT_OUTCOME_PENDING to the application. If the failing resource manager had an unprotected interest, RRS returns RR_BACKED_OUT.
In-only-agent	RRS returns RR_BACKED_OUT_OUTCOME_PENDING to the application. If the failing resource manager had an unprotected interest, RRS returns RR_BACKED_OUT.