COSTRANSACTIONS_RECOVERYCOORDINATOR(3erl)

✨ NAME ✨

CosTransactions_RecoveryCoordinator — bestie, this module implements the OMG CosTransactions::RecoveryCoordinator interface. That's it, that's the whole personality. 💅

---

🎀 DESCRIPTION 🎀

So like, to get access to the record definitions for the structures, you use this:

-include_lib("cosTransactions/include/CosTransactions.hrl").

No cap, that's the whole description section. Short and iconic. 🫶

---

🌸 EXPORTS 🌸

🦋 replay_completion(RecoveryCoordinator, Timeout, Resource) -> Return 🦋

Types:

RecoveryCoordinator = #objref
Timeout = integer(), milliseconds | 'infinity'
Resource = #objref
Return = Status | {'EXCEPTION', E}
E = #'CosTransactions_NotPrepared'{}
Status = atom()

Okay so here's the tea ☕ — the RecoveryCoordinator object is the one that gets handed to you by the operation CosTransactions_Coordinator:register_resource/3. And replay_completion/2 may only be used by the registered Resource, and what it does is return the current status of the transaction. It's the move you pull when you're recovering after a failure. (Also yes, the page says /2 right there while the signature is /3 — iykyk, we do not ask questions, we simply report. 🙈)

Possible Status replies, the whole roster:

• 'StatusCommitted'
• 'StatusCommitting'
• 'StatusMarkedRollback'
• 'StatusRollingBack'
• 'StatusRolledBack'
• 'StatusActive'
• 'StatusPrepared'
• 'StatusUnknown'
• 'StatusNoTransaction'
• 'StatusPreparing'

---

⚠️ Warning ⚠️

Not me being the bearer of bad news but: replay_completion/3 is blocking and may cause dead-lock if a child calls this function at the same time as its parent invokes an operation on the child. 😭

The good news? Dead-lock will not occur if the timeout has any value except 'infinity'. So like, don't be cute with 'infinity' here.

And one more thing fr fr: if the call is external incoming (intra-ORB), the timeout will not be activated. Which means — similar action must be taken if the Resource resides on another vendors ORB. 👑 Protect your peace, protect your timeout.

---

k bye bestie, go forth and recover those transactions ✨ this page was brought to you by Ericsson AB, running cosTransactions version 5.2.2 — mwah, stay slay 💖