     ͻ
͹ RAFTAG v1.06  Documentation 
     ͼ

               RemoteAccess v2.02 Fast File Tagging Door
                   Copyright (c) 1995, Irfan Butt

THIS PROGRAM AND ALL THE ACCOMPANYING DOCUMENTATION IS COPYRIGHT MATERIAL
AND AS SUCH  IS PROTECTED  BY INTERNATIONAL  COPYRIGHT LAWS.   FAILURE TO
ABIDE BY THE RULES SET  OUT IN THE LICENCE  DOCUMENT WILL BE CONSTRUED AS
AS A CRIMINAL OFFENCE AND WILL BE DEALT WITH ACCORDINGLY.

     ͻ
͹ Before you go further 
     ͼ
Please read the user licence file LICENCE.TXT.

     ͻ
͹ What does it do? 
     ͼ
I run a RemoteAccess BBS and decided it was a real pain for RA users to
tag files from many different areas quickly and easily.  The RA global
download menu option seemed rather laborious and prone to user error and
so I wrote RAFTAG to get around it.
It is a simple door which reads/writes TAGLIST.RA (a new feature for
RA 2.02).  Users compile a list of the files they require offline using
their favourite text editor, upload this wish list to the door which then
searches the file database for the files, tags them and exits back to the
BBS.

     ͻ
͹ Why use it? 
     ͼ
Users who call for mass downloading will love the door as it will
significantly reduce the amount of time spent on-line typing in the names
of the files required.
Why use RAFTAG and not other products?  Setup is INCREDIBLY easy, NO
EXTERNAL PROTOCOLS are required and errr well its quite good too.

     ͻ
͹ Benefits of registration 
     ͼ
In the non-registered version of this software you may tag a maximum of 5
files per session in the door.  When you register, you may tag a maximum
of 100 files.

HOWEVER, you must be aware that RemoteAccess has its own limits on the
number of files you may tag in this fashion.  If your copy of RA is NOT
registered, then no matter how many files you tag in the door, RA will
only read a maximum of 5 tagged file records.  Therefore, to get full
benefit from this door, you will need to register the door AND RemoteAccess.

     ͻ
͹ What are the requirements? 
     ͼ
You must be running RemoteAccess v2.02, note 2.02, this program WILL NOT
WORK with anything less than this.

     ͻ
͹ Installation Instructions 
     ͼ

             *** BACKUP YOUR EXISTING CONFIGURATION !!! ***

I cannot stress the importance of this.  A complete loon has written this
and there is no telling what it may do.  The author will not be held
responsible for any damage caused to your system or any other in any way
whatsoever (see LICENCE.TXT).

Make a directory to install RAFTAG in e.g. C:\RA\RAFTAG.  Unpack the archive
you received, you will basically require only the executable to run the
program.

Then create a new menu option in RA of type 7 (Execute sub-program), e.g.

          1         2         3         4         5         6         7
 123456789012345678901234567890123456789012345678901234567890123456789012345
 (^F^)ast file tagging door

 C:\RA\RAFTAG\RAFTAG.EXE C:\RA\NODE0*N *X *M

 Action   Execute sub-program (Type 7)
 Display
 OptData
 HotKey   F
 AutoExec No
 Colour   Colour example

 MinSec   100                TimeUsed 0                  FlatCost 0
 MaxSec   0                  TimeLeft 0                  TimeCost 0
 A flags  --------           Age      0                  Terminal Any
 B flags  --------           MinSpeed 0                  Nodes
 C flags  --------           MaxSpeed 0                  Groups
 D flags  --------           Credit   0                  DayTimes


The only command line argument required for the door is the path to the
directory where DOOR.SYS will be found.  This will normally be the
directory in which you started RA (note there is NO ending backslash).

In the example above, RA will convert the *N to a node number so if the
option is executed on node 3, then the actual command line will be

 C:\RA\RAFTAG\RAFTAG.EXE C:\RA\NODE03

It is vital to use *X on the command line.  This is the directive which
tells RA to write the current taglist to disk on exiting to the door
and to re-read it on returning from the door.

The *M simply causes RA to swap itself to disk to free up more memory for
the door.

And thats it !  RAFTAG automatically creates a directory for each node you
run it on (under the RAFTAG install dir) and in each, puts a log file called
RAFTAG.LOG for you to monitor activity.

     ͻ
͹ Running in local mode 
     ͼ
Of course, you may also run the program in local mode for testing purposes.
Just make a REQLIST.TAG file in the appropriate node directory (under the
RAFTAG install dir) and enter the door.  So for instance, if you installed
RAFTAG in C:\RA\RAFTAG and you run your local instance of RA on node 5, then
create C:\RA\RAFTAG\5\REQLIST.TAG.  Easy innit?

     ͻ
͹ Bugs, Problems, Requests for Enhancements 
     ͼ
Please direct all these to Irfan Butt at 2:252/322.  Please make sure
you describe:
1) Which operating system you run
  [ ] DOS, version           _____
  [ ] Windows NT             _____
  [ ] OS/2, version          _____
  [ ] Other (please specify) _______________________

2) Which front end (if any) you run
  [ ] Windows, version       _____
  [ ] DesqView, version      _____
  [ ] Other (please specify) _______________________

3) Which FOSSIL driver you run _______________________

4) Please describe the problem you have
________________________________________________________________
________________________________________________________________
________________________________________________________________
________________________________________________________________
________________________________________________________________
________________________________________________________________
________________________________________________________________

5) Please also supply a copy of your configuration files (autoexec.bat,
config.sys, RA menu used to call RAFTAG, etc.) and if possible the
log file created by RAFTAG.


And PLEASE if you are using RAFTAG successfully, please netmail me
and tell me about it, if possible, please supply the details above
so I know what configuration you run with.

     ͻ
͹ RAFTAG compatibility list 
     ͼ
RAFTAG has been tested and appears to work on:

1) DOS 6.2/Windows for Workgroups 3.11, BNU 1.7
2) OS/2 and x00
3) OS/2 Warp, SIO 1.45a and Filebar 1.90

