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


Searches for the first occurrence of an alarm tag, name, and description. If calling this function from a remote client, use the MsgRPC() function.

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.

Note: Record numbers obtained from AlarmGetDsp are not valid for this function.

This function returns an alarm record identifier that you can use in other alarm functions, for example, to acknowledge, disable, or enable the alarm, or to get field data on that alarm.

Note: This function will return a match for an Acknowledge Off alarm with [Alarm]AckHold=1 even after it has been cleared using AlarmClear or AlarmClearRec.


AlarmFirstTagRec(Tag, Name, Description [, ClusterName] )


The alarm tag to be matched. Specify an empty string (" ") to match all alarm tags.


The alarm name to be matched. Specify an empty string (" ") to match all alarm names.


The alarm description to be matched. Specify an empty string (" ") to match all alarm descriptions.


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 alarm record identifier or -1 if no match is found.

Related Functions

AlarmNextTagRec, AlarmGetFieldRec, AlarmAckRec, AlarmDisableRec, AlarmEnableRec, AlarmGetThresholdRec, AlarmSetThresholdRec, MsgRPC


See AlarmDisableRec

See Also

Alarm Functions