Open the Table of Contents

You are here: About the Sentinel RMS Utilities > Configuring Alerts Using E-mail

# Configuring Alerts Using E-mail

Email alerts are available on both Windows and UNIX computers, but are configured differently for each.

Configuring Email Alerts for Windows (lsmail)

On Windows computers, the License Manager calls thelsmail utility to send email alerts using SMTP. Here is how to use lsmail:

1. Set up the alert information section of the License Manager configuration file and use the EMAIL statement to enable email alerts.
   The file lsmail.exe should be in the directory in which the License Manager resides.
2. Run lsmail.exe. The first time it is run, it will ask for the SMTP server address (the mail server). The default port number used is 25 and the sender name is Sentinel RMS License Manager.

An anti-virus or such a program may block the SMTP port and then alert generation via e-mail will fail. Hence, make sure that SMTP is unblocked on the License Manager host.

3. lsmail will automatically be called by the License Manager to send email when the alert action specified in the License Manager configuration file occurs.

If you want to run lsmail manually, its options are:

Option | Description
--- | ---
-t recipient-name | Email address of the person who will receive the alert message.
-m message-text | Text of the alert message.
-s subject | Subject (if your email program accepts a subject argument).

To test lsmail, at the DOS prompt type (specifying your email address) say:

lsmail -t "user@company.com" -m "This is a test" -s "Test"

Configuring Email Alerts for UNIX

The mail sending program to use can be customized via the MAILPGM environment variable. If MAILPGM is not set, the first program found from the following locations will be used. Search the path in the License Manager’s start-up environment (PATH environment variable). Any command/shell aliases will be ignored.

- “/usr/bin/mailx”
- “/usr/ucb/mail”
- “/usr/bin/mail”
- “/bin/mail”

If no program is found via search or MAILPGM, the email mechanism will be off. The mail program will be invoked in a manner equivalent to:

MAILPGM email-recipient-list text-of-alert-message

No subject is provided.

If your mail program accepts a subject via the -s option, you could use:

MAILPGM= /usr/ucb/mail -s "Alert message"

to receive a subject for outgoing alert email.

The configuration file is read once per feature and version on the first addition of that feature (not necessarily at the License Manager start time), and the statements for that feature and version are cached. If you change the entries applicable to a feature, you should restart the License Manager.