home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / myboyhos.zip / README.TXT < prev    next >
Text File  |  1989-12-02  |  10KB  |  188 lines
  1.  
  2.  
  3.                              NEW BOYAN HOST
  4.                              ~~~~~~~~~~~~~~
  5.  
  6.    INTRO:  When I first saw Boyan's host, I thought it could use a little
  7.    more "pizzazz" and some serious rework on the program flow.  What I've
  8.    done here is to completely rewrite the script and add the following
  9.    features (to name a few of the important ones):  Caller can select text
  10.    colors for his/her type and/or text from my host, I eliminated the need
  11.    for a secondary hostmsgs.bsc - all functions run off one script, I tied
  12.    function access to a single PW - only the sysop can delete messages and
  13.    shutdown the host, new callers are limited to message action and chat
  14.    only, recognized callers have full access to messages, chat and files, I
  15.    added FV.COM to enable callers to view archive file contents on line, I
  16.    enabled the sysop to put messages, files, scripts, text files, etc in
  17.    whatever directories he/she chooses, I added the recognition by the
  18.    script of attempts by callers to select unauthorized functions more than
  19.    three times (automatic logoff results), it also recognizes
  20.    (and logs off callers) who fail to enter the correct password in three
  21.    times.  This host is by no means an attempt to write a BBS, but I think
  22.    it does do a good job in spicing up your host mode.  My name and address
  23.    are listed at the end should you have any suggestions for improvement or
  24.    comments on bugs found.  Hope you enjoy it.
  25.  
  26.    I.  Files Required (Most are included in archive, the ones that aren't
  27.                       get created by Comm.bat)
  28.  
  29.        a.  Host.bsc - this file replaces both host.bsc and hostmsgs.bsc, all
  30.                       functions run off one script
  31.  
  32.        b.  Welcome.msg - this is a sample ansi opener the caller will see
  33.                          when first connecting..substitute one of your
  34.                          choice.  THE DRAW is a good program to use if you
  35.                          want to make one.
  36.  
  37.        c.  Main.mnu -  A sample main menu you can use or change as you
  38.                        see fit.
  39.  
  40.        d.  Prot.mnu -  A sample protocol menu you can use or change
  41.  
  42.        e.  Send.bat - A small batch file that sends text out the modem
  43.                       faster than Boyan's default ULa convention.
  44.  
  45.        f.  Flist.bat - A small batch file which invokes FV.Com ..used for
  46.                        viewing archive file contents. (Note:  ZIPTV can be
  47.                        substituted for FV.COM - if you add ZIPTV, scan the
  48.                        Host.bsc for :VIEW, change the area that's currently
  49.                        \DC[FLIST %V0] to \DC[ZIPTV Pn Ty Lx %V0],
  50.                        where n = your comm port, y = time in minutes allowed
  51.                        in ZipTV and x = length in lines.  You'll need to get
  52.                        ZIPTV20.ZIP from a BBS.  Once ZipTV is installed, you
  53.                        can delete Flist.bat and FV.Com.)
  54.  
  55.        g.  Comm.bat -  A small batch file which initializes the msg.lst and
  56.                        files.lst files.  Invoke Boyan using this batch versus
  57.                        just typing in Boyan
  58.  
  59.        h.  Msg.lst -  A listing of messages available to be read by the
  60.                       caller.  Created and/or updated by Comm.bat
  61.  
  62.        i.  Files.lst -  A listing of files available for download by the
  63.                         caller.  Created and/or updated by Comm.bat
  64.  
  65.        j.  New.lst -  A list of new files uploaded..only sysop can see
  66.                       this one.
  67.  
  68.        k.  Free.lst - a crude, but effective method of showing the caller
  69.                       how many bytes you have free in your upload
  70.                       directory...just a redirected "dir" of your upload
  71.                       dir.
  72.  
  73.        l.  Goodbye.msg - What the caller sees when he/she logs off..can
  74.                          be changed as you see fit.
  75.  
  76.        m.  FV.COM -   File View..the method I chose to view contents of
  77.                       archived files. (See my note above about adding
  78.                       ZipTV instead of FV.COM)
  79.  
  80.     II.  INSTALLATION
  81.  
  82.        a.  Copy all files to the directory where you run Boyan scripts.
  83.            (Files.lst and Msg.lst will be created when you run
  84.            Comm.bat -- New.lst is created first time someone uploads
  85.            something)
  86.  
  87.        b.  Using a text editor, scan the host.bsc file for places I've
  88.            included comments to the right.  Of particular importance is
  89.            the requirement to substitute your APPROPRIATE PATHS in the
  90.            spaces I've marked by "Path". If you change any of the file
  91.            names, be sure the correct name appears in these places as well.
  92.  
  93.        c.  While scanning the host.bsc with your text editor, go to
  94.            the area I've marked as for users and put in your name and
  95.            PW along with names and PW's of any users you wish to add to
  96.            the system.  Be sure your password as well as those of your
  97.            users are all different.  Access to functions is determined
  98.            by password. Be sure none of your known users takes "new" as
  99.            his/her system password.  "New" is the default PW I use for
  100.            all new callers...anyone with this password is limited to
  101.            message activity and chat only.
  102.  
  103.        d.  Using a text editor, edit Comm.bat to reflect appropriate path
  104.            for files as indicated..DELETE REMARKS BEFORE RUNNING!!
  105.  
  106.        e.  Create your own welcome.msg and goodbye.msg -- the ones I've
  107.            included are OK, but you probably will want something which
  108.            reflects your personal taste.
  109.  
  110.  
  111.    III.  General Comments
  112.  
  113.        a.  The files.lst and msg.lst (just the titles of files and messages,
  114.            not the files or messages themselves) should reside in the
  115.            same directory you run the script from..they can go anywhere you
  116.            want though..
  117.  
  118.        b.  The default file directory in Boyan (done via the Alt-C) should
  119.            be set to the directory where you keep files available for
  120.            downloading, not the directory where you want files uploaded.
  121.  
  122.        c.  Once you have the paths set in the host.bsc you can delete the
  123.            comments I put out to the right (after the "\\"'s).
  124.  
  125.        d.  I recommend you set your Alt-G macro to \IE-%AM,G[\AM[G]].  This
  126.            will make entering gossip (chat mode) a lot easier.
  127.  
  128.        e.  I make use of several shortcut macros to hold values for: user
  129.            selection for color of text to and from him, current on-line
  130.            user's PW (needed for return from chat), a counter for how many
  131.            times the caller selected something he/she shouldn't have.  If
  132.            you are hard set on using the same shortcut macros for something
  133.            else, then you can do one of two things:  a.  not use this host or
  134.            b:  scan the host.bsc for all occurrences of shortcut macro
  135.            symbols and "SM" type commands --- change all to your liking.  It
  136.            would be far easier, though, to change your current shortcut
  137.            macros to some other keys.  I use shorcut macros: 114, 115, 116,
  138.            120. These are in addition to the ones Boyan already uses in the
  139.            Host.bsc.
  140.  
  141.    III.  Running the script
  142.  
  143.        a.  You invoke the host just as you normally would -- Alt-I
  144.  
  145.        b.  When in local test mode -- ANSI SEQUENCES WILL NOT APPEAR ON
  146.            SCREEN AS THEY WOULD IF SOMEONE HAD CALLED -- don't be alarmed
  147.            if you see a bunch of ^[[2C or other ^[[ type phrases appear
  148.            on your screen while in local test mode.  That's normal.
  149.  
  150.        c.  IMPORTANT:  While you are in local test mode there are a couple
  151.            of menu options you must NOT select.  These are: (L)ist
  152.            messages, (F)ile names, and (V)iew Files.  I've got these
  153.            functions set up for remote use only since I can do these
  154.            without being in host mode.  Making them run in local test
  155.            mode requires more lines in the script than I think are
  156.            necessary.  Add them if you want, but don't select these options
  157.            till you do.
  158.  
  159.        d.  Going to Gossip Mode:  If a caller selects (T)alk w/Sysop, a
  160.            bell will ring at your end.  Should you decide you wish to chat
  161.            with the caller, hit (and hold for a second) the escape key.
  162.            This will interrupt the script and you should see
  163.            "Communication Ready" in the status block.  At that point hit
  164.            Alt-G (if you changed your macro to what I suggested) and you
  165.            will be in gossip mode (split screen) and ready for chat.  When
  166.            you are finished with chat, just hit Alt-I again and the host
  167.            script will resume at the main menu.  (The script checks for
  168.            carrier on start-up, if found, assumes you came back from chat
  169.            mode and bypasses the welcome.msg and PW screens).
  170.  
  171.    The best way to see what this new host does is to call it from another
  172.    computer as would normally be the case.  All ANSI will be interpreted by
  173.    the calling comm program and you will be able to see the colors and
  174.    cursor control actions as they actually appear on the remote end.
  175.  
  176.    I've completed what I believe is thorough testing on this new host but
  177.    will not guarantee there aren't any glitches in it.  I haven't found
  178.    any.  If you should find something wrong with it, I'd appreciate a note.
  179.    You can reach me at any of the Prince William County BBSs or my address
  180.    is:
  181.  
  182.          James Bennett
  183.          14751 Barksdale St.
  184.          Dale City, VA  22193
  185.  
  186.    Hope you enjoy this new Boyan host.  See you.
  187.  
  188.