home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / mandown5.zip / MANDOWN.DOC < prev    next >
Text File  |  1994-02-01  |  12KB  |  288 lines
  1.  
  2.                                 ManDown!
  3.  
  4.                                   v1.5
  5.  
  6.                                    by
  7.  
  8.                               Bart Flentje 
  9.  
  10.                             
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                 OVERVIEW
  17.                                 ________
  18.  
  19.  
  20.   ManDown! v1.5 is the result of a need that I had on my BBS.  I found that
  21.   forcing NEWUSERS to download a NEWUSER registration package increased the
  22.   total registrations to my BBS, whether it be paid registrations, or users
  23.   actually sending in a legitimate I.D. to access the adult files.  I use
  24.   the door to force them to download my NEWUSER package and then I grant
  25.   them access to the system.  This could theoretically be used in conjunction
  26.   with a call back verifying door.  Having it set up in series:  such as 1st
  27.   verifying them by callback, then forcing download, and then granting access.
  28.  
  29.   This program was originally written with the thought that it was a totally
  30.   original idea.  After I had been running it for a while, I had noticed that
  31.   I was not the first to think of this idea with AT LEAST two other programs
  32.   that serve the same purpose.  I assure you that this is NOT the result of
  33.   an attempt to take from anyone else, but in fact I thought I was first.
  34.   I stand corrected.  Never the less, here it is.  If you like it, try it out!
  35.  
  36.   I also assure you that this program will be improved upon for my purposes
  37.   only, however, any revisions will be made available to the public as a
  38.   SHAREWARE system.  If anyone decides to register this product, as in ALL
  39.   of my programs, ALL future upgrades are absolutely free.
  40.  
  41.   This program WAS written using a registered version of Door Frame for 
  42.   which I give full credit to Ted Freeman.  God Bless.
  43.  
  44.    NOTE: Most errors will be logged to a file called DFRAME.ERR which is
  45.          created in the directory you run the door from.
  46.  
  47.  
  48.  
  49.                               INSTALLATION
  50.                               ____________
  51.  
  52.  
  53.    Installation is fairly easy and straight-forward. The following steps and
  54.    examples should have you up and running in a very short period of time.
  55.    It is assumed that you are familiar with setting up DOORS on your system.
  56.    
  57.    **********************
  58.    
  59.    IT IS ALSO assumed that you have the latest version of Omen Technology's
  60.    DSZ or GSX in your searchable path!!!
  61.  
  62.    If you would like to use the Comment to Sysop function, you will need
  63.    a copy of Postmaster in a DOS searchable path.  Please register your
  64.    SHAREWARE!
  65.    
  66.    **********************
  67.    
  68.    To this end, only examples of the configuration file and Door batch file
  69.    are described.
  70.  
  71.       1) Create a directory to hold all MANDOWN files
  72.  
  73.       2) Unzip MANDOWNx.ZIP into the the above directory
  74.  
  75.       3) Create a configuration file, with a name of your choice, or
  76.          modify the supplied MANDOWN.CFG file. A description follows:
  77.  
  78.      1      C:\WC30\WCWORK\NODE1\USERINFO.DAT     Path to system file
  79.      2      Eagan Wildcat! BBS                    Your BBS Name
  80.      3      Bart                                  Sysop's First name
  81.      4      Flentje                               Sysop's Last Name
  82.      5      0000000                               Registration Number
  83.      6      NEWUSER                               User profile to upgrade FROM
  84.      7      FREEUSER                              User profile to upgrade TO
  85.      8      15                                    Time adjustment
  86.      9      BITDEBRI.ZIP                          File to be forced
  87.      10     Yes                                   Use comment to sysop option
  88.                                                   must have Postmaster in a
  89.                                                   DOS path for yes answer.
  90.      11     GSZ                                   Which Omen Tech Zmodem to
  91.                                                   use.  DSZ or GSZ ONLY.
  92.      12     Yes                                   Allow return to BBS w/out
  93.                                                   downloading your file.
  94.                                                   Yes or No only.
  95.      13     Yes                                   Allow users in user log to
  96.                                                   have access.
  97.      14     C:\WC30\MANDOWN\FILES\                Path to the additional files
  98.                                                   you will offer to users.
  99.                                                   Must have trailing "\"
  100.      15     Yes                                   Use non-standard base and
  101.                                                   IRQ. Required for DSZ/GSZ.
  102.                                                   Mandown will also require
  103.                                                   parameters at command line!
  104.      16     2f8                                   Non-standard base if above
  105.                                                   is yes.  Lower case only!
  106.      17     3                                     Non-standard IRQ if above
  107.                                                   is yes.
  108.  
  109.  
  110.  
  111.                              *** Both of the preceeding user profiles
  112.                              MUST exist in your user database.
  113.                              Use MakeWild to create them if not
  114.                              already in database.
  115.  
  116.  
  117.                NOTE: There are NO Blank Lines in the Config File!! and must
  118.                      have 17 lines to operate properly.
  119.                      
  120.       
  121.       4) Create a batch file or modify the MANDOWN file supplied. A
  122.          description of this file follows:
  123.  
  124.             This could be MAIN1.BAT or MAIN2.BAT etc.
  125.  
  126.             ECHO off
  127.             cd\WC30\MANDOWN           Location of MANDOWN files
  128.             MANDOWNX MANDOWN1.CFG     This batch file MUST call the batch
  129.                                       file supplied with MANDOWN.       
  130.             CD\WC30
  131.             
  132.  
  133.        5) If you adding additional files to users, you need to add them to the
  134.           text file called MANDOWN1.LST.  The file info must be supplied in the
  135.           following format, I realize this is stupid and it will be converted
  136.           to a binary file very soon!!
  137.  
  138.           1NCALCAT51.ZIP
  139.           1DCalCat! v5.1 ultimate holiday screen swapper.
  140.           2NMANDOWN5.ZIP
  141.           2DManDown! v1.5 force your callers to download your registration
  142.           2Dand BBS information.
  143.           
  144.           The name of the files are denoted by xN with "x" being the file
  145.           number.  You CANNOT exceed 9 different files at this time.  There
  146.           CANNOT be more than 1 "N" for any single number.  The descriptions
  147.           are denoted by xD, D representing Description.  The x must be the
  148.           same x as in the N preceeding it.  Also, you may have up to 6 file
  149.           description lines for each file, BUT NOT MORE THAN 6!!
  150.           
  151.           To get a feel for what exactly this should look like, check out the
  152.           sample MANDOWN1.LST I have sent.
  153.  
  154. ********  Very important.....Any files you enter into the MANDOWN1.LST file
  155.           MUST actually reside in the additional files subdirectory that you
  156.           entered into the .CFG file.
  157.           
  158.        6) When running in more than one node, be sure to supply a
  159.           different configuration name for each node (your choice of name).
  160.  
  161.           AND use the %NODEID% environment variable.  I will supply both 
  162.           versions.
  163.  
  164.   
  165.  
  166.  
  167.                              COM Support
  168.                              ___________
  169.  
  170.       Support for COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  171.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  172.       number after the configuration filename. Let's assume your Door is
  173.       called BATMAN and you want to use COM1 and IRQ5. The command line
  174.       passed to your Door would be:
  175.                                    BATMAN BATMAN.CFG /5
  176.       The /5 tells BATMAN to use IRQ5 rather than the standard IRQ4 that is
  177.       normally used with COM1. No /x parameter is needed for the standard
  178.       IRQ's.
  179.  
  180.  
  181.  
  182.  
  183.  
  184.                               LEGALITIES
  185.                               __________
  186.  
  187.  
  188.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  189.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  190.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  191.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  192.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  193.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  194.       OR BREACH OF ANY WARRANTY.
  195.  
  196.  
  197.  
  198.  
  199.  
  200.                              DISTRIBUTION
  201.                              ____________
  202.  
  203.    You may make this file available for downloading from your BBS or you may
  204.    upload it to any BBS of your choice, provided that you do not make any
  205.    changes to the contents of the archive (ZIP file). The archive and its
  206.    individual contents may not be used by any service that charges any money
  207.    whatsoever, without the written permission of the author.
  208.  
  209.  
  210.  
  211.  
  212.  
  213.                              REGISTRATION
  214.                              ____________
  215.  
  216.    Registration and the subsequent insertion of the registration number into
  217.    your configuation file, allows for the display of your BBS name on the
  218.    opening and closing screen as well as the reduction of a delay built into
  219.    the opening screen display along with the ability to change certain
  220.    values in the configuration file.
  221.  
  222.    To register your copy of MANDOWN, please fill out the registration form
  223.    (REGISTER.DOC) and mail it along with $10.00 to the name and address on the 
  224.    form.  Registration keys will work for all future upgrades of this program.
  225.    
  226.    Be sure to fill in your name and BBS name as you wish to have them shown
  227.    and they MUST match the way you entered them in the configuration file.             
  228.  
  229.  
  230.    Remember, if you should have any problems with your door game, feel free
  231.    to get in touch with me on the MSI HQS BBS (1-805-395-0250) or you may
  232.    call me voice at 612-686-6276. (Before 11:30 p.m. C.S.T.)
  233.    BBS number is 612-686-8106.
  234.  
  235.  
  236.    Using MANDOWN...
  237.  
  238.      Very straight forward:
  239.  
  240.        1.  Run MANDOWN as a DOS hook from your MAIN menu or as one of
  241.            your LOGINx.BAT's.
  242.  
  243.        2.  If the users profile matches that of the configuration file
  244.            then user will be given a menu to either:
  245.              a. Edit File Queue
  246.              b. File Information
  247.              c. Choose Download Protocol
  248.              d. Download File Queue
  249.              e. Leave a comment to sysop
  250.              f. Quit back to BBS
  251.              g. Exit BBS system all together.
  252.              h. System Help
  253.  
  254.              
  255.            If the users profile does NOT match the specified profile, then
  256.            user will be prompted that he/she does not have access to go
  257.            through the download.  In other words, the user CANNOT go through
  258.            the download door and keep getting more access.  They will only
  259.            be granted access to profile specified in the .CFG file.
  260.  
  261.        3.  If the user chooses to download the file, the file will be sent
  262.            with there chosen protocol.  If the download has failed, the users 
  263.            profile will NOT be upgraded.  If the transfer was successful, 
  264.            the user will be upgraded and will be returned to BBS.
  265.  
  266.        4.  Simple.   
  267.  
  268.   ***  5.  In the config file, be sure to use the USERINFO.DAT file and NOT
  269.            DOOR.SYS.  It will not crash the system, and won't even cause an
  270.            error, BUT remember DOOR.SYS is not read in upon return to WILDCAT.
  271.            That means no upgrade to user.
  272.  
  273. ****************       
  274. IMPORTANT
  275. ****************
  276.  
  277.        6.  To change the name of the download file to be sent, you have to
  278.            edit this in the .CFG file.  If your file DOES NOT EXIST, it will 
  279.            return a failed download code to return of MANDOWN.  
  280.            
  281.            This is NOT fatal.
  282.            
  283.        
  284.        That's it.  Questions?  Call me.  612-686-6276  before 11:00 C.S.T.
  285.                                    BBS   612-686-8106  anytime!
  286.  
  287.  
  288.