tibemsMsg_SetDestination


Function

Purpose

Set the destination header of a message.

C Declaration

tibems_status tibemsMsg_SetDestination( 
    tibemsMsg message, 
    tibemsDestination value ); 

COBOL Call

CALL "tibemsMsg_SetDestination" 
     USING BY VALUE message, 
           BY VALUE value, 
           RETURNING tibems-status 
END-CALL. 

message and value have usage pointer.

Parameters

Parameter
Description
message
Set the destination of this message.
value
Set the destination to this value.

Remarks

Sending calls set the delivery mode header automatically. The JMS specification defines this call for symmetry.

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.

See Also

tibemsDestination

tibemsMsg_GetDestination

tibemsQueueSender_GetQueue

tibemsTopicPublisher_GetTopic


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