Sending from SMTP to specific services in SMTP-Syntax

Issue

Your customer wants to use TC/Link-SM to send FAX messages using the same SMTP-Addressing syntax as used with TC/LINK-MX7:

Addressing Syntax: Fullname#Number@KCSService.mail-domain 
Addressing Example: KofaxAustria#123456@fax.kcs.com "kcs.com" is the configured SMLinkDomain
Message flow: Mailsystem -> TC/Link-SM -> TCOSS -> outgoing Fax

Solution

The standard addressing syntax for TC/Link-SM uses the format "[Fullname#][KCSService#]Number@mail- domain", where "mail-domain" is the SMLinkDomain configured in the registry of TC/LINK-SM. So the used KCS Service (in this example FAX) must be specified in the local part of the e-mail address. But the desired addressing format is to specify the KCS Service in the first part of the specified mail domain (xxxx@fax.kcs.com).

To include the service information into the "mail-domain" part of the SMTP address you can either:

1. Add a route for each service in the rr99 (see TC/LINK-SM manual chapter "Implement Different Recipient Addressing Syntax")
2. Or modify the map file, which will be explained in this article.

To use option 2. following steps must be done:

• the mail-domain (in our example "kcs.com") must be configured under registry value:
  HKLM\SOFTWARE\Topcall\TCLINKSM\TCLSM\SMLinkDomain
• the mail-domain and all subdomains (kcs.com and *.kcs.com) must be included under registry value:
  HKLM\SOFTWARE\Topcall\TCLINKSM\TCLSM\SMRouteDomains
• SMTP Routing must be principally enabled by setting registry value:
  HKLM/SOFTWARE\Topcall\TCLINKSM\TCLSM\SMRouteEnable=1
• The MAP-File: SMTP.MAP (configured under \TCLINKSM\General\MapFile) must be adapted according to the description below (red part):

TO_TC_ORIG ---------------
no changes
TO_TC_RECP -------------------------------------------
REM add the following before the first entry
ENTRY -------- SMTP
REM send to non-smtp services
*
SET_FREE_ADDRESS
*
SET_FREE_ADDRESS
REPLACE
SRC.TS_FREE_ADDR
"+"
"*"
ISOLATE_LOCALPART
SRC.TS_FREE_ADDR
VAR.1
VAR.2
COPYFMT
VAR.2
".!?"
VAR.3
VAR.4
COMPARESTRING
IEQU
REG.TCLSM\SMLinkDomain
VAR.4
COPYFMT
VAR.1
"#?!"
DST.TS_FULLNAME
VAR.6
COPYAPPEND
DST.TS_RECP_ID
VAR.6
SEARCH_ADDRTYPE
VAR.3
VAR.6
SEP=.
REM End send to non-smtp services
TO_MAIL_ORIG --------------------------------
no changes
TO_MAIL_RECP ----------------------------
no changes

The additional entry is also included in the attached file 'SMTP_Addon.MAP'.

Notes: Do not forget to make a comment at the beginning of the MAP-File that it is documented what/why this file is modified.

Level of Complexity 

Moderate

Applies to  

References

Map_file_example

​