Share via

  • Article

StartRunTime 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 StartRunTime property filters jobs listed in the JobServer object EnumJobHistory method, restricting the returned QueryResults object result set to only those jobs whose execution time matches the value set.

Syntax

object
.StartRunTime [= value]

Parts

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

  • value
    A scaled, long integer representation of a time of day

Data Type

Long

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetStartRunTime(LPLONG pRetVal);
HRESULT SetStartRunTime(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.

Note

When SQL Distributed Management Objects (SQL-DMO) uses a scaled long integer to represent a time, the integer is built as a sum of the hour scaled by 10000, the minute scaled by 100, and the seconds. The time value uses a 24-hour clock. For example, the time 1:03:09 P.M. is represented by the long integer value 130309.