getACount()

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

Synopsis

int getACount( atime AlertTime );

Parameters

Parameter Description
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.

Error

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).

Example

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); 
}

Assignment

Data point functions

Availability

CTRL