tibrvTransport_CreateInbox()

Function

Declaration

tibrv_status tibrvTransport_CreateInbox(
    tibrvTransport       transport,
    char*                subjectString,
    tibrv_u32            subjectLimit);

Purpose

Create a unique inbox subject name.

Warning 

This function is the only legal way for programs to create inbox subject names.

Remarks

This function creates inbox names that are unique throughout the transport scope.

For network transports, inbox subject names are unique across all processes within the local router domain—that is, anywhere that direct multicast contact is possible. The inbox name is not necessarily unique outside of the local router domain.
For the intra-process transport, inbox names are unique across all threads of the process.

This function creates only the unique name for an inbox; it does not begin listening for messages on that subject name. To begin listening, pass the inbox name as the subject argument to tibrvEvent_CreateListener(). The inbox name is only valid for use with the same transport that created it. When calling tibrvEvent_CreateListener(), you must pass the same transport object that created the inbox subject name.

Remember that other programs have no information about an inbox subject name until the listening program uses it as a reply subject in an outbound message.

Programs can overwrite or free the subjectString storage at any time.

Use inbox subject names for delivery to a specific destination. In the context of a network transport, an inbox destination specifies unicast (point-to-point) delivery.

Rendezvous routing daemons (rvrd) translate inbox subject names that appear as the send subject or reply subject of a message. They do not translate inbox subject names within the data fields of a message.

Parameter

Description

transport

Create an inbox on this transport.

subjectString

The program supplies a string buffer, and the function stores the new inbox subject string in that buffer.

subjectLimit

The number of bytes that the program has allocated to receive the new inbox subject string.

See Also

tibrvEvent_CreateListener()