tibemsMsgConsumer_ReceiveNoWait


Function

Purpose

Receive a message (synchronous, non-blocking).

C Declaration

tibems_status tibemsMsgConsumer_ReceiveNoWait( 
    tibemsMsgConsumer msgConsumer, 
    tibemsMsg* message); 

COBOL Call

CALL "tibemsMsgConsumer_ReceiveNoWait" 
     USING BY VALUE msgConsumer, 
           BY REFERENCE message, 
           RETURNING tibems-status 
END-CALL. 

msgConsumer and message have usage pointer.

Parameter
Description
msgConsumer
Receive a message through this consumer.
msg
The function stores a pointer to the inbound message in this location.

Remarks

When the destination has at least one message ready, this function immediately returns the next message.

When the destination does not have any messages ready, this function immediately returns TIBEMS_NOT_FOUND.

When calling receiving within a transaction, the consumer retains the message until transaction commits.


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