HAM Radio 1/HamRadio.cdr/misc/tdoor177/tdoor.doc

Text File | 1991-05-10 | 21KB | 436 lines

           ╓──────────────────────────────────────────────╖
           ║      Welcome to The Transfer Door v1.77      ║
           ║                                              ║
           ║    (c) Copyright 1991 by Gary Blydenburgh    ║
           ║                                              ║
           ║             ALL RIGHTS RESERVED              ║
           ╙──────────────────────────────────────────────╜


                             DESCRIPTION
                             -----------

   The Transfer Door is an external Door Run as a Type 7 or 15  exit
   from QuickBBs, Remote Access, or SuperBBS. Remote Access has it's
   own  version.  It  is designed to replace the file section of you
   BBS with a more versitile file area. This version supports Remote
   Access 1.0 file structures, and QuickBBS 2.75




                              FEATURES
                              --------
   o Private files Supported
   o Define as many free areas as you want
   o # of file directories on 1 line is sysop configurable!
   o Looks for Help file (help.td)
   o Filename search for unwanted files (FILE.LST)
   o File tagging for Ansi users
   o Tape Drive Support! Will restore MISSING files
   o Will display Upload.ans or asc before uploads if it exists
   o Goodbye from Tdoor Sysop Configurable
   o User may Toggle Graphics on and off
   o Hot Keys now installed! Sysop Configurable
   o Full Communications Support
   o No Watchdog or CTTY needed
   o Uses ANSI so the Sysop sees what the user sees
   o Status line display
   o Keyboard inactivity timeout
   o Sysop Chat with word wrap
   o Shell to DOS option for Sysop
   o Sysop can return caller to BBS
   o Support for Errorlevel, or DSZLOG type Protocols, or Other
   o Configuration Program to set up system
   o Up to 60 Protocols may be defined in Config file
   o Keeps track of all Ratios imposed by bbs instantly!
   o Direct BIMODEM support without external programs
   o Complete security by Flags and Security level
   o Scans all areas users has access to for D/L's
   o Checks for duplicate uploads
   o Scans for Virus and reArcs uploads files to your arc
     Format  with  ZZAP  v54a  and  newer,  and VIRUSSCAN, sample
     zzap.cfg included
   o Support for External Archive Viewer such as Zipster
   o D/L hours, min baud rate, and D/L exempt
   o Default file extension support
   o Supports batch Transfers
   o Wildcard Support for file searches
   o All files are opened in Shared mode for Multinode Support
   o Sysop may use his own Ansi and Ascii menus
   o Will not show FILES.BBS or FILES.BAK
   o Shows blinking * in file list for new files
   o 2 line menu descriptions
   o New file search from any date
   o D/L or U/L while listing files
   o Built in FilesCounter
   o Upload Credit Sysop configurable
   o Supports locked baud rates, No need to do anything
   o Creates Up and download logs in default directory
   o Many other features not listed!



                   SETTING UP THE TRANSFER DOOR
                   ----------------------------
You may now specify Free file areas in Flsearch.td.  Each area that is
free, will not be counted against any imposed file Ratios, the time limit,
however, will still be checked.

File Tagging is now supported, Users may tag up to their D/L or time limit,
Tags are not lost till the file is downloaded. When the users limit is
reached, the file will not accept a Tag. Tagged files are lost if a user
does a "Regular" D/L.

In order to stay compatable with the new QuickBBS 2.75 File Structures, D/L
Hours, and min baud rate are now taken from The Door Config file instead of
Qconfig.

Upload Credit is Sysop Defined via Tdoor.cnf.  Before running Tdconfig or
Tdoor, when upgrading from an earlier version, Add 1 line to door config
and put the upload credit multiplier on this line, it must be a whole
number.  This number will be multiplied by the upload time and added to the
users time limit.  If you enter 0, then no credit will be given, a 1 will
add the time the upload took etc.

Hot keys are Sysop Enabled.  Use TDconfig to make new changes to Tdoor.cnf,
or use a text editor to place an E or D on the last line of Tdoor.cnf to
Enable or Disable Hot Keys.

When using ZZAP, make sure it and SCAN are in your Path, I've included a
sample zzap.cfg file.

The files counter now supports [1] or <1>, it will update whatever it finds

