name.alarm

When you define an alarm, you create an individual file for each alarm. Alarms are stored in the directory JS_TOP/work/alarms. Each alarm is in a separate file named alarm_name.alarm. The file name and its contents are case-sensitive. Each alarm can either notify one or more email addresses, or execute a script. To enable the alarm, reload the alarm list using the command jreconfigalarm.

Format

  • Email notification

    NOTIFICATION=Email[user_name ...]

    Specify the "Email" command, followed by a space-delimited list of email addresses to notify regarding the exception. Specify the complete email address, or just the user name if JS_MAILHOST was defined in js.conf. For example:

    NOTIFICATION=Email[bsmith ajones]

    You must specify a valid notification statement with at least one email address, or the alarm is not valid.

  • Script execution

    NOTIFICATION=CMD[/file_path/script_file user_variable ...]

    Specify the "CMD" command, followed by the path to the script file and any user variables (such as the error code). For example:

    NOTIFICATION=CMD[/home/admin/pageadmin.sh #{ERRORCODE}]

    Variable values cannot contain the backquote character (‘).

Example

The following example shows a database failure alarm definition. The alarm is called DBMSfail.alarm. Its contents are:

DESCRIPTION=Send DBA a message indicating DBMS failure
NOTIFICATION=Email[bsmith ajones]