The Pager Program
SCO Doctor supports the dialing of any remote device when an alert routine has detected a problem. In particular, the product fully supports pager systems that conform to the Pager Entry Terminal (PET) protocol, which is an industry standard for the remote entry of pager destined messages. This protocol is compatible with the IXO and TAP protocols.
To allow SCO Doctor to dial a remote device, you will need a modem attached to the computer on which SCO Doctor is installed. When running SCO Doctor for Networks, you need a modem on the remote system, as it is the remote agent (SCO Agent) that triggers an alert notice and dials the pager. This modem must be configured to the UUCP system for dial out use.
The pager program reads the /usr/lib/doctor/cf/pager.cf configuration file and the UUCP configuration files /usr/lib/uucp/Systems and /usr/lib/uucp/Devices.
For each pager there must be an entry in the pager.cf and in the System UUCP configuration files. The pager.cf file supplies information regarding the type of pager (number or message) and the number of the pager to dial. The UUCP System file defines the login procedure to use when connecting to the paging service. For number pagers the system entries will not contain a login chat script.
Switches:
-m Specifies the message to send to a message pager
-s Specifies the name of the pager. This must correspond to an entry in the UUCP Systems file and in the pager.cf file.
For example:
pager_smith {
pager = "pager -m \"$DATE $NAME $TITLE $MESSAGE \"
-s $PAGER";
send_script = '"" \
\002nnnnnnn\r$MESSAGE\rCC\r\003$CHECKSUM\r \
\006\r';
term_script = '"" \004\r \033\004\r';
}
The pager keyword specifies the name of the pager program to run, and the arguments to use with this program. The entry in the above example specifies the SCO pager program, which supports the PET protocol. However, you can specify the name of any program you like using this statement. For example, you can use one of your own programs to send a voice message to a mobile phone or to send a facsimile.The send_script specifies the PET protocol format of a message. You will need to change the string nnnnnnn to the number of your pager. This must be 7 digits. If your pager number is less than 7 digits, add leading 0s to make it 7 numbers long. You will also need to change the string CC which is the two digit city code of the required city. For example, the city of Brisbane, Australia has the code 07. Contact your pager service for this number.
Any configured pager, or list of pagers can be dialled when an alert routine has detected a problem and can be specified on a per alert basis. This is configured in the file
page = "";
in the default paragraph and has the same effect as putting this line in each and every alert in this file. You can either change this entry in the default paragraph, or, add an appropriate line to the alerts of your choosing. These new lines will override the value specified in the default paragraph.For example, if you require the pager pager_smith to be paged on each and every alert, change the page line in the default paragraph to:
page = "pager_smith";
If you only require this pager to be paged on a cpu alert, only add this line to the cpu paragraph.To notify multiple pagers, simply supply a list of pagers:
page = "pager_smith pager_jones";