StartRunDate Property

SQL-DMO

SQL-DMO

StartRunDate Property

The StartRunDate property filters jobs listed in the JobServer object EnumJobHistory method, restricting the returned QueryResults object result set to only those jobs whose execution date matches the value set.

Applies To
JobHistoryFilter Object
Syntax

object.StartRunDate [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

Scaled, long integer date representation

Data Type

Long

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetStartRunDate(LPLONG pRetVal);

HRESULT SetStartRunDate(long NewValue);

Remarks

Use the StartRunDate and StartRunTime properties to restrict result set membership to a specific execution instance of the job identified in the JobID or JobName property.

Set StartRunDate to zero to disable filtering by execution start time.

Note  When SQL-DMO uses a scaled long integer to represent a date, the integer is built as a sum of the year scaled by 10000, the month scaled by 100, and the day. For example, the date April 19, 1997 is represented by the long integer value 19970419.