Notify to mail is failing with XCOMN0988E error.

Document ID : KB000005315
Last Modified Date : 14/02/2018
Show Technical Document Details
Issue:

Trying to configure to notify userids by mail when a transfer completes but it fails with this error:  

XCOMN0988E Error sending notification, Check SMTP Server name, source or destination address

 

Environment:
XCOM r11.6 SP01 for Windows
Cause:

 

These are the parameters that need to be configured to send SMTP notifications: 

 

In xcom.glb: 

• MAIL_TYPE=SMTP 

• SMTP_SERVER=<ipaddrss or hostname of SMTP server> 

• MAIL_USERNAME parameter value will be used as sender to send SMTP notifications. 

 

In xcom.cnf: 

 

For Local Notification: 

• LCLNTFYL=ALL 

• NOTIFYL=MAIL 

• LOCAL_NOTIFY=<whom to notify> 

 

For Remote Notification: 

• RMTNTFYL=ALL 

• NOTIFYR=MAIL 

• NOTIFY_NAME=<whom to notify> 

 

The failure was due to the userid to be notified <whom to notify> not having the domain as part of the email address. 

NOTE : The SMTP server must  be within the internal organization, it will not work sending to an external service provider SMTP server (e.g. Yahoo / Google ) and the default port of 25 for XCOM must be used..  

 

 

Resolution:

To resolve this, either change the SMTP server to set up aliases for any userid that may be required to receive email notifications, or hardcode the value of the userid's email address in the xcomntfy.bat script, or code the script to add the domain portion. A group id containing multiple email addresses can be set up and used as the email address that is to be notified.

For example, to hardcode the value of the userid's email address in the xcomntfy.bat script, the following change is needed: 

 

Original section of the xcomntfy.bat:

:CHECK_MAIL_TYPE

if NOT /%mailtype%/ == /SMTP/ GOTO EXEC_MAPI

%xcomqm% -D%q_entryname% | %xcomsmtp% %q_entryname% %who% 

GOTO END

 

Change this to:

:CHECK_MAIL_TYPE

if NOT /%mailtype%/ == /SMTP/ GOTO EXEC_MAPI

%xcomqm% -D%q_entryname% | %xcomsmtp% %q_entryname% user.name@domain.name

GOTO END

 

NOTE:

If the value is hardcoded in the script, then XCOM will always send emails to this mail ID irrespective of what is specified in the transfer configuration parameters. If it is required to be able to send mails to different mail ids, then the script will need to be extended and modified to set the %WHO% value to the corresponding mail id based on the value from the transfer configuration parameters.  

 

 

  

 

Additional Information:

The following commands were used to help debug the problem

telnet <smtp server> 25

helo hi

mail from: <from_address>

rcpt to: <userid>

the errors received from telnet showed that the domain portion of the email address was required to be successful.