CORBA API

e-docs > Tuxedo > Administering a Tuxedo Application at Run Time > CORBA API

Administering a Tuxedo Application at Run Time

PortableServer::POA::create_lifespan_policy

Synopsis

Obtains an object with the LifespanPolicy interface so the user can pass the object to the POA::create_POA operation.

C++ Binding

LifespanPolicy_ptr
       PortableServer::POA::create_lifespan_policy (
              PortableServer::LifespanPolicyPolicyValue value)

Argument

value

A value of either PortableServer::USER_ID, indicating ObjectIds are assigned only by the application, or PortableServer::SYSTEM_ID, indicating ObjectIds are assigned only by the system.

Description

Objects with the LifespanPolicy interface are obtained using the POA::create_lifespan_policy operation and passed to the POA::create_POA operation to specify the lifespan of the objects implemented in the created POA. The following values can be supplied.

TRANSIENT—the objects implemented in the POA cannot outlive the process in which they are first created. Once the POA is deactivated, use of any object references generated from it will result in an OBJECT_NOT_EXIST exception.
PERSISTENT—the objects implemented in the POA can outlive the process in which they are first created.

If no LifespanPolicy object is passed to POA::create_POA, the lifespan policy defaults to TRANSIENT.

Note: This function is supported only for a joint client/server.

Return Values

Returns a LifespanPolicy.