home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / w0rli / mb1301 / config.doc < prev    next >
Text File  |  1991-03-27  |  7KB  |  220 lines
  1.  
  2.      W0RLI MailBox          Configuration File      Page 1
  3.  
  4.  
  5.        The Configuration Files.
  6.  
  7.  
  8. The files CONFIG.MB, INIT.MB, PORTS.MB, MOTD.MB, and NEWUSER.MB
  9. are text files that contains all site-specific information.
  10. Edit these files for the proper parameters for your site.
  11.  
  12. The form $x is a variable text field. The "$x" is replaced by
  13. the current value for that text.
  14.  
  15. $A - Total number of MailBox tasks.
  16. $a - Number of active MailBox tasks.
  17. $B - Users home bbs.
  18. $D - The current date.
  19. $F - Name of the users port.
  20. $H - Hang at end of line (suppress carriage return). Use at end of line only.
  21. $h - Number of held messages.
  22. $I - Sysops name.
  23. $L - Number of the last message in the MailBox
  24. $M - Message number from current msg header.
  25. $N - Number of active messages.
  26. $n - Number of killed messages.
  27. $O - Sysops callsign.
  28. $P - Current Port ID
  29. $Q - Sysops QTH
  30. $T - Current time.
  31. $t - Current task ID.
  32. $U - Users callsign.
  33. $V - Software version.
  34. $W - Users name.
  35. $X - Date user last logged in.
  36. $Y - Time user last logged in.
  37. $Z - Users zip code.
  38.  
  39.  
  40. Any line beginning with ";" is ignored.
  41.  
  42.  
  43.          Sysop Information.
  44.  
  45.  
  46. The basic information about the system owner and system operation is
  47. contained in the file INIT.MB. Replace the information with your own.
  48. If you feel you need to change the various WP lifetimes, be very
  49. careful and think through the implications of any such change.
  50.  
  51.  
  52.  
  53.          The Login Message.
  54.  
  55.  
  56. The login message is contained in the file MOTD.MB
  57. Variable text fields can be used in MOTD.MB, just as in CONFIG.MB
  58.  
  59.  
  60.      W0RLI MailBox          Configuration File      Page 2
  61.  
  62.  
  63.        The Port Definitions.
  64.  
  65.  
  66. The file PORTS.MB contains the port configuration information.
  67.  
  68. There must be one line defining your printer (if any):
  69. Printer type can be one of LPTx, COMx, or NONE
  70. Examples:
  71.  
  72. Printer NONE
  73. Printer COM5
  74. Printer LPT2
  75.  
  76. There are three (or more) lines for each communications port.
  77. The first line contains the port definition.
  78. The second line is the port name.
  79. The third line contains the port privileges and timing information.
  80. Any lines following the third line are commands to send to the
  81. TNC at the time the software is initialized.
  82.  
  83. The port definition line is made of three fields, seperated by blanks:
  84.  
  85. The first field contains the word "Port".
  86.  
  87. The second field is the port identifier.
  88.  
  89. The third field is the type of device connected to the port:
  90.  
  91.     Console - This port is the local console.
  92.     Node    - This port connects to G8BPQ switch software.
  93.     Serial  - This port has a modem, computer, terminal, or printer connected.
  94.     TNC     - This port has a TNC.
  95.  
  96. Examples:
  97.  
  98. Port A TNC
  99. Port L Console
  100. Port G Node
  101.  
  102. The second line contains the port name.
  103. Examples:
  104.  
  105. 144.91 Mhz
  106. Local LAN link frequency.
  107.  
  108.  
  109. The third line is made of several fields, seperated by blanks:
  110.  
  111. Field 1:
  112.   A list of characters that give information about the port:
  113.  
  114.     B - Only BBS may connect on this port.
  115.     D - File download allowed from this port.
  116.     I - Kick off user that connects using illegal call.
  117.     P - If remote sysop is allowed, password is required.
  118.     R - Remote sysop allowed on this port (if user marked as sysop).
  119.     U - File upload allowed from this port.
  120.  
  121.     1 - Echo monitored packets to the console.
  122.     2 - Echo user data and forwarding to the console.
  123.     3 - Echo TNC commands to the console.
  124.  
  125. Field 2: Connect timeout, in seconds.
  126. Field 3: Disconnect timeout, in seconds.
  127. Field 4: Number of concurrent forwards allowed on this port.
  128. Field 5: Minute of the hour to attempt forwarding.
  129.      Note that any value above 59 will disable forwarding on the port.
  130. Field 6: Number of command errors allowed before user kicked off.
  131.  
  132.      W0RLI MailBox          Configuration File      Page 3
  133.  
  134.        The Configuration File, section one.
  135.  
  136. The first section (to the first *** EOF) is the user file directory
  137. path definitions. Three lines per path.
  138.  
  139. The first line is a single character path ID,
  140. followed by "D" if downloading is allowed, and "U" if uploading is allowed.
  141.  
  142. The second line is the path, with trailing '\'.
  143.  
  144. The third line is the name of the path, as shown to the user.
  145.  
  146.  
  147.  
  148.        The Configuration File, section two.
  149.  
  150.  
  151. The second section (to the second *** EOF) is the designator translation list.
  152.  
  153. Each line in this section instructs the MailBox to take some action
  154. when it recieves some specific kind of message. Each line has several
  155. fields. The first field tells WHAT action to take (@, D, H, or T).
  156. The second and following fields tell HOW to take that action.
  157. Note that the character string matches all allow wildcards (See WILD.DOC).
  158. If more than one action applies to a given message, they take
  159. place in the order they exist in CONFIG.MB
  160.  
  161. Action code   Meaning
  162.  
  163.   @          Translate @ BBS field of message.
  164.   B          File message by BID
  165.   D          Use the distribution list given in field 4,
  166.           if TO matches field 2 and @ BBS matches field 3.
  167.   H          Hold any message with this TO, FROM, or @ BBS.
  168.   K          Kill after forwarding.  Applies to bulletins only.
  169.   R          Replace TO and @ BBS.
  170.   T          Translate TO field of message.
  171.  
  172.  
  173. The examples below show how to use this feature:
  174.  
  175. @ W0RLI          - Remove the "@ BBS" if it is this BBS.
  176. @ NCNET ALLCAN         - Any message "@ NCNET" becomes "@ ALLCAN".
  177. T SYSOPS SYSOP         - Any message "TO SYSOPS" becomes "TO SYSOP".
  178. R ALL AMSAT AMSAT USA     - Bulletins to ALL@AMSAT become AMSAT@USA
  179. H N1NERD         - Hold any message to/from/at N1NERD
  180. D * ALLUSA WORLD.DIS     - Any message @ ALLUSA go to all calls
  181.                in file WORLD.DIS
  182. D * NORCAL NCNET.DIS     - Any message @ NORCAL go to all calls
  183.                in file NCNET.DIS
  184. D * ALLCAN NCNET.DIS     - So does any messages @ ALLCAN ...
  185. D AMSAT *  NCNET.DIS     - ... and all messages TO AMSAT ...
  186. B ARL* \bull\arrl\     - File ARRL fulletins by BID.
  187. K 4SALE ALLUSA         - Kill after forwarding.
  188. *** EOF
  189.  
  190.  
  191. There can be up to 35 destinations in a distribution list.
  192.  
  193. My file NCNET.DIS contains:
  194.  
  195. kb6irs
  196. n6iya
  197. ki6eh
  198. aa4re
  199. kb6owt
  200. wa6rdh
  201. w6pw
  202. w0rli     <-   I put my own call in the list so the message will
  203.           not automatically kill until after I have read it.
  204.  
  205.  
  206. The message is not forwarded to these stations in any special order.
  207. If a station is busy then the MailBox will try again the next hour.
  208.  
  209. An "L ;" listing of a message with a distribution list shows the sysop the
  210. status of forwarding to each station on a second "cc:" line. The calls to
  211. which the message have been sent have an asterisk before them.
  212.  
  213.  
  214.  
  215.  
  216.        The Configuration File, section three (remainder of file).
  217.  
  218. Each item goes on one line. Various prompts, messages, and constants.
  219.  
  220.