# tibemsSession_CreateConsumer

Function

## Purpose

Create a message consumer.

## C Declaration

    tibems_status tibemsSession_CreateConsumer(
        tibemsSession session,
        tibemsMsgConsumer* consumer,
        tibemsDestination destination,
        const char* messageSelector,
        tibems_bool noLocal );

## COBOL Call

    CALL "tibemsSession_CreateConsumer"
         USING BY VALUE session,
               BY REFERENCE consumer,
               BY VALUE destination,
               BY REFERENCE messageSelector,
               BY VALUE noLocal,
               RETURNING tibems-status
    END-CALL.

Note: `session`, `consumer` and `destination` have usage pointer.

## Parameters

Parameter | Description
--- | ---
`session` | Create the consumer in this session.
`consumer` | The function stores the new consumer object in this location.
`destination` | Create a consumer for this destination. The argument may be any destination (queue or topic).
`messageSelector` | When non-null, the server filters messages using this selector, so the consumer receives only matching messages; see Message Selectors. When null, or the empty string, the consumer receives messages without filtering.
`noLocal` | When true, the server filters messages so the consumer does not receive messages that originate locally—that is, messages sent through the same connection. When false, the consumer receives messages with local origin.

## See Also

`tibemsDestination`

`tibemsMsgConsumer`

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