Oninit
Talk to an expert →

Informix Error -32001: The rollback was caused by a communication failure.

Cause and resolution

The rollback was caused by a communication failure.

This error is same as XA_RBCOMMFAIL in the X/OPEN XA Specification Standard. For more information, refer to the "Distributed Transaction Processing: The XA Specification".

According to the X/OPEN XA Specification Standard :

A communication failure occurred within the Resource Manager.

In the xa_commit context, the Resource Manager did not commit the work done on behalf of the transaction branch. Upon return, the Resource Manager has rolled back the branch's work and has released all held resources. This value can be returned only if TMONEPHASE is set in flags.

In the xa_end context, the Resource Manager has dissociated the transaction branch from the thread of control and has marked rollback-only the work performed on behalf of *xid.

In the xa_prepare context, the Resource Manager did not prepare to commit the work done on behalf of the transaction branch. Upon return, the Resource Manager has rolled back the branch's work and has released all held resources.

In the xa_rollback context, the Resource Manager has rolled back the transaction branch's work and has released all held resources. These values are typically returned when the branch was already marked rollback-only.

In the xa_start context, the Resource Manager has not associated the transaction branch with the thread of control and has marked *xid rollback-only.

Also refer to the Resource Manager guide for more details.

Oninit® Troubleshooting Guidance

Reasons / Common Causes

-32001 is the Informix representation of XA_RBCOMMFAIL from the X/Open XA Specification — per the official guidance, a communication failure occurred within the Resource Manager.

  1. xa_commit: the Resource Manager didn't commit the branch's work due to a communication failure, per the official guidance — only returnable when TMONEPHASE is set.
  2. xa_end: the Resource Manager dissociated the branch and marked it rollback-only, per the official guidance.
  3. xa_prepare: the Resource Manager didn't prepare to commit, due to the communication failure, per the official guidance.
Solutions / Resolution
  1. Check network/communication connectivity to the Resource Manager, per the official guidance's implication.
  2. Retry the global transaction once connectivity is restored.
Examples
N/A

No specific triggering statement is documented — this is a Resource-Manager-side XA return code.

Diagnostic Checks
  1. Check the network path and Resource Manager availability around the time of the failure.
Related Errors / Related Topics
  • -32000 — "The rollback was caused by an unspecified reason." Same XA rollback-reason family (XA_RBROLLBACK), for an unspecified rather than communication-related reason.
  • -32002 — "The rollback was caused by a deadlock was detected." Same family (XA_RBDEADLOCK).

An XA transaction branch was rolled back due to a communication failure (XA_RBCOMMFAIL) — check connectivity to the Resource Manager and retry.