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

See also

SetACount(), getLastError()