Panel Name |
fwAlertConfig.pnl |
|||||||||||||||
Introduction |
This panel is used to set up the alert configuration for one or many data point elements. If the panel is used for just one data point element at a time, the panel shows the current configuration of the alert config when loaded. |
|||||||||||||||
Instructions | When configuring the alert for a data point element (or elements) you should first check the "Configure" check box. Then the alert options will appear. For analog style alerts, you should first select the number of ranges you wish to have in your alert handling. Then for each range you should enter a description text in the left hand column and choose an alert class from the drop down lists in the right hand column. The alert classes define the severity of the alert and come in acknowledgeable (ending with Ack) and non-acknowledgeable (ending with Nack) types. Between each range you need to choose a limit value. The limit values should be entered in descending order as you go down the panel (see the figure below). It is essential that one range has no alert class. This is the valid (good) range. The alert classes should increase in severity as you move further away from the valid range. The severity order is Warning -> Error -> Fatal (lowest to highest). So, for example, if the range above the valid range has an Error class (e.g. fwErrorAck) then the range above that can not have a Warning class (e.g. fwWarningAck). An example of a valid analog alert configuration is shown below. In addition to setting absolute limit values, it is also possible to set limit values relative to the current value of the data point element. This option is available from the drop down list in the top right of the panel. It is possible to specify limits which are the current value + or - a fixed number, or + or - a percentage of the current value. For example you could set the limits on a dpe whose value is 50 to +5 and -5 which would equate to actual limits of 45 and 55, or using the percentage mode you could specify +10% and -10% which in this case would give the same result. For digital style alert, you need to enter a text for each state of the boolean value (0 and 1) in the left hand column and choose an alert class for the bad state from the combo box in the right hand column. An alert class must be chosen - it can not be left blank. Then, by using the radio buttons in the middle column, you indicate whether 0 or 1 is the valid (good) state. An example of a valid digital alert configuration is shown below. For discrete, select the type "Discrete values match". Each range has a value to match. The value can be a single number (i.e. "3"), a set of numbers (i.e. "3,4,7") and/or a range (i.e. "3-6"). The first range is always the good range and corresponds to any value not included in the other ranges. Finally, if you want the alert configuration to be active, make sure that the "Alert Handling ON" checkbox is checked. If you uncheck this, then the alert configuration will be stored but the alert handling will not be active. Then press OK or Apply to save the configuration. The alert class is divided into two groups: Local and Global. If necessary, the following convention can be used. Local can be alarms belonging to a local system (i.e. detector channels). Global can be alarms belonging to common infrastructure (i.e. primary electricity for the experiment). The available class elements are the following:
To delete the alert configuration on the data point element(s), uncheck the "Configure" check box and then press either OK or Apply. |
|||||||||||||||
Restrictions | This panel is only for configuring analog and digital style alerts. Summary alerts are configured with another framework panel. Integer, unsigned and float data point elements support analog alerts and boolean data point elements support digital alerts. If you load the panel for a collection of data point elements, the
panel will not allow you to configure them if they contain a mixture
of elements that require digital and analog alerts. You can press the
"Select Elements" buttons to choose which data point elements to configure
from the list that was passed to the panel. |
![]() |
![]() |
Dollar Parameters | ||
Name | Description | |
$sDpe | The name of the data point element(s) to configure. If you wish to use the panel for multiple data point elements, you
should pass a list in the same format as the PVSS dyn_string, i.e.dpe1
| dpe2 | dpe3 |
Required |
$bHierarchyBrowser | Controls the position and visibility of the OK, Apply and Cancel buttons. TRUE - Shows Apply button only. |
Required |
$sSummaryDpe | The data point element that has a summary alert in which you wish to add the newly configured alert. If not needed, this should be set to "". If used, $sSummaryDpe can be either an absolute data point element name, or a relative path for the data point on which the alert config is being configured. For example, to add a reference to the configured alert in the root element of the same data point, this $ parameter should be set to ".". | Required |