remove_xact

Decrements the count of sites still active in the distributed transaction.

Syntax

RETCODE remove_xact (
PDBPROCESS connect,
DBINT commid,
INT n );

where

connect

Is the DBPROCESS structure used to communicate with the commit service.

commid

Is the number used by the commit service to identify the transaction.

n

Is the number of sites to remove from the transaction.

Returns

SUCCEED or FAIL.

Remarks

The commit service records the number of sites participating in a distributed transaction. The remove_xact function informs the commit service that one or more sites has committed or canceled the transaction locally and therefore is no longer participating. The commit service removes the sites from the transaction by decrementing the count of sites. The transaction record is deleted entirely if the count drops to zero.

See Also

abort_xact, commit_xact, scan_xact, start_xact, stat_xact