Partilhar via

JobStep.RetryAttempts Property

  • Artigo

Gets or sets the maximum number of times a job step is retried before it is returned with a completion status of failure.

Namespace: Microsoft.SqlServer.Management.Smo.Agent
Assembly: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)

Syntax

'Declaration
Public Property RetryAttempts As Integer

public int RetryAttempts { get; set; }

public:
property int RetryAttempts {
    int get ();
    void set (int value);
}

/** @property */
public int get_RetryAttempts ()

/** @property */
public void set_RetryAttempts (int value)

public function get RetryAttempts () : int

public function set RetryAttempts (value : int)

Property Value

An Int32 value that specifies the number of times a job step is retried.

Remarks

Microsoft SQL Server Agent job steps are assigned simple logic determining job execution behavior on step success or failure.

If the job step is completed successfully, job execution branches to follow the on-success action for the step. If the number of execution attempts reaches the value of the RetryAttempts property, job execution branches to follow the on-failure action for the step.

When a job step fails, and the step is flagged for retry, SQL Server Agent can pause between execution attempts for the length of time specified in the RetryInterval property

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

Example

How to: Create a Job with Steps and a Schedule in Visual Basic .NET

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

JobStep Class
JobStep Members
Microsoft.SqlServer.Management.Smo.Agent Namespace

Other Resources

Scheduling Automatic Administrative Tasks in SQL Server Agent
Automating Administrative Tasks (SQL Server Agent)
sp_help_jobstep (Transact-SQL)