DistributionSubscription Object

The DistributionSubscription object exposes the properties of subscription to a publication maintained by a Distributor.

Properties

DistributionAgent Property	SubscriptionDB Property
Name Property	SubscriptionType Property
Status Property (Subscription Objects)	SyncType Property
Subscriber Property

Methods

Remarks

For snapshot and transactional replication, a replication Distributor maintains an image of articles defining a publication. The Distributor replicates the articles to Subscribers, that enable one type of replication load balancing.

There is no requirement that an instance of Microsoft® SQL Server™ create Distributor-maintained data images. Snapshot and transactional replication publications created on the Distributor enable one type of third-party, or heterogeneous, replication.

With the DistributionSubscription object, you can:

• Create a Distributor-originated (push) subscription to a heterogeneous replication publication.
  
  
• Enable or disable a subscription to a publication maintained by the Distributor.
  
  
• Remove a push subscription to a heterogeneous replication publication.

For more information about using SQL-DMO in heterogeneous replication, see Programming Replication from Heterogeneous Data Sources.

Note  DistributionSubscription object properties are read/write only when using the object to create a subscription. When a DistributionSubscription object references a Distributor's image of an existing subscription, all properties are read-only.

The DistributionSubscription object is compatible with instances of SQL Server 2000 and SQL Server version 7.0. However, the DistributionSubscription2 object extends the functionality of the DistributionSubscription object for use with features that are new in SQL Server 2000.

See Also