Share via


TransSubscription Object

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 TransSubscription object represents a push subscription (made from the Publisher) to a transactional or snapshot publication.

SQL-DMO object model that shows the current object

Properties

DistributionJobID Property

Subscriber Property

EnabledForSyncMgr Property

SubscriberType Property (TransPullSubscription, TransSubscription)

FullSubscription Property

SubscriptionDB Property

Name Property

SubscriptionType Property

Status Property (Subscription Objects)

SyncType Property

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.

Note

The TransSubscription object is compatible with instances of SQL Server versions 7.0 and later. However, the TransSubscription2 object extends the functionality of the TransSubscription object for use with features that were introduced in SQL Server 2000.

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 is to 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 is to 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.

See Also

Reference

TransSubscription2 Object

Help and Information

Getting SQL Server 2005 Assistance