home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / DDMENU20.ZIP / DDMENU20.DOC < prev    next >
Text File  |  1994-03-09  |  6KB  |  153 lines
  1. Beta Docs:  For DoorDoor 2.0 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.      15 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.
  9.  
  10. The programming toolkit assumes you are using a fossil driver.
  11.  
  12. Files included in ddmenu##.zip are:
  13. ddmenu.exe          The doordoor execution file.
  14. ddmenu.cfg          Sample config file (the name cannot be changed).
  15. nutedit.exe         The data editor.
  16. ddmenu##.doc        This file.
  17. readme.com          This file in a screen readable form.
  18. upgrade.doc         What do do if you already have a doordoor system.
  19. door.sys            Sample door.sys file.
  20. one.bat             Sample batch files.
  21. two.bat                      "
  22. three.bat                    "
  23.  
  24. The ddmenu.cfg should be as follows:
  25.      Line 1:   Sysop's name
  26.            //* If the sysop's names begin with capital letter and the
  27.                rest are lower case, then the sysop's name won't appear
  28.                as the last user when the sysop enters the door. If you
  29.                want your name to appear, then Make line 1 all capital
  30.                letters. I did this because I don't like everyone knowing
  31.                if or when I tried a door.  (tested with door.sys)*//
  32.      Line 2:   Name of the BBS
  33.  
  34.  
  35.  
  36. ddmenu.dat     (created with nutedit.exe)
  37.      Each line keeps the usage data for that door,
  38.           i.e. line1 is the data for doordoor 1. and looks like
  39.           the following:
  40.           str1,str2,str3,str4,str5^
  41.      where:
  42.      str1 is the number of times that ddoor1 has been entered.
  43.      str2 is an 'a' or 'p' or 'r'. If str1 is an 'a', then
  44.           the users alias will be printed as the last user. If it is a 'p',
  45.           then a name I chose will be printed, e.g. Liz Taylor. If an 'r'
  46.           is there, then the real users name will be used.
  47.      str3 is last user's name.
  48.      str4 is the time of day the last user entered the door.
  49.      str5 is the description of the door.
  50.      Please note that a comma is between each str# and the line ends with
  51.           a caret (shift-6) . This is essential that each line be in this
  52.           form! See the sample ddmenu.dat file included.
  53.  
  54. Directions to make door# on your system a gateway to doors.
  55.  
  56.      1-   Unzip the ddmenu.zip file into a work directory.
  57.      2-   Edit nuthse.cfg and ddmenu.dat to your wants.
  58.      3-   Test the system by entering the command:
  59.  
  60.           'nutedit ddmenu.dat'
  61.  
  62.           and then exit the nutedit program. It will create a ddmenu.dat
  63.           file with one door. Now enter the command:
  64.  
  65.           'ddmenu .'
  66.  
  67.           The . in the above command tells ddmenu.exe to look for door.sys
  68.           in the present directory. Hit the '1' key several times to
  69.           try out this system. If you like what you see, then continue.
  70.      4-   copy ddmenu.exe, nutedit.exe and the ddmenu.cfg into your
  71.           BBS directory,  e.g.  c:\wc30.
  72.      5-   Make a directory ddoor#, e.g. c:\wc30\doors\ddoor20 would be a
  73.           path to the directory if door20.bat is the bat file to the
  74.           gateway ddoor20.
  75.                e.g.:  give the following commands
  76.                     cd\wc30\doors
  77.                     md ddoor20
  78.  
  79.      6-   Change to this directory and enter the command
  80.  
  81.           'nutedit  ddmenu.dat'
  82.  
  83.           and make the ddmenu.dat file as you want it.
  84.      7-   Make a one.bat file to run the first ddoor program, a two.bat
  85.           to run the second doordoor program, etc. Each line
  86.           in the ddmenu.dat file should have a *.bat file included in
  87.           this directory. The bat files MUST be named as follows:
  88.                one.bat
  89.                two.bat
  90.                three.bat
  91.                four.bat
  92.                five.bat
  93.                six.bat
  94.                seven.bat
  95.                eight.bat
  96.                nine.bat
  97.                ten.bat
  98.                eleven.bat
  99.                twelve.bat
  100.                thirteen.bat
  101.                fourteen.bat
  102.                fifteen.bat
  103.  
  104.           You only need as many as doors you want to run in this doordoor.
  105.           Remember 15 doors is the maximun number of doors that can be run
  106.           from Doordoor. Look into one.bat file included.
  107.  
  108.      8-   Edit your door#.bat file so it appears as the following
  109.                ddmenu <path to doordoor dir>
  110.  
  111.           A sample door#.bat file would be:
  112.                ddmenu c:\wc30\doors\ddoor20
  113.  
  114.           It is essential that the above line be in the door#.bat file
  115.                before any change in directories, i.e. the ddmenu.exe
  116.                file must find your drop file first. If your door#.bat
  117.                file doesn't open up in a directory where your drop file
  118.                is, then first change to this directory.
  119.                e.g.
  120.                     c:
  121.                     cd\BBS\...\node1
  122.                     ddmenu c:\...\ddoor20
  123.  
  124.      9-   Fire up your BBS and try it, but first say a prayer and if it
  125.           doesn't work, you shouldn't get mad at me.
  126.  
  127.      This utility was compiled using Borland's 3.1 C++ compiler and Brian
  128.           Pirie's Opendoor door kit (which requires a fossil driver, e.g.
  129.           X00 or BNU, be installed).
  130.  
  131.      These docs were written for  a Wildcat BBS, as that is all
  132.      that I know. I think this system will fly on many BBSs, I don't know.
  133.      Also, it has not been tried out on a multi-node BBS, but I hope it
  134.      will run alright there also.
  135.  
  136.      This will say the procedure is registered to line 2 of the nuthse.cfg
  137.      file. If you like this program, and want your name to be included
  138.      as a donor in the next docs, you may send me a tax deductible
  139.      check made out to:
  140.                 Lock Haven University / Woodward Scholarship
  141.      in the amount you desire, and send to:
  142.  
  143.           Jim Woodward
  144.           556 W. Main St.
  145.           Lock Haven, PA 17745-1109
  146.  
  147.      This money will assist a future teacher spend a semester studying
  148.      abroad. I strongly believe that our teachers must understand other
  149.      cultures.
  150.  
  151.      Any other comments, good, bad, or indifferent are welcome, just
  152.      send to the above address.
  153.