home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / RA / BBSDOR25.ZIP / BBS_DOOR.DOC < prev    next >
Text File  |  1994-04-05  |  13KB  |  307 lines
  1.  
  2.  
  3.         BBS_DOOR version 2.50
  4.         The Premiere BBS Listing Door for DORINFO1.DEF systems!
  5.         by Mark L. Sarnov, Fozzy INC.
  6.         March 1994
  7.  
  8. The BBS_DOOR system includes :
  9.  
  10.        BBS_DOOR.EXE    : the executable door file.
  11.        BBS_TOOL.EXE    : Command Line program to generate listings, RENUMBER
  12.                          the entries, and IMPORT entries from another
  13.                          BBS_DOOR.BBS file or a TEXT file Listing into your
  14.                          listing!
  15.        BBS_DOOR.XFR    : Protocol/Archive Definition file for Downloading.
  16.        BBSHELP.ANS/ASC : Help Screens for callers without Nuking Security
  17.        BBSHELP2.ANS/ASC: Help Screens for callers with Nuking Security.
  18.  
  19.        BBS_DOOR.DOC    : This File!
  20.        BBS_TOOL.DOC    : Doccumentation for BBS_TOOL.EXE
  21.        BBS_DOOR.REG    : The BBS_DOOR registration form! <hint, hint!>
  22.  
  23. supplemental files :
  24.  
  25.         11TO25.EXE     : Use this file to update your BBS_DOOR.BBS from
  26.                           version 1.0, 1.1 to 2.5.
  27.         20TO25.EXE     : Use this program to update your old BBS_DOOR.BBS
  28.                           file if you have used BBS_DOOR version 2.0.
  29.         TEMPLBDR.250   : Sample TEMPLATE file to be used with BBS_TOOL.EXE
  30.                           when importing a TEXT FILE LISTING created by
  31.                           BBS_DOOR.EXE v2.5 or BBS_TOOL.EXE v2.5.
  32.         TEMPLBDR.200   : Sample TEMPLATE file to be used with BBS_TOOL.EXE
  33.                           when importing a TEXT FILE LISTING created by
  34.                           BBS_DOOR.EXE v2.0.
  35.  
  36.  
  37. What BBS_DOOR.EXE does!
  38.  
  39.         This door will create and maintain a BBS listing for your BBS. This
  40.         program features :
  41.  
  42.         * Compatibility with any system using a standard DORINFO1.DEF
  43.           drop file!
  44.         * Easy execution as Type 7 (External Door) menu option
  45.         * Alphabetized listing of the BBS's
  46.         * Brief Display of BBS name, number, location as well as ability
  47.           to examine details of an entry.
  48.         * Detailed entry lookup including
  49.             BBS Name, Number, Sysop, Location,
  50.             Software, Baud Rates, Hours of operation,
  51.             Networks the BBS is on, and 3 lines of additional comments!
  52.         * Almost Unlimited number of listings! ([9999] numbered lisings)
  53.         * Checking for Duplicate entries, regardless of how user enters
  54.           BBS name (i.e. "FOZZY'S PLACE" will not be added if "Fozzy's Place"
  55.           is already listed)
  56.         * Editing of specific entries provided the user editing is the user
  57.           who posted the listing OR is the SYSOP of the BBS!
  58.         * Ability to NUKE (Delete) listings if security level is above the
  59.           security level indicated on the command line.
  60.         * Ability to CREATE ARCHIVED LISTINGS for Download!!
  61.         * Generation of BBS listings in TEXT FILE FORMAT!
  62.         * Ability to DOWNLOAD the Entire Listing from within the door!
  63.           (External transfer program required)
  64.         * Ability to Search desired entries based on specific field criteria!
  65.                 ** Now Advanced Cross Indexing!! **
  66.         * Help screens in ANSI/ASCII format called from within program!
  67.         * more stuff too! Try the program and see!!
  68.  
  69. How to setup and use this door for your BBS!
  70.  
  71. SETUP:
  72.         First create a directory where you would like the BBS_DOOR program
  73.         files to reside, then copy all the archive files to that directory!
  74.  
  75.         For example, create the directory "C:\RA\BBS_DOOR", then copy all
  76.         files from the BBS_DOOR archive to "C:\RA\BBS_DOOR".
  77.  
  78.         Then... make sure the following environment variables are set up.
  79.  
  80.   The program will search for a unique environment variable called
  81.      BBS_DOOR so please include :
  82.  
  83.          SET BBS_DOOR=drive:\dir\ <path to BBS_DOOR files>
  84.            in your batch file or your AUTOEXEC.BAT
  85.  
  86.         For example, if you have your files in "C:\RA\BBS_DOOR" then place
  87.  
  88.         SET BBS_DOOR=C:\RA\BBS_DOOR
  89.  
  90.                 in your AUTOEXEC.BAT file!
  91.  
  92.        This is VITAL for BBS_DOOR to find the files BBS_DOOR.XFR,
  93.           BBSHELP*.ANS/ASC, and BBS_DOOR.BBS program files!
  94.  
  95.   The program will also search for the RA environment variable..
  96.  
  97.      (i.e. SET RA=c:\ra in AUTOEXEC.BAT)
  98.  
  99.      to locate the DORINFO1.DEF drop file from your BBS program in order to
  100.      operate properly..
  101.           Make sure the environment variable is set correctly!
  102.  
  103. Execution
  104.  
  105.  [Method 1]
  106.  
  107. Run this program as a Type 7 external door with the command line :
  108.  
  109.         c:\RA\BBS_DOOR\BBS_DOOR.EXE /S=<sec level> /N=*N /L=Filename *M *D
  110.  
  111.    the /S=<sec level> will be the minimum level a person can
  112.              Nuke (delete) a BBS listing.. Handy if you want to allow only
  113.              Visiting sysops to delete listings or set it to the SYSOP security
  114.              level to insure only the SYSOP can nuke a listing. This option
  115.              is MANDATORY!
  116.  
  117.    the /N is for the node you are launching from.. default is
  118.              node 1. This parameter is optional.
  119.  
  120.    the /L=Filename determines if you would like the program
  121.              to allow the DOWNLOADING of the TWO types of BBS LISTINGS!
  122.  
  123.        **NOTE : Do not include the filename's EXTENSION! See the DOWNLOAD
  124.        section under PROGRAM FEATURES below for details!
  125.  
  126.      *M will allow Remote Access to swap itself to EMS/XMS (one of the
  127.         two) so BBS_DOOR will occupy conventional memory and also have room
  128.         for the External File Transfer Protocols to run properly!
  129.  
  130.      *D will force RemoteAccess to produce a DORINFO1.DEF without the "-R"
  131.         denoting error correction after the baud rate.
  132.  
  133. For Example :
  134.  
  135.         Type 7 (Run External Door)
  136.         BBS_DOOR.EXE /S=100 /N=*N /L=C:\RA\BBSLIST *M *D
  137.         Hot Key : L
  138.         AutoExecute : No
  139.  
  140.         will only allow users equal or over a security of 100 to nuke entries
  141.         and Downloading is enabled with the files "C:\RA\BBSLIST.LST"
  142.         transferred as the COMPLETE listing and "C:\RA\BBSLIST.SCH" as the
  143.         SEARCHED listing. After the user quits the program, a complete list
  144.         of the entries is created in "C:\RA\BBSLIST.LST" for display as a
  145.         "Display Text File" from within RA.
  146.  
  147.  
  148.  [Method 2]
  149.  
  150.         Run this program after a Type 15, Exit with Errolevel
  151.  
  152.         You can run this program from a batch file like any other Door program.
  153.  
  154.         Just use the same format as noted above in your batch file.
  155.         If you are using BBS software that does not create a DORINFO1.DEF drop
  156.         file, you can run a CONVERTER like QDOOR.EXE, or DM.EXE (Door Master)
  157.         that can create one for you! You may have to fiddle around with
  158.         where you put the DORINFO1.DEF file, but in most cases, put it in
  159.         the directory you are running the batch file from!
  160.  
  161.  
  162.                ------------ PROGRAM FEATURES!! ---------------
  163.  
  164. [A]dd a BBS:
  165.  
  166.      The program will allow ALL users to Add entries. The Adding of a entry
  167.      is menu driven and the user may edit the entry before saving it to the
  168.      listing.
  169.  
  170.  
  171. [E]dit a BBS:
  172.  
  173.      Users can Edit existing entries provided they are the one who
  174.      entered it in the first place. (Sysops can Edit ANY entry).
  175.  
  176.  
  177. [I]nfo on BBS:
  178.  
  179.      Users can obtain more details on an entry than initially displayed.
  180.      The general listing only shows BBS Name, number, location, and whether
  181.      the current caller entered the entry. The caller can enter the number of
  182.      the BBS entry and gain other details.
  183.  
  184.  
  185. [S]earch:
  186.  
  187.      This REVAMPED option in BBS_DOOR version 2.50 now presents you with a
  188.      menu to activate certain fields to search and the keywords associated
  189.      with those fields. The fields available for searching and limiting the
  190.      listings are NAME, NUMBER, LOCATION, SYSOP, NUMBER, BAUD RATES, SOFTWARE,
  191.      and NETWORKS. The program will display the number of entries that match
  192.      the entered criteria each time you change a setting. The caller may then
  193.      <D>isplay the Entries, <R>eset all fields, or <E>xit and do not search.
  194.  
  195.     ** If a <D>isplay Entries is selected when ZERO entries match the criteria
  196.        the [S]earch is disabled but the criteria is saved for modification.
  197.  
  198.        When the [S]earch is activated, the Menu Item for [S]earch will be
  199.        capitalized ([S]earch) and FLASH! <blink, blink>. To disable the
  200.        SEARCH, the caller must choose the [S]EARCH again and [E]xit and
  201.        do not Search from the SEARCH SCREEN.
  202.  
  203.  
  204. [D]OWNLOAD:
  205.  
  206.     Users may download the entire listing (details on each BBS included)
  207.     or a subset of the listing (see below) provided the program has access
  208.     to an external transfer program like CEXYZ.EXE. The program requires a
  209.     "protocol definition file" called BBS_DOOR.XFR and one is included with
  210.     documentation in the file. To use the Download option, you must also use
  211.     the /L=<Filename> parameter when calling the door in order to tell
  212.     BBS_DOOR.EXE  the name of the file listing to transfer! If you have other
  213.     external file transfer programs and set them up correctly, please send me
  214.     a note with the program's command line structure via netmail!
  215.  
  216.     You may use the *B and *P parameter to designate Baud and Port #
  217.     respectively in the BBS_DOOR.XFR file for you multi-line sysops!
  218.  
  219.    BBS_DOOR utilizes the SEARCH feature for the downloadable BBS
  220.       Listing as well. IF the user has the SEARCH ACTIVATED, the caller
  221.       will be asked if he/she would like to download :
  222.  
  223.                 [1] COMPLETE BBS Listing
  224.                 [2] SEARCHED Listing
  225.  
  226.        If the caller selects the COMPLETE Listing, the text file created
  227.           will be named : FILENAME.LST.
  228.  
  229.        If the caller selects the SEARCHED Listing, the text file created
  230.           will be named : FILENAME.SCH
  231.  
  232.        IF the SEARCH is NOT ACTIVATED, BBS_DOOR will default to the COMPLETE
  233.         listing and not prompt the user for a choice of BBS Listings.
  234.  
  235. **   BBS_DOOR now can archive the listing created above into NINE definable
  236.      archive types, such as ZIP, ARJ, LZH. The setup for these archive
  237.      definitions is explained and examples are given in the BBS_DOOR.XFR
  238.      file with adequate doccumentation. The caller will be prompted to choose
  239.      an ARCHIVE format or [N]one, If no ARCHIVE definitions are present in the
  240.      BBS_DOOR.XFR file the uncompressed listing will be transferred.
  241.  
  242.      Then the caller will be prompted for the type of protocol defined in
  243.       the BBS_DOOR.XFR file.
  244.  
  245.  
  246. [N]uke:
  247.  
  248.       Callers can DELETE a file entry provided their security is equal to or
  249.       higher than the value you set in the command line with the
  250.       /S=<sec level> parameter. (optional data field in the RA menu structure!)
  251.  
  252.  
  253. [H]elp!
  254.  
  255.         BBS_DOOR version 2.5 has built in HELP screens that must be located
  256.         in the directory pointed to by the SET BBS_DOOR=drive:\directory
  257.         environment variable.. (Am i harping on this point?) The help files
  258.         have the names of BBSHELP*.ANS/ASC.
  259.  
  260.  
  261. [M]ore
  262.  
  263.         Advance One Page (15 listings)
  264.  
  265.  
  266. [B]ack 1 page
  267.  
  268.         umm. Back one page.. (15 listings back!)
  269.  
  270.  
  271. [R]elist
  272.  
  273.         Displayed at the END of the listing, the List will restart from Entry
  274.         Number ONE!
  275.  
  276.  
  277. [Q]uit
  278.  
  279.         Quit the program and return to the BBS.
  280.  
  281.  
  282.                                  DISCLAIMER!!
  283.       This program is not guaranteed to do anything but take up space on your
  284.       hard drive. It has been tested fairly extensively and should not corrupt
  285.       any of your RA files, however.. Backup your files consistently and often,
  286.       a rule that applies to any computer user!!
  287.  
  288.    This program will display una UNREGISTERED EVALUATION VERSION at the top
  289.    of the caller screen if you are not registered! The program is not crippled
  290.    in any way, but if you use this program for more than 21 days, it would
  291.    be nice to show your appreciation and register this fine door for a paltry
  292.    $15 US! :) The program won't go boom or anything, but you may wind up with
  293.    a guilty conscience!
  294.  
  295. To encourage future versions of this program please register by sending $15
  296. to:
  297.  
  298.                 Mark Sarnov
  299.                 c/o Fozzy INC.
  300.                 44 Avonwood Rd.
  301.                 Apt #221
  302.                 Avon, CT 06001
  303.  
  304.  
  305.                                         Thanks!   Mark Sarnov
  306.  
  307.