Table of Contents

Class SchedulerOptions

Namespace
Excalibur.Dispatch.Options.Scheduling
Assembly
Excalibur.Dispatch.dll

Options controlling the Excalibur.Dispatch.Delivery.ScheduledMessageService polling behaviour.

public sealed class SchedulerOptions
Inheritance
SchedulerOptions
Inherited Members
Extension Methods

Properties

AdaptivePollingBackoffMultiplier

Gets or sets the multiplier used to increase polling delay when the scheduler is idle.

public double AdaptivePollingBackoffMultiplier { get; set; }

Property Value

double

EnableAdaptivePolling

Gets or sets a value indicating whether adaptive polling backoff is enabled when the scheduler is idle.

public bool EnableAdaptivePolling { get; set; }

Property Value

bool

MaxAdmissionAttemptsPerOccurrence

Gets or sets how many times one occurrence may be admitted without its settlement being committed before the schedule is retired instead of dispatched again.

public int MaxAdmissionAttemptsPerOccurrence { get; set; }

Property Value

int

The admission bound per occurrence. Defaults to 5. Must be at least 1.

Remarks

An occurrence whose settlement write is refused — because the host paused, migrated or was collected past its execution lease — is admitted again on the next poll, by design: a lapsed lease must produce a successor rather than a stop. Nothing in that loop retires the occurrence, so without a bound the same handler is invoked once per poll interval indefinitely while the schedule never advances.

On the admission that exceeds this bound the handler is NOT invoked. The schedule is disabled and the occurrence settled under the still-live lease, which stops the loop and leaves an operator a durable row to inspect. Raise it for handlers that legitimately outrun their lease; prefer renewing the lease.

MinPollingInterval

Gets or sets the minimum polling interval used when adaptive polling is enabled and work is present.

public TimeSpan MinPollingInterval { get; set; }

Property Value

TimeSpan

PastScheduleBehavior

Gets or sets determines how messages scheduled in the past are handled.

public PastScheduleBehavior PastScheduleBehavior { get; set; }

Property Value

PastScheduleBehavior

The current PastScheduleBehavior value.

PollInterval

Gets or sets how often the scheduler checks for messages to dispatch.

public TimeSpan PollInterval { get; set; }

Property Value

TimeSpan

How often the scheduler checks for messages to dispatch.

PollingJitterRatio

Gets or sets the jitter ratio applied to polling delay to reduce synchronized wake-ups.

public double PollingJitterRatio { get; set; }

Property Value

double

Remarks

A value of 0 disables jitter. A value of 0.1 applies up to +/-10% random jitter.