SQL-DMO
TransSubscription Object
The TransSubscription object represents a push subscription (made from the Publisher) to a transactional or snapshot publication.
Properties
Methods
| BeginAlter Method | ReInitialize Method |
| CancelAlter Method | Remove Method (Objects) |
| DoAlter Method | Script Method (Replication Objects) |
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
- Create a new TransSubscription object.
- Set the Subscriber property to the name of an existing Subscriber.
- Set the SubscriptionDB property to the name of the database (at the Subscriber) where the subscription data will be stored.
- Note that the Name property defaults to Subscriber:subscription_database.
- Add the TransSubscription object to the TransSubscriptions collection of a connected TransPublication object.
To alter an existing transactional push subscription
- Get a TransSubscription object from the TransSubscriptions collection of a connected TransPublication object.
- Use the BeginAlter method to mark the beginning of the changes.
- Set the TransSubscription object properties to reflect the changes to the transactional push subscription.
- Use the DoAlter method to submit the changes to Microsoft® SQL Server™.
To create a snapshot push subscription at the Publisher
- Create a new TransSubscription object.
- Set the Subscriber property to the name of an existing Subscriber.
- Set the SubscriptionDB property to the name of the database (at the Subscriber) where the subscription data will be stored.
- Note that the Name property defaults to Subscriber:subscription_database.
- Add the TransSubscription object to the TransSubscriptions collection of a connected TransPublication object containing a snapshot publication.
To alter an existing snapshot push subscription
- Get a TransSubscription object from the TransSubscriptions collection of a connected TransPublication object containing a snapshot publication.
- Use the BeginAlter method to mark the beginning of the changes.
- Set the TransSubscription properties to reflect the changes to the snapshot push subscription.
- Use the DoAlter method to submit the changes to SQL Server.
Note The TransSubscription object is compatible with instances of SQL Server 2000 and SQL Server version 7.0. However, the TransSubscription2 object extends the functionality of the TransSubscription object for use with features that are new in SQL Server 2000.