Understand Drag Reducing Agent (DRA) alarms and events
- Last UpdatedApr 24, 2025
- 6 minute read
The following table provides the cross-reference details for the Drag Reducing Agent alarm severity configuration.
Note: The messages noted in the table are designated as either alarms that generate identical events or simple events. In all cases, you can customize the message text and, where applicable, adjust the alarm severity. To update an alarm/event message, refer to the msgInfo table row for the alarm/event message identifier of interest. For more information on configuration using the msgInfo table, refer to Volume 1 of the RealTime Administrator documentation.
|
Alarm/Event |
Alarm/Event Message Configuration |
Alarm Severity Configuration |
Type |
|---|---|---|---|
|
DRA Injection point {PointName} Automatically sending command {shutDownCommand} |
DRA_INJ_AUTO_SEND_CMD Issued when Automatic DRA Shutdown is enabled and a violation is detected. Usually accompanied by another alarm describing the violation. |
DRA_INJ_AUTO_SEND_CMD |
Alarm & Event |
|
Startup DRA Injection Failure:{failure message} |
DRA_STARTUP_FAILURE Issued when when the DRA underlying status point fails to start. |
DRA_STARTUP_FAILURE |
Alarm & Event |
|
Shutdown DRA Injection Failure:{failure message} |
DRA_SHUTDOWN_FAILURE Issued when the DRA underlying status point fails to shutdown. |
DRA_SHUTDOWN_FAILURE |
Alarm & Event |
|
DRA Injection point {PointName} shutdown failure after three attempts |
DRA_SHUTDOWN_FAILURE_THREE_ATMPS If you have enabled the DRA Automatic Shutdown feature, three attempts to shut down the DRA Injection point are made. After three unsuccessful attempts at shutting the injector down, this alarm is issued. |
DRA_SHUTDOWN_FAILURE_THREE_ATMPS |
Alarm & Event |
|
DRA rate issued to analog point by setpoint command unsuccessful. View log for details. |
DRA_SETPOINT_CMD_UNSCSFL The DRA Injector application attempted to send a setpoint to an analog point, and the command failed. To determine the reason for the failure, consult the error logs for the system. |
DRA_SETPOINT_CMD_UNSCSFL |
Alarm & Event |
|
DRA is disabled by {username} |
DRA_DISABLED_BY_USER Alarm generated when the DRA Injector is disabled by an Administrator or Controller. |
Base Message |
Alarm & Event |
|
DRA is enabled by {username} |
DRA_ENABLED_BY_USER A return-to-normal alarm generated when the DRA injector is re-enabled by an Administrator or Controller. |
N/A |
Alarm & Event |
|
DRA Injection point {PointName} shutdown failure is cleared |
DRA_SHUTDOWN_FAILURE_CLEARED A return-to-normal alarm generated when the shutdown failure is cleared. |
DRA_SHUTDOWN_FAILURE_CLEARED |
Alarm & Event |
|
DRA Injection Point '{PointName}' startup failure after three attempts |
DRA_STARTUP_FAILURE_THREE_ATMPS Issued when the DRA Injector has enabled Automatic mode. After three unsuccessful attempts at starting the injector, this alarm is issued. |
DRA_STARTUP_FAILURE_THREE_ATMPS |
Alarm & Event |
|
An invalid DRA line configuration was encountered during RealTime validation. Please see the error log for details. |
DRA_MON_SP_LOOKUP_OPER_VALIDATION Issued when the existing configuration for Setpoint Lookup has not passed validation. Consult the system error logs and correct the errors to make Setpoint Lookup functional again. |
DRA_MON_SP_LOOKUP_OPER_VALIDATION |
Alarm & Event |
|
The new DRA configuration for the DRA line: '{DRA LINE}' has changed the flow rate ranges. Please select a new flow rate range for each DRA line or group. |
DRA_LINEMANAGER_RESET_FLOW_RATE_RANGE Issued when the new configuration for Setpoint Lookup has caused the flow rate range selection to reset. The Controller must select a new flow rate range for each DRA line or group before Setpoint Lookup will resume evaluating. |
DRA_LINEMANAGER_RESET_FLOW_RATE_RANGE |
Alarm & Event |
|
DRA incompatible products '{product name}' found in Upstream Zone. |
DRA_UPSTREAM_PRODUCT_INCOMPATIBLE Issued when a product violation occurs, that a Batch Transfer feeding into the injector has some Drag Reducing Agent (DRA)-incompatible product within the configured upstream volume zone of this injector. |
Base Message |
Alarm & Event |
|
The validation passed for a new DRA line configuration on DRA line: '{DRA LINE}'. |
DRA_LINE_VALIDATION_PASSED Issued when a new set of configuration for Setpoint Lookup has passed validation. No action is required. |
N/A |
Event |
|
Current flowrate '{CURRENT FLOW RATE}' at DRA location is less than minimum flowrate '{MINIMUM FLOW RATE}'. |
DRA_FLOW_RATE_LESS_THAN_MINIMUM Issued when the flow rate summation of all the rates flowing past the Injector is less than the configured minimum threshold. |
Base Message |
Alarm & Event |
|
Violation state '{VIOLATION STATE}' detected by violation detector. |
DRA_IN_VIOLATION_STATE Issued when the status or multistate configured for additional violation checking enters a configured violation state. |
Base Message |
Alarm & Event |
|
The validation for the DRA configuration of the DRA line: "{DRA LINE}" was not successful. Please see the error log for details. |
DRA_LINE_VALIDATION_UNSUCCESSFUL Issued when a new set of configuration for Setpoint Lookup has not passed validation. The system error logs should be consulted to determine and correct the errors before attempting to load the new configuration again. |
N/A |
Event |
|
Density is within density range of prohibited products '{PROHIBITED PRODUCTS}'. |
DRA_DENSITY_WITHIN_PROHIBITED_RANGE Issued when the densitometer detects a density that is within a the max/min density range of a known DRA-incompatible product. |
Base Message |
Alarm & Event |
|
DRA violation conditions are cleared. DRA is allowed to be started. |
DRA_VIOLATION_CLEAR Issued when all violation conditions have cleared for an injector that was previously in violation. |
N/A |
Alarm & Event |
|
DRA Injection point '{INJECTOR_NAME}' automatically sending command '{STARTUP_COMMAND}'. |
DRA_INJ_AUTO_SEND_CMD Issued when the DRA Injector is in Automatic mode and an attempt has been made to start up the DRA pump based on operational conditions. |
DRA_INJ_AUTO_SEND_CMD |
Alarm & Event |
|
Automatic Mode enabled. |
DRA_CORE_REP_AUTOMATIC_MODE_ENABLED Issued when you enable the automatic mode of a DRA Line or a DRA Group. |
N/A |
Event |
|
Automatic Mode disabled. |
DRA_CORE_REP_AUTOMATIC_MODE_DISABLED Issued when you disable the automatic mode of a DRA Line or a DRA Group. |
N/A |
Event |
|
DRA rate '0' is issued to analog point '{ANALOG}' by setpoint command. |
DRA_RATE_SETPOINT_CMD_ANALOG_TO_ZERO The DRA reset event is generated when the DRA Injection Analog point is reset to zero by setpoint command. |
N/A |
Event |
|
DRA rate setpoint command was not issued due to the update frequency. |
DRA_RATE_SETPOINT_CMD_UPDATE_FREQUENCY_PERIOD The DRA error event that is generated when the update frequency has passed while trying to update the DRA Injection Rate Analog point directly. |
N/A |
Event |
|
DRA rate '{rate value}' is issued to analog point '{analog name}' by setpoint command. |
DRA_RATE_SETPOINT_CMD_ANALOG_TO_RATE The DRA set event that is generated when the DRA Injection Rate Analog point is set directly by a value. |
N/A |
Event |
|
Exception thrown: {EXCEPTION MESSAGE}. |
DRA_RATE_SETPOINT_EXCEPTION_THROWN The DRA exception event that is generated when an exception is thrown while trying to send the set point command. |
N/A |
Event |
|
DRA product group set to '{PRODUCT GROUP}'. |
DRA_CORE_REP_PRODUCT_GROUP_SET The DRA set event that is generated when the DRA product group of the DRA injector group is set. |
N/A |
Event |
|
DRA flow rate range set to '{FLOW RATE}'. |
DRA_CORE_REP_FLOW_RATE_RANGE_SET The DRA set event that is generated when the DRA flow rate range of the DRA injector group is set. |
N/A |
Event |
|
Target Concentration is set to 0 PPM. |
DRA_CONCENTRATION_IS_ZERO Issued when the DRA injector's concentration is set to 0 Parts Per Million (PPM). |
Base Message |
Alarm & Event |
|
'{Source Product}' and no matching product. |
DRA_NO_MATCHING_PROD This is a partial text that supports other events that are generated by the system when the source product does not have a matching destination product. |
N/A |
Event |
|
'{Source Product}' and '{Destination Product}'. |
DRA_PRODUCT_NAMES This is a partial text that supports other events that are generated by the system when the source product and destination products do not match. |
N/A |
Event |
|
'{Source Product}' volumes {volume Deadband} and {Destination Product} exceed threshold. |
DRA_PRODUCT_VOL_THRESHOLD_EXCEED This is a partial text that supports other events that are generated by the system when the source and destination product volume deadband limits are exceeded. |
N/A |
Event |
|
The DRA Flow Rate sources for this injector are using deprecated configuration fields. They need to be updated to use the full path. See error logs for more details and contact the system administrator. |
DRA_INJ_DEPRECATED_FLOWRATE_SOURCE Issued when a DRAInjector is configured to use DRARate.flowRate.point instead of DRARate.flowRate.path for a flow rate when the Rate Management Method is calculated. |
DRA_INJ_DEPRECATED_FLOWRATE_SOURCE |
Alarm & Event |
|
Configuration error due to an invalid DRA Flow Rate source for this injector. See error logs for more details and contact the system administrator. |
DRA_INJ_INVALID_FLOWRATE_SOURCE Issued when a DRAInjector is configured to use a flow rate path that does not point to a valid numeric field when the Rate Management Method is calculated. |
DRA_INJ_INVALID_FLOWRATE_SOURCE |
Alarm & Event |
|
Configuration error has been resolved. |
DRA_INJ_FLOWRATE_SOURCE_RTN Issued when the flow rate for calculation configuration issues as indicated by DRA_INJ_DEPRECATED_FLOWRATE_SOURCE or DRA_INJ_INVALID_FLOWRATE_SOURCE have been resolved. |
DRA_INJ_FLOWRATE_SOURCE_RTN |
Alarm & Event |