Creating a Custom Notification Script

You can implement your own notification method by creating a custom notification script. You must save the script in the $BBHOME/ext/pg directory on the BBPAGER server with the proper permissions (the Big Brother user must be able to run it).

You can create your own look for the notification message by using the following environment variables in your script:

Variable

Description

BBALPHAMSG

The text body

ACKCODE

The security associated with the notification

RCPT

The recipient name

BBHOSTNAME

The hostname in  host.name.com format

BBHOSTSVC

The host.name.com.service tag

BBHOSTSVCCOMMAS

The host name and service, with commas (,) replacing periods (.):  host,name,com.service

BBNUMERIC

A 22 or more digit number, in the format: XXXYYYYYYYYYYYYZZZZZZZ

  • XXX is the three-digit code for the service from the svcerrlist parameter in bbwarnsetup.cfg.

  • YYYYYYYYYYYY is the 12-digit IP address of the host.

  • ZZZZZZZ is the seven-digit security code. The first five digits are the event ID code; the last two digits are the user ID code for the recipient.

MACHIP

The 12-digit IP address of the host: AAABBBCCCDDD

BBSVCNAME

Name of the service of the event

BBSVCNUM

The three-digit code for the service from the svcerrlist parameter in bbwarnsetup.cfg

BBCOLORLEVEL

The color level causing the notification

RECOVERED

1 in recovery mode, anything else in non-recovery mode

DOWNSECSMSG

The default recovery message

DOWNSECS

The number of seconds to recovery

 

You define which recipients to use the custom script for in etc/bbwarnrules.cfg. For examples of custom scripts, please see ext/pg/ex1 and ext/pg/ex2.  

After you have created your own script, make sure the permissions allow only authorized users to modify it.