TibrvNetTransport::create()

Method

Declaration

TibrvStatus create(
    const char* service = NULL,
    const char* network = NULL,
    const char* daemon  = NULL );
TibrvStatus createLicensed(
    const char* service,
    const char* network,
    const char* daemon,
    const char* license_ticket);

Purpose

Create a transport that connects to a Rendezvous daemon.

Remarks

This method creates a C network transport and stores its handle in the C++ object.

Parameter	Description
`service`	The Rendezvous daemon divides the network into logical partitions. Each TibrvNetTransport communicates on a single service; a transport can communicate only with other transports on the same service. To communicate on more than one service, a program must create more than one transport—one transport for each service. You can specify the service in several ways. For details, see Service Parameter in TIBCO Rendezvous Concepts. `NULL` specifies the default `rendezvous` service.
`network`	Every network transport communicates with other transports over a single network interface. On computers with more than one network interface, the `network` parameter instructs the Rendezvous daemon to use a particular network for all outbound messages from this transport. To communicate over more than one network, programs must create more than one transport. You can specify the network in several ways. For details, see Network Parameter in TIBCO Rendezvous Concepts. `NULL` specifies the primary network interface for the host computer.
`daemon`	The daemon parameter instructs the transport object about how and where to find the Rendezvous daemon and establish communication. For details, see Daemon Parameter in TIBCO Rendezvous Concepts. You can specify a daemon on a remote computer. For details, see Remote Daemon in TIBCO Rendezvous Concepts. If you specify a secure daemon, this string must be identical to as the `daemonName` argument of TibrvSdContext:setDaemonCert(). See also, Secure Daemon in TIBCO Rendezvous Concepts. `null` specifies the default—find the local daemon on TCP socket `7500`. (This default is not valid when the local daemon is a secure daemon.)
`licenseTicket`	License tickets are no longer required. Values for this parameter are ignored.

Connecting to the Rendezvous Daemon

Rendezvous daemon processes do the work of moving messages across a network. Every TibrvNetTransport must connect to a Rendezvous daemon.

If a Rendezvous daemon process with a corresponding daemon parameter is already running, the transport connects to it.

If an appropriate Rendezvous local daemon is not running, the transport tries to start it. However, the transport does not attempt to start a remote daemon when none is running.

If the transport cannot connect to the Rendezvous daemon, it returns the status code TIBRV_DAEMON_NOT_CONNECTED, and does not create a C transport object.

Description String