Subscription.AgentOffloadServer Property

Gets or sets the name of the remote computer where the agent runs when using remote agent activation.

Namespace: Microsoft.SqlServer.Replication
Assembly: Microsoft.SqlServer.Rmo (in microsoft.sqlserver.rmo.dll)

Syntax

'Declaration
Public Property AgentOffloadServer As String
public string AgentOffloadServer { get; set; }
public:
property String^ AgentOffloadServer {
    String^ get ();
    void set (String^ value);
}
/** @property */
public String get_AgentOffloadServer ()

/** @property */
public void set_AgentOffloadServer (String value)
public function get AgentOffloadServer () : String

public function set AgentOffloadServer (value : String)

Property Value

A String value.

Remarks

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

The AgentOffloadServer property can only be retrieved by members of the sysadmin fixed server role at the Publisher, by members of the db_owner fixed database role on the publication database, or by the user that created the subscription.

The AgentOffloadServer property can only be set by members of the sysadmin fixed server role at the Publisher or by members of the db_owner fixed database role on the publication database.

Retrieving the AgentOffloadServer property is equivalent to executing sp_helpsubscription or sp_helpmergesubscription.

Setting the AgentOffloadServer property is equivalent to executing sp_enableagentoffload, sp_disableagentoffload, sp_addsubscription, or sp_addmergesubscription.

The AgentOffloadServer property is available with SQL Server 2000.

This namespace, class, or member is supported only in version 2.0 of the Microsoft .NET Framework.

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

See Also

Reference

Subscription Class
Subscription Members
Microsoft.SqlServer.Replication Namespace

Other Resources

Discontinued Functionality in SQL Server 2005 Replication