# 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`

Copyright © Cloud Software Group, Inc. All rights reserved.