Skip to main content
Kofax

Change originator FAX service on incoming Faxes to EXCHANGE

Summary

3582

Description

BE AWARE:

Changes to the MAPFILE can have a severe impact on the functionality of the Link. Always create a backup of the MAPFILE in case something goes not the way it was expected. Also be aware that MAPFILE changes are not effective if you update the Link Package afterwards, as the modified MAPFILE will get overwritten by the new one shipped with the new package.

This change only applies to TC/LP v2.34.00.

TCOSS matches the originator service with a kind of "best match" for the prefix, meaning if you have an incoming fax with prefix F:, it searches for a matching service for that prefix. This means, it searches the service list from the top down and the first matching service will be taken. This was tested with a service called ASDFAX, so this matched and it worked for our tests. In additional tests with GDFNFAX it didn't work.

So basically, the only practical way to achieve a change of the originator service, is to make a MAPFILE change. In addition you need to set the correct service in the registry key "HKLM\Software\TOPCALL\TCLINKMX7\TOPCALL\FaxService" and you also need the service to be present on TCOSS. In addition, you have to install a modified mapfile, which is attached below.

Steps:

  1. Create a new FAX service inside TCOSS (in your example "GDFNFAX" with the same settings as the normal/default FAX service)
  2. Change the registry key HKLM\Software\TOPCALL\TCLINKMX7\TOPCALL\FaxService to "GDFNFAX"
  3. Change the MAPFILE

For comparison, I will point out the changes done in the mapfile:

Original Mapfile section "TO_MAIL_ORIG:"

TO_MAIL_ORIG --------------------------------
ENTRY ----- ignore inactive address *
*
SMTP
SET_FREE_ADDRESS
COMPAREINT
NEQU SRC.INT_ADDR_ACTIVE 1
REMOVETHIS
ENTRY ----- internet syntax *
*
SMTP SET_FREE_ADDRESS
COMPARESTRING
EQU REG.Exchange\SMTPSyntaxToMail 1
VALID_SMTP EXCHANGE SRC.TS_NUMBER
COPYAPPEND DST.TS_FREE_ADDR
"
SRC.TS_NUMBER
"
@
SRC.TS_SERVICE
. REG.TCLSM\SMLinkDomain
ONLYTHIS

Modified Mapfile:

TO_MAIL_ORIG --------------------------------
ENTRY ----- ignore inactive address
*
*
SMTP
SET_FREE_ADDRESS
COMPAREINT
NEQU
SRC.INT_ADDR_ACTIVE
1
REMOVETHIS
ENTRY ----- internet syntax FAX <---------- THIS IS THE NEW ENTRY
*
*
SMTP
SET_FREE_ADDRESS
COMPARESTRING
EQU
REG.Exchange\SMTPSyntaxToMail
1
COMPARESTRING
IEQU
SRC.TS_SERVICE
"FAX"
COPYAPPEND
SRC.TS_SERVICE
REG.TOPCALL\FaxService
VALID_SMTP
EXCHANGE
SRC.TS_NUMBER
COPYAPPEND
DST.TS_FREE_ADDR
"
SRC.TS_NUMBER
"
@
SRC.TS_SERVICE
.
REG.TCLSM\SMLinkDomain
ONLYTHIS
ENTRY ----- internet syntax
*
*
SMTP SET_FREE_ADDRESS
COMPARESTRING
EQU
REG.Exchange\SMTPSyntaxToMail
1
VALID_SMTP
EXCHANGE
SRC.TS_NUMBER
COPYAPPEND
DST.TS_FREE_ADDR
"
SRC.TS_NUMBER
"
@
SRC.TS_SERVICE
. REG.TCLSM\SMLinkDomain
ONLYTHIS

Result:

Assuming that you have a service FAX and a service GDFNFAX configured in KCS.

The registry value HKLM\Software\TOPCALL\TCLINKMX7\TOPCALL\FaxService is set to "GDFNFAX"

  • With the original Map file inbound FAX messages to Exchange are received with the originator address: 123456789@FAX.kcs.com
  • After applying the modification in the Map file as explained above, the messages are received in Exchange with the originator address:
    123456789@GDFNFAX.kcs.com

Applies to

  • TCLP 2.34.00 (KCS 8.2) only

Keywords: EXCHANGE, FAX, originatorMAPFILE

  • Was this article helpful?