PullSubscription.AgentSchedule Property

Gets the schedule for the agent job used to synchronize the subscription.

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

Syntax

'Declaration
Public ReadOnly Property AgentSchedule As ReplicationAgentSchedule
public ReplicationAgentSchedule AgentSchedule { get; }
public:
property ReplicationAgentSchedule^ AgentSchedule {
    ReplicationAgentSchedule^ get ();
}
/** @property */
public ReplicationAgentSchedule get_AgentSchedule ()
public function get AgentSchedule () : ReplicationAgentSchedule

Property Value

A ReplicationAgentSchedule object that represents the schedule for the subscription.

Remarks

You must set the properties of the returned ReplicationAgentSchedule object before creating the subscription. Once the schedule is set, you cannot change it using Replication Management Objects (RMO). Instead you must call the JobSchedule class or execute sp_update_schedule (Transact-SQL) to change an existing schedule, where AgentJobID represents the ID of the job's schedule.

The AgentSchedule 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.

Retrieving the AgentSchedule property is equivalent to executing sp_helppullsubscription (Transact-SQL) or sp_helpmergepullsubscription (Transact-SQL).

Setting an agent schedule is equivalent to executing sp_addpullsubscription_agent (Transact-SQL) or sp_addmergepullsubscription_agent (Transact-SQL).

The AgentSchedule property is available with SQL Server 7.0, SQL Server 2000, and SQL Server 2005.

This namespace, class, or member is supported only in version 2.0 of the .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

PullSubscription Class
PullSubscription Members
Microsoft.SqlServer.Replication Namespace

Other Resources

How to: Specify Synchronization Schedules (RMO Programming)