TibrvCmTransport.destroy()

Method

Declaration

void destroy()
void destroyEx()

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.

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. In contrast, destroyEx() blocks until previously assigned tasks are complete; then it destroys the transport and returns. 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.

Restrictions

destroyEx() is available in both the JNI preferred implementation and the JNI backward compatibility implementation. It is not available in the pure Java implementation.

See Also

TibrvCmTransport()