home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / FTPD101.ZIP / FTPDOOR.DOC < prev    next >
Text File  |  1994-01-09  |  18KB  |  397 lines
  1.   
  2. ▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀  ▀▀▀▀▀▀     ▀▀▀▀▀     ▀▀▀▀▀   ▀▀▀▀▀▀
  3. ▀▀         ▀▀    ▀▀   ▀▀ ▀▀   ▀▀   ▀▀   ▀▀   ▀▀   ▀▀  ▀▀   ▀▀
  4. ▀▀▀▀▀      ▀▀    ▀▀▀▀▀▀  ▀▀   ▀▀▀ ▀▀▀   ▀▀▀ ▀▀▀   ▀▀▀ ▀▀▀▀▀▀
  5. ▀▀         ▀▀    ▀▀      ▀▀   ▀▀   ▀▀   ▀▀   ▀▀   ▀▀  ▀▀  ▀▀
  6. ▀▀         ▀▀    ▀▀      ▀▀▀▀▀▀     ▀▀▀▀▀     ▀▀▀▀▀   ▀▀   ▀▀   v1.01
  7. ──────────────────────────────────────────────────────────────────── 
  8.              Copyright (C) 1994 All Rights Reserved
  9.                        By: Nightline Elite 
  10.                                         
  11.  
  12.                                               BBS (519)766-9139      
  13.  
  14.  
  15.                        
  16.   ┌────────────────────────────────────────────────────────────────────────┐
  17.   │▓▒░▓▒░▓▒░▓▒░▓▒░▓ NightLine Elite Computing Door Ware ▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓░│
  18.   └────────────────────────────────────────────────────────────────────────┘
  19.                Supporting: DOOR.SYS, Spitfire, WWIV, RBBS16.x                 
  20.                Phoenix, WildCat (Pre - 3.0), PCBoard 14.x+ .
  21.  
  22.                         DESQVIEW & FOSSIL AWARE!
  23.  
  24.                       Programmed in Turbo Pascal V6.0
  25.                             using JPDOOR 4.0.
  26.  
  27.                    V1.01                 Compiled - JAN 9, 1994   
  28.                    
  29.                                       BY
  30.                                  Richard Rog
  31.  
  32.  
  33.   ┌────────────────────────────────────────────────────────────────────────┐
  34.   │▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░     Program Support  ▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓░│
  35.   └────────────────────────────────────────────────────────────────────────┘
  36.  
  37.                           
  38.                           24 Hour BBS Line (519)766-9139
  39.                      Voice Support (9am - 9pm) (519)766-0154
  40.                        Internet Address: rrog@uoguelph.ca
  41.                              Fido Address: 1:221/333
  42.  
  43.   ┌────────────────────────────────────────────────────────────────────────┐
  44.   │▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░  Program Description ▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓░│
  45.   └────────────────────────────────────────────────────────────────────────┘
  46.  
  47.        FTPDOOR is a BBS Files Request door and more.  FTP can 
  48.        be used to show a files.bbs file with requestable files
  49.        a sysop has easy access to (as in an internet FTP site). 
  50.        This door automatically shows the user the list of files,
  51.        lets users request the file they wish to receive, leave 
  52.        notes for the sysop while inside the door, page and chat
  53.        with the sysop if they have questions, and much more...
  54.  
  55.                                 Read on,  you'll catch on!
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                     }}}}}}}}  BUT FIRST {{{{{{{{
  62.  
  63.   ┌────────────────────────────────────────────────────────────────────────┐
  64.   │▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░ Please Support Shareware ▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓░│
  65.   └────────────────────────────────────────────────────────────────────────┘
  66.                     
  67.  
  68.         A lot of time and effort went into creating this program
  69.     The main reason this program has been created in the first place 
  70.     was for the support of Childfind.  Proceeds from your $4.00 Donation
  71.     will go towards Childfind Canada.  Where $1.00 for every $4.00 paid
  72.     will go to this very worthy cause. Please help keep shareware alive 
  73.     and help Childfind, and their cause.
  74.  
  75.     You can also (See Registration form) ask to have your BBS Logo 
  76.     custom programmed into your very own copy.
  77.                             - Within reason of course - 
  78.  
  79.     so please feel free to use this evaluation copy,  and hope to hear from 
  80.     everybody soon.
  81.  
  82. you can send in your contributions to:
  83.  
  84. Cheque or m/o payable to: Richard Rog
  85.  
  86. Mail To:
  87. ┌────────────────────────────────────────┐
  88. .       NightLine Elite Computing        .
  89. .       University of Guelph             .
  90. .       Guelph On. N1G 2W1               .
  91. .       P.O. box 48 3720                 .
  92. └────────────────────────────────────────┘
  93.  
  94.                                                 Thank you.
  95.  
  96. ──────────────────────────────────────────────────────────────────────────
  97.  
  98.  
  99.  
  100.   ┌────────────────────────────────────────────────────────────────────────┐
  101.   │▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░  Program Legalities  ▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓░│
  102.   └────────────────────────────────────────────────────────────────────────┘
  103.  
  104.         The author does not in any way maintain responsibility for 
  105.         any wrong doings created by this program.  This program
  106.         has been tested; however, as you know, something can always
  107.         go wrong, so for this reason everyone always writes this message
  108.         and I better do the same.
  109.       
  110.   ┌────────────────────────────────────────────────────────────────────────┐
  111.   │▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░    Welcome Section   ▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓░│
  112.   └────────────────────────────────────────────────────────────────────────┘
  113.  
  114.         
  115.         Well this is the part where I thank everyone for trying out this new
  116.         door.   When I set out to write FTP,  I didn't realize all the
  117.         problems I had coming when trying to create this door.  What I wanted
  118.         to do was basically create an attractive user interface, for the 
  119.         following reasons.  First of all,  a lot of the door programs I have
  120.         seen on the local Bulletin Boards are very plain..  Mostly due to 
  121.         poor programming, as well as using very basic or limited compilers.
  122.         I then tried to write this program using the advanced features on
  123.         Turbo Pascal V6.0.  After a couple of months the learning process 
  124.         was finished and I finally compiled the door for the last time.
  125.         Hopefully this version will not have many bugs in it;  however, if 
  126.         you find some, please feel free to contact me any way and let me know.
  127.  
  128.         Secondly, the reason for my interest in this FTP door is the fact
  129.         that most Bulletin Boards are always striving for File integrity.  
  130.         I find it useless to carry megs/gigs of files online, when only a 
  131.         small percentage of these files are ever downloaded.  For this reason,
  132.         I have given you a way to let your users have access to Gigabytes of
  133.         Files, without having to waste valuable hard drive space storing 
  134.         it.  I have also set up the option to custom program this door for 
  135.         pay users,  where I would like to either engrave their BBS
  136.         logo,  or any other visual difference to set aside this door program,
  137.         and let that certain BBS be the only one with one like it.
  138.  
  139.  
  140.                                 
  141.                                 
  142.                                 
  143.  
  144.   ┌────────────────────────────────────────────────────────────────────────┐
  145.   │▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░    Documentation     ▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓░│
  146.   └────────────────────────────────────────────────────────────────────────┘
  147.         
  148.         
  149.         Files contained on this disk
  150.  
  151.                 FTP.EXE     { The FTP Executable Program.
  152.  
  153.                 SAMPLE.BAT  { Sample Bat file for FTP Door 1.01
  154.  
  155.                 FTPDOOR.DOC { This file. (Why do people say this?)
  156.  
  157.                 FTP.CNF     { Sample configuration file needed for FTPDoor.
  158.  
  159.                 REGISTER.TXT { Door Registration Information 
  160.       
  161.         OPTIONAL FILES: (CREATED BY FTPDOOR v1.01);
  162.  
  163.                 MESSAGE.    { This file is created immediately after
  164.                               a user leaves the sysop a private note
  165.                               once you see this file in your door dir,
  166.                               you may read it.  Or you will also be
  167.                               alerted as to having mail if you logon
  168.                               to the door in local mode.
  169.  
  170.                 INCOMING.    { This file is a list of incoming "Requested"
  171.                                files, which users have requested.
  172.  
  173.                 FTPDOOR.LOG  { This file is the doors' log file, and
  174.                                is created after the door is run, and
  175.                                updated after every use. It contains
  176.                                important information, and things that
  177.                                happened during each user's session.
  178.                                You may delete it at any time
  179.                                in order to update and refresh it.
  180.       
  181.  
  182.   ┌────────────────────────────────────────────────────────────────────────┐
  183.   │▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░ Program Installation ▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓░│
  184.   └────────────────────────────────────────────────────────────────────────┘
  185.  
  186.     
  187.  
  188.         FTP File Request Door v1.01 will work on almost any Bulletin Board 
  189.         system that supports either, EXITINFO.BBS, or DOOR.SYS.
  190.         The set up is very similar to most doors,  the first thing you 
  191.         have to do is create a sub directory in the BBS path, which will
  192.         hold all your FTPDOOR files.  
  193.  
  194.         ie...
  195.                 C:\RGB\DOORS\FTPDOOR
  196.  
  197.         The next step is to copy all the Zip files into that sub dir. 
  198.         You must then set up your door in the regular way off of your
  199.         main BBS.  The best way to do this is to have your board
  200.         execute a batch file similar to the one below.
  201.         
  202.         Example FTP.BAT
  203.         -----------------------
  204.         @Echo Off
  205.         Set OutBuff=On
  206.         CD\
  207.         CD BBS\DOORS\FTPDOOR
  208.         FTP
  209.         Set OutBuff=Off
  210.  
  211.         ----------------------
  212.  
  213.         The Set OutBuff option must be included in order to activate
  214.         the doors hot-key functions.  this speeds up user choices 
  215.         for your door, and makes things look a lot more professional.
  216.  
  217.  
  218.         Secondly you must configure your doors Configuration file.
  219.         The Configuration file the door uses is called "FTPDOOR.CFG"
  220.         and a sample configuration goes like this.
  221.  
  222.         Example: FTPDOOR.CFG
  223.         --------------------------
  224.         C:\BBS                  { Path to main BBS }
  225.         C:\BBS\DOORS\FTPDOOR    { Path to Door Files }
  226.         Richard                 { Sysop's First Name }
  227.         Rog                     { Sysop's Last Name }
  228.         Nightline               { Board's Name }
  229.         DOOR.SYS                { Include whether you are using
  230.                                   DOOR.SYS or EXITINFO.BBS}
  231.  
  232.  
  233.         After setting your configuration file,  you are almost on your way.
  234.         You will have to finally set up your board to execute your 
  235.         batch file and enter the door once a user is on your system.  
  236.         Do this as you would any other door.  
  237.         
  238.         If you have never set up a door before, please consult
  239.         your BBS Documentation to find out the correct procedure for the
  240.         BBS Program you are using.
  241.  
  242.                              *** IMPORTANT ***
  243.  
  244.         You must place a copy of "FILES.BBS" in your Door directory 
  245.         in order for the door to locate your off-line  files and display
  246.         them to your users.  A sample FILES.BBS file is included in your
  247.         archive, but you should change it with your own.  It is not mandatory 
  248.         to do this, but you will find it easy to just place this one file in 
  249.         your doors' directory rather than just having the files listed in 
  250.         your file directory but signifying that they are OFFLINE...  
  251.  
  252.         If you are planing to add "ie" an FTP sites files.bbs list to
  253.         your door, you must have it in the doors' directory.  This lets
  254.         your users request and have access to Gigabytes of files from
  255.         your very own system, without wasting a byte of your hard drive's
  256.         space.
  257.  
  258.         Please also remember, FTPDOOR will log a user off if "5" minutes
  259.         of keyboard inactivity time has occurred...  This is to ensure
  260.         that your board is not hung for hours due to a user who has 
  261.         fallen asleep at the keyboard.
  262.  
  263.  
  264.  
  265.   ┌────────────────────────────────────────────────────────────────────────┐
  266.   │▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░  FTP DOOR COMMANDS   ▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓░│
  267.   └────────────────────────────────────────────────────────────────────────┘
  268.  
  269.  
  270.        The following is a list of commands that can be used while
  271.        in the FTPDoor.
  272.  
  273.        "F" -  This enables a user to see all the files listed
  274.               within your configured FILES.BBS list.  The "F"
  275.               command shows this list, and uses a nice color array
  276.               to show the files.  If the file list does not contain
  277.               a file size, or specifies the file is offline, the
  278.               message *MISSING* will appear.  (Just like the one 
  279.               used by RA).  This will enable the user to browse the
  280.               file list, and request whatever he/she wants.
  281.  
  282.  
  283.        "R"    This command brings the user to a screen where he/she
  284.               will be able to request a file which is currently off
  285.               line, and stores it into the "INCOMING" text file which
  286.               you will find in your DOS/DOOR root directory.  You
  287.               can read the file either by using the "S" command from
  288.               the FTPDOOR, or by typing and editing the "INCOMING" 
  289.               text file, or by using the "P" command from the FTPDOOR
  290.               and printing the files to your printer (NOTE: The printer
  291.               must be turned on prior to printing the "INCOMING" file.
  292.               From there, you have a copy of the files to pick up
  293.               from whichever site you wish.
  294.              
  295.              The choices from the Request file area are as follows.
  296.  
  297.              'FILE TO REQUEST': Give the name of the file you wish to
  298.                                 request.  ie: TESTFILE.ZIP.
  299.  
  300.              'FILE LOCATION'  : Give some info to where you saw the file
  301.                                 - its location.  If the sysop has it
  302.                                 displayed in a file area ie called "MODEM
  303.                                 UTILS _ FTP1, please enter that, or
  304.                                 whatever format the sysop has configured.
  305.  
  306.              'FILE SIZE'       : Try and give the files' approx size.
  307.                                  This gives the sysop and other users
  308.                                  info as to how long it will take to d/l
  309.                                  and have it ready for you.
  310.  
  311.         *** NOTE *** The date will always be stamped right after
  312.                      you have made your request, this lets people
  313.                      know when the file was requested.
  314.              
  315.  
  316.  
  317.        "N"    This command lets the user leave the sysop a private
  318.               message.  This message can be read by editing/typing
  319.               the dos text file "MESSAGES." in your BBSDOOR directory.
  320.               Once the user chooses this command, he/she will be guided 
  321.               by a number of instructions for posting the message
  322.  
  323.  
  324.        "S"    This command displays any incoming files which users
  325.               have previously requested from FTPDoor.  This file
  326.               is the dos text file "INCOMING.", which FTP Door displays
  327.               in full ansi graphics (providing that the user is using
  328.               ansi, else it shows the display in ASCI).  Once the files
  329.               have been received and noted by the sysop, the file "INCOMING"
  330.               can be deleted, and the door resets this option with the
  331.               "NO INCOMING FILES" display.
  332.  
  333.        "C"    This option is the door's quick Chat.  Many times users
  334.               will have a question and have to exit a door to page
  335.               the sysop for help.  This way, a user can page the sysop
  336.               while inside the door.  If the sysop is busy during the
  337.               first page, a message will be displayed on the door's
  338.               status bar indicating that the user tried to page the sysop
  339.               and the reason for the page.
  340.  
  341.        "P"    This option is available for the sysop to print the list
  342.               of user requested files.  NOTE: however as mentioned earlier
  343.               that the printer must be turned on, and the sysop must
  344.               be in the door in LOCAL mode before the print will work.
  345.  
  346.        "Q"    This option logs the user back onto the BBS.
  347.  
  348.        "H"    This option drops carrier, hangs up on the user,
  349.               and resets the BBS.
  350.  
  351.  
  352.        
  353.        
  354.   ┌────────────────────────────────────────────────────────────────────────┐
  355.   │▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░      Final Note      ▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓▒░▓░│
  356.   └────────────────────────────────────────────────────────────────────────┘
  357.        
  358.        
  359.        
  360.        That is pretty much all there is to it, please remember, if
  361.        you have any more questions, please feel free to contact me
  362.        in any of the ways mentioned at the beginning of this documentation.
  363.  
  364.        Just hack around with it,  it won't take you long to get the
  365.        hang of this - it's really easy -
  366.  
  367.        But
  368.  
  369.  
  370.        If for some reason you find that you are having problems 
  371.        with any BBS Software type,  you can call The BBS number
  372.        listed below 24 hours for support.  Due to the nature of
  373.        doors, and the differences between one BBS program to another
  374.        it is hard to keep doors compatible with each other.
  375.        Hopeful this door will stay compatible with the most popular
  376.        used BBS programs.  If you also find an area of this program
  377.        or in this documentation that is hard to understand,  or that 
  378.        the program doesn't function properly when it should,  please
  379.        feel free to get in touch with me as well.
  380.  
  381.  
  382.        
  383.           And hey,  there you have a File Request Door program running on
  384.           your board with hopefully all the style and class
  385.           your board deserves....
  386.           
  387.           Thank you again for evaluating this program.
  388.           and hope to hear from everyone soon.
  389.  
  390.  
  391.  
  392.  
  393.                                           Richard Rog
  394.                                           NightLine Elite Computing
  395.  
  396.  
  397.