Share via


PullSubscription.AgentOffload Property

Definition

Gets or sets whether or not the Synchronization Agent runs on a computer other than the one where the agent job was created. This property is no longer supported for Distributors running Microsoft SQL Server 2005 and later.

public:
 property bool AgentOffload { bool get(); void set(bool value); };
public bool AgentOffload { get; set; }
member this.AgentOffload : bool with get, set
Public Property AgentOffload As Boolean

Property Value

A Boolean value. If true, the agent runs on another computer and is launched using a Distributed Component Object Model (DCOM) process. If false, the agent runs on the computer where the agent job was created.

Remarks

SQL Server 2000 supported running the Distribution Agent or Merge Agent on another computer and then activating that agent remotely using DCOM. Support has been discontinued for Distributors running SQL Server 2005 and later; it has been deprecated for Distributors running earlier versions of SQL Server. Setting the AgentOffload property on an instance of SQL Server 2005 will generate an exception on the server.

When AgentOffload is true, the agent will be launched remotely by way of a DCOM process if is not local.

The AgentOffload property can only be retrieved by members of the sysadmin fixed server role at the Subscriber or by members of the db_owner fixed database role on the subscription database.

The AgentOffload property can only be set by members of the sysadmin fixed server role at the Subscriber or by members of the db_owner fixed database role on the subscription database.

Applies to