MinimumRetries 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 MinimumRetries property specifies filtering by the number of times SQL Server Agent attempted to execute a scheduled job prior to a successful execution.

Syntax

object
.MinimumRetries [= value]

Parts

  • object
    an expression that evaluates to an object in the Applies To list

  • value
    A long integer

Data Type

Long

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetMinimumRetries(LPLONG pRetVal);
HRESULT SetMinimumRetries(long NewValue);

Remarks

Set the MinimumRetries property to filter the job execution history list based on failed execution attempts. For example, set the MinimumRetries property to 1 to list only those jobs that did not successfully execute on the first attempt.

If the MinimumRetries property is 0, the property is not used as part of job execution history filtering.

Applies To: