MSGALARM (Message Alarm) keyword for display files

You use this file-level or record-level keyword to specify that the system is to sound the audible alarm when this record is displayed with an active ERRMSG, ERRMSGID, SFLMSG, or SFLMSGID keyword, or when a validity checking error is detected. The alarm is of short duration.

This keyword has no parameters.

If you specify the MSGALARM and ALARM keywords on the same record format and both are active, the alarm sounds only once.

Option indicators are valid with this keyword.

Example 1

The following example shows how to specify the MSGALARM keyword at record level.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A          R RCD1
00020A                                      MSGALARM
00030A            FLD01          8A    12 10
00040A  12                                  ERRMSGID(XYZ0123 MSGFILE)
     A

When record format RCD1 is on the display and RCD1 is put to the display again and indicator 12 is on, the message XYZ0123 from message file MSGFILE is displayed on the message line and the workstation alarm sounds.

Example 2

The following example shows how to specify the MSGALARM keyword at file level.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A  01                                  MSGALARM
00020A          R RCD1
00030A            FLD01          8A    12 10
00040A  12                                  ERRMSGID(XYZ0123 MSGFILE)
00050A
00060A          R RCD2
00070A            FLD02          8A    12 10
00080A  10                                  ERRMSG('Message text')
     A

When record format RCD1 is on the display and RCD1 is put to the display again and indicators 01 and 12 are on, the message XYZ0123 from message file MSGFILE is displayed on the message line, and the workstation alarm sounds.

When record format RCD2 is on the display and RCD2 is put to the display again and indicator 10 is on (but 01 is off), the message text is displayed on the message line and the alarm does NOT sound.