Also suggest checking out nas guide, it has appending detailing all (well at least most) nas functions. Here's an excerpt from it to help with Keith's good suggestion:
alarm.list ( [Field, Value [, Value…]] )
Returns an array of table elements containing alarm data. Will, if used with the field and value(s) parameters, filter the result set according to the user criteria. Use the column name for your field and one or more match strings. The % is used as the wildcard character. E.g alarm.list ("hostname","%xp%") returns alarms for all hostnames with ’xp’ in them. These records are extracted from the NAS_ALARMS table.
You might also use alarm.query
-jon