• Article

StartRunDate 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 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.

Syntax

object.StartRunDate [= value]

Parts

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

  • value
    A 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 Distributed Management Objects (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.