ORB::shutdown

Overview The shutdown() method is used to instruct the ORB to shut down, that is, to stop processing in preparation for destruction.
Original class CORBA::ORB
Exceptions CORBA::SystemException
 


Intended Usage

This method is called by a server application to indicate to the ORB that it should shut down and cease processing, after it has finished servicing all outstanding requests. While the ORB is shutting down, it operates as normal, servicing outstanding requests until all requests have been completed. After the ORB has shut down, only object reference management operations (duplicate(), release(), and is_nil()) can be invoked on the ORB. Most other operations result in a BAD_INV_ORDER system exception with OMG minor code 4.

Syntax

void shutdown ( CORBA::Boolean wait_for_completion );

Input parameters

wait_for_completion
If TRUE, the shutdown() method blocks until the ORB has finished processing all outstanding requests and has completed its shutdown. If FALSE, the shutdown() method returns immediately.

Example

#include <corba.h>

// Assume "op" points to the ORB object.

...

// Time to shut down the ORB.
// Note: we'll block until all processing has stopped.
op->shutdown ( TRUE );

Related reference
CORBA module



Searchable topic ID:   rcor_modo32a
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/corba/ref/rcor_modo32a.html

Library | Support | Terms of Use | Feedback