[Enterprise Extensions only]

BOA::impl_is_ready

Overview Initializes an application as a server, allows it to accept incoming request messages, and registers it with the somorbd daemon
Original class CORBA module: BOA Class
Exceptions CORBA::SystemException


Intended Usage

This method is intended to be used by all server applications, to initialize themselves. A server application cannot receive remote requests and cannot export objects (for instance, using CORBA::ORB::object_to_string or CORBA::BOA::create) without first calling CORBA::BOA::impl_is_ready. This method initializes the server's communications resources so that it can accept incoming request messages, and (optionally) registers the server with the somorbd daemon so that client applications can locate it via the daemon.

After a server has called CORBA::BOA::impl_is_ready, it should call CORBA::BOA::deactivate_impl before termination (either normal or abnormal), to inform the somorbd daemon that it is no longer active.

This method is part of the CORBA specification.

IDL Syntax

  virtual void impl_is_ready(CORBA::ImplementationDef_ptr impldef,
                             CORBA::Boolean registration = 1);

Parameters

impldef
The ImplementationDef, obtained from the Implementation Repository, that describes the server. The ImplementationDef is typically obtained using the CORBA::ImplRepository find_impldef or find_impldef_by_alias method. On-the-fly servers that are not registered in the Implementation Repository can create ImplementationDef objects using operator new.
registration
The default value (1) indicates that the server should register itself with the somorbd daemon. A zero value indicates that the server should not register itself with the somorbd daemon; this should only be done for lightweight servers of transient objects. This parameter is an IBM extension to the CORBA specification.

Example

See example in CORBA::ORB::BOA_init.