TransSubscription Object (SQL-DMO)

The TransSubscription object represents a push subscription (made from the Publisher) to a transactional or snapshot publication.

Remarks

With the TransSubscription object, you can:

• Add a push subscription to a transactional publication.
• Change the properties of an existing push subscription to a transactional publication.
• Add a push subscription to a snapshot publication.
• Change the properties of an existing push subscription to a snapshot publication.

To create a transactional push subscription at the Publisher

1. Create a new TransSubscription object.
2. Set the Subscriber property to the name of an existing Subscriber.
3. Set the SubscriptionDB property to the name of the database (at the Subscriber) where the subscription data will be stored.
4. Note that the Name property defaults to Subscriber:subscription_database.
5. Add the TransSubscription object to the TransSubscriptions collection of a connected TransPublication object.

To alter an existing transactional push subscription

1. Get a TransSubscription object from the TransSubscriptions collection of a connected TransPublication object.
2. Use the BeginAlter method to mark the beginning of the changes.
3. Set the TransSubscription object properties to reflect the changes to the transactional push subscription.
4. Use the DoAlter method to submit the changes to Microsoft® SQL Server™.

To create a snapshot push subscription at the Publisher

1. Create a new TransSubscription object.
2. Set the Subscriber property to the name of an existing Subscriber.
3. Set the SubscriptionDB property to the name of the database (at the Subscriber) where the subscription data will be stored.
4. Note that the Name property defaults to Subscriber:subscription_database.
5. Add the TransSubscription object to the TransSubscriptions collection of a connected TransPublication object containing a snapshot publication.

To alter an existing snapshot push subscription

1. Get a TransSubscription object from the TransSubscriptions collection of a connected TransPublication object containing a snapshot publication.
2. Use the BeginAlter method to mark the beginning of the changes.
3. Set the TransSubscription properties to reflect the changes to the snapshot push subscription.
4. Use the DoAlter method to submit the changes to SQL Server.

Methods

Properties