Class TriggerFiredBundle

Namespace

Quartz.Extensibility

Assembly

Quartz.dll

What a job store hands the scheduler for one fire: the trigger that fired, the job it starts, and the fire times the execution context reports.

public sealed record TriggerFiredBundle : IEquatable<TriggerFiredBundle>

Inheritance

object

TriggerFiredBundle

Implements

IEquatable<TriggerFiredBundle>

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

A required-init record rather than a positional constructor, because a store builds one of these on its fire path and the shape used to end in three interchangeable DateTimeOffset values — transposing two compiled cleanly and produced a scheduler that reported wrong fire times to every listener. The sibling SPI request records (TriggerAcquisitionRequest) made the same choice for the same reason.

Properties

Calendar

The calendar the trigger fires against, when it names one.

public ICalendar? Calendar { get; init; }

Property Value

ICalendar

FireTimeUtc

The UTC time the trigger actually fired.

public required DateTimeOffset FireTimeUtc { get; init; }

Property Value

DateTimeOffset

JobDetail

The job the fire executes.

public required IJobDetail JobDetail { get; init; }

Property Value

IJobDetail

NextFireTimeUtc

The trigger's next UTC fire time, after this fire.

public required DateTimeOffset? NextFireTimeUtc { get; init; }

Property Value

DateTimeOffset?

PreviousFireTimeUtc

The trigger's previous UTC fire time, before this fire.

public required DateTimeOffset? PreviousFireTimeUtc { get; init; }

Property Value

DateTimeOffset?

Recovering

Whether this fire recovers an execution a failed scheduler instance left behind.

public required bool Recovering { get; init; }

Property Value

bool

ScheduledFireTimeUtc

The UTC time the trigger was scheduled to fire, which trails FireTimeUtc by the firing latency.

public required DateTimeOffset? ScheduledFireTimeUtc { get; init; }

Property Value

DateTimeOffset?

SupersededFireInstanceIds

The fire instance ids of the trigger's running firings this fire replaces, or null when it replaces none.

public IReadOnlyList<string>? SupersededFireInstanceIds { get; init; }

Property Value

IReadOnlyList<string>

Remarks

Set by a store when the trigger's OverlapPolicy is CancelPrevious and earlier firings of it are running on this node. The scheduler interrupts each of them once the store has recorded this fire and before it runs the job. A firing on another node is never named here: a clustered store records an interrupt request on it for that node to act on, or holds the trigger back when that node does not read requests.

Trigger

The trigger that fired.

public required IOperableTrigger Trigger { get; init; }

Property Value

IOperableTrigger