TibrvCmTransport::destroy()

Method

Declaration

TibrvStatus destroy();
TibrvStatus destroyEx(
    TibrvCmTransportOnComplete* completeCB = NULL);

Purpose

Destroy a certified delivery transport.

Remarks

Destroying a certified delivery transport with a file-based ledger always leaves the ledger file intact; it neither erases nor removes a ledger file.

Parameter

Description

completeCB

Rendezvous software runs this completion callback immediately after all queued tasks are complete.

Do not destroy the transport’s listeners until after this callback signals that cleanup has completed.

See TibrvCmTransportOnComplete::onComplete.

Distributed Queue

To destroy a distributed queue transport, call destroyEx(). With the ordinary destroy call, the distributed queue can lose reliable (non-certified) task messages before they are processed. The distributed queue needs the listeners, queues and dispatchers (associated with the transport) to remain operational—programs must wait until after the transport has been completely destroyed before destroying these associated objects.

See Also

TibrvCmTransport::create()

TibrvCmTransportOnComplete