OpenTTCN/2.56.0/ANSI C SDK library reference/ISL/otResolveInitialReferences

From OpenTTCN

otResolveInitialReferences

The otResolveInitialReferences function performs basic initialization actions upon startup of a pluggable adapter component, such as TRI SUT adapter, TRI platform adapter, or TCI test management entity (TCI-TM).

int otResolveInitialReferences(
    const char* id,
    const char** args);

Parameters

id		A reference or a set of references to be resolved by this method (see Remarks for more details).
args		A NULL-terminated array of C strings used to specify resolution parameters. Its content depends on the id parameter value.

Return values

Returns 0 upon success, non-zero upon failure. Possible return error codes are listed below.

Error code	Error value
OT_RESOLVE_ERROR_INVALID_ARGS_PARAM	1
OT_RESOLVE_ERROR_NAMING_SERVICE_UNAVAILABLE	2
OT_RESOLVE_ERROR_NS_ROOT_CTX_UNAVAILABLE	3
OT_RESOLVE_ERROR_SMGR_UNAVAILABLE	4
OT_RESOLVE_ERROR_OTD_UNAVAILABLE	5
OT_RESOLVE_ERROR_UNRECOGNIZED_ID_PARAM	6
OT_RESOLVE_ERROR_ORB_INIT_FAILED	7

Remarks

The "ORB" value of the id parameter performs basic CORBA initialization.

The "RootManager" value of the id parameter is used to resolve a set of references associated with OpenTTCN Tester Runtime Environment (OTRE) services. Note that "RootManager" can be successfully resolved only if you have started OpenTTCN Tester services before. Typically this is done by launching the ot binary from the OpenTTCN Tester distribution. Please consult OpenTTCN Tester manual for more details.

For "ORB", the args parameter shall refer to an empty array or be 0. If it refers to a non-empty array, elements of this array are interpreted as additional ORB-specific initialization parameters. For example, the following specifies startup address of the local client (for MICO ORB, currently not in use):

{ "-ORBIIOPAddr", "inet:127.0.0.1:4343", NULL } 

The above string sets local adapter IP address and port, what can be useful in case of multihomed hosts and multiple network interfaces. This has no relevance to OpenTTCN server address whatsoever.

Note that MICO also allows -ORBIIOPAddr inet::<port> address format (without a host name), to listen on all interfaces.

Another useful ORB-specific initialization string is:

{ "-ORBDebug", "All", NULL }

The above string enables additional ORB debug info printed to the standard output at adapter runtime.

Several parameter pairs can be combined in one initialization string.

For "RootManager", the first element of the args array shall contain IP address of the host where OTRE service is running (typically "127.0.0.1") and the second element shall contain port number of the OTRE running instance (typically "5500").

Requirements

Header	<isl/TTCN3.h>
Library	openttcn-isl-mt.lib
Compatibility	OpenTTCN ANSI C SDK 2.x and higher