# tibemsMsg_GetReplyTo

Function

## Purpose

Get the reply-to header from a message.

## C Declaration

    tibems_status tibemsMsg_GetReplyTo(
        tibemsMsg message,
        tibemsDestination* value );

## COBOL Call

    CALL "tibemsMsg_GetReplyTo"
         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 reply-to header from this message.
`value` | Store the reply-to header.

## Remarks

Sending clients can set this header to request that recipients reply to the message:

- When the value is a destination object, recipients can send replies to that destination. Such a message is called a request.
- When the value is null, the sender does not expect a reply.

When sending a reply, clients can refer to the corresponding request by setting the correlation ID field.

## See Also

`tibemsMsg_SetCorrelationID`

`tibemsMsg_SetReplyTo`

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