tibemsMsgConsumer_Close

Purpose

Close a message consumer and release associated storage.

C Declaration

tibems_status tibemsMsgConsumer_Close(
    tibemsMsgConsumer msgConsumer );

COBOL Call

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

Parameters

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