# 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.

## See Also

`tibemsMsgConsumer_Receive`

`tibemsSession_CreateConsumer`

Copyright © Cloud Software Group, Inc. All rights reserved.