# tibemsConsumerInfo_GetSharedSubscriptionName

Function

## Purpose

Get the shared subscription name for a consumer.

## C Declaration

    tibems_status tibemsConsumerInfo_GetSharedSubscriptionName(
        tibemsConsumerInfo consumerInfo,
        char* sharedName,
        tibems_int name_len);

## COBOL Call

    CALL "tibemsConsumerInfo_GetSharedSubscriptionName"
     USING BY VALUE consumerInfo,
           BY REFERENCE sharedName,
           BY VALUE name-len,
           RETURNING tibems-status
    END-CALL.

Note: `sharedName` has usage pointer.

## Parameters

Parameter | Description
--- | ---
`consumerInfo` | Get the subscription name for this consumer.
`sharedName` | Store the shared subscription name.
`name_len` | Length of the `sharedName` buffer.

## Remarks

This function can be used to retrieve the shared subscription name for the consumer. Only shared consumers have a shared subscription name. The function returns `NULL` if the consumer is not shared or is a queue receiver.

For more information, see the section "Shared Subscriptions for Topics" in the TIBCO Enterprise Message Service User’s Guide.

## See Also

`tibemsConsumerInfo_IsShared`

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