home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / RBBS_PC / RCHAT300.ZIP / RBBSCHAT.DOC < prev    next >
Encoding:
Text File  |  1990-08-28  |  10.7 KB  |  223 lines
  1.  
  2.  
  3.   RBBS-PC Internode chat modifications  Release 3.00    August 28 1990
  4.   Copyright 1989-1990 by John Morris  All Rights Reserved.
  5.  
  6.   Written By:
  7.   John Morris
  8.   TradeWars Software
  9.  
  10.   I can be reached on my BBS:
  11.   The Reno RBBS
  12.   (702)746-1358  Voice  (limited hours)
  13.   (702)746-1364  Strictly V32
  14.   (702)746-1365  USR-HST
  15.  
  16.   Included are three files which can be BLED into the current RBBS 17.3 code,
  17.   but it may be a LOT faster just to merge it in by hand. These files are:
  18.  
  19.   R-PCCHAT.MRG      to be merged into RBBS-PC.BAS
  20.   RSB1CHAT.MRG      to be merged into RBBSSUB1.BAS
  21.   RSB2CHAT.MRG      to be merged into RBBSSUB2.BAS
  22.   RSB4CHAT.MRG      to be merged into RBBSSUB4.BAS
  23.   RSB5CHAT.MRG      to be merged into RBBSSUB5.BAS
  24.   RBBS-VAR.MOD      sample include file needed for RCHAT300.BAS
  25.   RCHAT300.BAS      to be added to RBBS-PC.EXE at link time..
  26.   RBBSCHAT.BAT      sample batch file to merge in Chat Mods.
  27.   CHAT.MNU          chat help, a menu list of chat commands.
  28.  
  29.   This code is intended to be compiled with QuickBASIC 3.0 or later, mainly
  30.   because I make generous use of block IF..END IF statements. I also don't
  31.   use a whole lot in the way of line-numbers, which means I use quite a few
  32.   DO..LOOP statements.
  33.  
  34.   This will one of many releases of this code, and it is my third release
  35.   of my internode chat code.  I wanted the ability of the user to page another,
  36.   and I also wanted to see if I could emulate a 'True chat'. I do realize that
  37.   there are quite a few chat products out there in BBS-land, but none follows
  38.   the RBBS tradition of including source code, which means that they have to be
  39.   implemented as doors.
  40.   My logic is that if a system is popular enough to have multiple nodes, it has
  41.   a good file & message bases (doors are generally secondary in multi-node
  42.   systems)  So, why should a guy have to open a door?  Just my humble opinion.
  43.   So anyways, here is the code for you to play with.
  44.  
  45.   You are free to modify the code for implementation in your system, but you
  46.   may not distribute this code in modified form!  If you'd like to see your
  47.   mods incorporated into the official release of this mod, then give me a
  48.   jingle, and I'll happy to talk with you about your mods.
  49.  
  50.   How its -supposed- to work
  51.   --------------------------
  52.  
  53.   This mod will give your users access to 2 new commands. Rather than message
  54.   around with CONFIG I decided all 'options' will have to be hard-coded, which
  55.   means these commands are hard-coded.  The commands are:  CHAT  and  @
  56.   (The '@' is for turbo-key users)  you can, of course, change these to
  57.   whatever you like (they are found in R-PCCHAT.MRG).  For the first couple
  58.   o' releases I made 2 separate ways to chat. Starting with 3.00 there is one
  59.   chat routine, that will function like two. All chats are character by
  60.   character. Each node uses a 72 byte ring-buffer to hold the typed text.
  61.   (Thanks go out to Cary Kolker for help on the ring buffer!)  Because each
  62.   character typed by each node must be saved to disk, there is always the
  63.   possibility of things going wrong. Thats the main reasoning behind the
  64.   ring-buffer.  For best performance, and to save where and tear on your
  65.   hard disk, I suggest modifying RCHAT300.BAT where it says:
  66.  
  67.      CONST ChatFileName$ = "RBBSCHAT.DEF"
  68.  
  69.   Change that to a RAM drive. For instance, if your RAM drive was drive H,
  70.   you'd change it to:
  71.  
  72.      CONST ChatFileName$ = "H:RBBSCHAT.DEF"
  73.  
  74.   The chat mod also uses shared files with record locking. This means you need
  75.   to have SHARE loaded on each node running the chat mods. (you can find
  76.   SHARE.EXE on your DOS disk)  RBBSCHAT.DEF is opened in SHARED mode, with
  77.   read & write access (nobody is denied access). A record will be locked
  78.   immediately prior to a read or write operation. It will be unlocked
  79.   right after the read/write operation. This does not operate in the same
  80.   manner as RBBS-PC itself!  I fully realize this.  I don't think the chat
  81.   would work at all using the same file locking methods as RBBS, so I did
  82.   not try to use the RBBS methods.  I may be wrong, and I realize that.
  83.   As long as most folks are using DOS 3.1 or above, we might as well make use
  84.   of its abilities.
  85.  
  86.   Before you merge things in
  87.   --------------------------
  88.  
  89.   RCHAT300 uses variables which are local to any code in RCHAT300, along
  90.   with the global variables used by RBBS. Because of this, you must modify
  91.   your RBBS-VAR.BAS file.  First, you need to add the variable:
  92.  
  93.   ZAvailableForChat
  94.  
  95.   To the file. Put it in the file in alphabetical order. (so you remember
  96.   where its at)
  97.  
  98.   Next, you need to make a copy of your RBBS-VAR.BAS file. Copy it to
  99.   RBBS-VAR.MOD. In RBBS-VAR.MOD, delete the DEF FNxx  line.
  100.   Take this line:
  101.  
  102. DEF FNOffOn$ (Switch) = MID$("OffOn", 1 - 3 * (Switch <> 0), 3)
  103.  
  104.   and delete it! If you have used the ANSI Editor mod, you will notice this
  105.   it uses the exact same modification, and if you already have an RBBS-VAR.MOD
  106.   go ahead and use it.
  107.  
  108.   All mods are commented with 'CHATxxxx'  (where xxxx is the date) starting
  109.   at column 70.
  110.  
  111.   NOTE:  I've included a 17.3A RBBS-VAR.MOD file as an example. You may use
  112.   it if you are running a stock 17.3A RBBS-PC.
  113.  
  114.   How to compile and link RCHAT300.BAS
  115.   ------------------------------------
  116.  
  117.   I've tried several different ways of compiling RCHAT300. The best way
  118.   is simply to use to the command:
  119.  
  120.   QB RCHAT300.BAS /O;
  121.  
  122.   That's it!  And add RCHAT300.OBJ to your list of OBJect modules to link
  123.   together.
  124.  
  125.   Update History:
  126.   ---------------
  127.   02/14/90   First bungled release.. forgot to put CHATHELP into the ZIP
  128.   1.00       file I uploaded to a couple places. Fixed that on my system,
  129.              but a lot of guys missed it.
  130.  
  131.   03/22/90   Second release. Went and added some improvements, and implemented
  132.   2.00       some of Tom Macks ideas for internode chat.  These include
  133.              a way for each user to 'lock-out' a page attempt from other
  134.              nodes. This allows them to roam in privacy.  The option is toggled
  135.              from the (where else?) T)oggle options prompt.
  136.  
  137.              Thanks go out to Cary Kolker for doing something very similar to
  138.              what I was planning for the TrueCh@. Basically to keep some
  139.              systems from dropping chars here-and-there, Cary implemented
  140.              the TrueCh@ in a 'ring buffer' concept.  Adding only about 6
  141.              or 7 lines to the existing code.
  142.  
  143.              Also, I attempted to implement a way to save the node chats to
  144.              disk (as per the SysOps option, check RCHAT300.MRG in the comments
  145.              for info on how to turn this option on.. I didn't wanna screw
  146.              around with CONFIG) I took the following ideas into consideration:
  147.  
  148.              1: Each chat should have its own unique filename.
  149.                 -OR, 1a: would one file be okay??
  150.              2: One node should write the chat to disk to make sure that
  151.                 the text is saved in correct order. And this also keeps
  152.                 the entire chat in the same file.
  153.                 -OR, 2a: would it be okay if each node:
  154.                          a: opened the chat file (in file-locked mode)
  155.                          b: appended its text to the end
  156.                          c: closed the chat file
  157.                      for EACH line typed by EACH node?
  158.              3: Users are told if the SysOp has told the chat mods to save the
  159.                 chat to a file.
  160.  
  161.              Problem with above??:
  162.              ---------------------
  163.              Anyways, Using my ideas (1, 1a, 2 and 2a) there are lots of
  164.              problems to consider.. not being a great programmer I might
  165.              have missed some brilliant idea, but these are problems I see
  166.              with the above:
  167.  
  168.              Ideas 1a and 2a would work fine together, but how would we know
  169.              where one chat starts and/or ends? or does it matter?
  170.  
  171.              Ideas 1 and 2a present another problem, how would each node
  172.              know the unique filename for that chat?
  173.  
  174.              There are more problems, just give it a little thought.
  175.  
  176.              I chose to implement ideas 1 and 2 in this fashion:  The node
  177.              that initiates the chat (in this case one node pages another)
  178.              saves the chat to disk using a unique filename (using time and
  179.              date info).  If another user joins in, that node realizes it has
  180.              not paged, and does try to save anything to disk. What happens
  181.              when nodes are 'squelched'?
  182.  
  183.              Maybe, each chat should have a 'process number' which identifies
  184.              the chat as unique.
  185.  
  186.              Actually, I'm not going to say:  "This is how it works, so live
  187.              with it!"  I'd rather get input from every SysOp who wants to
  188.              contribute and then proceed from there.  How should the above
  189.              ideas be worked out?
  190.  
  191.              In the end, I think that I'll plan each chat as a separate
  192.              'process'. Each process has its own unique name or number, and
  193.              then the chats will be saved according to process number.
  194.  
  195.   08/28/90   Heavily modified the chat code. All chats are now character by
  196.   3.00       character. This works fine even with multiple nodes. A TrueChat
  197.              is now considered a private chat between two nodes, and does
  198.              not have its own separate subroutine. The mod now uses a menu
  199.              system instead of using separate Ctrl-x sequences for each
  200.              'command'  You now type 'Ctrl-Q or ESCape' to get the chat menu,
  201.              and a chat command prompt, and you can then page someone, see
  202.              who is on, etc, from the prompt. To exit back into Chat, you
  203.              simply type C (for Chat) or [ENTER].  The W)hos on section was
  204.              rewritten to tell the user what the other user might be doing.
  205.              For instance, a user might be in Doors, or may be in the message
  206.              system, or in the file system. Whos on will now tell them. If the
  207.              user sees a CITY after the other users name, they are likely
  208.              to be able to page them. The file number used by RCHAT300 was
  209.              changed to 9, becuase I failed to realize that file 7 was used
  210.              by the voice board driver.
  211.  
  212.  
  213.   Revision numbers for RBBS Chat mods.
  214.   ------------------------------------
  215.   Revision numbers are as follows:  x.yz
  216.                                     x    gets incremented when code is added
  217.                                          or heavily modified.
  218.                                     y    gets incremented on a major bug fix
  219.                                          release
  220.                                     z    gets incremented on a minor fix
  221.  
  222.   End of RBBSChat.doc
  223.