DTSPackageLocation Property
The DTSPackageLocation property specifies the location of a Data Transformation Services (DTS) package to be used during a replication process.
Applies To
| TransPullSubscription2 Object | TransSubscription2 Object |
Syntax
object.DTSPackageLocation [= value]
Parts
object
Expression that evaluates to an object in the Applies To list
value
Long integer that specifies a SQLDMO_REPLDTSLOC_TYPE constant as described in Settings.
Data Type
Long integer
Modifiable
Read/write
Prototype (C/C++)
HRESULT GetDTSPackageLocation(
SQLDMO_REPLDTSLOC_TYPE pRetVal);
HRESULT SetDTSPackageLocation(
SQLDMO_REPLDTSLOC_TYPE NewValue);
Settings
Set the DTSPackageLocation property using these values.
| Constant | Value | Description |
|---|---|---|
| SQLDMOReplDTSPackageLocation_Distributor | 0 | DTS package located at the Distributor |
| SQLDMOReplDTSPackageLocation_Subscriber | 1 | DTS package located at the Subscriber |
Remarks
For push subscriptions, a DTS package used during the replication process is located at the Distributor by default. Specify a SQLDMO_REPLDTSLOC_TYPE setting of SQLDMOReplDTSPackageLocation_Subscriber to specify to the Distribution Agent that the DTS package is located at the Subscriber.
For pull subscriptions, a DTS package used during a replication process is located at the Subscriber by default. Specify a SQLDMO_REPLDTSLOC_TYPE setting of SQLDMOReplDTSPackageLocation_Distributor to specify to the Distribution Agent that the DTS package is located at the Distributor.
The complexity and quantity of transformations performed by a DTS package may significantly affect performance at the Distributor or Subscriber, especially during periods of heavy processing. Additionally, data transformation requirements may vary at different subscribing locations. Use the DTSPackageLocation and the AgentOffload properties to reduce the network traffic. For example, in the case of a push subscription, the Distribution Agent runs at the Distributor by default. If the DTS package is located at the Subscriber, the Distribution Agent must execute package instructions over a network connection. However, if Distribution Agent execution is offloaded to the Subscriber, then the Agent executes package steps at the Subscriber.
Note If an application calls DTSPackageLocation on an instance of SQL Server version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000" are returned.