OldestFirst Property

SQL-DMO

SQL-DMO

OldestFirst Property

The OldestFirst property controls ordering for the SQL Server Agent job histories, listed using the EnumHistory or EnumJobHistory method.

Applies To
JobHistoryFilter Object  
Syntax

object.OldestFirst [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

TRUE or FALSE

Data Type

Boolean

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetOldestFirst(LPBOOL pRetVal);

HRESULT SetOldestFirst(BOOL NewValue);

Remarks

The result set returned by either the EnumHistory or EnumJobHistory method is ordered by values in the run-date and run-time columns. By default, history records are ordered so that records for jobs run most recently precede those run at an earlier date and time.

Set the OldestFirst property to TRUE to alter default behavior, and order records so that the oldest record appears first in the result set.