Share via


EndRunTime 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 EndRunTime property specifies the most recent execution time of a SQL Server Agent job.

Syntax

object
.EndRunTime [=value]

Parts

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

  • value
    A long integer that specifies a date value as described in Remarks

Data type

Long

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetEndRunTime(LPLONG pRetVal);
HRESULT SetEndRunTime(long NewValue);

Remarks

To filter for jobs last executed at a particular date and time, set both the EndRunDate and EndRunTime properties. To filter for jobs executed only before a certain time, such as filtering for jobs that run before 6 A.M. local time on any date, set only the EndRunTime property.

By default, EndRunTime is 0. If 0, the property is not used as part of job history filtering.

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.