Skip to main content

Automatic Reply for a received FAX Message back to the sender of the FAX

Article # 3036221 - Page views: 238


Want to set up automatic replies for received FAX messages back to the sender of the fax.  


Configure a NULL-TUM channel:

This is done by starting the WCONFIG program with the command-line option –a, e.g.

"C:\MT\XXXXX(currentTCOSSversion)\WCONFIG.EXE c:\mt\myinst –a"

Within the 'HW/SW assignment' you have to select: 'NU NULL channel' the “slave” for this channel should be 1.0 (primary master)

Change following configlines within the NULL TUM channel:

Configline 2:


a new, unused channelgroup

Configline 6:

Autoreply channel FAX

comment within the line statistics

Configline 24:


automatic distribution for sending copies

Configline 41:


Default termination for sendorders created

Configline 42:

NU:Automatic Reply

Default originator for sendorders created

Create a Mask +MAIL5V/A+R

Remove any leading ---A4--- lines within the mask and select “No Cover” within the send options. The first 2 lines of the mask are fixed, beginning with line 3 the text can be customized. The mask should contain, anywhere after line 2, the Mask variable $N1370$.

++HEADER $O1070$;
This is the Autoreply message for a FAX message
The configurable text for the user is $N1370$

Create a service that uses this mask

The prefix of the service should go to the channelgroup of the NULL TUM channel configured in step 1.

Additionally the mask +R (created in step 3.) should be used and a send switch B which advises the NULL TUM channel to create sending copy files:

Service Name: AUTOREPLY
Service Type: Free format
Description: Autoreply for FAX messages
Abilities: Image, Text, restricted Text
Prefix: R:+RB

Create a distribution Directory +MAIL5V/AVV99

The important entry within the VV99 file is the 2nd line.

If there already is an existing +MAIL5V/AVV99, simply add the 2nd line to the existing VV99:

++HEADER \;,\

Create an in-event for the user, for whom an autoreply message should be sent to the originator:

The event can be auto-terminating or not, depending on the requirements of the customer.

Number: Any free text which should be user specific, e.g. the username, fax number,…


Example for the User MM:

Number: Max Muster

Extend the rr99 for routing international numbers based on the TSI received:


For example:

F:*43186353~, F:<I>~
F:*431~, F:~
F:*43~, F:0~
F:*~, F:00~

How does it work:

If an incoming FAX message is received, the sendorder is done to service FXI plus received DDI digits.

The originator of this inbound sendorder is of service FAX (configured in configline 42 of the FAX channel), appending the TSI of the sending machine, for example:

Originator of FAX Inbound sendorder: F:*43186353601

Then the normal FAX inbound routing is executed and the message is distributed to a user (based on the received subaddressing digits).

If the FAX message reaches the inbox of the user (lets assume inbox of user MM), the configured INEVENT using service AUTOREPLY is activated.

The originator of this event sendorder is the user for whom the event was defined, appending the original originator (which is the service FAX plus the received TSI of the sender FAX machine), so for the example above:

Originator of the Event sendorder: MM :F:*43186353601

The recipient of this event sendorder is built according to the definition within the event, so when resolving the service prefix for the service AUTOREPLY, the recipient of the event sendorder will be:

Recipient of the Event sendorder: R :+RBMax Muster

The channelgroup R is polled by the NULL TUM channel.

This sendorder is using the mask +R, where 2 mask variables are included:

$O1070$ will remove the MM:  part from the originator (see above)
$N1370$ will remove the R: +RB part from the recipient (see above)

So the message as it is received on the NULL TUM channel looks like:

++HEADER F:*43186353601;
This is the Autoreply message for a FAX message
The configurable text for the user is Max Muster

Because of using the NULL TUM Sendswitch B, the NULL TUM channel will create a sending copy document, which looks exactly the same as the message shown above (the sending copy is an exact copy of the message as it is received on the NULL TUM channel). The filename of this sending copy document is


Because of configuring configline 24 of the NULL TUM channel to value 2, there will be automatic distribution of this generated sending copy document. This means TCOSS will search the VV99 table for matching entries and will generate a sendorder, if it finds a matching entry.

In our case, TCOSS will find a match with the 2nd line of the VV99 table.

This 2nd line of the VV99 table uses a search string with variables, which is marked within the VV99 entry with a backslash character:

++HEADER \;,\

So TCOSS searches through the content of the sending copy document, if it finds a string, which starts with ++HEADER (do not forget the blank after ++HEADER) and ends with a semicolon character. The string parts placed in between these “begin-” and “end-mark” is represented by the backslash character:

++HEADER F:*43186353601 ;

Similar as in the rr99, the backslash character can be used on the right side of the VV99 entry, where the sendorder for this match is defined.

The comma after the semicolon character is the separator between searchstring and sendorder definition, so in our case TCOSS will create a sendorder for the sending copy document going to:

F: *43186353601

which is in fact the originator of the original FAX inbound sendorder. The originator for this sending copy sendorder is taken from configline 42 of the NULL TUM channel The termination of this sending copy sendorder is taken from configline 41 of the NULL TUM channel.

Recipient of sending copy sendorder: F:*43186353601

Because of the **ROUTE entries within the rr99 file it is ensured that the “international” number format, as it is used within the TSI is routed to a local number, in our case F:<I601>

Originator of sending copy sendorder: NU:Automatic Reply

Message content of the sending copy sendorder:

++HEADER F:*43186353601;
This is the Autoreply message for a FAX message
The configurable text for the user is Max Muster

This is where an undocumented feature of the FAX module shows its face.

The FAX module, which processes this sendorder skips the ++HEADER and the ++BODY line, so in fact the message really received on the FAX machine consists only of line 3 and 4:

This is the Autoreply message for a FAX message
The configurable text for the user is Max Muster


Note:   If you need more than text for your Autoreply messages, KCS does offer a product - TC/BIA that will provide a customizable coversheet w/ image and text.  It does require customization and a special license.   For more information, please contact you KCS support personnel.

Level of Complexity 



Applies to  

Product Version Build Environment Hardware
Kofax Communication Server All      



Keywords: FAXAutoreply, auto, reply, automatic



Article # 3036221
  • Was this article helpful?