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.