home *** CD-ROM | disk | FTP | other *** search
/ Hacker Chronicles 2 / HACKER2.BIN / 1072.MB.DOC < prev    next >
Text File  |  1989-04-28  |  9KB  |  283 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. MBINIT
  54.  
  55. Note that LM and SHARE have also been loaded. LM is the MailBox
  56. Lock Manager, SHARE is the MS-DOS file sharing utility.
  57.  
  58.  
  59.      2) Edit INIT.MB, MOTD.MB, INFO.MB, CONFIG.MB for your configuration.
  60.  
  61. Put in your call, name, qth, and zip (or postal) code in the appropriate
  62. places. Set up various subdirectories for user files and for MailBox working
  63. files. Setup the port definitions to correspond to the hardware on your
  64. computer.
  65.  
  66.  
  67.      3) Plug in the tncs.
  68.  
  69. Make sure they are set for hardware handshake. See the *.SET files for
  70. examples of correct tnc parameter settings.
  71.  
  72.  
  73.      4) Put it on the air!
  74.  
  75.      W0RLI MailBox and GateWay                  Page    2
  76.  
  77.     Files on the distribution disk:
  78.  
  79. - The MailBox and GateWay programs:
  80.  
  81.    MB.EXE    -  The MailBox program.
  82.    MBINIT.EXE    -  The MailBox initialization.
  83.    MBMODE.EXE    -  Replacement for MODE command, supports COM1 - COM16.
  84.    MBSTAT.EXE    -  MailBox status display.
  85.    NW.EXE    -  The NetWalker.
  86.    PRTLOG.EXE    -  Log file analyzer.
  87.    RECOVER.EXE    -  Message and User file recovery program.
  88.    SERVER.EXE    -  MailBox server driver.
  89.    LM.COM    -  MailBox Lock Manager and Task Control.
  90.  
  91. - Documentation and other text files:
  92.  
  93.    README    -  Basic information on getting started.
  94.    *.DOC    -  Release notes, tech notes, installation notes, etc.
  95.    PK232.SET    -  Setup parameter list for PK-232 and PK-87.
  96.    KAM.SET    -  Setup parameter list for KAM and KPC-4.
  97.    TNC1.SET    -  Setup paramater list for TNC1.
  98.    TNC2.SET    -  Setup parameter list for TNC2.
  99.  
  100. MailBox support files:
  101.  
  102.    CONFIG.MB    -  Configuration data, error messages, etc.
  103.    HELP.MB    - The text of the "H" command.
  104.    INFO.MB    - The text of the "I" command.
  105.    MOTD.MB    - The text of the login message.
  106.    INIT.MB    - Information about the system owner.
  107.    SERVER.MB    - The server definition information.
  108.    FWD.MB    - The routing tables for forwarding messages.
  109.  
  110. The following files will be created automatically by the MailBox:
  111.  
  112.    BID.MB    - Log of Message Identifiers.
  113.    CALLS.MB  - All calls heard by the MailBox.
  114.    MON.MB    - The saved "J" lists.
  115.    WP.MB     - The user database.
  116.    MAIL.MB   - The message database.
  117.    YYMMLOG.n - The log files. A text file that contains the user log.
  118.            A seperate log is kept by each copy of the program.
  119.            YYMM is the curent year and month.
  120.  
  121. The cable between the computer and the TNC should have pins 2,3,4,5,7 and 20
  122. connected. Hardware flow control (CTS/RTS) is used in both directions.
  123.  
  124.      W0RLI MailBox and GateWay                  Page 3
  125.  
  126.  
  127.          Known restrictions.
  128.  
  129.  
  130. There can be at most 50 pending different message destinations. These
  131. are the calls that show in the beacon text plus any calls in AT fields
  132. of messages that have not been forwarded. The only time this might cause
  133. a problem is if you keep many bulletins on the system, and they are
  134. not marked as read ("Y") or forwarded ("F").
  135.  
  136.  
  137.     Message header formats in use at this time include:
  138.  
  139.  
  140.  
  141. R:date/time @:call qth #:nnn O:call S:date/time Z:zzz
  142. R:date/time @:call qth #:nnn O:call S:date/time
  143. R:date/time @:call qth #:nnn O:call Z:zzz
  144. R:date/time @:call qth #:nnn Z:zzz
  145. R:date/time @:call qth #:nnn O:call
  146. R:date/time @:call qth #nnn O:call
  147. R:date/time nnn@call qth
  148.  
  149.  
  150. 1) calls may have ssid
  151.  
  152. 2) time may have timezone.
  153.    If so, may be single char or 3 char.
  154.    May be upper or lower case, or mixed.
  155.  
  156. 3) qth may be enclosed in []
  157.  
  158. 4) Space between @ call and qth may be missing
  159.  
  160. 5) ":" between field ID and contents may be missing.
  161.  
  162. 6) May be space between ":" and field contents.
  163.  
  164.  
  165. There are many other forms seen. They may leave out required information.
  166. They may have the required information in an unexpected format.
  167. There is little chance of parsing them all.
  168.  
  169.  
  170. PLEASE FOLKS ... keeps things simple. There is a good deal of software
  171. out there that looks at the message headers to determine paths, station
  172. locations, etc. etc. Save those cute messages and trite sayings for your
  173. login message. Put your QTH in the qth field. Put your postal code in
  174. the zip code field. Don't add extra "[", "]", "{}", "***" etc. Leave out
  175. your operating frequency, pet cat's name, brand of car you drive, agency
  176. you handle emergency communications for, etc.
  177.  
  178.  
  179.  
  180.          Message manipulation.
  181.  
  182. One problem that confronts the sysop from time to time is the message
  183. that has the wrong type, wrong distribution list, etc. There are two ways
  184. to correct this problem.
  185.  
  186. 1) Use the "E" command and edit the message header. Because of the many
  187.    possibilities, this command is limited in scope. For simple changes,
  188.    such as "unkilling" a message, it will work. It will not create a
  189.    distribution list.
  190.  
  191. 2) Copy the message to a file and then make a new message.
  192.    This is simpler than it sounds. It requires two commands.
  193.    Here is an example. Assume someone sent a message to KB6BHN, and
  194.    instead of using SP KB6BHN @ W0RLI used instead SB KB6BHN @ ALLUSA.
  195.    Assume it was message number 325.
  196.  
  197.    First put the message into a file using the F command:
  198.    F 325 J
  199.    This puts the message into file J.
  200.  
  201.    Then make the new message:
  202.    MP J KB6BHN @ W0RLI
  203.    You can either enter the orignal title, or, since you had to do
  204.    all this work to correct a users error, just give the new message
  205.    a blank title!
  206.  
  207.    Now kill the orignal message.
  208.    K 325
  209.  
  210.  
  211.      W0RLI MailBox and GateWay                  Page 4
  212.  
  213.  
  214.      PRTLOG.EXE - The log file analyzer.
  215.  
  216.     PRTLOG OUT.PRT -opt
  217.  
  218. The output is placed in file OUT.PRT.
  219.  
  220. Options: -L lists the entire log.
  221.      With no options you get the usual monthly summary.
  222.  
  223. PRTLOG prompts for the names of log files to process.
  224.  
  225.  
  226.  
  227.        Log file format
  228.  
  229.    Each line in the log file contains an event code, the date and time,
  230.    followed by further information about the event.
  231.  
  232.    'C' - User connected to system.
  233.  
  234.       'A' -> 'H' - A user connected on that port.
  235.       'I' - Program startup.
  236.       'L' - User was linked via the station that just connected.
  237.       'S' - "connect" from local console (sysop).
  238.  
  239.    'D' - Diagnostics. Text explains what happened.
  240.  
  241.    'G' - GateWay event.
  242.  
  243.       'A' - Connection attempted and failed. Path shown.
  244.       'C' - Connection attempted and obtained. Path shown.
  245.       'E' - End of GateWay event, or use.
  246.       'I' - Station logged into RoundTable.
  247.       'M' - Start of monitoring.
  248.       'O' - Station logged out of RoundTable.
  249.       'R' - Start of RoundTable use.
  250.       'S' - Start of GateWay use.
  251.       'U' - Entry to unprotocol mode.
  252.  
  253.    'X' - Exit.
  254.  
  255.       'A' - Owner put MailBox on line.
  256.       'B' - User said good bye.
  257.       'D' - User disconnected.
  258.       'E' - Excluded user attempted connect.
  259.       'F' - User forced off by system owner.
  260.       'Q' - Owner exited from program.
  261.       'T' - Timeout, forced disconnect.
  262.  
  263.    'F' - File event. Command line shown as user entered it.
  264.  
  265.       'D'  - File downloaded.
  266.       'K'  - File deleted.
  267.       'U'  - File uploaded.
  268.  
  269.    'M' - Message event. Message number always shown.
  270.  
  271.       'E'  - Message exported.
  272.       'F'  - Message forwarded.
  273.       'FE' - End of forwarding session.
  274.       'FR' - Start of reverse forwarding within forwarding session.
  275.       'FS' - Start of forwarding session.
  276.       'FZ' - Message forwarded. Message size shown.
  277.       'K'  - Message killed.
  278.       'R'  - Message read.
  279.       'SE' - End of server session.
  280.       'SS' - Start of server session.
  281.       'Z'  - Message entered. Message size shown.
  282.  
  283.