    FAX support

One example of the flexibility of the MDMRESLT.CIT file is FAX support.
This can be enabled by:
  1) Telling the modem to answer with FAX support.
        This could be done via #DIAL_RING or #MODSETUP.
  2) Making a command to tell Citadel how to deal with a FAX call.
        A script and/or batch file may be necessary to get things set up
        correctly.
  3) Adding a line to MDMRESLT.CIT that tells what the FAX result code is and
     the name of the command to run.
        This must be added.  If you create a MDMRESLT.CIT with only this line
        in it, the computer won't understand anything else the modem sends it.
        You can create the default MDMRESLT.CIT (and the other default .CIT
        files) by running Citadel in an empty directory (and thus creating a
        new system).

 The first thing to do is find or write a program that will handle receiving
a FAX and that can be called from a host program.  One popular shareware
program is BGFAX, by B.J. Guillot.  If you use this program, get version 1.35
or later (I have 1.36).  The included example script is written for BGFAX.

 The next thing to do is figure out how to get the modem to answer a FAX call.
You can look in your modem's documentation or the FAX program's documentation.
This will probably involve setting +FAA (for Class 2/2.0) or +FAE (for Class
1) and +FCLASS parameters.  Semicolons might be involved.  I recommend testing
in dial-out mode.

 Next, have a FAX machine or FAX modem call you and try to answer it.  Since
it might not always be convenient to have a human work with you, the following
sample list of FAX-on-Demand numbers should help for testing.  Any of these
numbers could be invalid, most are untested.

  800-554-2494  Acer
  408-957-7150  Adaptec
  800-767-8182  ADI Systems (monitors)
  206-628-5737  Adobe/Aldus
  800-347-FAXX  American Power Conversion
  800-868-8148  AMS
  800-926-1AST  AST Research
  800-341-7500  Austin Direct
  610-458-6485  Bentley Systems (MicroStation Fax Centers)
  412-746-5500  Black Box [dial 14 after connecting]
  800-822-4269  Borland (Technical)
  800-408-0001  Borland
  206-683-8989  Bright Star
  800-535-SCAN  Caere [dial 4 after connecting]
  800-847-8766  Central Point Software
  503-690-2660  Central Point Software
  800-800-8954  Claris
  800-345-1518  Compaq
  613-728-0826  Corel [dial 3080 after connecting]
  408-428-2389  Creative Labs
  604-681-3530  Crystal Services
  800-362-9927  Day-Timer Technologies [dial 82 after connecting]
  800-950-1FAX  Dell Computer
  512-728-1681  DellWare
  416-443-1614  Delrina
  408-648-4021  DeltaPoint
  800-380-0030  Diamond Computer Systems / Diamond Multimedia
  612-943-0573  DigiBoard
  800-DIGITAL   Digital Equipment Corporation
  800-388-3228  Digital Equipment Corporation
  800-723-0778  Ergo Computing
  510-814-5040  Farallon
  800-FAX-BACK  FaxBack
  408-428-6153  Frame Technology
  800-846-4526  Gateway 2000
  605-232-2561  Gateway 2000
  516-625-6268  Global
  800-HAYES-FX  Hayes
  800-333-1917  Hewlett-Packard
  800-289-9998  Ibex Technologies
  800-IBM-3395  IBM Personal Computer Co.
  800-IBM-4FAX  IBM and Business Partners
  800-755-9654  Insight Direct
  800-525-3019  Intel
  415-858-6090  Intuit
  514-835-2216  ITI Software
  908-219-0990  Jensen-Jones
  800-535-4242  Kensington Microware Limited [dial 82 after connecting]
  606-232-2380  Lexmark International
  415-461-8090  Light Source
  800-245-0000  Logitech
  800-346-3508  Lotus Development
  800-552-2511  MapInfo
  800-2-MAXTOR  Maxtor [dial 11 after connecting]
  303-678-2618  Maxtor
  800-285-2802  Microcom
  800-936-4100  Microsoft (Desktop Applications)
  800-936-4200  Microsoft (Personal Operating Systems)
  800-936-4300  Microsoft (Development Tools)
  800-936-4400  Microsoft (Advanced Systems)
  800-727-3351  Microsoft (Sales)
  203-854-5300  MicroWarehouse
  800-78-MOUSE  Mouse Systems
  800-MPC-6686  MPC Technologies
  800-FAX-7177  National Instruments
  800-366-0476  NEC
  800-756-9430  Network World
  800-967-IDEA  New Ideas
  800-NET-WARE  Novell (Netware Product Info) [dial 22 after connecting]
  800-768-9771  Novell (Netware Desktop Applications)
  800-4-UNIVEL  Novell (UNIX)
  800-733-9673  Novell (Developer)
  800-233-EDUC  Novell (Education)
  800-414-LABS  Novell (Labs) [Product Certification]
  503-520-4200  PC Kwik
  404-888-5344  Periscope Company, The
  619-592-7400  Polaris Software [extension 350?]
  800-225-4PPI  Practical Peripherals
  201-887-4919  PrePress Direct
  800-FAX-PSI-1 PSI (Performance Systems International)
  800-633-7213  QMS
  301-718-6066  Qualitas
  800-4-DISKFAX Quantum
  201-229-4053  Samsung
  408-438-2620  Seagate
  206-521-4550  Shapeware
  516-753-0986  Sheridan Software [dial 3 after connecting]
  800-370-6917  Shiva
  617-431-9402  Shiva
  404-988-2401  SoftNet
  408-955-5505  Sony (monitors)
  314-444-7575  Southwestern Bell internal news
  619-929-3900  Stac Electronics
  800-USE-SUNX  SunExpress
  503-967-0072  Supra
  800-554-4403  Symantec
  503-682-7450  Tektronix
  201-586-1553  Teleware (now Bestware)
  714-583-3800  Toshiba America
  206-487-5410  Traveling Software
  909-869-7318  ViewSonic
  800-836-8028  Washburn & Company
  800-832-4778  Western Digital [dial 21 after connecting]
  714-WD2-4300  Western Digital
  800-438-4526  Xircom [dial 1 after connecting]
  800-845-2341  Zeos International
  404-428-0008  Zsoft

 Of these, I most highly recommend the Novell (Labs) system for testing: you
can request a catalog within a minute, and it sends the pages at standard
rather than fine resolution so they're through quickly.

 Then, see what strings the modem sends when receiving a FAX call.  In dial-
out mode, I wait for "RING" from the modem and enter "AT +FCLASS=1 +FAE=1 A".
As soon as the modem recognizes a FAX call, it sends "FAX" on a line by
itself.  After negotiating the call, it sends "CONNECT" at 19200 if it was
initially at 38400.  It supports FAX baud rates up to 9600.
 
 To tailor Citadel for the above example, I set the following:
In CONFIG.CIT:   #DIAL_RING "AT +FCLASS=1 +FAE=1 A"
In MDMRESLT.CIT: #RUNAPPLIC "FAX" "*FAX"
 and tailored FAX.CSF to set the port rate to 19200 and allow carrier
rate of 9600.  BGFAX waits for the final "CONNECT" and takes things from
there.
 
 If you can use them, I recommend using Class 2 or 2.0 instead of Class 1,
since they're more robust (Class 1 depends a lot on the computer's timing,
and might not work if the computer reacts too slowly, while 2 and 2.0 are
implemented more within the modem).
