Joint Client/Servers

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

Administering a Tuxedo Application at Run Time

start_persistent_userid

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_persistent_userid(
              portableServer::Servant     a_servant,
              in CORBA::RepositoryId      rep_id,
              in string                   stroid) 
    raises ( ServantAlreadyActive, ObjectAlreadyActive );

C++ Binding

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

Java Binding

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

Arguments

servant

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

rep_id

The repository ID of the interface.

stroid

The stringified version of an ObjectId provided by the user to be set in the object reference being created. The stroid holds application-specific data and is opaque to the ORB.

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.

ObjectAlreadyActive

The stringified ObjectId is already being used for a callback. A given ObjectId can have only one servant associated with it. If you wish to change to a different servant, you must first invoke stop_object with the servant currently in use.