Action: Ifnotfixed(target, alarm ID, delay)

Related Actions: timer, randomtimer, lettimer, iffixed, ifmapped, ifmoved, ifnotmapped, ifnotmoved, exitevent
Related Events: alarm
See also: FKiSS, Events, Actions

ifnotfixed(target, alarm ID, delay)

First defined in: FKiSS2.1
If the fix value for the object specified by target is zero, the ifnotfixed action sets the timer for an alarm. If a timer for that alarm is already counting down, the new delay time will replace it, resetting the alarm's timer.
Setting delay to zero will cancel the timer for that alarm, preventing the alarm from being activated.

target

In FKiSS2.1 to FKiSS3, target must be an object number.
In FKiSS4, target may be an object number or a variable representing an object number.

alarm ID

In FKiSS2.1, alarm ID must be an alarm ID number.
In FKiSS3, alarm ID may be an alarm ID number or a variable representing an alarm ID number.
In FKiSS4, alarm ID may also be a symbolic name representing an alarm or a variable representing an alarm ID number.

delay

In FKiSS2.1, delay must be a number representing the delay time in milliseconds.
In FKiSS3, delay may also be a variable representing the delay time in milliseconds.

Example:

;@ ifnotfixed(#5, 10, 1000)              ; If the fixed value for object 5 is zero, set alarm 10 to 1000 milliseconds.
;@ ifnotfixed(VarObj, MyAlarm, VarDelay) ; If the fixed value for object identified by VarObj is zero, set alarm MyAlarm to VarDelay milliseconds.