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.