tibemsMsg_GetMessageID


Function

Purpose

Get the message ID header from a message.

C Declaration

tibems_status tibemsMsg_GetMessageID( 
    tibemsMsg message, 
    const char** value ); 

COBOL Call

CALL "tibemsMsg_GetMessageID" 
     USING BY VALUE message, 
           BY REFERENCE value, 
           RETURNING tibems-status 
END-CALL. 

message and value have usage pointer.

Parameters

Parameter
Description
message
Get the message ID from this message.
value
The function stores the message ID in this location.

Remarks

Sending calls assign a unique ID to each message, and record it in this header.

All message ID values start with the 3-character prefix ID: (which is reserved for this purpose).

Applications that do not require message IDs can reduce overhead costs by disabling IDs; see tibemsMsgProducer_SetDisableMessageID . When the producer disables IDs, the value of this header is null.

See Also

tibemsMsg_GetCorrelationID

tibemsMsg_SetMessageID

tibemsMsgProducer_SetDisableMessageID


TIBCO Enterprise Message Service™ C and COBOL Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com