home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / DDMENU25.ZIP / DDMENU25.DOC < prev    next >
Text File  |  1994-12-09  |  7KB  |  167 lines
  1. Beta Docs:  For DoorDoor 2.5 Menu System
  2.  
  3. Just what is this stuff?
  4.      This is a procedure that allows a door to call a gateway to up to
  5.      19 doors, and also keep the usage statistics for the doors in the
  6.      gateway. I will refer to these doors as doordoors from here on out.
  7.      The procedure creates its own menu for the gateway from the data
  8.      file ddmenu.dat. DDmenu can call itself, thus allowing one door
  9.      to open to possible 361 doors.
  10.  
  11. The program assumes you are using a fossil driver.
  12.  
  13. Files included in ddmenu##.zip are:
  14. ddmenu.med          The doordoor execution file. (medium *)
  15. ddmenu.slo          The doordoor execution file. (slowest *)
  16. ddmenu.exe          The doordoor execution file. (fastest *)
  17. ddmenu.cfg          File with registration name.
  18. nutedit.exe         The data editor.
  19. ddmenu##.doc        This file.
  20. readme.com          This file in a screen readable form.
  21. upgrade.doc         What do do if you already have a doordoor system.
  22. door.sys            Sample door.sys file.
  23. one.bat             Sample batch files.
  24. two.bat                      "
  25. three.bat                    "
  26.  
  27. The ddmenu.cfg should be as follows:
  28.      Line 1:   Registration name
  29.      Line 2:   Sysop's name. If you want this name to not appear
  30.                on the screen updates, enter it so each word begins
  31.                with a capital letter and the other letters lower
  32.                case.
  33.      example line 2:
  34.      Jim Woodward -> would cause Jim Woodward to not appear
  35.      Jim WoodwarD -> would cause Jim Woodward to appear on screen update.
  36.  
  37.      This file must be located in the c:\ (root) directory, or
  38.      the registration name will be the sysop's name.
  39.  
  40. ddmenu.dat     (created and/or edited with nutedit.exe)
  41.      Each line keeps the usage data for that door,
  42.           i.e. line1 is the data for doordoor 1. and looks like
  43.           the following:
  44.           str1,str2,str3,str4,str5^
  45.      where:
  46.      str1 is the number of times that ddoor1 has been entered.
  47.      str2 is an 'a' or 'p' or 'r'. If str1 is an 'a', then
  48.           the users alias will be printed as the last user. If it is a 'p',
  49.           then a name I chose will be printed, e.g. Liz Taylor. If an 'r'
  50.           is there, then the real users name will be used.
  51.      str3 is last user's name.
  52.      str4 is the time of day the last user entered the door.
  53.      str5 is the description of the door.
  54.      Please note that a comma is between each str# and the line ends with
  55.           a caret (shift-6) . This is essential that each line be in this
  56.           form! See the sample ddmenu.dat file included.
  57.  
  58. Directions to make door# on your system a gateway to doors.
  59.  
  60.      1-   Unzip the ddmenu.zip file into a work directory.
  61.      2-   Edit ddmenu.dat and ddmenu.cfg to your wants, then copy
  62.           ddmenu.cfg to c:\ , i.e. enter the command:
  63.           copy   ddmenu.cfg   c:\
  64.           after you have edited it.
  65.      3-   Test the system by entering the command:
  66.  
  67.           'nutedit ddmenu.dat'
  68.  
  69.           and then exit the nutedit program. It will create a ddmenu.dat
  70.           file with one door. Now enter the command:
  71.  
  72.           'ddmenu .'
  73.  
  74.           The . in the above command tells ddmenu.exe to look for door.sys
  75.           in the present directory. Hit the '1' key several times to
  76.           try out this system. If you like what you see, then continue.
  77.      4-   copy ddmenu.exe and nutedit.exe into your BBS directory,
  78.           e.g.  c:\wc30.
  79.      5-   Make a directory ddoor#, e.g. c:\wc30\doors\ddoor20 would be a
  80.           path to the directory if door20.bat is the bat file to the
  81.           gateway ddoor20.
  82.                e.g.:  give the following commands
  83.                     cd\wc30\doors
  84.                     md ddoor20
  85.  
  86.      6-   Change to this directory and enter the command
  87.  
  88.           'nutedit  ddmenu.dat'
  89.  
  90.           and make the ddmenu.dat file as you want it.
  91.      7-   Make a one.bat file to run the first ddoor program, a two.bat
  92.           to run the second doordoor program, etc. Each line
  93.           in the ddmenu.dat file should have a *.bat file included in
  94.           this directory. The bat files MUST be named as follows:
  95.                one.bat
  96.                two.bat
  97.                three.bat
  98.                four.bat
  99.                five.bat
  100.                six.bat
  101.                seven.bat
  102.                eight.bat
  103.                nine.bat
  104.                ten.bat
  105.                eleven.bat
  106.                twelve.bat
  107.                thirteen.bat
  108.                fourteen.bat
  109.                fifteen.bat
  110.                sixteen.bat
  111.                sevnteen.bat
  112.                ateteen.bat
  113.                nineteen.bat
  114.                NO More possible, and they must be spelled as above!!
  115.  
  116.           You only need as many as doors you want to run in this doordoor.
  117.           Remember 19 doors is the maximum number of doors that can be run
  118.           from Doordoor. Look into one.bat file included.
  119.  
  120.      8-   Edit your door#.bat file so it appears as the following
  121.                ddmenu <path to doordoor dir>
  122.  
  123.           A sample door#.bat file would be:
  124.                ddmenu c:\wc30\doors\ddoor20
  125.  
  126.           It is essential that the above line be in the door#.bat file
  127.                before any change in directories, i.e. the ddmenu.exe
  128.                file must find your drop file first. If your door#.bat
  129.                file doesn't open up in a directory where your drop file
  130.                is, then first change to this directory.
  131.                e.g.
  132.                     c:
  133.                     cd\BBS\...\node1
  134.                     ddmenu c:\...\ddoor20
  135.  
  136.      9-   Fire up your BBS and try it, but first say a prayer and if it
  137.           doesn't work, you shouldn't get mad at me.
  138.  
  139.      This utility was compiled using Borland's 3.1 C++ compiler and Brian
  140.           Pirie's Opendoor door kit (which requires a fossil driver, e.g.
  141.           X00 or BNU, be installed).
  142.  
  143.      These docs were written for  a Wildcat BBS. I do know that it works
  144.      in Renegade and Maximus, as well as Wildcat3.x and Wildcat4.x.
  145.      I have it running on Wildcat 4 and Maximus BBSs which share doors
  146.      and up/download files.
  147.  
  148.      Addendum: Added by request are the ddmenu.slo & ddmenu.med. If the
  149.      dot (*) is moving too fast copy ddmenu.med or ddmenu.slo over
  150.      ddmenu.exe .
  151.  
  152.           Jim Woodward
  153.           556 W. Main St.
  154.           Lock Haven, PA 17745-1109
  155.  
  156.  
  157.      Any other comments, good, bad, or indifferent are welcome, just
  158.      send to the above address.
  159.  
  160.      Wildcat BBS
  161.           Woody's NutHouse
  162.           717-748-5728 (Supra 28.8 V.FAST)
  163.  
  164.      Maximus 2.02 BBS
  165.           Woody's NutHouse II (ZyXEL 1496E+ V.32BIS)
  166.           717-748-1834
  167.