            Reqfil Version 1.0d for TSTHOST
            ===============================

       A  REQFIL server for TSTHOST (c) 1994 Gi6IRL John Agnew.

Introduction
============

	Reqfil is a server which allows remote users to request a file
from your system. It has been designed to work with TSTHOST, a terminal 
program by Mario, IK1GKJ.

Installation
============

	Assuming that you have TSTHOST installed in the directory C:\TSTHOST,
then REQFIL.EXE must be installed in this directory. The configuration file
REQFIL.CFG must also be located in the C:\TSTHOST directory.

Configuration
=============

The operation of REQFIL can be configured by setting several options within
the REQFIL.CFG file. Currently the following options are supported:-

	BASEDIR - This specifies the directory below which users have
	          access. 

	LOG     - This specifies whether logging is ON or OFF. Logging is
                  enabled by default.

	MAXSIZE - This specifies the maximum size that a file can be before
                  it is split into smaller parts for transmission.

BASEDIR is used to restrict the directories and files to which users
have access.  By specifying a BASEDIR of, for example,  C:\RADIO, users will 
only be able to get files from this directory and any of its
sub-directories. The C:\RADIO directory has in effect become the root
directory for remote users. Any REQFIL requests that they send will
look under C:\RADIO for the directories and files. I strongly recommend
that you create a directory under which the textfiles that remote users
can access are located e.g. C:\RADIO. This will prevent users
from accessing any other files on your machine.

e.g.
	A user sends a REQFIL request for C:\MODS\W15FM.TXT

	REQFIL will look for a directory called C:\RADIO\MODS and if it
        exists will then look for a file called W15FM.TXT. If this files
	exists it will be sent to the user.

If logging is enabled, a file called REQFIL.LOG will be created in the
TSTHOST directory.

Using REQFIL
============

Reqfil is used by sending a mail message as follows:

	SP REQFIL @ GI6IRL
	C:\MODS\W15FM.TXT @GB7XXX
        Message body ignored
	/EX

The drive letter can be omitted from the request as it willbe automatically
added by the sevrer according to the setting of BASEDIR e.g.

	SP REQFIL @ GI6IRL
	MODS\W15FM.TXT @GB7XXX
	Message body ignored
	/EX

Asuming that BASEDIR is set to C:\RADIO, this will send the file 
C:\RADIO\MODS\W15FM.TXT to GI6IRL@GB7XXX. If the @GB7XXX part is missing, 
the reply will remain in the PMS and will not be forwarded.

In order to let TSTHOST recognise that REQFIL is a server, the following lines
must be added to the TSTHOST.CFG file:-

SERVER +REQFIL

UL INTERFACE PMS

The UL INTERFACE PMS is only needed if you expect to receive REQFIl requests
from distant users via mail i.e. not connected to the PMS.

Bugs
====

Please report any bugs or ideas for enhancements to:

Packet: gi6irl@gb7ted.#63.gbr.eu
or
Internet: johna@bfs.unibol.com

Version history
===============

1.0a Initial release.

1.0b Added code to check for a binary file. If a binary file is requested a
     message is sent to the user with an error message.

1.0c If the file does not exist an error report is sent to the user. Minor
     bugs fixed.

1.0d Fixed problem where file referenced as C:\.... would be reported as
     not found.

