3.7.3.6.3 Arguments

interfaceName

Specifies a character string that contains the fully qualified interface name for the object.

The interface name can be retrieved by making a call on the following interface typecode ID function: const char* _tc_<CORBA interface name>::id();

where <CORBA interface name> is any object class name. For example:

char* idlname = _tc_Simple->id();

stroid

Specifies the ObjectId in string format. The ObjectId uniquely identifies this instance of the class. It is up to the programmer to decide what information to place in the ObjectId. One possibility would be to use the ObjectId to hold a database key. Choosing the value of an object identifier, and the degree of uniqueness, is part of the application design. The Oracle Tuxedo software cannot guarantee any uniqueness in object references, since object references may be legitimately copied and shared outside the Oracle Tuxedo domain (for example, by passing the object reference as a string). It is strongly recommended the you choose a unique ObjectId in order to allow parallel execution of invokes on object references.

Note:

The restriction on the length of the ObjectId has been removed in this release.

criteria

Specifies a list of named values that can be used to provide factory-based routing for the object reference. The list is optional and is of type CORBA::NVList. The use of factory-based routing is optional and is dependent on the use of this argument. If you do not want to use factory-based routing, you can pass a value of 0 (zero) for this argument.

The Oracle Tuxedo system administrator configures factory-based routing by specifying routing rules in the UBBCONFIG file. See Oracle® Tuxedo Application Configuration Guide online document for details on this facility.