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

Note: `message` and `value` have usage pointer.

## Parameters

Parameter | Description
--- | ---
`message` | Get the destination from this message.
`value` | Store the destination.

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

`tibemsMsg_SetDestination`

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