tibemsMsgConsumer_Close

Function

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.
Note: 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.