The DowntimeEntity object is used to generate planned and unplanned maintenance events for various types of objects. The DowntimeEntity generates the downtime events and their durations, but the objects that use one or more DowntimeEntities must provide their own logic for halting operations.
In some cases, there can be a delay before object using the DowntimeEntity initiates the downtime activity. This can occur when an object such as a Server uses the DowntimeEntity in its OpportunisticMaintenanceList or OpportunisticBreakdownList inputs. The NumberPending output for the DowntimeEntity returns the number of downtime events that are ready to start, but have not started yet.
DowntimeEntity Inputs
Keyword |
Description |
Key Inputs |
|
Description |
A free-form string describing the object. |
FirstDowntime |
The calendar or working time for the first planned or unplanned maintenance event. If an input is not provided, the first maintenance event is determined by the input for the Interval keyword. A number, an object that returns a number, or an expression can be entered. |
IntervalWorkingEntity |
The object whose working time determines the occurrence of the planned or unplanned maintenance events. Calendar time is used if the input is left blank. |
DurationWorkingEntity |
The object whose working time determines the completion of the planned or unplanned maintenance activity. Calendar time is used if the input is left blank. |
Interval |
The calendar or working time between the start of the last planned or unplanned maintenance activity and the start of the next maintenance activity. A number, an expression, or an object that returns a number can be entered. |
Duration |
The calendar or working time required to complete the planned or unplanned maintenance activity. A number, an expression, or an object that returns a number can be entered. |
Concurrent |
If TRUE, the downtime event can occur in parallel with another downtime event. |
MaxDowntimePending |
The maximum number of downtimes pending for the downtime event. |
Options |
|
AttributeDefinitionList, CustomOutputList |
See Section 6.2. |
Graphics |
|
Position, Alignment, Size, Orientation, Region, RelativeEntity, DisplayModel, Show, Movable, VisibleViews, DrawRange |
See Section 11.1. |
DowntimeEntity Outputs
Output Name |
Description |
Entity and DisplayEntity |
|
Name, ObjectType, SimTime, Parent, Position, Size, Orientation, Alignment, GraphicalLength, ObserverList, NextList, PreviousList, EntityReferenceList |
See Section 11.1. |
StateEntity |
|
State, WorkingState, WorkingTime, StateTimes, TotalTime |
See Section 10.3. |
DownTimeEntity |
|
UserList |
The objects that experience breakdowns or maintenance caused by this DowntimeEntity. |
NumberPending |
The number of downtime events that are backlogged. If two or more downtime events are pending they will be performed one after another. |
StartTime |
The time that the most recent downtime event started. |
EndTime |
The time that the most recent downtime event finished or will finish. |
NextStartTime |
The time at which the next downtime event will begin. If downtime is based on the working time for an entity, then the next start time is estimated assuming that it will work continuously until the downtime event occurs. |
CalculatedDowntimeRatio |
The value calculated directly from model inputs for: (avg. downtime duration)/(avg. downtime interval) |
Availability |
The fraction of calendar time (excluding the initialisation period) during which this type of downtime did not occur. |
User-defined attributes and custom outputs |
As defined by the AttributeDefinitionList and CustomOutputList inputs. |