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

tibemsMsg_SetDestination


TIBCO Enterprise Message Service™ C and COBOL Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com