tibrvMsg_SetSendSubject()

Function

Declaration

tibrv_status tibrvMsg_SetSendSubject(
    tibrvMsg        message,
    const char*     subject);

Purpose

Set the subject for a message.

Remarks

The subject of a message can describe its content, as well as its destination set.

Rendezvous routing daemons modify subjects and reply subjects to enable transparent point-to-point communication across network boundaries. This modification does not apply to subject names stored in message data fields; we discourage storing point-to-point subject names in data fields.

Parameter

Description

message

Set the subject of this message.

subject

Use this string as the new subject.

The function copies this string to the message.

The empty string is not a legal subject name.

Subject Name Length

The constant TIBRV_SUBJECT_MAX determines the longest possible subject name.

See Also

tibrvMsg_GetSendSubject()

Supplementary Information for Messages in TIBCO Rendezvous Concepts