Faximum TechNote #182

Faximum TechNote #182

(http://www.faximum.com/technotes/182)

TITLE:    #182 - Faximum support for DID and DDI

KEYWORDS: DID DDI ISDN telephone fax routing analog DNIS

RELEASE:  All 

CLASSIFICATION: All

PROBLEM:  The user wishes to use analog DID (Direct Inward Dialling)
	  trunks or ISDN digital trunks with DDI (Direct Dial Inward)
	  or DNIS (Dialled Number Identification Service) for the
	  automatic routing of received faxes.

	  DID/DDI/DNIS are services that enable a single phone line 
	  (sometimes called a trunk) to have more than one phone number.  
	  Whenever someone sends a fax to one of the many phone numbers 
	  associated with the DID/DDI/DNIS line, a special signal is sent
	  down the line to tell the fax server which number was dialled to
	  send this fax.

	  By associating different numbers with different users or
	  departments and by configuring Faximum appropriately, one
	  can have the appearance of multiple fax machines when, in fact,
	  all you have is a single DID/DDI/DNIS line with multiple
	  numbers.  And faxes can be routed directly to the intended 
	  person without any manual intervention. 

	  For example, you could arrange with your telephone company
	  to have a single DID trunk with the a range of numbers,
	  (say) 925-1901 through 925-1950. You could then configure your
	  Faximum Software product so that any fax that was sent to 925-1901
	  was delivered (say) to Jane, while faxes sent to 925-1950 would
	  be delivered (say) to John, etc. and etc.

	  Please contact your local telephone company for pricing information
	  on DID trunk(s) and on obtaining blocks of numbers for your DID
	  trunk(s).


CAUSE:    N/A
		

SOLUTION: All major Faximum software products (Faximum PLUS, Faximum 
          Client/Server and the Faximum Messaging Server products) support 
	  DID/DDI/DNIS but a special software package may be needed to add 
	  this capability to the shipping product (depending on the product
	  and release).  There is no charge for this package.

	  Contact Faximum Technical Support for information on how to
	  receive this software.


	  To support DID you will need to have a supported MultiTech modem
	  (see below) as well as a DID Trunk Interface to connect the modem 
	  to the DID trunk.  Faximum Software recommends Exacom (see
	  http://www.exacom.com) DID Trunk Interface devices and is an
	  Exacom reseller. For planning purposes one ought to budget
	  between $800 and $1000 per line for the DID interfacing hardware.

	  The purpose of the DID Trunk Interface is (a) to convert the
	  electrical characteristics of the DID trunk into the signals
	  expected by an analogue fax modem, and (b) to convert the
	  signalling information that indicates the DID number that
	  has been dialled from the method used on the DID trunk to
	  DTMF (a.k.a. "Touch Tone") signals that the MultiTech modem
	  can decode.


	  MultiTech Modems Supported for DID
	  ==================================

	  Model		Firmware Revision
	  -----		-----------------
	  1432BA,BL,BR	114 or later

	  1932ZDX	114 or later
	  1932BL	107 or later

	  2834ZDX	207c or later, 307c or later
	  2834BA,BL	209 or later
	  2834MR	109 or later

	  Contact Faximum for information on support for other makes and
	  models.
	  

	  To support ISDN DDI/DNIS you will need to have an appropriate
	  ISDN fax modem.  Faximum currently supports ZyXEL Elite 2864I
	  ISDN fax modem as well as the ISDN BRI and PRI fax boards from
	  Dialogic Gammalink.

	  Customers wishing to support ISDN PRI lines ought to contact
	  Faximum Software for information on supported fax boards.


	  Configuration - DID
	  ===================

	  To configure a fax line to handle DID you will need to make
	  the following changes to the fax line configuration file(s).

	  These files usually have names of the form fax-line-1. The
	  directory depends on the product and platform. See below:

	  Product       Platform   Directory
	  ------------- ---------- ----------------------------------
	  PLUS          SCO        /opt/faximum/dev
	  PLUS          AIX        /usr/faximum/dev
	  Client/Server HP-UX 10.x /etc/opt/faximum/dev
	  Client/Server Others     /opt/FAXserver/dev
	  FMS           All        /var/faximum/dev
	  ------------- ---------- ----------------------------------

	  Edit those files which apply to those modems connected to Exacom
	  interface boxes and change the  "modem-init-string" parameter so
	  that it includes the string "S0=0" (and not "S0=1").  This string
	  will include many other options, leave those as they are.

	  Also, change the parameter "class2-type" to read:
		  class2-type = multitech-did


	  Configuration - DDI/DNIS
	  ========================

	  No special software configuration is required to prepare the
	  Faximum Fax Server to handle the DDI/DNIS information on the
	  ISDN line.


	  Configuration - Fax Routing
	  ===========================

	  Then you will need to define the actions that will be taken 
	  when a fax is received on the DID line with a specific number.  
	  The specific approach will depend on the Faximum Server product
	  you are using.

	  Faximum Client/Server
	  ---------------------

	  It will be helpful to review the section in the on-line help 
	  on "Incoming Fax Routing" in the "Receiving a Fax" section.

	  To associate a specific Action with a certain DID number, 
	  select the "Incoming Fax Routing..." menu option in the 
	  "Admin" menu of the graphical user interfgace.  Then press 
	  the "Routing" button and select "DID Number Registration".  
	  
	  If you are using DID (as opposed to DDI/DNIS), note that only 
	  the last n digits of the number are entered (where n is set
	  by the telephone company and is usually three or four).

	  If you are using DDI/DNIS then the entire number is entered.


	  Faximum Messaging Server
	  ------------------------

	  The DID information is entered in the User database (i.e.
	  each user can be assigned a DID number if they are to receive
	  faxes sent to that DID number or '*' if there are to receive
	  all incoming faxes).

	  Please consult your FMS documentation for more information on
	  DID routing in the manual. (See also 
	  http://www.faximum.com/fms/manual).


	  Troubleshooting - Client/Server
	  ===============================

	  If you are experiencing problems getting DID/DDI/DNIS routing
	  to work then follow these steps:

	    1)  Edit the /etc/inittab file and add a "-d" option to the
		faxgetty line for the DID/DDI/DNIS line you wish to test.
	
	    2)  Kill the current faxgetty process on the line you wish to
		test.

	    3)  Create a file called /tmp/dispatch.dbg and make sure it
		is rw-rw-rw- for everyone.
	
	  Then manually send a fax from a fax machine to one of the 
	  DID/DDI/DNIS numbers on the line you are testing.  Once the fax 
	  has been sent, email the /tmp/dispatch.dbg and /tmp/faxgetty.dbg 
	  files to Faximum Technical Support for analysis.


	  Troubleshooting - FMS
	  =====================

	  If you are experiencing problems getting DID/DDI/DNIS routing
	  to work then first look into the system log to see if there
	  are any error messages that might suggest the cause of the
	  problem.

	  Failing that, you can look at the trace files which detail
	  the handshaking between the fax modem and the fax software
	  during the transfer of the DID digits. These are stored
	  in /var/spool/faximum/traces. If you have trouble deciphering
	  these files you can email them to Faximum Technical Support
	  (if you have a Technical Support Contract) for analysis.

	  If you (or TS) determine that the digits are being passed
	  but that the fax is not being properly routed then please
	  create a file called /tmp/dispatch.dbg and make sure it
	  is rw-rw-rw- for everyone.
	
	  Then manually send a fax from a fax machine to one of the 
	  DID/DDI/DNIS numbers on the line you are testing.  Once the fax 
	  has been sent, look at the dispatch.dbg file for clues as to
	  what is happening during the dispatch process. Or (if you
	  have purchased support) email them to Faximum Technical Support.


Tech Note: 182 - Copyright 1997-2000 Faximum Software Inc., All Rights Reserved.
Last Updated: Fri Mar 17 10:21:30 PST 2000
The complete set of Faximum TechNotes are available on the Internet at
	http://www.faximum.com/support

Copyright 2001 Faximum Software Inc. All Rights Reserved.