TibrvTransport::createInbox()

Method

Declaration

TibrvStatus createInbox(
    char* subjectString,
    tibrv_u32 subjectLimit) const;

Purpose

Create a unique inbox subject name.

Remarks

This method 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 method 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 TibrvListener::create(). The inbox name is only valid for use with the same transport that created it. When calling TibrvListener::create(), 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.

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.

This inherited method is disabled for TibrvCmQueueTransport objects.

Warning

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

Parameter	Description
subjectString	The program supplies a string buffer, and the method 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

TibrvMsg::setReplySubject()