• Article

TransSubscriptions Collection

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The TransSubscriptions collection contains TransSubscription objects that reference all known (non-anonymous) subscriptions to a transactional or snapshot publication.

SQL-DMO object model that shows the current object

Properties

Count Property

 

Remarks

With the TransSubscriptions object, you can:

  • Create a Publisher-initiated (push) subscription to a transactional or snapshot replication publication.

  • Generate a Transact-SQL script that can be used as part of the administration of all subscriptions to a transactional or snapshot publication.

  • Remove a push subscription to a transactional or snapshot replication publication.

For more information about creating push subscriptions to transactional or snapshot publications by using the TransSubscription object and TransSubscriptions collection, see the TransSubscription Objectsection.

To remove a transactional or snapshot replication push subscription

  1. Get the TransSubscription object that references the target subscription from the TransSubscriptions collection of the TransPublication object referencing the publication.

  2. Query the SubscriptionType property of the TransSubscription object.

  3. If SubscriptionType returns SQLDMOSubscription_Push, the referenced subscription is a push subscription and can be safely removed at the Publisher. Use the Remove method of the TransSubscription object to remove the subscription.

    Note

    Removing a subscription by using the Remove method of a TransSubscriptionobject does not remove a replicated copy of the publication articles at any Subscriber.

When using the Item or Remove method, the TransSubscriptions collection supports member identification using either name or ordinal reference syntax. For example:

Set oTransSubscription = oTransPublication.TransSubscriptions("[LONDON2_Push]")

Or:

Set oTransSubscription = oTransPublication.TransSubscriptions(2)