TibrvMsg::setSendSubject()

Method

Declaration

TibrvStatus setSendSubject(const char* sendSubject);

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

sendSubject

Use this string as the new subject, replacing any existing subject.

The method copies this string to the message.

The subject NULL removes the previous subject, leaving the message unsendable.

The empty string is not a legal subject name.

See Also

TibrvMsg::getSendSubject()

Supplementary Information for Messages in TIBCO Rendezvous Concepts