EndRunTime Property (SQL-DMO)

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

Applies To

JobHistoryFilter Object

Syntax

object.EndRunTime [= value]

Part Description
object Expression that evaluates to an object in the Applies To list
value Long integer specifying a date value as described in Remarks

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.


Data type

Long

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetEndRunTime(LPLONG pRetVal);

HRESULT SetEndRunTime(long NewValue);

  


(c) 1988-98 Microsoft Corporation. All Rights Reserved.