Alarms as system failures

Generating a report on alarms as system failures

In Monitoring PSIM, you can generate a report on alarms as failures (see System failures) by specifying the beginning of the alarm, its ending, and its duration. For this, the alarms must have starting and finishing events. To generate such a report on alarms as failures, do the following:

1. On the Control Agent side, add the interception of starting and finishing events. The format of the message must strictly correspond to the following template: <Event name> [<id> ] - <name>, where instead of the <id>, specify the object number, and instead of the <name>, the object name. 
   Example of a "starting" event.
   
   Example of a "finishing" event.
   
   As a result, there is a list of two events.
   
   

   Note

   On the Control Server side, these alarms are registered as short-term.

2. On the Control Server side, create the Monitoring reports interface object.
3. On the toolbar of the Monitoring reports object, click the System failures button.
   The corresponding configuration form appears, in which you must:
   1. Set the Alarms as failures checkbox.
      
   2. Click the button to open the Alarm list window.
   3. In the Alarm list window:
      1. Click the button to add an entry.
      2. In the Failure name field, specify the name of the failure, as it must appear in the failure report.
         
      3. In the Starting event line, specify the name of the starting event in full accordance with the template, as in step 1.
      4. In the Finishing event line, specify the name of the finishing event in full accordance with the template, as in step 1.
      5. Set the Remove from Alarm report checkbox to prevent displaying the starting and finishing events when generating the "Alarm" report.
      6. Add an entry by clicking the button.
         

         Note

         The button to add an entry appears only if you fill in all the data, and the description of the starting and finishing events contains the [<id>] - <name> template. Further, you can edit or remove the created entry.

         As a result, the new entry is added to the alarm list.
         
      7. Repeat steps i-vi for all alarms.
         

         Note

         When you add the following entry, don't duplicate the values of the edited fields. If you try to enter a duplicate, the error message appears.
         

      8. Generate a report.
         Example of an alarm report.
         
         Example of a report on failures with the Alarms as failures checkbox set.
         
         If you set the Remove from Alarm report checkbox in the Alarm list window, the corresponding events aren't included in the alarm report.
         
         

Generating a report on alarms as system failures is complete.

Features of generating a report on alarms as system failures

When you clear the Alarms as failures checkbox, the Failure type list displays standard failures.

When you set the Alarms as failures checkbox, the Failure type list displays failures described in the Alarm list window.

You can generate a report for all failures (Failure type=all failures) or several ones (in the Failure type field, select specific failure).

Example of a script for a timer with number 1, which triggers once a day

If the starting event is lost, the Alarms as failures incorrect report is created. To avoid this, we recommend using scripts on the Control Agent side to generate, for example, a starting or finishing event once a day, depending on the object's current state. For more details on how to create scripts, see Guide for creating scripts (programming).
Example of a script for a timer with number 1, which triggers once a day.

if (Event.SourceType=="TIMER" && Event.SourceId=="1" && Event.Action=="TRIGGER")
{
  var msg = CreateMsg();
  msg.StringToMsg(GetObjectIds("CAM"));
  var count = msg.GetParam("id.count");
  var i;
  for(i = 0; i < count; i++)
  {
    if(GetObjectState("CAM", msg.GetParam("id." + i))=="DISARMED")
    {
      NotifyEventStr("CAM",msg.GetParam("id." + i),"DISARM","");
    }
    else
    {
      NotifyEventStr("CAM",msg.GetParam("id." + i),"ARM","");
    } 
  }
}