Modify the Notification Script

Contents
xdtw1161
 
 
The XCOMNTFY script is used, when notification is requested, to notify users that a transfer has completed successfully. System administrators can modify this script to customize notification procedures, if necessary. For any other post-processing modifications, we recommend that you use XCOMPP.
XCOMNTFY
XCOMNTFY uses one of the following programs to read the queue entry to determine the user ID and password to send an email:
  • xcommail to use the MAPI (Messaging Application Programming Interface)
  • xcomsmtp to use the SMTP interface
Notification is done using the notify script, which is defined to 
CA XCOM Data Transport
 for Windows in the XNOTIFYCMD=%XCOM_HOME%\xcomntfy.bat global file.
You need to set up the notify script to use xcommail or xcomsmtp. A sample notify script is distributed with 
CA XCOM Data Transport
 (see Sample XCOMNTFY Script).
Requirements for SMTP Notifies
The following sections describe the requirements for addresses and related parameters for SMTP notifies.
From Addresses
This section describes the requirements for 
from 
addresses and related parameters for SMTP notifies (local and remote).
  • Local Notifies
    For an SMTP email 
    local 
    notify, 
    CA XCOM Data Transport
     checks the following parameters to use as the 
    from 
    address:
    • First, MAIL_USERNAME (in the global file or the configuration file)
    • Second, FILE_ACCESS_USERNAME (in the global file or the configuration file)
    • Third, local logged in user
    If none of these parameters has been specified, then the results are as follows:
    • No notify happens.
    •  
      CA XCOM Data Transport
       displays an error message.
    The following parameters must also be set:
  • Remote Notifies
    For an SMTP email 
    remote 
    notify, 
    CA XCOM Data Transport
     checks the following parameters to use as the 
    from 
    address:
    • First, MAIL_USERNAME (in the global file)
    • Second, the USERID of the remote user (in the configuration file)
    • Third, XCOM_USERID (in the global file)
    If none of these parameters has been specified, then the results are as follows:
    • No notify happens.
    •  
      CA XCOM Data Transport
       displays an error message.
    The following parameters must also be set:
To Addresses
This section describes the requirements for 
to 
addresses and related parameters for SMTP notifies (local and remote).
  • Local Notifies
    For an SMTP email 
    local 
    notify, 
    CA XCOM Data Transport
     uses the following parameter as the 
    to 
    address:
    • LOCAL_NOTIFY (in the configuration file)
    If this parameter has not been specified, then the results are as follows:
    • No notify happens.
    •  
      CA XCOM Data Transport
       displays an error message.
    The following parameters must also be set:
  • Remote Notifies
    For an SMTP email 
    remote 
    notify, 
    CA XCOM Data Transport
     uses the following parameter as the 
    to 
    address:
    • NOTIFY_NAME (in the configuration file)
    If this parameter has not been specified, then the results are as follows:
    • No notify happens.
    • CA XCOM Data Transport
       displays an error message.
    The following parameters must also be set:
Sample XCOMNTFY Script
The sample XCOMNTFY script, xcomntfy.bat, is installed during the installation of 
CA XCOM Data Transport
and can be found in your site’s installation directory.