AlarmSumLast

Cicode Programming Reference > Cicode Function Categories > Alarm Functions Introduction > AlarmSumLast

AlarmSumLast

This command is deprecated in this version of CitectSCADA. Use the AlmSummaryLast command instead.

Gets the index of the most recent alarm summary entry. You can use this index in the AlarmSumGet() function to get field data from an alarm record, in the AlarmSumSet() function to change the existing data in that record, or in the AlarmSumDelete() function to delete the record.

To work with a series of alarm summary records, call this function to get the index, and then call AlarmSumPrev() within a loop, to move backwards in the alarm summary.

This function can only be used if the Alarm Server is on the current machine. When the Alarm Server is not in the calling process, this function will become blocking and cannot be called from a foreground task. In this case, the return value will be undefined and a Cicode hardware alarm will be raised.

Syntax

AlarmSumLast( [ClusterName] )

ClusterName:

Specifies the name of the cluster in which the Alarm Server resides. This is optional if you have one cluster or are resolving the alarm server via the current cluster context. The argument is enclosed in quotation marks "".

Return Value

The index of the most recent alarm summary entry, or -1 if no alarm summary entry is found.

Related Functions

AlarmSumGet, AlarmSumSet, AlarmSumDelete, AlarmSumPrev, AlarmSumFirst, AlarmSumNext

Example

/* This function finds all alarm summary entries that match the 
specified tag and sets the "OffTime" to the time specified. The 
alarm entry is not acknowledged or set to the off state, the alarm 
summary "OffTime" field is all that is affected. */

FUNCTION

SumSetTime(STRING sTag, INT Time)

	INT Index;

	STRING Name;

	Index=AlarmSumLast();

	WHILE Index<>-1 DO

		Name=AlarmSumGet(Index,"Tag");

		IF Name=sTag THEN

			AlarmSumSet(Index,"OffTime",Time);

		END

		Index=AlarmSumPrev(Index);

	END

END