# OS_SetVAlarmTag

## C Specification

      #include <nitro/os.h>

      void OS_SetVAlarmTag( OSVAlarm* alarm, u32 tag );

## Arguments

alarm | Pointer to the V-Count alarm structure for which a tag is being set.
tag | The tag that is set.

## Return Values

None.

## Description

This function sets a tag for V-Count alarms. This is used when you use `OS_CancelVAlarms()` to cancel V-Count alarms belonging to a specified tag group.
Users cannot use the tag value "0" because it is reserved by the system.

## See Also

`OS_InitVAlarm, OS_CancelVAlarms`

## Revision History

02/24/2004 Initial version.