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 Jakarta Messaging 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.