
FAXHOST is a free host script for {COMMO} by David Rife.  No warranty of
any kind is provided by the author.  The latest version of FAXHOST can be
found at http://www.geocities.com/dcrife/freeware.html.

FAXHOST can be called by BGFAX or used alone.  FAXHOST will call BGFAX to
receive fax calls if the modem has the proper functions and BGFAX.EXE is in
the protocol directory (defined by the variable protodir).  If your modem
has the proper functions but you do not want FAXHOST to answer fax calls,
then do not put a copy of BGFAX.EXE in the protocol directory.

On 08-05-2005 the fax modem setup string used by FAXHOST was moved to the
COMMO set file to provide more flexibility.

If your modem requires special setup commands, consider calling FAXHOST
from BGFAX, which has a cfg file into which any setup commands can be
placed.

FAXHOST does not use any macros that are in commo.mac and can be started
from DOS by the command string:  commo /mfaxhost.mac /:host /in.

FAXHOST shows a local menu when idle.  The local menu command V, to view
fax files, will appear only if there are received fax files to view and the
modem has been configured to receive fax files. The V command will work
only if a copy of view.exe is in the DOS path.  The command P does not
appear but is available to edit the password file.

The following table lists the host commands and which commands are
available to each user security level. The system prompts for the optional
entries if not entered after a command. Some of these commands may not
appear in the caller's menu.

  Command    Description            Level 1   Level 2   Level 3   Level 9
  ---------  ----------------       --------  --------  --------  -------
  BYE        Goodbye                   Y         Y         Y         Y
  CD         Change directory          Y (1)     Y (1)     Y (1)     Y
  COPY       Copy a file                         Y (2)     Y         Y
  DEL        Delete file                         Y (2)     Y         Y
  DIR        List files                Y         Y         Y         Y
  G          Goodbye                   Y         Y         Y         Y
  LOGON      Logon again               Y         Y         Y         Y
  MAIL       Invoke mail menu          Y         Y         Y         Y
  REN        Rename a file                       Y (2)     Y         Y
  RH         HS/Link upload            Y         Y         Y         Y
  RZ         Zmodem upload             Y         Y         Y         Y
  SH         HS/Link download          Y         Y         Y         Y
  SZ         Zmodem download           Y         Y         Y         Y
  SHOW       Show file in pages        Y         Y         Y         Y
  TYPE       Autotype file             Y         Y         Y         Y
  VIEW       View ARC/ZIP list         Y         Y         Y         Y

  END        Remote turn off host                                    Y
  FF         Find files on disk drive                                Y
  HELP       List sysop-only commands                                Y
  MAKELIST   Create files.bbs list                                   Y
  MD         Make directory                                          Y
  RD         Remove directory                                        Y
  RR         Zmodem resume upload                                    Y
  SHELL      Activate DOORWAY.EXE                                    Y
  SLOG       Send log file via Zmodem                                Y

Notes:

    1.  Can change directory to home directory or its sub directories, or
        the public directory.

    2.  Not allowed in public directory or its subdirectories.

    3.  Cannot access DOS, UTILITY, UTIL, SYSOP, or {COMMO} directory.

    4.  Only level 2, 3, and 9 callers may overwrite files.  See note 6.

    5.  File names are checked to assure that they are not filespecs that
        point to files outside the allowed directories.

    6.  Security level 3 is the same as level 2 with the added ability to
        use all valid commands in any allowed directory.  Level 3 callers
        can, therefore, overwrite and manage files in the "home" and
        "public" directories.

FAXHOST will use the following programs if they are in the protocol
directory:  BGFAX.EXE, FV.COM, DOORWAY.EXE, and HSLINK.EXE.  The program
VIEW.EXE only has to be in the DOS path. FAXHOST will work if any of these
external programs are not available, but with reduced caller commands.

FAXHOST will show the HS/Link and VIEW commands in the caller's menu only
if HSLINK.EXE and FV.COM, respectively, are in the protocol directory.

FAXHOST will only show valid commands in the caller's menu.  Command
validity depends on caller's security level and current directory.

FAXHOST will use the macro file mail.mac for mail functions if mail.mac is
located in the home directory.  If mail.mac is not in the home directory,
then MAIL is not listed in the caller's menu and the mail command is
ignored.

The security level 9 (sysop) command, MAKELIST, invokes makelist.exe (if
available) to create a list of all files in the current directory,
including the file_id.diz files that are in zip archive files.  The list is
in files.bbs.

FAXHOST requires variables not normally in the set file (commo.set). These
will will be added to the set file the first time the script is used.

Passwords can be kept in the file password.lst, in the COMMO home
directory. A text editor or the program pwd.bat can be used to manage the
password file. Pressing P when viewing the local menu of FAXHOST will
invoke editing of the password file.  P does not show in the local menu.

FAXHOST will send the file faxhost.ans before asking a caller for his or
her name if the file exists in the COMMO home directory.

When FAXHOST is exited, it will unload itself if called from COMMO or exit
to DOS if started from DOS.


Notes: Set Windows 95 idle sensitivity to low when running this script in
       background.

       FAXHOST uses ACSII 28 for the escape character. If BGFAX will call
       this script, then make sure the following line is in the bgfax.cfg
       file:  in=ATS2=28

