# OS_SetVAlarmTag

## C Specification

      #include <nitro/os.h>

      void OS_SetVAlarmTag( OSVAlarm* alarm, u32 tag );

## 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.

## Arguments

`alarm` | Pointer to the V-Count alarm structure that sets the tag
`tag` | The tag that is set

## Return Values

None

## See Also

`OS_InitVAlarm, OS_CancelVAlarms`

## Revision History

02/24/2004 Initial Version