../pvss.htm menu.gif basics.gif

getACount()

Returns the internal number of an alarm (count starts at 0) at a particular time.

Synopsis

int getACount( atime AlertTime );

Parameters

    Parameters

    Meaning

    AlertTime

    Time of the alarm

Return value

The function returns the number of the alarm (count starts at 0) or in the event of an error, -1.

Errors

In the event of an error, does not set an error class list.

Description

Returns the number of an internal alert at a time AlertTime in context with dpQuery(ALERT) (if there is an occasion with more than one alert of a data point element).

IconExample

AcknowledgeDpe(string dpe)

{

   int range;

   time t;

   atime At;

   

  // get range of the alert   

  dpGet(dpe+":_alert_hdl.._act_range", range);

   

  // get time of the alert  

  dpGet(dpe+":_online..stime", t);

 

  // make time to be of type "atime"

  At= makeATime(t, 0, dpe);

 

  //make sure acknowledging is needed

  if (range != 0)

    // single-acknowledge alert

    alertSet(t, getACount(At), dpe+":_alert_hdl."+range+"._ack_state", DPATTR_ACKTYPE_SINGLE);       

}  

Member of

Data point functions

Availability

UI, CTRL, DP

See also

SetACount(), getLastError()

Top Of Page

 

V 3.11 SP1

Copyright ETM professional control GmbH 2013 All Rights Reserved