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.
Note: 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

tibemsMsgProducer_Send

tibemsMsgProducer_GetDestination