home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / packet / packetcl / mb.doc < prev    next >
Text File  |  1988-12-07  |  8KB  |  261 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 Microsoft 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.  
  44. LM
  45. SHARE
  46. MBBIOS
  47. MBMODE COM1:12,n,8,1
  48. MBMODE COM3:96,n,8,1
  49. MBMODE COM4:96,n,8,1
  50. MBMODE COM5:96,n,8,1
  51. MBMODE COM6:96,n,8,1
  52. MBMODE COM7:96,e,7,1
  53.  
  54. Note that LM and SHARE have also been loaded. LM is the MailBox
  55. Lock Manager, SHARE is the MS-DOS file sharing utility.
  56.  
  57.  
  58.      2) Edit CONFIG.MB for your configuration.
  59.  
  60. Put in your call, name, qth, and zip (or postal) code in the appropriate
  61. places. Set up various subdirectories for user files and for MailBox working
  62. files. Setup the port definitions to correspond to the hardware on your
  63. computer.
  64.  
  65.  
  66.      3) Plug in the tncs.
  67.  
  68. Make sure they are set for hardware handshake. See the *.SET files for
  69. examples of correct tnc parameter settings.
  70.  
  71.  
  72.      4) Put it on the air!
  73.  
  74.      W0RLI MailBox and GateWay                  Page    2
  75.  
  76.     Files on the distribution disk:
  77.  
  78. - The MailBox and GateWay programs:
  79.  
  80.    MB.EXE    -  The MailBox program, for 80286, 80386, V20, V30 processor.
  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.     WP.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. There can be at most 50 pending different message destinations. These
  123. are the calls that show in the beacon text plus any calls in AT fields
  124. of messages that have not been forwarded. The only time this might cause
  125. a problem is if you keep many bulletins on the system, and they are
  126. not marked as read ("Y") or forwarded ("F").
  127.  
  128.  
  129.     Message header formats in use at this time include:
  130.  
  131.  
  132.  
  133. R:date/time @:call qth #:nnn O:call S:date/time Z:zzz
  134. R:date/time @:call qth #:nnn O:call S:date/time
  135. R:date/time @:call qth #:nnn O:call Z:zzz
  136. R:date/time @:call qth #:nnn Z:zzz
  137. R:date/time @:call qth #:nnn O:call
  138. R:date/time @:call qth #nnn O:call
  139. R:date/time nnn@call qth
  140.  
  141.  
  142. 1) calls may have ssid
  143. 2) time may have timezone.
  144.    If so, may be single char or 3 char.
  145.    May be upper or lower case, or mixed.
  146. 3) qth may be enclosed in []
  147. 4) Space between @ call and qth may be missing
  148. 5) ":" between field ID and contents may be missing.
  149. 6) May be space between ":" and field contents.
  150.  
  151.  
  152. There are many other forms seen. They may leave out required information.
  153. They may have the required information in an unexpected format.
  154. There is little chance of parsing them all.
  155.  
  156.  
  157. PLEASE FOLKS ... keeps things simple. There is a good deal of software
  158. out there that looks at the message headers to determine paths, station
  159. locations, etc. etc. Save those cute messages and trite sayings for your
  160. login message. Put your QTH in the qth field. Put your postal code in
  161. the zip code field. Don't add extra "[", "]", "{}", "***" etc. Leave out
  162. your operating frequency, pet cat's name, brand of car you drive, agency
  163. you handle emergency communications for, etc.
  164.  
  165.  
  166.  
  167.          Message manipulation.
  168.  
  169.      One problem that confronts the sysop from time to time is the message
  170. that has the wrong type, wrong distribution list, etc. There are two ways
  171. to correct this problem.
  172.  
  173. 1) Use the "E" command and edit the message header. Because of the many
  174.    possibilities, this command is limited in scope. For simple changes,
  175.    such as "unkilling" a message, it will work. It will not create a
  176.    distribution list.
  177.  
  178. 2) Copy the message to a file and then make a new message.
  179.    This is simpler than it sounds. It requires two commands.
  180.    Here is an example. Assume someone sent a message to KB6BHN, and
  181.    instead of using SP KB6BHN @ W0RLI used instead SB KB6BHN @ ALLUSA.
  182.    Assume it was message number 325.
  183.  
  184.    First put the message into a file using the F command:
  185.    F 325 J
  186.    This puts the message into file J.
  187.  
  188.    Then make the new message:
  189.    MP J KB6BHN @ W0RLI
  190.    You can either enter the orignal title, or, since you had to do
  191.    all this work to correct a users error, just give the new message
  192.    a blank title!
  193.  
  194.    Now kill the orignal message.
  195.    K 325
  196.  
  197.  
  198.      W0RLI MailBox and GateWay                  Page 4
  199.  
  200.  
  201.      PRTLOG.EXE - The log file analyzer.
  202.  
  203.     PRTLOG OUT.PRT -opt
  204.  
  205. The output is placed in file OUT.PRT.
  206.  
  207. Options: -L lists the entire log.
  208.      With no options you get the usual monthly summary.
  209.  
  210. PRTLOG prompts for the names of log files. Enter them in time sequence order.
  211.  
  212.  
  213.  
  214.        Log file format
  215.  
  216.    Each line in the log file contains an event code, the date and time,
  217.    followed by further information about the event.
  218.  
  219.    'C' - User connected to system.
  220.       'A' -> 'H' - A user connected on that port.
  221.       'I' - Program startup.
  222.       'L' - User was linked via the station that just connected.
  223.       'S' - "connect" from local console (sysop).
  224.  
  225.    'G' - GateWay event.
  226.       'A' - Connection attempted and failed. Path shown.
  227.       'C' - Connection attempted and obtained. Path shown.
  228.       'E' - End of GateWay event, or use.
  229.       'I' - Station logged into RoundTable.
  230.       'M' - Start of monitoring.
  231.       'O' - Station logged out of RoundTable.
  232.       'R' - Start of RoundTable use.
  233.       'S' - Start of GateWay use.
  234.       'U' - Entry to unprotocol mode.
  235.  
  236.    'X' - Exit.
  237.       'A' - Owner put MailBox on line.
  238.       'B' - User said good bye.
  239.       'D' - User disconnected.
  240.       'E' - Excluded user attempted connect.
  241.       'F' - User forced off by system owner.
  242.       'Q' - Owner exited from program.
  243.       'T' - Timeout, forced disconnect.
  244.  
  245.    'F' - File event. Command line shown as user entered it.
  246.  
  247.       'D'  - File downloaded.
  248.       'K'  - File deleted.
  249.       'U'  - File uploaded.
  250.  
  251.    'M' - Message event. Message number always shown.
  252.  
  253.       'F'  - Message forwarded.
  254.       'FE' - End of forwarding session.
  255.       'FR' - Start of reverse forwarding within forwarding session.
  256.       'FS' - Start of forwarding session.
  257.       'K'  - Message killed.
  258.       'R'  - Message read.
  259.       'Z'  - Message entered. Message size shown.
  260.  
  261.