# OS_SetAlarmTag

## C Specification

      #include <nitro/os.h>

      void OS_SetAlarmTag( OSAlarm* alarm, u32 tag );

## Arguments

alarm | Pointer to the alarm structure that sets the tag
tag | The tag that is set

## Return Values

None.

## Description

Sets an alarm tag These alarm tags are used by `OS_CancelAlarms()` to cancel all of the alarms belonging to a specified tag group.
Users cannot use the tag value "0" because it is reserved by the system.

## See Also

`OS_InitAlarm, OS_CancelAlarms`

## Revision History

02/04/2004 Initial Version