22.0 Using SPITFIRE To Receive FAX Calls

22.0 - USING SPITFIRE TO RECEIVE FAX CALLS
        ------------------------------------------

            SPITFIRE is capable of receiving both data and fax calls on the
        same line.  This will work with most Class 2/2.0 and with a few Class
        1 fax modems.  Most Class 1 modems (such as the US Robotics 16.8
        series) will not be fax capable.

            To determine whether your modem will properly receive an incoming
        fax call, issue the following command from your terminal program:
        AT+FCLASS=?

        Possible return codes include:

            0 = Data
            1 = Fax Class 1 capable
            2 = Draft Fax Class 2 "compatible"       ----\  These modems
          2.0 = Fax Class 2.0 capable                ----/   will work!
        ERROR = NO fax capabilities

            Adaptive answering mode describes a state where a modem is capable
        of discriminating between an incoming data call and an incoming fax
        call and taking appropriate action.  On a SPITFIRE BBS, SPITFIRE will
        answer the phone in all cases.  If the modem returns a code indicating
        an incoming data call, SPITFIRE will present the BBS to the caller.
        In the case of an incoming fax call, SPITFIRE will then run SFFAX.BAT.
        Sysops need to create and configure their SFFAX.BAT according to the
        modem and the fax reception software in use.  SFFAX.BAT should be
        placed in each node's SPITFIRE Home Directory.  Once the fax has been
        received, SPITFIRE will re-initialize the COM port and will accept
        subsequent calls of either type.

        22.1 - CONFIGURING YOUR SYSTEM TO RECEIVE FAX CALLS
        ---------------------------------------------------

            To begin, it is necessary to store all modem settings related to
        receiving data calls in the modem's NRAM.  All of SPITFIRE's strings
        should therefore only be used for fax-related parameters.  Consult
        your modem documentation to determine which registers need to be
        changed and how to store those changes.  Currently, no known modem
        stores fax-related settings in NRAM.

            To configure your modem to be fax-capable, first press ALT+M from
        the SPITFIRE "Ready..." prompt.  Here are some suggested setups:

        CLASS 2 MODEMS
        --------------

        <I> Initialization String:
            AT+FCLASS=2+FAA=1+FCR=1+FLID="515 225 8496"+FDCC=1,5^M
        <A> Answer String: AT+FAA=1A
        <F> FAX Connection Result Message: +FCON

        (You may substitute an alphanumeric string of up to 20
        characters for the phone number listed above in quotes.)

        CLASS 2.0 MODEMS
        ----------------

        <I> Initialization String:
            AT+FCLASS=2.0+FLI="515 225 8496"^MAT+FNR=1,1,1^M
        <A> Answer String: AT+FCLASS=2.0+FAA=1A
        <F> FAX Connection Result Message: +FCO

        ZyXEL CLASS 2 MODEM

        <I> Initialization String:
            AT#B1+FCLASS=6^M
        <A> Answer String: ATA
        <F> FAX Connection Result Message: FZYX

        These are just SOME of the strings related to fax reception used by
        capable modems. Consult your modem manual for further information.

        As you can see, there are MANY possibilities.

        22.2 - SFFAX.BAT
        ----------------

            SFFAX.BAT needs to include all the necessary commands which are
        required for receiving the incoming fax calls, using the fax reception
        program of your choice.  The shareware fax program, BGFAX, will be used
        in the following example to demonstrate how the SFFAX.BAT might be set
        up to receive incoming fax calls.  The following example demonstrates
        the batch commands needed to receive a fax using a USR fax modem:

         REM  This Batch File Will Run BGFAX from SPITFIRE 3.5
         C:
         CD\BGFAX
         BGFAX /FCO C:\BGFAX 1 Q
         CD C:\SF
         EXIT

        (The above receives a fax using COM1: in QuickLink II mode.)

        Many other configurations are possible, depending upon the software
        used to receive the fax. The BGFAX documents provide an excellent
        overview of fax modem capability and their use as well as
        instructions for its own use.

            It is important to remember that unless a fax modem returns a code
        which can be recognized by SPITFIRE, it will NOT work with SF 3.5.
        SPITFIRE itself does NOT receive the fax!  What it does, is recognize
        the code configured in ALT+M and then passes control to a third party

        program which is capable of receiving and printing incoming fax calls.
        After configuring their BBS to receive fax calls, Sysops can use their
        fax capabilities to receive questionnaires, subscription applications,
        proofs of identity, etc., thus, providing a valuable additional feature
        for their SPITFIRE Bulletin Board System.