MinimumRetries Property

SQL-DMO

SQL-DMO

MinimumRetries Property

The MinimumRetries property specifies filtering by the number of times SQL Server Agent attempted to execute a scheduled job prior to a successful execution.

Applies To
JobHistoryFilter Object  
Syntax

object.MinimumRetries [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

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.

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