Connection.Close


Method

Declaration

virtual void Close(); 

Purpose

Close the connection; reclaim resources.

Remarks

Closing the connection is sufficient to reclaim all of its resources; you need not separately close the sessions, producers, and consumers associated with the connection.

Closing a connection deletes all temporary destinations associated with the connection.

Blocking

If any message listener or receive call associated with the connection is processing a message when the program calls this method, all facilities of the connection and its sessions remain available to those listeners until they return. In the meantime, this method blocks until that processing completes—that is, until all message listeners and receive calls have returned.

Acknowledge

Closing a connection does not force acknowledgment in client-acknowledged sessions. When the program still has a message that it received from a connection that has since closed, its Message.Acknowledge method throws IllegalStateException.

Transactions

Closing a connection rolls back all open transactions in all sessions associated with the connection.

See Also

Message.Acknowledge

MessageConsumer

MessageProducer

Destination

Session

IMessageListener

IllegalStateException


TIBCO Enterprise Message Service™ .NET Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com