home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / rli612 / mb.doc < prev    next >
Text File  |  1988-06-16  |  7KB  |  226 lines
  1.  
  2.      W0RLI MailBox and GateWay                  Page    1
  3.  
  4.  
  5.  
  6.      Created for packet community by:
  7.  
  8.       Hank Oredson, W0RLI
  9.       134 Ponderosa Drive
  10.       Santa Cruz, CA 95060
  11.  
  12.  
  13.      The code will run under DoubleDOS or DESQView.
  14.  
  15.      The code will run under Micrsoft Windows, but there will
  16.      probably be difficulties with the serial ports. These difficulties
  17.      will appear as lost characters from the tncs. If it works for you,
  18.      please let me know - what machine, how many ports, which ports,
  19.      how did you set it up, etc. etc. I do not have Microsoft Windows,
  20.      so cannot check this myself.
  21.  
  22.  
  23.        Running multiple copies of the MailBox.
  24.  
  25.      To run multiple copies, simply execute MB again in another window
  26.      or partition. All files and ports may be shared by up to 8 copies
  27.      of MB. Each copy will create it's own log file.
  28.  
  29.  
  30.       Bringing things up for the first time.
  31.  
  32.  
  33.      1) Prepare an AUTOEXEC.BAT file:
  34.  
  35. The supplied serial device driver (MBBIOS from AA4RE) replaces
  36. the standard INT 14 drivers included in the IBM ROM BIOS.
  37.  
  38. MBBIOS     supports many different serial boards. See MBBIOS.DOC for details.
  39. MBBIOS     was created by Roy, AA4RE.
  40.  
  41. Example driver setup as it might appear in your AUTOEXEC.BAT
  42.  
  43. LM
  44. SHARE
  45. MBBIOS
  46. MBMODE COM1:12,n,8,1
  47. MBMODE COM3:96,n,8,1
  48. MBMODE COM4:96,n,8,1
  49. MBMODE COM5:96,n,8,1
  50. MBMODE COM6:96,n,8,1
  51. MBMODE COM7:96,e,7,1
  52.  
  53. Note that LM and SHARE have also been loaded. LM is the MailBox
  54. Lock Manager, SHARE is the MS-DOS file sharing utility.
  55.  
  56.  
  57.      2) Edit CONFIG.MB for your configuration.
  58.  
  59. Put in your call, name, qth, and zip (or postal) code in the appropriate
  60. places. Set up various subdirectories for user files and for MailBox working
  61. files. Setup the port definitions to correspond to the hardware on your
  62. computer.
  63.  
  64.  
  65.      3) Plug in the tncs.
  66.  
  67. Make sure they are set for hardware handshake. See the *.SET files for
  68. examples of correct tnc parameter settings.
  69.  
  70.  
  71.      4) Put it on the air!
  72.  
  73.      W0RLI MailBox and GateWay                  Page    2
  74.  
  75.     Files on the distribution disk:
  76.  
  77. - The MailBox and GateWay programs:
  78.  
  79.    MB.EXE    -  The MailBox program, for 80286, 80386, V20, V30 processor.
  80.    MB88.EXE    -  The MailBox program, for 80xx  processor (XT).
  81.    MBMODE.EXE    -  Replacement for MODE command, supports COM1 - COM16.
  82.    PRTLOG.EXE    -  Log file analyzer.
  83.    RECOVER.EXE    -  Message and User file recovery program.
  84.    LM.COM    -  MailBox Lock Manager.
  85.  
  86. - Documentation and other text files:
  87.  
  88.    CONFIG.MB    -  Configuration data, login message, error messages, etc.
  89.    *.DOC    -  Release notes, tech notes, installation notes, etc.
  90.    PK232.SET    -  Setup parameter list for PK-232 and PK-87.
  91.    README    -  Basic information on getting started.
  92.    TNC1.SET    -  Setup paramater list for TNC1.
  93.    TNC2.SET    -  Setup parameter list for TNC2.
  94.  
  95. MailBox support files:
  96.  
  97.     HELP.MB   - The text for the "H" command.
  98.     INFO.MB   - The text for the "I" command.
  99.     FWD.MB    - The routing tables for forwarding messages.
  100.         You can create this file with any text editor.
  101.  
  102. The following files will be created by the MailBox:
  103.  
  104.     BID.MB    - Log of Message Identifiers.
  105.     CALLS.MB  - All calls heard by the MailBox.
  106.     MON.MB    - The saved "J" lists.
  107.     USER.MB   - The user database.
  108.     MAIL.MB   - The message database.
  109.     LOG.n     - The log files. A text file that contains the user log.
  110.         A seperate log is kept by each copy of the program.
  111.  
  112.  
  113. The cable between the computer and the TNC should have pins 2,3,4,5,7 and 20
  114. connected. Hardware flow control (CTS/RTS) is used in both directions.
  115.  
  116.      W0RLI MailBox and GateWay                  Page 3
  117.  
  118.  
  119.          Known restrictions.
  120.  
  121.  
  122. If you attempt to change a users information while that user is
  123. connected to the system, the change will not take effect. User
  124. information can only be changed when that user is not connected.
  125.  
  126.  
  127. There can be at most 50 pending different message destinations. These
  128. are the calls that show in the beacon text plus any calls in AT fields
  129. of messages that have not been forwarded. The only time this might cause
  130. a problem is if you keep many bulletins on the system, and they are
  131. not marked as read ("Y") or forwarded ("F").
  132.  
  133.  
  134.  
  135.          Message manipulation.
  136.  
  137.      One problem that confronts the sysop from time to time is the message
  138. that has the wrong type, wrong distribution list, etc. There are two ways
  139. to correct this problem.
  140.  
  141. 1) Use the "E" command and edit the message header. Because of the many
  142.    possibilities, this command is limited in scope. For simple changes,
  143.    such as "unkilling" a message, it will work. It will not create a
  144.    distribution list.
  145.  
  146. 2) Copy the message to a file and then make a new message.
  147.    This is simpler than it sounds. It requires two commands.
  148.    Here is an example. Assume someone sent a message to KB6BHN, and
  149.    instead of using SP KB6BHN @ W0RLI used instead SB KB6BHN @ ALLUSA.
  150.    Assume it was message number 325.
  151.  
  152.    First put the message into a file using the F command:
  153.    F 325 J
  154.    This puts the message into file J.
  155.  
  156.    Then make the new message:
  157.    MP J KB6BHN @ W0RLI
  158.    You can either enter the orignal title, or, since you had to do
  159.    all this work to correct a users error, just give the new message
  160.    a blank title!
  161.  
  162.    Now kill the orignal message.
  163.    K 325
  164.  
  165.  
  166.      W0RLI MailBox and GateWay                  Page 4
  167.  
  168.  
  169.      PRTLOG.EXE - The log file analyzer.
  170.  
  171.     PRTLOG OUT.PRT -opt
  172.  
  173. The output is placed in file OUT.PRT.
  174.  
  175. Options: -L lists the entire log.
  176.      With no options you get the usual monthly summary.
  177.  
  178. PRTLOG prompts for the names of log files. Enter them in time sequence order.
  179.  
  180.  
  181.  
  182.        Log file format
  183.  
  184.    Each line in the log file contains an event code, the date and time,
  185.    followed by further information about the event.
  186.  
  187.    'C' - User connected to system.
  188.       'A' -> 'H' - A user connected on that port.
  189.       'I' - Program startup.
  190.       'L' - User was linked via the station that just connected.
  191.       'S' - "connect" from local console (sysop).
  192.  
  193.    'G' - GateWay event.
  194.       'A' - Connection attempted and failed. Path shown.
  195.       'C' - Connection attempted and obtained. Path shown.
  196.       'E' - End of GateWay event, or use.
  197.       'M' - Start of monitoring.
  198.       'S' - Start of GateWay use.
  199.       'U' - Entry to unprotocol mode.
  200.  
  201.    'X' - Exit.
  202.       'A' - Owner put MailBox on line.
  203.       'B' - User said good bye.
  204.       'D' - User disconnected.
  205.       'E' - Excluded user attempted connect.
  206.       'F' - User forced off by system owner.
  207.       'Q' - Owner exited from program.
  208.       'T' - Timeout, forced disconnect.
  209.  
  210.    'F' - File event. Command line shown as user entered it.
  211.  
  212.       'D'  - File downloaded.
  213.       'K'  - File deleted.
  214.       'U'  - File uploaded.
  215.  
  216.    'M' - Message event. Message number always shown.
  217.  
  218.       'F'  - Message forwarded.
  219.       'FE' - End of forwarding session.
  220.       'FR' - Start of reverse forwarding within forwarding session.
  221.       'FS' - Start of forwarding session.
  222.       'K'  - Message killed.
  223.       'R'  - Message read.
  224.       'Z'  - Message entered. Message size shown.
  225.  
  226.