Place the following files into your BBS or TDOOR Directory: if you put
Tdoor in its own directory, you will need to copy Dorinfo1.def to that
directory, then copy it back after exiting Tdoor.

            TDOORQ.EXE  or TDOOR-RA.EXE (RA version)
            PROTOCOL.TD
            FLSEARCH.TD
            TDOOR.CNF
            TDCONFIG.EXE
            HELP.TD
            FILE.LST (if you use this option)
            TDOOR.ANS (if you want to use this sample menu
                      Delete it if you want to use internal menu)



SETTING THE DSZ ENVIRONMENTAL VARIABLE
--------------------------------------
First of all you must set the enviromental variable for DSZLOG, Put the
following command in your autoexec.bat SET DSZLOG=C:\pathtobbs\DSZ.LOG

If you leave this out, your transfers will not be counted unless they are
the Errorlevel type. Please note the filename DSZ.LOG can now be any name
you like as Tdoor now reads the variable you set.

Tdoor nows checks the enviromental variable for DSZLOG internally if it is
not set properly, you will exit with an Error.


TDOOR CONFIGURATION
-------------------
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░┌──────────────────────────────────────────────────────┐░░░░░░░░░░
░░░░░░░░░░░░░│   The Transfer Door Configuration Program Ver 1.76   │░░░░░░░░░░
░░░░░░░░░░░░░╞══════════════════════════════════════════════════════╡░░░░░░░░░░
░░░░░░░░░░░░░│            Edit File Areas                           │░░░░░░░░░░
░░░░░░░░░░░░░│            Edit Door configuration File              │░░░░░░░░░░
░░░░░░░░░░░░░│            Edit Protocol Configuration File          │░░░░░░░░░░
░░░░░░░░░░░░░│            Quit                                      │░░░░░░░░░░
░░░░░░░░░░░░░└──────────────────────────────────────────────────────┘░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░


Run TDCONFIG and set up all your file areas and protocols. Use my examples
for templates. Protocols examples are set up for use as COM1. When using
BIMODEM be sure to set up your upload directory in BiConfig the same as the
directory configured in your Door.cnf file. Bimodem.cfg must also be in
your BBS directory

Protocols are set up with [D]sz.log [E]rrorlevel or [O]ther to check
whether the transfer was a success, D and E are the best choices to use,
but some protocols need another way to test. This is done by comparing the
transfer time, with the estimated transfer time, it is not the best method
for testing, use the first two if at all possible.

The number of file directories on 1 line is now configurable to 2 or 3
across. Also note that if you have more than 33 file areas you must disable
hot keys, as you will run out of menu choice characters for file area
selections. When hot keys are off, the file areas are numbered instead of
using single chars. You may now define up to 200 file areas. Also if you
have more than 99 file areas your area description length for 2-column
mode may only be 30 characters, 3-column mode 20 characters.

When Entering file area descriptions, DO NOT USE Quotes OR Periods OR YOU
WILL GET AN ERROR. Also the 3 flags in Tdoor.cnf can now be XX, if you want
Tdoor to ignore them.


░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░┌───────────────[ The Transfer Door Configuration File ]───────────────┐░░░░
░░░│                                                                      │░░░░
░░░│                                                                      │░░░░
░░░│                                                                      │░░░░
░░░│        ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄                     │░░░░
░░░│        █┌──[ Enter Configuration File Name ]──┐█                     │░░░░
░░░│        █│█████████████████████████████████████│█                     │░░░░
░░░│        █│████████████Tdoor.cnf   █████████████│█                     │░░░░
░░░│        █│█████████████████████████████████████│█                     │░░░░
░░░│        █└─────────────────────────────────────┘█                     │░░░░
░░░│        ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀                     │░░░░
░░░│                                                                      │░░░░
░░░│                                                                      │░░░░
░░░│                                                                      │░░░░
░░░│                                                                      │░░░░
░░░└──────────────────────────────────────────────────────────────────────┘░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

Note that you must enter a name for the Door config file. This was done so
the user could pick any name he wants and use multiple config files.


