Joint Client/Servers

e-docs > Tuxedo > Administering a Tuxedo Application at Run Time > Joint Client/Servers

Administering a Tuxedo Application at Run Time

start_transient

Synopsis

Activates an object, sets the ORB and the POA to the proper state, and returns an object reference to the activated object.

IDL

Object start_transient( in PortableServer::Servant   servant, 
                        in CORBA::RepositoryId       rep_id) 
          raises ( ServantAlreadyActive );

C++ Binding

CORBA::Object_ptr start_transient( 
                    PortableServer::Servant         servant, 
                    const char*                     rep_id);

Java Binding

org.omg.CORBA.Object start_transient( 
                    org.omg.PortableServer.Servant  servant, 
                    java.lang.String                rep_id);

Arguments

servant

An instance of the C++ implementation class for the interface.

rep_id

The repository id of the interface.

Exceptions

ServantAlreadyActive

The servant is already being used for a callback. A servant can be used only for a callback with a single ObjectId. To receive callbacks on objects containing different ObjectIds, you must create different servants and activate them separately. The same servant can be reused only if a stop_object operation tells the system to stop using the servant for its original ObjectId.

CORBA::BAD_PARAM

The repository ID was a NULL string or the servant was a NULL pointer.

Description

This operation performs the following actions: