ImplRepository::find_impldef_by_alias

Overview Retrieves an ImplementationDef from the Implementation Repository, by server alias.
Original class CORBA::ImplRepository
Exceptions CORBA::SystemException


Intended Usage

This method is used to retrieve an ImplementationDef object from the Implementation Repository, using the server alias as a key. This method (or the find_impldef method) is intended to be used by a server application to retrieve its own ImplementationDef object from the Implementation Repository; a server application then passes this ImplementationDef object to the BOA::impl_is_ready and BOA::deactivate_impl methods.

A CORBA::SystemException is thrown if the Implementation Repository cannot be accessed (for instance, due to a configuration error), if the input server alias is NULL, or if the specified server alias cannot be found in the Implementation Repository.

Note: This is an IBM-defined operation, which extends the CORBA 2.1 specifications provided by the OMG.

Syntax

  CORBA::ImplementationDef* find_impldef(const char * ImplAlias);

Input parameters

ImplAlias
The server alias of the ImplementationDef to be retrieved. A CORBA::SystemException will be thrown if this string is NULL.

Return values

CORBA::ImplementationDef*
The CORBA::ImplementationDef from the Implementation Repository whose alias matches the input. The caller assumes ownership of this object and must subsequently delete it. (If passed to BOA::impl_is_ready, however, the ImplementationDef object should not be deleted until after BOA::deactivate_impl has subsequently been called and the server has quiesced, to insure that the BOA does not subsequently refer to that object.) Each call to find_impldef_by_alias returns a different ImplementationDef object ( although the different objects will be equivalent for equivalent input to find_impldef_by_alias).

Related reference
CORBA module



Searchable topic ID:   rcor_modir2
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_modir2.html

Library | Support | Terms of Use | Feedback