░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░┌───────────────[ The Transfer Door Configuration File ]───────────────┐░░░░
░░░│  BBS Path: C:\Quickbbs                D/L Ratio Exempt Flag: D2      │░░░░
░░░│  BBS Node: 1                          # of File Directories: 3       │░░░░
░░░│  BBS Name: The Space Coast BBS                                       │░░░░
░░░│                                       File Ratio K-1: 100            │░░░░
░░░│  U/L Path: E:\LOOT                    D/L's Before Ratio Check: 3    │░░░░
░░░│                                                                      │░░░░
░░░│  BBS Log: C:\Quickbbs\System.log      Flag to Enable D/L's: A1       │░░░░
░░░│                                       Flag to Enable U/L's: XX       │░░░░
░░░│  Zip View Program: Zipster                                           │░░░░
░░░│                                       Enable Virus Scan?: E          │░░░░
░░░│  Default Archive Extension: ZIP       Enable Hot Keys: E             │░░░░
░░░│                                       Private Files: E               │░░░░
░░░│  Minimum Baud Rate: 1200              Dir: D:\DL\PRIVATE\            │░░░░
░░░│                                       U/L Credit Multiplier: 2       │░░░░
░░░│  D/L Hours Start: 00:01  End: 23:59   Log Off from Tdoor?: E         │░░░░
░░░│                                                                      │░░░░
░░░│  Tape: E                              Tape Directory: D:\TEMP\       │░░░░
░░░│  Cmd: EZTAPE Restore /w 0 /m 0 /k 0 /t D:\TEMP\ /s \BBS\FD\F$        │░░░░
░░░│            <Help for parameters appear on this line>                 │░░░░
░░░└────────────────────────[ Editing : Tdoor.cnf ]───────────────────────┘░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

I will not get into the configuration program in detail as all input is
fully explained in the program itself.

                          ──────────//──────────

When Private Uploads are enabled, a directory must be named it may be you
regular uploads directory, or another.


░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░┌──────────────────────[ File Configuration Menu ]──────────────────────┐░░░
░░░│                                                                       │░░░
░░░│ Path: D:\General                                  Security: 5         │░░░
░░░│                                                                       │░░░
░░░│ Area: General & New Users                         Flag: XX            │░░░
░░░│                                                                       │░░░
░░░│ Free Area: Y                                                          │░░░
░░░│                <HELP FOR ENTRIES APPEAR ON THIS LINE>                 │░░░
░░░│                                                                       │░░░
░░░│                                                   Record Number: 1    │░░░
░░░└───────────────────────────────────────────────────────────────────────┘░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░┌───────────────────────────[ Editing Keys ]────────────────────────────┐░░░
░░░│               [F6] - Del Record       [F7] - Add Record               │░░░
░░░│     [F8] - Quit           [F9] - Abort Edit           [F10] - Save    │░░░
░░░│       [F3] - Page back one record   [F4] - Page forward one record    │░░░
░░░│        [Enter] - Advances a field.   [PgDn] - Jump to last field      │░░░
░░░│ [PgUp] - Jump to first field  [Arrow Keys] Advance or backup one field│░░░
░░░└───────────────────────────────────────────────────────────────────────┘░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

All menu areas in the configuration process display help information for
the commands to be entered.


