Email alerts are available on both Windows and UNIX computers, but are configured differently for each.
On Windows computers, the License Manager calls the lsmail utility to send email alerts using SMTP.
In order 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 SentinelLM.
NOTE 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, the following options are available:
Email address of the person who will receive the alert message.
Text of the alert message.
Subject (if your email program accepts a subject argument).
If you are unable to send alerts using email due to any reason, you are required to debug lsmail.
To debug lsmail, create a batch file which returns "%Errorlevel%".
The contents of the batch file should be as follows:
lsmail -t "email@example.com" -m "This is a test mail" -s "Test" echo %Errorlevel%
The following table provides the list of error codes and their corresponding descriptions.
|Error #||Error Code||Error Description|
|0||ALL_SUCCESS||Email successfully sent|
|104||ERR_SMTP_NOT_CONFIGURED||SMTP server is not configured|
|116||ERR_SOCKET_INIT_FAILED||Failed to initialize the sockets|
SMTP connection has failed
|118||ERR_SENDMAIL_FAILED||Failed to send the email|
|119||ERR_INVALID_SENDER_NAME||Name of the sender is invalid|
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.
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.