Copyright © TIBCO Software Inc. All Rights Reserved

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.

 

message and value have usage pointer.

Parameters

 

Parameter	Description
message	Get the destination from this message.
value	The function stores the destination in this location.

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 on page 146

tibemsMsg_SetDestination on page 63

Copyright © TIBCO Software Inc. All Rights Reserved