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 144
> tibemsMsg_SetDestination on page 61

Copyright © TIBCO Software Inc. All Rights Reserved