DTSPackageLocation Property

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 DTSPackageLocation property specifies the location of a Data Transformation Services (DTS) package to be used during a replication process.


object
.DTSPackageLocation [= value]

object

An expression that evaluates to an object in the Applies To list.

value

A long integer that specifies a SQLDMO_REPLDTSLOC_TYPE constant as described in Settings.

Long integer

Read/write

HRESULT GetDTSPackageLocation(
SQLDMO_REPLDTSLOC_TYPE pRetVal);
HRESULT SetDTSPackageLocation(
SQLDMO_REPLDTSLOC_TYPE NewValue);

Set the DTSPackageLocationproperty using these values.

Constant

Value

Description

SQLDMOReplDTSPackageLocation_/Distributor

0

The DTS package is located at the Distributor.

SQLDMOReplDTSPackageLocation_/Subscriber

1

The DTS package is located at the Subscriber

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 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 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, Distribution Agent runs at the Distributor by default. If the DTS package is located at the Subscriber, Distribution Agent must run package instructions over a network connection. However, if Distribution Agent execution is offloaded to the Subscriber, the agent runs package steps at the Subscriber.

NoteNote

If an application calls DTSPackageLocationon 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 or later" are returned.

Community Additions

ADD
Show: