tibemsMsgConsumer_Close


Function

Purpose

Stop receiving messages; reclaim resources.

C Declaration

tibems_status tibemsMsgConsumer_Close( 
    tibemsMsgConsumer msgConsumer ); 

COBOL Call

CALL "tibemsMsgConsumer_Close" 
     USING BY VALUE msgConsumer, 
           RETURNING tibems-status 
END-CALL. 

msgConsumer has usage pointer.

Parameters

Parameter
Description
msgConsumer
Close this consumer.

Remarks

If a receive call or a message listener callback is in progress, then this function waits until that call returns, and then closes the consumer.

This call also notifies the server that the client program is closing the consumer. In response, the server stops sending message data to the consumer.

Your program must explicitly close all consumers that it creates.

See Also

tibemsMsgConsumer_Receive

tibemsSession_CreateConsumer


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