░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░┌─────────────────────[ Protocol Configuration File ]─────────────────────┐░░
░░│                                                      Record Number: 1   │░░
░░│ <D>ownload or <U>pload Command: D       Errorlevel Type: D              │░░
░░│                                         Efficiency : 75%                │░░
░░│ Kepress to Activate Protocol: Z                                         │░░
░░│                                                                         │░░
░░│ Protocol Description: Zmodem (The Best!)                                │░░
░░│                                                                         │░░
░░│ Number of Files Allowed with Protocol: 10                               │░░
░░│                                                                         │░░
░░│ Command: dsz port 1 ha both estimate 0 B$ sz -m                         │░░
░░│                                                                         │░░
░░└──────[ Enter Either..<HELP FOR ENTRIES APPEARS HERE>..' for upload ]────┘░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░┌────────────────────────────[ Editing Keys ]─────────────────────────────┐░░
░░│                [F6] - Del Record       [F7] - Add Record                │░░
░░│      [F8] - Quit           [F9] - Abort Edit           [F10] - Save     │░░
░░│        [F3] - Page back one record   [F4] - Page forward one record     │░░
░░│         [Enter] - Advances a field.   [PgDn] - Jump to last field       │░░
░░│  [PgUp] - Jump to first field  [Arrow Keys] Advance or backup one field │░░
░░└─────────────────────────────────────────────────────────────────────────┘░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

All configuration files may also be edited by a text editor if you want to
make a quick change. No comments are allowed in these files!


USER CREATED MENU
-----------------
If Tdoor finds TDOOR.ANS or TDOOR.ASC it will use that menu instead of the
Main Menu in the program. Do not use screen clearing in you ansi menu or
you will lose the status bar.

Please note if you Files.bbs has a header, be sure to put a SPACE before
it.

Tdoor also creates UPLOADS.LOG and DOWNLOAD.LOG in the default directory,
the system log is also updated.

To test the program and run locally, I have enclosed a sample exitinfo.bbs
and dorinfo1.def. Type TDOOR TDOOR.CNF and check it out! Do not run this
way with your users.bbs in the same directory, as it will get trashed, as
my exitinfo.bbs is looking for my users.bbs not yours!


To Run as a Type 15 Door insert the following into your bat file:

      if errorlevel 90 goto Tdoor
      .
      .
      .

      :tdoor
      TdoorQ.exe tdoor.cnf
      Quickbbs -e0 -r
      goto after_Quick

To run as a Type 7 door just put TDOORQ.EXE TDOOR.CNF on your menu

If you do not specify a config file TDOOR.CNF is assumed

TAPE DRIVE SETUP
----------------
In TDCONFIG there are 3 parameters for Tape Support.

     o Enable Support by Entering E in the approriate field.
     o Enter a Temporary Directory for restored Tape files.
     o Enter You Tape Command String.

Tdoor will replace F$ with the filename in your tape command string.  Be
sure to restore all files to the Temporary Tape directory, they will be
D/Led from there, and deleted after the transfer.

For CMS Jumbo you create D:\TAPE\ as your Temp directory in Tdoor.cnf.  The
tape must be formatted as 1 single directory called TAPE then use:

     TAPE RESTORE \TAPE\F$

Create a Temporary directory of the name configured in TDCONFIG.

That's it, if a user comes across a file that is Listed in your FILES.BBS,
but not found on the disk, it will give the option of Restoring the file
from the tape drive. The file must be listed in the files.bbs to be
restored.

Most Tape drives do not work under DesqView, i have enclosed a Sample of
EZTAPE from Irwin Magnetics, as the is the drive that I use. If you need a
bigger command string, just edit Tdoor.cnf with a text editor.

Be sure to disable you modem from hanging up if user activity is too long,
as it takes a while to get the files off the tape as you know.


UNWANTED FILES
--------------
Tdoor checks to see if FILE.LST exists in current directory. This file is a
list of unwanted filenames and is checked against uploads. It will not
allow any file in this list to be uploaded. just enter 1 filename per line.
Sample is enclosed.


HELP FILE
---------
A Help file may be added as HELP.TD and a sample is enclosed. Create/Add to
it whatever you want to include to assist your users.

                          ──────────//──────────


                  Error Codes For Tdoor

 2 Syntax Error                 53 File Not Found
 3 Return without Gosub         54 Bad File Mode
 4 Out of Data                  55 File Already Open
 5 Illegal Function Call        56 Field Statemant Active
 6 Overflow                     57 Device I/O
 7 Out Of Memory                58 File Already Exists
 9 Subscript out of Range       59 Bad Record Length
10 Dupe Definition              61 Disk Full
11 Division by 0                62 Input past end of file
13 Type mismatch                63 Bad Record #
14 Out of string space          64 Bad file name
16 String formula too complex   67 Too many files
19 No Resume                    68 Device unavailable
20 Resume without error         69 Comm buffer overflow
24 Device timeout               70 Permission denied
25 Device fault                 71 Disk not ready
27 Out of paper                 72 Disk media error
39 Case else expected           73 Advanced Feature Unavailable
40 Variable required            74 Rename Across disks
50 Field overflow               75 Path/File access error
51 Internal Error               76 Path not found
52 Bad file name or #

                          ──────────//──────────


Tdoor Beta sites:

  The Palace BBS          3610/39  [phone] Arthur Morgan
  Lounge Lizard's Retreat 382/8    [phone] George Vandervort
  The Chess Board         124/2213 [phone] Ken Givens
  Hurricane Alley BBS     266/901  [phone] Al Chavez
  Shadowdale              130/28   [phone] Mike Wilson
  Middle Earth            382/19   [phone] Jim Roe
  Waterfront East BBS     261/1071 [phone] Mike McCullough
  The Private Ear         388/10   [phone] Fred Horner

                          ──────────//──────────


This program is Shareware, You may use it for an Evaluation period of 30
days, if you like it a Registration fee of $20_US is greatly appreciated!
This program may not be modified in any way! A Key file will be sent to you
to take the evaluation copy message out of you copy.

The current version of Tdoor may be freq'ed from 3610/39 under magic name
of TDOOR.

Registering your software will encourage future updates!

Send Registrations and questions to:
                                      Gary Blydenburgh
                                      1395 Armory Dr NE
                                      Palm Bay, Fl 32907
                                      Fidonet 3610/30
                                      BBS 1-407-951-7681 HST