tibemsMsgConsumer_ReceiveTimeout


Function

Purpose

Receive a message (synchronous, limited blocking).

C Declaration

tibems_status tibemsMsgConsumer_ReceiveTimeout( 
    tibemsMsgConsumer msgConsumer, 
    tibemsMsg* message, 
    tibems_long timeout ); 

COBOL Call

CALL "tibemsMsgConsumer_ReceiveTimeout" 
     USING BY VALUE msgConsumer, 
           BY REFERENCE message, 
           BY VALUE timeout, 
           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.
timeout
When present, wait no longer than this interval (in milliseconds) for a message to arrive. Zero is a special value, which specifies no timeout (block indefinitely).

Remarks

Remarks

This function consumes the next message from the consumer’s destination.

When the destination does not have any messages ready, this function blocks:

When calling receive 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