EndRunTime Property

SQL-DMO

SQL-DMO

EndRunTime Property

The EndRunTime property specifies the most recent execution time of a SQL Server Agent job.

Applies To
JobHistoryFilter Object
Syntax

object.EndRunTime [= value]

Part

object

Expression that evaluates to an object in the Applies To list

value

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. When 0, the property is not used as part of job history filtering.

Note  When 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.