home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / hamradio / mb1501a.zip / MB1501A.EXE / CONFIG.DOC < prev    next >
Text File  |  1992-11-27  |  29KB  |  903 lines

  1. R:921122/0643 1766@WA7SJN.WA.USA.NA
  2. R:921122/0618 9294@W0RLI.OR.USA.NA
  3.  
  4.  
  5.        The Configuration Files.
  6.  
  7.  
  8. The following files are text files that contain site-specific information.
  9. Edit these files for the proper parameters for your site.
  10.  
  11. In general:
  12.  
  13. Fields are delimited by any number of blanks and/or tabs.
  14. Lines beginning with ";" are ignored, may be used for commentary.
  15. Blank lines delimit groups, or are ignored.
  16. A ";" delimits trailing comments on that line.
  17.  
  18.  
  19. DIRS.MB    -  File directory area definitions.
  20. DIST.MB    -  Bulletin distribution lists.
  21. FWD.MB       -  Message routing information.
  22. HELP.MB    -  Help command text.
  23. INFO.MB    -  Text of the "I" command. System information.
  24. INIT.MB    -  Information about the system owner.
  25. KEYS.MB    -  Passwords for remote sysops.
  26. MOTD.MB    -  Text of the login message.
  27. NEWUSER.MB -  Text sent to user at their first login.
  28. PORTS.MB   -  COM port definitions.
  29. SERVER.MB  -  Server definition information.
  30. TAG.MB       -  Your message "signature".
  31. TEXT.MB    -  Various configurable prompts, messages, etc.
  32. XLATE.MB   -  Designator translation lists, file-by-BID list, etc.
  33.  
  34. The following are created and maintained automatically by the MailBox:
  35.  
  36. BID.MB       -  Bulletin ID database.
  37. MAIL.MB    -  Message database.
  38. WP.MB       -  White Pages database.
  39. YYMMLOG.n  -  The log files. A text file that contains the user log.
  40.           A separate log is kept by each copy of the program.
  41.           YYMM is the current year and month.
  42.  
  43. The form $x is a variable text field. The "$x" is replaced by
  44. the current value for that text.
  45.  
  46. $A - Total number of MailBox tasks.
  47. $a - Number of active MailBox tasks.
  48. $B - Users home bbs.
  49. $D - The current date.
  50. $H - Hang at end of line (suppress carriage return). Use at end of line only.
  51. $h - Number of held messages.
  52. $I - Sysops name.
  53. $L - Number of the last message in the MailBox
  54. $M - Message number from current msg header.
  55. $m - Number of active messages (total minus killed)
  56. $N - Number of messages on system.
  57. $n - Number of killed messages.
  58. $O - Sysops callsign.
  59. $P - Current Port ID
  60. $Q - Sysops QTH
  61. $T - Current time.
  62. $t - Current task ID.
  63. $U - Users callsign.
  64. $W - Users name.
  65. $X - Date user last logged in.
  66. $Y - Time user last logged in.
  67. $Z - Users zip code.
  68.  
  69.  
  70. -----------------------------------------------------------------------------
  71.            The File INIT.MB - Sysop Information.
  72. -----------------------------------------------------------------------------
  73.  
  74. The basic information about the system owner and system operation is
  75. contained in the file INIT.MB. Replace the information with your own.
  76. If you feel you need to change the various WP lifetimes, be very
  77. careful and think through the implications of any such change.
  78.  
  79. -----------------------------------------------------------------------------
  80.           The File MOTD.MB - The Login Message.
  81. -----------------------------------------------------------------------------
  82.  
  83. The login message is contained in the file MOTD.MB
  84. Variable text fields can be used in MOTD.MB, just as in CONFIG.MB
  85.  
  86. -----------------------------------------------------------------------------
  87.         The File DIRS.MB - File directory areas.
  88. -----------------------------------------------------------------------------
  89.  
  90. The first field is a single character path ID,
  91. followed by "D" if downloading is allowed, and "U" if uploading is allowed.
  92. The second field is the path, with trailing '\'.
  93. The third field is the name of the path, as shown to the user.
  94.  
  95. -----------------------------------------------------------------------------
  96.     The File XLATE.MB - Translation, file-by-BID, hold lists, etc.
  97. -----------------------------------------------------------------------------
  98.  
  99. Each line in this section instructs the MailBox to take some action
  100. when it receives some specific kind of message. Each line has several fields.
  101. The first field tells WHAT action to take. The second and following fields
  102. tell HOW to take that action. Note that the character string matches allow
  103. wildcards (See WILD.DOC).  If more than one action applies to a given message,
  104. they take place in the order they are given in CONFIG.MB
  105.  
  106. Action code   Meaning
  107.  
  108.   B          File message by BID
  109.   K          Kill after forwarding.  Applies to bulletins only.
  110.   H          Hold any messages TO, FROM, or @ this callsign.
  111.   HT          Hold any messages TO this callsign.
  112.   HF          Hold any messages FROM this callsign.
  113.   HA          Hold any messages @ this callsign.
  114.   R <old TO> <old @> <new TO> <new @> - Address translation information.
  115.           The 1st or 2nd fields may use wildcard matching (see wild.doc).
  116.           A single "*" in the 3rd or 4th fields means "leave unchanged".
  117.   T          Set time-to-live for this bulletin class.
  118.  
  119. Examples:
  120.  
  121. b arl* \bull\arrl\     - File ARRL bulletins by BID.
  122.  
  123. k sale allusa        - Kill SALE and ALLUSA after forwarding.
  124.  
  125. hf n1nerd         - Hold any messages from N1NERD
  126. ht sell          - Hold any messages to SELL
  127.  
  128. r * w0rli *          - Remove the "BBS" if it is this BBS.
  129. r * orgb * allor      - Any message @ "ORGB" becomes @ "ALLOR".
  130. r sysops * sysop *      - Any message to "SYSOPS" becomes to "SYSOP".
  131. r all amsat amsat allusa  - Bulletins to ALL@AMSAT become AMSAT@ALLUSA
  132.  
  133. t wx pdx 2          - Bulletins to WX@PDX will go away in two days.
  134. t * amsat 10          - Bulletins @AMSAT will go away in ten days.
  135.  
  136.  
  137. -----------------------------------------------------------------------------
  138.            The File DIST.MB - Distribution lists
  139. -----------------------------------------------------------------------------
  140.  
  141.  
  142. The file consists of any number of lines, where each line has:
  143.  
  144. TO AT call1 call2 call2 ...
  145.  
  146. If a message matches the TO and AT (with wildcards - see wild.doc), then it
  147. will be distributed to the calls listed on the rest of the line.  There can
  148. be up to 14 calls per line.  If you have more than 14 calls for a single
  149. distribution, simply create two lines.    Distribution lists are cumulative.
  150.  
  151. Note that if you put your own call in the list, the message will
  152. not automatically kill until after you have read it.  It will be
  153. "distributed" to you.
  154.  
  155. The message is not forwarded to the stations in the list any special order.
  156. If a station is busy then the MailBox will try again the next hour.
  157.  
  158. An "L ;" listing of a message with a distribution list shows the sysop the
  159. status of forwarding to each station on a second "cc:" line. The calls to
  160. which the message have been sent have an asterisk before them.
  161.  
  162.  
  163. Distribution list example:
  164.  
  165. * allor  ka7agh n7chr kb7dbd w7dcr n7dxt wa7shp wa7sjn n7vyn
  166. * allors             w7dcr n7dxt wa7shp
  167. * allusa ka7agh n7chr kb7dbd w7dcr n7dxt wa7shp wa7sjn n7vyn
  168. * allusa w7xyz    w7xyz aa7qq
  169. * allusw ka7agh n7chr kb7dbd w7dcr n7dxt wa7shp wa7sjn n7vyn
  170. * amsat  ka7agh n7chr kb7dbd w7dcr n7dxt wa7shp wa7sjn n7vyn
  171. * open     ka7agh       kb7dbd            wa7sjn
  172. * pdx     ka7agh n7chr kb7dbd         wa7shp wa7sjn n7vyn
  173. * pnw     ka7agh n7chr kb7dbd w7dcr n7dxt wa7shp wa7sjn n7vyn
  174. * sunami n7hae    w7vtw
  175. * wwgb     ka7agh n7chr kb7dbd            wa7sjn n7vyn
  176. sysop *  w0rli
  177. * net     ve3gyq w3iwi wb1dsw w0ljf k0jjv ad8i
  178.  
  179.  
  180. Things to note:
  181.  
  182. A message addressed SYSOP @ PNW will hit two distribution lists,
  183. "sysop *" and "* pnw".  It will thus get all the calls in both
  184. lists as it's distribution.
  185.  
  186. The distribution list file is read "fresh" for each message, thus
  187. you can alter it "on the fly" while the system is running, IF your
  188. text editor supports file sharing properly.  If it does not, you
  189. may get "sharing violation error" when attempting to write the
  190. file back out from your editor.
  191.  
  192.  
  193. -----------------------------------------------------------------------------
  194.          The File FWD.MB - Automatic Forwarding.
  195. -----------------------------------------------------------------------------
  196.  
  197. The file FWD.MB contains information that drives the automatic forwarding
  198. of messages. If the file does not exist, no forwarding is done. Forwarding
  199. is attempted each hour at the minute specified for the port in PORTS.MB.
  200. Forwarding will occur on those hours given in FWD.MB.
  201.  
  202. FWD.MB consist of a number of lists, and a "forwarding script" associated
  203. with each list.  Each list has the information for one MailBox to which you
  204. will forward.  The script associated with the list tells your MailBox how
  205. to connect to the MailBox you will forward to.    The list contains information
  206. that describes which messages will forward to that MailBox. Each list is
  207. terminated by one or more blank lines.
  208.  
  209. I have included an example FWD.MB file.
  210.  
  211.  
  212. The overall structure of FWD.MB is thus:
  213.  
  214. Script1
  215. List1
  216.  
  217. Script2
  218. List2
  219.  
  220. ... etc.
  221.  
  222.  
  223.      Routing lists.
  224.  
  225.  
  226. Each list has a header line, and any number of callsigns, designators, or
  227. sublists. The header line tells the MailBox when to do the forwarding to
  228. that station, what MailBox port to use for the connection, and how to
  229. identify the list when you use the X commands. There can be up to 24
  230. callsigns or designators on each line.
  231.  
  232. Thus, a list will look like:
  233.  
  234. fa0023w0qrm
  235. ntsmn ntssd
  236. w0qrm k0cj
  237.  
  238. or:
  239.  
  240. fh0205w7xyz
  241. ntswa 98* w7xyz aa7abc
  242.  
  243.        Format of the list header.
  244.  
  245. Columns     Data
  246.  
  247.   1        List type.
  248.   2        Port identifier or filler. "A" = COM1, "B" = COM2, etc.
  249.   3-4        First hour to do this function.
  250.   5-6        Last hour to do this function.
  251.   7-12        Key used to select the list with the X or XI commands.
  252.         For forwarding lists, this must be the callsign of the MailBox to
  253.         forward to, WITHOUT SSID.
  254.         For Export/Import lists, the name of the file
  255.         to be exported or imported.
  256.  
  257.  
  258.       List types:
  259.  
  260.  
  261. Type        Function
  262.  
  263. E      "Answer Reverse Forward Requests"
  264. F      "Forward and Reverse Forward"
  265. H      "Forward, Reverse Forward, and Poll"
  266.  
  267. E, F, and H lists are lists of stations for whom you should forward messages.
  268. They are grouped in the list by the call of the MailBox to which the messages
  269.  
  270. An "F" list is used when you wish to initiate forwarding.
  271.  
  272. An "H" list acts the same as an "F" list, except that the
  273. connect and probe for reverse forwarding will occur even
  274. if you do not have any messages to forward.
  275.  
  276. An "E" list acts like an "F" list, except the forwarding is not done,
  277. the list is used only when someone requests reverse forwarding from you.
  278.  
  279.  
  280.      Connect Scripts.
  281.  
  282.  
  283. Connect scripts are supported through C, L, N, P, Q, R, and S items.
  284.  
  285. The Connect Script precedes the list that uses it.  The following are
  286. some examples of common Connect Scripts:
  287.  
  288. For a direct connect to the MailBox you wish to forward to:
  289.  
  290. cc n7hae   <- Means "connect to n7hae from the tnc"
  291.  
  292. For a simple NET/ROM connect to the MailBox you wish to forward to:
  293.  
  294. cc k7zvv-7 <- Means "connect from the tnc (uplink) to your local node"
  295. nc w7fbm-8 <- Means "connect from this node to the distant node"
  296. nc n7hae   <- Means "downlink from this node, to the MailBox"
  297.  
  298. To connect to a distant MailBox running the g8bpq switch, when you are
  299. using the g8bpq switch also just connect to that MailBox call:
  300.  
  301. nc n7kmj
  302.  
  303.  
  304.       Summary of script items in FWD.MB
  305.  
  306.  
  307. C     Connect TO this call FROM a normal tnc.
  308. N     Connect TO this call FROM a node.
  309. J     Connect TO this call, it is a KA-node.
  310. K     Connect TO this call, FROM this KA-node.
  311. P     Do this tnc command before connecting.
  312. Q     Do this tnc command after disconnecting.
  313. P!    Do this DOS command before connecting.
  314. Q!    Do this DOS command after connecting.
  315. L     Limit forwarding when you use this list.
  316. S     Send this text.
  317. R     Receive this text.
  318. R!    Receive any text.
  319. T     Set port timeout (in seconds) for this forward.
  320. M+    Raise RTS.
  321. M-    Drop RTS.
  322. W     Wait for this many seconds.
  323.  
  324. Some further examples:
  325.  
  326.      CC W6NR-11
  327.      CC N7EQN-10 via A6DIG
  328.  
  329.  
  330.      NC W6NR
  331.      NC W6QRM v N6DIG
  332.  
  333.  
  334. P items give TNC commands to be executed BEFORE the connection:
  335.  
  336.      Pretry 10
  337.      Pmaxframe 3
  338.      Pfrack 8
  339.  
  340. Q items give TNC commands to be executed AFTER the disconnect:
  341.  
  342.      Qretry 3
  343.      Qmaxframe 7
  344.      Qfrack 3
  345.  
  346.  
  347. Be very careful using P and Q items. The MailBox assumes that the
  348. TNC is setup in a "standard" manner. If you change CR, CP, or SE
  349. in a script, it could cause problems.
  350.  
  351.  
  352. An L item is used to place limits on what will forward when the list is used.
  353.  
  354. L nnnn    -  Will limit the size of messages forwarded.
  355. L B    -  Will NOT forward bulletins.
  356.  
  357.   Examples:
  358.  
  359. L 5000
  360.  
  361. Would cause any message larger than 5000 bytes to NOT forward.
  362.  
  363. S and R items are used to forward in unusual situations, so that
  364. you can handle networks which do not use NET/ROM or KA-NODES.
  365.  
  366. S and R items come in pairs:
  367. An S item is a line to send:
  368.  
  369.      SBBS
  370.  
  371. An R item is the expected response:
  372.  
  373.      R#SBAY1:N7EQN-10} Connected to #WWORM:WB6FFC-1
  374.  
  375. In the case that ANY response is valid use:
  376.  
  377.      R!
  378.  
  379. There can only be one C item in a script, but may be as many N, P, Q, R
  380. and S items as required. As an example, the script for W0RLI
  381. in Santa Cruz using NET/ROM to connect with KA6IQA in San Diego might
  382. be (using all the possible script features).
  383.  
  384.  
  385. l 2000              <-  Don't forward messages larger than 2K
  386. t 240              <-  Use 4 minute timeout for this forward
  387. pretry 10          <-  Tough path, retry a lot.
  388. pmaxframe 3          <-  And don't send very many packets.
  389. pfrack 8          <-  And wait a long time for ACK.
  390. qretry 3          <-  Put things back to normal after this forward.
  391. qmaxframe 7          <-  Ditto
  392. qfrack 3          <-  Ditto
  393. cc w6amt          <-  Connect to the local NET/ROM
  394. nc w6amt-3          <-  Connect to the NET/ROM closest to KA6IQA
  395. nc ka6iqa v w6amt-4      <-  Connect to KA6IQA
  396. fb0023ka6iqa          <-  Use port B. All hours. List name KA6IQA.
  397. ka6iqa              <-  Forward messages TO or AT KA6IQA
  398. 91*              <-  Forward zip codes starting with 91
  399.  
  400.  
  401.      Wildcards and special "callsigns" in lists.
  402.  
  403.  
  404. When the designator in FWD.MB is compared to the TO or @ BBS call,
  405. the characters '?', '*', '@', '!', '+', '"' in the designator act as
  406. wildcards. See WILD.DOC for an explanation of how to use them.
  407.  
  408. The callsign "*" is special.  Putting it into a list means for forward
  409. all messages not addressed to users of the system.  It is a shorthand way
  410. to set up a "local" bbs, which forwards all outgoing traffic to a single
  411. "full service" bbs.  If you use this feature, there should be NO other
  412. callsigns or designators in the list.
  413.  
  414.  
  415.  
  416.      Sublists.
  417.  
  418.  
  419. At any place in the FWD.MB file you can refer to another file. The contents
  420. of the file is treated exactly as if it was in the FWD.MB file. This feature
  421. is very useful when you have several alternate paths to a given location.
  422. FWD.MB need only contain the connect Script for each different path, and a
  423. list containing a reference to the file which contains the list contents.
  424. A sublist file is given by a line starting with "@". The rest of the line is
  425. the device, path, and file name of the sublist.
  426.  
  427. Example:
  428.  
  429. NC N4CHV
  430. FC0023N4CHV
  431. N4CHV
  432. @C:\BBS\HF111.FWD
  433. @C:\BBS\SILICON.FWD
  434.  
  435. NC W6CUS-1
  436. FD0023W6AMT
  437. NI6A
  438. @C:\BBS\SILICON.FWD
  439.  
  440.  
  441.      Entry qualifiers.
  442.  
  443. A qualifier is appended to the line it affects. There is one qualifier at
  444. this time: " /TSSEE" where SS is the start hour and EE is the end hour.
  445. This qualifier causes the line to be ignored if the current time is not
  446. within the time window.
  447.  
  448. -----------------------------------------------------------------------------
  449.            The File PORTS.MB - Port Definitions.
  450. -----------------------------------------------------------------------------
  451.  
  452. There must be a definition for your printer:
  453. Printer type can be one of LPTx, COMx, or NONE
  454. Examples:
  455.  
  456. Printer NONE
  457. Printer COM5
  458. Printer LPT2
  459.  
  460. There must a definition for the Console:
  461.  
  462. Console
  463. Timeout 300
  464. Errlim     20
  465.  
  466. For each port available to the MailBox, there must be a definition.
  467.  
  468. The first field is the port type:
  469.    Node    - This port connects to G8BPQ switch software.
  470.    Serial  - This port has a modem, computer, or terminal connected.
  471.    TNC       - This port has an ordinary TNC connected.
  472.  
  473. The second field is the port identifier.
  474. It is used when you refer to the port in FWD.MB, or use terminal mode.
  475.  
  476. The 3rd field is the port address or COM number.
  477.  
  478. Examples:
  479.  
  480. TNC    A  1
  481. Node   G 12
  482. Serial L  5
  483.  
  484. This line is followed by information about how the port is to be used:
  485.  
  486. Options <xxxx> - A list of characters that give information about the port:
  487.  
  488.     B - Only BBS may connect on this port.
  489.     I - Kick off user that connects using illegal call.
  490.     N - This port will never be used as alternate for forwarding.
  491.  
  492.     1 - Echo monitored packets to the console.
  493.     2 - Echo user data and forwarding to the console.
  494.     3 - Echo TNC commands to the console.
  495.  
  496. Timeout  xxxx - Connect timeout, in seconds.
  497. DTimeout xxxx - Disconnect timeout, in seconds.
  498. Maxfwd     xxxx - Number of concurrent forwards allowed on this port.
  499. Fwdtime  xxxx - Minute of the hour to attempt forwarding.
  500.       Note that any value above 59 will disable forwarding on the port.
  501. Errlim     xxxx - Number of command errors allowed before user disconnected.
  502. Init     xxxx - Command to be sent to TNC at startup.
  503.  
  504. Examples:
  505.  
  506. TNC A 1
  507. Options   I2NB
  508. Timeout   300
  509. DTimeout   30
  510. Maxfwd        0
  511. Fwdtime    22
  512. Errlim        5
  513. Init   echo off
  514. Init   flow off
  515.  
  516. Node D 12
  517. Options    I2
  518. Timeout   180
  519. DTimeout   10
  520. Maxfwd        3
  521. Fwdtime    55
  522. Errlim        5
  523.  
  524. -----------------------------------------------------------------------------
  525.        The File SERVER.MB - Definitions for the server.
  526. -----------------------------------------------------------------------------
  527.  
  528. SERVER.EXE is the main dispatcher for events that happen on
  529. a periodic basis.  It drives forwarding, import/export of messages
  530. to external servers such as REQFIL, and does the daily housekeeping.
  531.  
  532. You must have SERVER running for the system to operate properly.
  533.  
  534.  
  535.    External Server operation: Automatic Export/Import of messages.
  536.  
  537.  
  538. The file SERVER.MB contains information that drives the automatic
  539. Export/Import of messages. If the file does not exist, no Export/Import is done.
  540.  
  541. There are two types of server; "simple" and "complex".
  542. The information required in SERVER.MB, and the type of processing done,
  543. is slightly different for each type.
  544.  
  545.  
  546.    Simple Server:
  547.  
  548.  
  549. A simple server first checks for messages to export. If there are
  550. none, it does nothing. If there were messages to export, it exports them,
  551. and runs the server process. If the server process completes normally,
  552. then an import is done. If the server process does not complete normally,
  553. no import is done. A line like the one below, placed into SERVER.MB, is
  554. all that is required to define a simple server.
  555.  
  556. S SNAME SNAME.EXE SNAME.OUT fmt SNAME.IN fmt
  557.  
  558. "SNAME" is the name of the server. Messages addressed to SNAME or SNAME @ SYSOP
  559. will be processed. SNAME.EXE is the name of the server program to execute.
  560. If the server executable has extension EXE or COM, COMMAND.COM is not loaded.
  561. If the server executable has extension BAT, then COMMAND.COM will be loaded,
  562. and about 23k more memory will be required.
  563.  
  564. To activate the "echo" server, which reads file ECHO.OUT and
  565. creates file ECHO.IN, with ECHO.EXE in directory \MB :
  566.  
  567. S ECHO \MB\ECHO.EXE ECHO.OUT H8 ECHO.IN H8
  568.  
  569.  
  570.  
  571.    Complex Server:
  572.  
  573. A complex server first exports any messages that match the designators in
  574. the designator list. Then the server process is run. Then any generated
  575. messages are imported. Note that, unlike a simple server, all three functions
  576. always take place. Thus a complex server can function (for example) to
  577. transfer messages both ways between the MailBox and smtp.
  578. A list like the one below, placed into SERVER.MB, is required to define a
  579. complex server. If the server file extension is EXE or COM, then COMMAND.COM
  580. is not loaded. If the server file extension is BAT, then COMMAND.COM is
  581. loaded, and you must take it's memory requirement into account.
  582.  
  583.  
  584. C SNAME SNAME.EXE SNAME.OUT fmt SNAME.IN fmt
  585. list
  586.  
  587. Messages will be processed according to the list, just as in FWD.MB.
  588.  
  589.  
  590.  
  591.       Export, Import, and Execute, with no Server process.
  592.  
  593.  
  594.    Export Only:
  595.  
  596.  
  597. O FILE.OUT fmt
  598. list
  599.  
  600.  
  601.    Import Only:
  602.  
  603.  
  604. I FILE.IN fmt
  605.  
  606.    Execute Only:
  607.  
  608. ! FILE
  609.  
  610.       Summary of list types within SERVER.MB
  611.  
  612.  
  613. Item    Function
  614.  
  615. C  "Activate a Complex server"
  616. I  "Input from File"
  617. O  "Output to File"
  618. S  "Activate a Simple server"
  619. !  "Run program or batch file"
  620.  
  621.  
  622.  
  623. Available format modifiers are:
  624.  
  625. O - Use the old style "standard" (WA7MBL) export/import format.
  626. 8 - Use RFC-822 headers.
  627. H - Include the BBS message headers.
  628.     On import, there will be no blank line between existing
  629.     headers and the new header created with the new message.
  630.  
  631. If no modifier is given, then ONLY the message text is put into the file.
  632.  
  633. To Export messages TO the file MSG.OUT in old (WA7MBL) format :
  634.  
  635. O MSG.OUT O
  636. WA6XXX
  637.  
  638. To Export messages TO the file MSG.OUT, with only RFC-822 headers
  639. and message text, (as might be used by a user written smtp interface):
  640.  
  641. O MSG.OUT 8
  642. WA6XXX
  643.  
  644. To Export messages TO the file MSG.OUT,
  645. with RFC-822 headers, existing BBS headers, and message text :
  646.  
  647. O MSG.OUT H8
  648. WA6XXX
  649.  
  650. To Export messages TO the file MSG.OUT, with only the message text :
  651.  
  652. O MSG.OUT
  653. WA6XXX
  654.  
  655.  
  656. To Import messages FROM the file MSG.IN, which is in "standard" format :
  657.  
  658. I MSG.IN OH
  659.  
  660.  
  661.  
  662.      DOS commands.
  663.  
  664. A "!" list is a program or batch file to run. A file extension must be given.
  665. If the extension is BAT, the window size must be large enough for COMMAND.COM
  666. as well as the largest program run from the batch file.
  667.  
  668.  
  669.      Example:
  670.  
  671. ! CLOCK.BAT
  672.  
  673. This will run CLOCK.BAT, which can do multiple DOS commands.
  674.  
  675. ! CLOCK.EXE
  676.  
  677. This will load and run CLOCK.EXE
  678.  
  679.  
  680.       Wildcards and special "callsigns" in lists.
  681.  
  682.  
  683. See WILD.DOC for a description of how to use wildcard characters.
  684.  
  685.       Sublists.
  686.  
  687. At any place in the SERVER.MB file you can refer to another file.
  688. What happens is that the contents of the sublist are treated exactly
  689. as if they were in the SERVER.MB file. A sublist is given by a line
  690. starting with "@". The rest of the line is the device, path, and file
  691. name of the sublist file.
  692.  
  693.      File formats.
  694.  
  695. The following is an example export file produced using format H8.
  696.  
  697. Things to note about this file:
  698.  
  699. 1. There is a blank line following the RFC-822 header, and another
  700.    following the MailBox header.
  701.  
  702. 2. The special header item "X-msgtype" is used to show whether the
  703.    message is a Bulletin, is Personal, or is an NTS message.
  704.  
  705. 3. The special header item "X-BID" is used to show the BID,
  706.    if the message has one.
  707.  
  708. 4. The file can contain multiple messages.
  709.  
  710.  
  711. Date: 12 Mar 89 17:09           <- Date at originating MailBox
  712. Message-ID: <8988@N6IYA>       <- Message number at orig MailBox
  713. X-msgtype: P               <- Message type (B, P, T)
  714. X-BID: 1234_N6IYA           <- BID, if the message has one.
  715. From: N6IYA@N6IYA           <- User at orig MailBox
  716. To: ECHO@W0RLI.OR.USA.NA       <- Full location as sent
  717. Subject: Testing path turnaround.  <- Message title
  718.                    <- Blank between RFC-822 hdr and MailBox hdrs
  719. R:890312/1722z @:W0RLI.OR.USA.NA West Linn #:3571 Z:97068
  720. R:890312/1709z @:N6IYA.CA.USA.NA Felton #:8988 Z:95008
  721.                    <- Blank between MailBox hdrs and text.
  722. Test message.               <- Message text.
  723. ../EX                   <- ".." added, not there in actual format
  724.  
  725.  
  726.  
  727.  
  728. It appears that there will be a large number of servers created.
  729. These are servers I have heard about. Some are ready for use, some
  730. are in the planning/coding stage.
  731.  
  732.  
  733. ECHO   - "echo" the message back to sender for path testing.
  734.  
  735. REQDBF - Database server by K0ZXF.
  736.  
  737. FILEX  - "File eXchange". Upload, Download, directory listings.
  738. REQDIR - Request directory information.
  739.      The FILEX server handles REQDIR.
  740. REQFIL - Request a file.
  741.      The FILEX server handles REQFIL.
  742.  
  743. REQQSL - Request qsl manger info for dx callsign.
  744. REQWP  - Request WP information.
  745.      Remote access to the I, I@, IH, and IZ commands.
  746.  
  747. RLIMON - Automated sysop functions from KJ4LQ.
  748.  
  749. REQQTH - Request name/address for callsign.
  750.  
  751. REQCB  - Callbook info from the J-Comm or RT Systems databases.
  752.  
  753. SMTP   - smtp/BBS message interface.
  754.  
  755.  
  756.  
  757. Here is an example for a user-written server, using only DOS batch commands.
  758. This server will print selected messages as they arrive.
  759.  
  760. 1. In the distribution lists for any messages you want printed,
  761.    add an extra callsign PRTIT.
  762.  
  763. 2. In SERVER.MB add the lines:
  764.  
  765.    ! DEL PRTIT.OUT
  766.    O PRTIT.OUT 8
  767.    PRTIT
  768.  
  769.    ! PRINT PRTIT.OUT
  770.  
  771.  
  772. -----------------------------------------------------------------------------
  773.        The File KEYS.MB - Passwords for Remote Sysops.
  774. -----------------------------------------------------------------------------
  775.  
  776.   Sysop passwords for the MailBox.
  777.  
  778.   Designed by Geert Jan de Groot, PE1HZG, Eindhoven, Holland
  779.  
  780.  
  781.  
  782.   Remote sysop is a nice way to split the work involved with managing a
  783.   BBS among several people. However, in the past, some crooks used the
  784.   calls of some (remote) sysops and erased all files...
  785.   I added a netrom-like verification procedure to check if a remote
  786.   sysop is really who he says he is.
  787.  
  788.   The procedure is as follows:
  789.  
  790.   Each 'trusted person' has his own personal key, which consists of
  791.   an array of 10 by 10 random letters and numbers, like this:
  792.  
  793.  
  794.   Key for: PE1HZG
  795.  
  796.       01234 56789
  797.     0 tBixT 03ytR
  798.    10 9yD6s HfC0c
  799.    20 ze28q 70nL4
  800.    30 7OczX 1fEdW
  801.    40 6R8BU cao07
  802.    50 OWJ1m lTo2q
  803.    60 XLHGl NCDdF
  804.    70 2wXUO rjwDL
  805.    80 uh7P4 fsYiO
  806.    90 mQPjY zXxAM
  807.  
  808.  
  809.   On the @ command, the BBS gives 3 lines of 8 numbers, like this:
  810.  
  811.   2354 - L#4912 - PI8ZAA-BBS > @      (user gives sysop command)
  812.   2 55 26 46 24 52 79 77          (BBS verification )
  813.   41 23 94 23 86 56 54 23
  814.   75 69 3 97 77 49 64 38
  815.   il0aqJLw                  (user response to 1st line)
  816.   N#182 - L#4912 - PI8ZAA-BBS >       (success - sysop prompt)
  817.  
  818.  
  819.   A remote sysop translates ONE (just random, first, second or third) line
  820.   into the matching characters using his personal key. Which line matches,
  821.   does not matter.
  822.  
  823.   If the sent response-string matches, the user is who he says he is and goes
  824.   to remote sysop status. If not, nothing happens.
  825.   Bad guys who monitor the BBS, see an answer to 3 possible questions, and
  826.   don't know what line matches the response string, so they can't re-build
  827.   the key matrix owned by the remote sysop. This, of course, only works
  828.   if remote sysops randomly pick the first, second or third line to translate.
  829.  
  830.   (However, using statistics, people can deduce the original key if they
  831.   have enough data. Crypt wizards say it may take 100 sessions before
  832.   such an attempt may be successful. If you go sysop 1 time a day
  833.   at most, and change keys every 2 months, they should not be able to
  834.   get sysop status.. time will tell!)
  835.  
  836.   In the BBS, there is a file called KEYS.MB which has records of this
  837.   format:
  838.  
  839.   PE1HZG
  840.   tBixT03ytR9yD6sHfC0cze28q70nL47OczX1fEdW6R8BUcao07 (continue at next line)
  841.   OWJ1mlTo2qXLHGlNCDdF2wXUOrjwDLuh7P4fsYiOmQPjYzXxAM
  842.  
  843.  
  844.   Each remote sysop has his own entry in the keys.mb file, and should have
  845.   different keys. At PI8ZAA, the actual keys are generated by machine,
  846.   a small basic program will do the trick.
  847.   Of course, NOBODY should EVER consider downloading the KEYS.MB on air!
  848.   If a person with a unknown call tries to get sysop status, simply
  849.   NO response-string matches. I did this because it was easier and
  850.   maybe it keeps the bad guys puzzled..
  851.  
  852.   If the password is a single "*", then that user may become sysop
  853.   without any password being required (added by W0RLI).
  854.  
  855.   Note that the port definition in CONFIG.MB must have the "R" privilege
  856.   set for remote sysop to be allowed at all, and must have the "P"
  857.   privilege set to require passwords.
  858.  
  859.  
  860.  
  861. -----------------------------------------------------------------------------
  862.           The File TAG.MB - Message tagging
  863. -----------------------------------------------------------------------------
  864.  
  865.  
  866. The file consists of any number of groups, where each group has:
  867.  
  868. Header line
  869. <any number of text lines>
  870. .      <a line containing only a period, this terminates the text>
  871. Header line
  872. <text>
  873. .
  874.  
  875. etc.
  876.  
  877. The header line contains a single character to indicate when to apply
  878. the tag, and a list of callsigns, (no more than 15).
  879. The character at the start of the line can be:
  880.  
  881. L - Apply the tag to locally entered messages (it's your signature).
  882. R - Apply the tag to messages received from these stations.
  883.  
  884. If any station in the list sends a message, the text following that
  885. header is appended to the message.
  886.  
  887. For example:
  888.  
  889. r w3iwi k0jjv n6iya
  890.  
  891. ----------------------------------------------------------
  892. This message received at W0RLI via HF unattended operation.
  893. Please contact your ARRL representatives if you feel this
  894. service is of value to you.
  895. ----------------------------------------------------------
  896. .
  897. l w0rli
  898.  
  899.    ...    Hank
  900.  
  901. .
  902.  
  903.