tibemsMsg_GetDestination

Function

Purpose

Get the destination header from a message.

C Declaration

tibems_status tibemsMsg_GetDestination(
    tibemsMsg message,
    tibemsDestination* value );

COBOL Call

CALL "tibemsMsg_GetDestination"
     USING BY VALUE message,
           BY REFERENCE value,
           RETURNING tibems-status
END-CALL.
Note: message and value have usage pointer.

Parameters

Parameter Description
message Get the destination from this message.
value Store the destination.

Remarks

Sending calls record the destination (queue or topic) of the message in this header (ignoring and overwriting any existing value). The value is based on either a property of the producer, or on a parameter to the send call.

Listeners that consume messages from several destinations can use this property to determine the actual destination of a message.

See Also

tibemsDestination

tibemsMsg_SetDestination