TransPullSubscription Object

SQL-DMO

previous page next page
SQL-DMO

TransPullSubscription Object

The TransPullSubscription object represents a Subscriber-originated pull or an anonymous subscription to a transactional or snapshot publication.

Methods
BeginAlter Method ReInitialize Method
CancelAlter Method Remove Method (Objects)
DoAlter Method Script Method (Replication Objects)
EnumJobInfo Method  
Properties
Description Property Publication Property
DistributionJobID Property PublicationAttributes Property
Distributor Property PublicationDB Property
EnabledForSyncMgr Property Publisher Property
FTPAddress Property SubscriberLogin Property
FTPLogin Property SubscriberPassword Property
FTPPassword Property SubscriberSecurityMode Property
FTPPort Property SubscriberType Property (TransPullSubscription, TransSubscription)
LastDistributionDate Property SubscriptionType Property
Name Property  

Remarks

With the TransPullSubscription object, you can:

  • Add a pull or anonymous subscription to a transactional publication.

  • Change the properties of an existing pull or anonymous subscription to a transactional publication.

  • Add a pull or anonymous subscription to a snapshot publication.

  • Change the properties of an existing pull or anonymous subscription to a snapshot publication.

To create a transactional pull subscription at the Subscriber

  1. Create a new TransPullSubscription object.

  2. Set the Publisher property to the name of an existing Publisher.

  3. Set the Distributor property to the name of the Distributor.

  4. Set the PublicationDB property to the name of the database (at the Publisher) where the publication is located.

  5. Set the Publication property to the name of the publication to which to subscribe.

  6. Set the SubscriptionType property to SQLDMOSubscription_Pull.

  7. Set the SecurityMode property of the DistributorSecurity object property as appropriate.

  8. If the SecurityMode property of the DistributorSecurity object property is set to SQLDMOReplSecurity_Normal, set the StandardLogin and StandardPassword properties of the DistributorSecurity object property.

  9. Set the SecurityMode property of the PublisherSecurity object property as appropriate.

  10. If the SecurityMode property of the PublisherSecurity object property is set to SQLDMOReplSecurity_Normal, set the StandardLogin and StandardPassword properties of the PublisherSecurity object property.

  11. Note that the Name property defaults to publisher:publication_database:publication.

  12. Add the TransPullSubscription object to the TransPullSubscriptions collection of a connected ReplicationDatabase object at the Subscriber.

  13. Get a ReplicationDatabase object that contains the publication from the ReplicationDatabases collection of a Replication object connected to the Publisher.

  14. Use the EnableTransSubscription method of the ReplicationDatabase object that is connected to the Publisher.

To create a transactional anonymous subscription at the Subscriber

  1. Create a new TransPullSubscription object.

  2. Set the Publisher property to the name of an existing Publisher.

  3. Set the PublicationDB property to the name of the database (at the Publisher) where the publication is located.

  4. Set the Publication property to the name of the publication to which to subscribe.

  5. Set the SubscriptionType property to SQLDMOSubscription_Anonymous.

  6. Set the SecurityMode property of the DistributorSecurity object property as appropriate.

  7. If the SecurityMode property of the DistributorSecurity object property is set to SQLDMOReplSecurity_Normal, set the StandardLogin and StandardPassword properties of the DistributorSecurity object property.

  8. Set the SecurityMode property of the PublisherSecurity object property as appropriate.

  9. If the SecurityMode property of the PublisherSecurity object property is set to SQLDMOReplSecurity_Normal, set the StandardLogin and StandardPassword properties of the PublisherSecurity object property.

  10. Note that the Name property defaults to publisher:publication_database:publication.

  11. Add the TransPullSubscription object to the TransPullSubscriptions collection of a connected ReplicationDatabase object at the Subscriber.

To alter an existing transactional pull subscription at the Subscriber

  1. Get a TransPullSubscription object from the TransPullSubscriptions collection of a connected ReplicationDatabase object at the Subscriber.

  2. Use the BeginAlter method to mark the beginning of the changes.

  3. Set the TransPullSubscription object properties to reflect the changes to the transactional pull subscription.

  4. Use the DoAlter method to submit the changes to Microsoft® SQL Server™.

