Runtime attributes for the AppEngine object
- Last UpdatedJul 18, 2024
- 10 minute read
The following table describes the runtime only attributes for the object.
Note: Configurable runtime attributes are described in the configuration sections. For more information, see AppEngine object configuration.
For a list of common object attributes, click Attribute Help in the Help file header.
|
Attribute |
Description |
Run-Time Access |
|---|---|---|
|
AlarmDSCnt |
The total number of disabled and silenced alarms in the object. Sub-areas or sub-notification-distributors are not included. |
Read-Only |
|
AlarmOnCnt |
The number of active alarms in the distributor. Does not include sub-areas or sub-notification-distributors. |
Read-Only |
|
AlarmUnAckCnt |
The number of unacknowledged alarms in the distributor (including unacknowledged return-to-normals). Does not include sub-areas or sub-notification-distributors. |
Read-Only |
|
Engine.AlarmsThrottled |
The number of alarms that have been throttled in the prior scan. The limit for the number of alarms per second that can be raised by this object before throttling occurs is set using the alarm throttle limit. |
Read-Only |
|
Engine.AsyncScriptsRunningCnt |
The total number of asynchronous scripts that are currently executing on the object. |
Read-Only |
|
Engine.AsyncScriptsWaitingCnt |
The total number of asynchronous scripts that are currently queued to execute on the object, but are not yet executing because they are waiting for a free thread. |
Read-Only |
|
Engine.CheckPointFailed.Condition |
Used to indicate whether the checkpointer failed to checkpoint the last attempt. |
Read-Only |
|
Engine.EngineAlarmRate |
The number of alarms raised on this object during the prior scan by all objects running on this object, calculated as alarms per second. When alarm throttling occurs, the maximum value is the alarm throttle limit. This value is updated by the Notification Distributor. |
None |
|
Engine.ExternalReferenceCnt |
The number of registered external references. For extra quality information, see About object quality handling. |
Read-Only |
|
Engine.ExternalReferenceCntUnbound |
The number of registered external references that are unbound. For extra quality information, see About object quality handling. |
Read-Only |
|
Engine.Folding.Condition |
Set to TRUE when Message Exchange folding is currently active, which means that this object is overloaded with regards to publishing throughput. Folding occurs when the object detects that a target object is receiving more data than it can process in a timely manner. |
Read-Only |
|
Engine.GlobalAdviseOnlyActiveEnabled |
If set to TRUE, Galaxy-wide advising of only active items is enabled. |
Read-Only |
|
Engine.Historian.BufferCount |
Obsolete. Do not use. Use the BufferSize attribute instead. |
Read-Only |
|
Engine.Historian.ConnectionPartner |
The name of the partner Historian Server, if one is configured for the Historian. If no partner Historian is detected, the value of this attribute is an empty string. |
Read-Only |
|
Engine.Historian.ConnectState |
The physical state of the connection between HCAL and the historian. This value should remain TRUE as long as HCAL is able to communicate with the historian, regardless of whether it is historizing data or not. A network failure, for example, will cause the ConnectState attribute to be set to FALSE. Even if the ConnectState attribute is FALSE, the AppEngine may still be connected to the historian and appear listed as a client in the historian System Management Console. In a redundant historian setup, the connect state is TRUE if the connection is good for at least one of the historians. To determine state of an individual historian in a redundant setup, use the ConnectStateMask attribute. |
Read-Only |
|
Engine.Historian.ConnectStateCmd |
This attribute has no effect on the connection between the engine and historian (feature has not been implemented). |
Supervisory, User |
|
Engine.Historian.ConnectStateMask |
A bitmask where the lowest order bit represents the connection state of the primary Historian and the second bit represents the connection state of the partner. If no partner is configured, the second bit will always be 0. |
Read-Only |
|
Engine.Historian.ForwardingChunkSize |
Obsolete. Do not use. |
Read-Only |
|
Engine.Historian.ForwardingDelay |
Obsolete. Do not use. |
Read-Only |
|
Engine.Historian.InStoreForward |
If set to TRUE, HCAL is in store-and-forward mode. In a redundant historian setup, the InStoreForward attribute is TRUE if either one of the historians is in store-and-forward mode. To determine state of an individual historian in a redundant setup, use the InStoreForwardMask attribute. |
Read-Only |
|
Engine.Historian.InStoreForwardMask |
A bitmask where the lowest order bit represents the store-and-forward state of the primary Historian and the second bit represents the store-and-forward of the partner. If no partner is configured, the second bit will always be 0. |
Read-Only |
|
Engine.Historian.ProcessInterval |
Obsolete. Do not use. |
Read-Only |
|
Engine.Historian.StoreForwardProblem |
If set to TRUE, the HCAL on the active engine is unable to store data while in store-and-forward mode. In a redundant historian setup, the StoreForwardProblem attribute is TRUE if either one of the historians has a store-and-forward issue. |
Read-Only |
|
Engine.Historian.StoreForwardSpaceAvailable |
The available storage space, in MB, for the HCAL of the active engine. |
Read-Only |
|
Engine.Historian.StoreFwdDataLost |
Set to TRUE when HCAL is in store-and-forward mode, the store-and-forward deletion threshold has been exceeded, and history data has been lost. This value remains TRUE until the connection to the historian has been re-established and store-and-forward is no longer in effect. |
Read-Only |
|
Engine.IssuedExternalGetsCnt |
The number of off-engine gets (initiated from AutomationObjects on this object). For extra quality information, see About object quality handling. |
Read-Only |
|
Engine.IssuedExternalSetsCnt |
The number of off-engine sets (initiated from AutomationObjects on this object). For extra quality information, see About object quality handling. |
Read-Only |
|
Engine.IssuedInternalGetsCnt |
The number of on-engine gets (initiated from AutomationObjects on this object). For extra quality information, see About object quality handling. |
Read-Only |
|
Engine.IssuedInternalSetsCnt |
The number of on-engine sets (initiated from AutomationObjects on this object). For extra quality information, see About object quality handling. |
Read-Only |
|
Engine.ObjectQuarantined.Condition |
Used to trigger an alarm when at least one hosted object is in a quarantined state, indicating a software exception has occurred on the object. If all quarantined objects are later undeployed, the alarm will be disabled. |
Read-Only |
|
Engine.Objects |
An array containing the names of all objects hosted by this object. |
Read-Only |
|
Engine.ProcessCPULoad |
The current processor load that the engine is consuming. |
Read-Only |
|
Engine.ProcessIODataBytes |
The current rate, in bytes per second, that the engine is reading and writing I/O bytes. I/O bytes include network bytes, file bytes, and all device I/O bytes. |
Read-Only |
|
Engine.ProcessPageFaults |
The current page fault rate, per second, for the engine. |
Read-Only |
|
Engine.ProcessPrivateBytes |
The current private bytes of memory that the engine has allocated. |
Read-Only |
|
Engine.ProcessWorkingSet |
The current number of bytes in the working set of the engine. The working set is the amount of memory that the operating system has dedicated for the engine process. |
Read-Only |
|
Engine.PublisherDataNotifyFailureCnt |
The total number of times that the engine, acting as a publisher, failed to send data change notifications to a subscriber. |
Read-Only |
|
Engine.PublishPacketsRcvdCnt |
The number of publish packets received on this engine from other engines. For extra quality information, see About object quality handling. |
Read-Only |
|
Engine.PublishPacketsSentCnt |
The number of publish packets sent from this engine to other engines. For extra quality information, see About object quality handling. |
Read-Only |
|
Engine.RcvdExternalGetsCnt |
The number of incoming external gets (received from other engine objects that do not exist on this object). For extra quality information, see About object quality handling. |
Read-Only |
|
Engine.RcvdExternalSetsCnt |
The number of incoming external sets (received from other engine objects that do not exist on this object). For extra quality information, see About object quality handling. |
Read-Only |
|
Engine.RestartOnFailure |
The AppEngine object will automatically attempt to restart if a failure occurs. This behavior cannot be changed, even if the attribute is set to FALSE. A failure to start is defined as an AppEngine object failing within five minutes of startup. Therefore, if an engine operates longer than five minutes and then fails, three subsequent attempts will be made to start the engine. If an engine fails to start three times in a row, within five minutes, no more attempts are made to start it. The system will attempt to restart this engine as part of the failover sequence. |
Supervisory, User |
|
Engine.StartingFromCheckpoint |
If set to TRUE, an engine is starting and restoring a checkpoint file. |
Read-Only |
|
Engine.StartupReason |
Indicates whether an engine is starting after deployment, from a checkpoint, or from standby (failover). Valid values are: Starting_AfterDeploy, Starting_FromCheckpoint, Starting_FromStandby. |
Read-Only |
|
Engine.StatsReset |
Used to reset all statistics during run time. |
Supervisory, User |
|
Engine.SubscribedAttrCnt |
The number of attributes on this engine, including the attributes of all objects hosted on this engine, that are being subscribed to (read) by other engines and their hosted objects and anonymous engines, such as the Object Viewer and InTouch. |
Read-Only |
|
Engine.SubscribedObjectCnt |
The number of objects on this engine that have one or more attributes that are subscribed to by other engines. |
Read-Only |
|
Engine.SubscriberEngineCnt |
The number of other engines that are subscribing to attributes on this engine. For example, if InTouch View is displaying 10 attributes from this engine, and objects hosted on another AppEngine are reading data from five objects on this engine, then the value is 2. |
Read-Only |
|
Engine.SubscriptionAttemptCnt |
The total number of subscriptions initiated by this engine. |
Read-Only |
|
Engine.SubscriptionCancelledCnt |
The total number of subscriptions initiated by this engine that were cancelled by the publisher. |
Read-Only |
|
Engine.SubscriptionFailureCnt |
The total number of subscription failures detected by this engine. |
Read-Only |
|
Engine.SubscriptionFailureCommsCnt |
Thenumber of subscription failures detected by this engine that resulted from platform or engine communications errors. |
Read-Only |
|
Engine.SubscriptionFailureConfigCnt |
The total number of times that the engine, acting as a publisher, failed to send data change notifications to a subscriber. |
Read-Only |
|
Engine.SubscriptionLocalCnt |
The current number of active subscriptions to an engine on the local platform. |
Read-Only |
|
Engine.SubscriptionRemoteCnt |
The current number of active subscriptions to an engine on a remote platform. |
Read-Only |
|
Engine.SuspendedAttributeCnt |
The number of attributes on this engine that are currently in a suspended (or inactive) state. |
Read-Only |
|
Redundancy.AlarmStateChangesBufferedCnt |
The total number of alarm state changes that are buffered and waiting to be sent to the standby engine. |
Read-Only |
|
Redundancy.AlarmStateChangesOutOfSyncCnt |
The total number of times a full snapshot of alarm state changes was requested by the standby engine. This occurs when the standby engine misses alarm state changes. |
Read-Only |
|
Redundancy.AlarmStateChangesSentToStandby |
The total number of alarm state changes that have been sent by this engine to the standby engine. |
Read-Only |
|
Redundancy.CheckpointDeltasBufferedCnt |
The total number of checkpoint deltas that are buffered and waiting to be sent to the standby engine. |
Read-Only |
|
Redundancy.CheckpointDeltasSentToStandby |
The total number of checkpoint deltas that have been sent from this engine to the standby engine. |
Read-Only |
|
Redundancy.CheckpointOutOfSyncCnt |
The total number of times a full checkpoint synchronization was requested by the standby engine. This occurs when the standby engine misses checkpoint deltas. |
Read-Only |
|
Redundancy.FailoverOccurred |
If set to TRUE, this engine was previously in a standby state and now is active. This attribute will be TRUE for the first scan after the failover occurs and will be set back to FALSE on the subsequent scan. |
Read-Only |
|
Redundancy.FailoverOccurred.Condition |
Set to TRUE the first time the object is scanned, after having been restored and running on an engine that was formerly running as standby. Set to FALSE when the object has executed for a scan. |
Read-Only |
|
Redundancy.ForceFailoverCmd |
If set to TRUE, the active engine will be forced to failover to the current standby engine. This command is only valid if the standby engine is ready. |
Supervisory, User |
|
Redundancy.Identity |
Indicates whether the engine is configured as the primary or backup. |
Read-Only |
|
Redundancy.PartnerStatus |
The failover status of the partner engine. For more information, see About AppEngine object redundancy. |
Read-Only |
|
Redundancy.PartnerPlatform |
The name of the platform that is hosting the standby engine. |
Read-Only |
|
Redundancy.StandbyAlarmDataOutOfSync |
If set to TRUE, the alarm data is out of sync on the standby engine. The primary engine periodically transfers alarm data to the standby engine so that the information is current. |
Read-Only |
|
Redundancy.StandbyHeartbeatsMissedCnt |
The total number of heartbeats from the standby engine that have been missed. |
Read-Only |
|
Redundancy.StandbyHeartbeatsMissedConsecCnt |
The current consecutive number of heartbeats from the standby engine that have been missed. |
Read-Only |
|
Redundancy.StandbyHistoryDataOutOfSync |
If set to TRUE, history data is out of sync on the standby engine. When the primary engine is in store-and-forward mode, it periodically transfers the store-and-forward data to the standby engine so that the information is current. |
Read-Only |
|
Redundancy.StandbyNotReady.Condition |
If set to TRUE, the standby engine is not ready. For example, the standby engine is in the process of syncing with the active engine. |
Read-Only |
|
Redundancy.StandbyUnavailable.Condition |
If set to TRUE, the standby engine is not available. For example, the standby engine is shut down. |
Read-Only |
|
Redundancy.Status |
The failover status of this engine. For more information, see About AppEngine object redundancy. |
Read-Only |
|
Scheduler.CheckpointPeriodAvg |
The average number of milliseconds between checkpoints for the averaging period. For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.ExecInterruptsTimeAvg |
The average number of milliseconds required to perform execution interrupts per engine scan cycle. For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.ExecutionTimeAvg |
The average number of milliseconds required to execute all objects per cycle. For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.HousekeepingTimeAvg |
The average number of milliseconds required for this object to do housekeeping tasks per cycle. For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.InputMsgSizeAvg |
The average size of an input message, in bytes, for this averaging period. For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.InputMsgsProcessedAvg |
Theaverage number of input messages, in total bytes, in the input queue per scan period (including deferred and processed messages). For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.InputMsgsQueuedAvg |
The average number of messages queued, including processed and deferred messages, per scan period. The value is calculated for the averaging period. For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.InputMsgsQueuedMax |
The maximum value of the average number of queued input messages since the last statistics reset. For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.InputQueueSizeAvg |
The average size, in bytes, of the input queue during the averaging period. For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.InputQueueSizeMax |
The maximum value of the average input queue size since the statistics were last reset. For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.ObjectCnt |
The number of objects, excluding the AppEngine object. |
Read-Only |
|
Scheduler.ObjectOffScanCnt |
The number of offscan objects, excluding the AppEngine object. |
Read-Only |
|
Scheduler.ScanCyclesCnt |
The number of execution cycles since the statistics were last reset. |
Read-Only |
|
Scheduler.ScanOverrun.Condition |
A Boolean condition alarm flag indicating a scan overrun condition. This value is set to FALSE when the object goes offscan. |
Read-Only |
|
Scheduler.ScanOverrunsCnt |
The number of scan overruns since the last time statistics were reset. |
Read-Only |
|
Scheduler.ScanOverrunsConsecCnt |
The number of consecutive scan overruns. This value increments by 1 when a scan overrun occurs. This value is set to 0 when the object goes offscan. |
Read-Only |
|
Scheduler.ScanTime |
The current, local, system time for a given scan of the AppEngine that contains this scheduler. The date format reflects the current locale setting for the operating system. For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.StatsReset |
Used to reset all statistics during run time. |
Supervisory, User |
|
Scheduler.TimeIdleAvg |
The average number of milliseconds per scan period that the object is idle (for example, receiving data, or sending data). For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.TimeIdleMax |
The maximum value for the TimeIdleAvg attribute since statistics were reset or since the engine went onscan. For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.TimeIdleMin |
The minimum value for the TimeIdleAvg attribute since statistics were reset or since the engine went onscan. For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.TimeInputAvg |
The average number of milliseconds required to process input messages per scan period. For extra quality information, see About object quality handling. |
Read-Only |
|
Scheduler.TimeOutputAvg |
The average number of milliseconds required to process output messages per scan period. For extra quality information, see About object quality handling. |
Read-Only |