SET_ALARM(1) General Commands Manual SET_ALARM(1)
set_alarm, get_alarm, ring_alarm - SunView programmable alarms
set_alarm [ -b number ] [ -f number ] [ -d duration ]
This command is available with the SunView User's software installation
option. Refer to for more information on how to install optional soft-
set_alarm sets the WINDOW_ALARM environment variable according to the
get_alarm returns the setting of WINDOW_ALARM in the form:
ring_alarm performs the actual beeping and flashing of the alarm.
Note: the occurrence of the alarm is controlled by the SunView/Visi-
ble_Bell and SunView/Audible_Bell settings in defaultsedit(1). If
either of these is disabled, the respective feature of the alarm will
not occur, regardless of how it is specified by WINDOW_ALARM.
In the C shell, set_alarm echoes the following command to set the WIN-
DOW_ALARM environment variable:
set noglob;setenv WINDOW_ALARM setting;unset noglob;
In the Bourne shell, set_alarm echos the following:
Consequently, set_alarm is should be used as follows:
eval `set_alarm [options]`
-b number Specify the number of beeps. The default is 1.
-f number Specify the number of flashes. The default is 1.
-d duration Specify the duration of the beep in milliseconds. The
default is 1000.
The SunView programmable alarms use the WINDOW_ALARM environment vari-
able to define the characteristics of the alarm. The variable is set
with a string argument of the following form:
csh(1), defaultsedit(1), sh(1)
get_alarm: the WINDOW_ALARM environment variable is NULL.
This message is self-explanatory.
ring_alarm: WINDOW_ALARM is NULL; using default values.
set_alarm was not used to set values for the WINDOW_ALARM envi-
ronment variable. See OPTIONS for default values.
ring_alarm: WINDOW_ME not found
Attempted to ring the alarm when SunView is not running.
BUGS and LIMITATIONS
The user must be running SunView in order to ring the alarm; conse-
quently, the alarms cannot be used with Open Windows.
30 September 1989 SET_ALARM(1)