To alter an existing transactional anonymous subscription at the Subscriber

  1. Get a TransPullSubscription object containing a transactional anonymous subscription from the TransPullSubscriptions collection of a connected ReplicationDatabase object at the Subscriber.

  2. Use the BeginAlter method to mark the beginning of the changes.

  3. Set the TransPullSubscription object properties to reflect the changes to the transactional anonymous subscription.

  4. Use the DoAlter method to submit the changes to SQL Server.

To create a snapshot pull subscription at the Subscriber

  1. Create a new TransPullSubscription object.

  2. Set the Publisher property to the name of an existing Publisher.

  3. Set the PublicationDB property to the name of the database (at the Publisher) where the snapshot publication is located.

  4. Set the Publication property to the name of the snapshot publication to which to subscribe.

  5. Set the SubscriptionType property to SQLDMOSubscription_Pull.

  6. Set the SecurityMode property of the DistributorSecurity object property as appropriate.

  7. If the SecurityMode property of the DistributorSecurity object property is set to SQLDMOReplSecurity_Normal, set the StandardLogin and StandardPassword properties of the DistributorSecurity object property.

  8. Set the SecurityMode property of the PublisherSecurity object property as appropriate.

  9. If the SecurityMode property of the PublisherSecurity object property is set to SQLDMOReplSecurity_Normal, set the StandardLogin and StandardPassword properties of the PublisherSecurity object property.

  10. Note that the Name property defaults to publisher:publication_database:publication.

  11. Add the TransPullSubscription object to the TransPullSubscriptions collection of a connected ReplicationDatabase object at the Subscriber.

  12. Get a ReplicationDatabase object that contains the publication from the ReplicationDatabases collection of a Replication object connected to the Publisher.

  13. Use the EnableTransSubscription method of the ReplicationDatabase object connected to the Publisher.

To create a snapshot anonymous subscription at the Subscriber

  1. Create a new TransPullSubscription object.

  2. Set the Publisher property to the name of an existing Publisher.

  3. Set the PublicationDB property to the name of the database (at the Publisher) where the snapshot publication is located.

  4. Set the Publication property to the name of the snapshot publication to subscribe to.

  5. Set the SubscriptionType property to SQLDMOSubscription_Anonymous.

  6. Set the SecurityMode property of the DistributorSecurity object property as appropriate.

  7. If the SecurityMode property of the DistributorSecurity object property is set to SQLDMOReplSecurity_Normal, set the StandardLogin and StandardPassword properties of the DistributorSecurity object property.

  8. Set the SecurityMode property of the PublisherSecurity object property as appropriate.

  9. If the SecurityMode property of the PublisherSecurity object property is set to SQLDMOReplSecurity_Normal, set the StandardLogin and StandardPassword properties of the PublisherSecurity object property.

  10. Note that the Name property defaults to publisher:publication_database:publication.

  11. Add the TransPullSubscription object to the TransPullSubscriptions collection of a connected ReplicationDatabase object at the Subscriber.

To alter an existing snapshot pull subscription at the Subscriber

  1. Get a TransPullSubscription object containing a snapshot pull subscription from the TransPullSubscriptions collection of a connected ReplicationDatabase object at the Subscriber.

  2. Use the BeginAlter method to mark the beginning of the changes.

  3. Set the TransPullSubscription object properties to reflect the changes to the snapshot pull subscription.

  4. Use the DoAlter method to submit the changes to SQL Server.

To alter an existing snapshot anonymous subscription at the Subscriber

  1. Get a TransPullSubscription object containing a snapshot anonymous subscription from the TransPullSubscriptions collection of a connected ReplicationDatabase object at the Subscriber.

  2. Use the BeginAlter method to mark the beginning of the changes.

  3. Set the TransPullSubscription object properties to reflect the changes to the snapshot anonymous subscription.

  4. Use the DoAlter method to submit the changes to SQL Server.

The TransPublication2 object now supports the FTP-related properties, formerly supported by the TransPullSubscription object. Previously, if it was necessary to modify these properties, changes had to be made at each Subscriber. Now changes can be made at the Publisher.

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

See Also

TransPullSubscription2 Object
previous page start next page