OldestFirst 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 OldestFirst property controls ordering for the SQL Server Agent job histories, listed using the EnumHistory or EnumJobHistory method.

Syntax

object
.OldestFirst [= value]

Parts

• object
  An 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.

Applies To:

JobHistoryFilter Object