# tibemsSession_Unsubscribe

Function

## Purpose

Unsubscribe a durable topic subscription.

## C Declaration

    tibems_status tibemsSession_Unsubscribe(
        tibemsSession session
        const char* name );

## COBOL Call

    CALL "tibemsSession_Unsubscribe"
         USING BY VALUE session,
               BY REFERENCE name,
               RETURNING tibems-status
    END-CALL.

Note: `session` has usage pointer.

## Parameters

Parameter | Description
--- | ---
`session` | Delete a subscription in this session.
`name` | Enable the server to locate the subscription.

## Remarks

This function deletes the subscription from the server.

Warning: You must unsubscribe before closing the session.

It is illegal to delete an active subscription—that is, while a `tibemsMsgConsumer` exists.

It is illegal to delete a subscription while one of its messages is either unacknowledged, or uncommitted (in the current transaction). Attempting to do so results in a status of `TIBEMS_EXCEPTION`.

## See Also

`tibemsMsgConsumer`

`tibemsTopic`

`tibemsSession_CreateDurableSubscriber`

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