home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / mbbs301.zip / !WHATS.NEW < prev    next >
Text File  |  1994-05-14  |  36KB  |  677 lines

  1. =======================================================================
  2.  
  3.                   !WHATS.NEW   At a glance ...
  4.  
  5.        Section:
  6.                    I.    Miscellaneous New Features
  7.                    II.   MacroBBS as a door program
  8.                    III.    MacroNET configuration and Session Passwords
  9.                             Quick start
  10.                             SESSION PASSWORDS
  11.                             MacroNET in more detail
  12.                    IV.   Multi-node configuration
  13.                             Setup
  14.                             Multi-node chat and variables
  15.                             Multi-tasking
  16.  
  17. =======================================================================
  18.  
  19.  
  20. *************************************
  21. I.  Miscellaneous New Features
  22. *************************************
  23.  
  24. - Added an external editor option for local use omlu (e.g. for
  25. answering/composing mail).
  26.  
  27.  - User uploads are placed in File Area 0 (the "invisible" File Area,
  28. attainable only by entering "0" at the File Area list), BUT the file
  29. descriptions will remain in the various filelists.  The unvalidated
  30. descriptions will be "invisible" to users with an Access Level less than
  31. 999.  To validate a file description, simply use an ASCII editor to
  32. remove the "+" (plus sign) from the first column of the description
  33. line(s).  Uploads by Callers with an access level of 999 are auto-
  34.  validated, which means their uploads are automatically available
  35. for download by other Callers.
  36.  
  37. - Individual time limits were added.  This is editable from the
  38. offline user edit menu, from the online "! Remote Config", and from the
  39. "Online Sysop Menu".  Also, a new field was added to toggle a user's
  40.  access to the chat call.  This comes in handy for those pesky callers
  41. who insist on paging you a million times a day.
  42.  
  43. - Added the prompt-for-phone-number routine.  If VALIDPHN.DAT exists
  44. in your datadir, it will be displayed just brfore the phone# prompt.
  45.  
  46. - Totally remodeled the File Base to take full advantage of {COMMO}'s
  47. FILE macro function.  Filelists are now displayed in full color. (See
  48. !UPGRADE.DOC for the new format conversion instructions.)  Time
  49. approximations are now calculated (when file(s) are to be downloaded)
  50. based on file size/user connect rate.  This calculation is then compared
  51. with the user's remaining online time.  Time limits will no longer be
  52. exceeded by lengthy downloads.
  53.  
  54. - A Batch Download Menu (option "B" from the File Base menu) was added
  55. to allow users to download files by way of a FILE.LST which is created
  56. by MacroBBS when a caller specifies "(b)ztch" at the download options
  57. menu.  Download times are calculated to ensure that user time limits are
  58. not exceeded.
  59.  
  60. - Added an events processor. (See the notes in the file MBBSEVNT.LST
  61. for details.)  EVENTS.BAT will no longer be auto-executed at midnight.
  62. If you used this feature previously, just create an event to do it.  The
  63. advantage is that now you can choose the time(s) events take place.
  64.  
  65. - If the file PHONENBR.BAD exists in your datadir (e.g. \{COMMO}\MACROBBS),
  66. extra phone number checking will take place when new users log on to your
  67. BBS.  Each line of this file contains a bad phone number segment.  If the
  68. user enters a phone number that contains any of these bad segments,
  69. MacroBBS sends an error message then drops carrier/resets.  You may add to
  70. and/or delete from this file as you wish.  If the file does not exist, no
  71. extra checking is performed.
  72.  
  73. *************************************
  74. II.   MacroBBS as a door program
  75. *************************************
  76.  
  77. - MacroBBS can now more effectively be used as a door program.  This
  78. feature has been around for quite awhile but has been improved.
  79.  
  80.  
  81.      1.  Pass carrier to MacroBBS from your front-end mailer
  82.  
  83.      Look over the sample BINKLEY.BAT file included in the MacroBBS
  84. package.  This file well demonstrate how to pass carrier to MacroBBS as
  85. well as how to run midnight maintenance or log on locally.  Basically, you
  86. need to SET a DOS environment variable and enter MacroBBS through a
  87. different "opening" (:binkdoor rather than :boot).  See,BINKLEY.BAT for the
  88. necessary details.
  89.  
  90.      2.  Run MacroBBS as a door off another BBS
  91.  
  92.      This method uses the same concepts as above but is somewhat easier,
  93. although it's not as straight-forward/versatile.  You need to create a
  94. batch file to invoke from your primary BBS.  As an example, let's say your
  95. system is locked at 19200.  Your batch file would look like this:
  96.  
  97. set BD=19200
  98. cd \commo
  99. commo /iN /v10000 /mMACRODAT.MAC /:binkdoor
  100.  
  101. Also, make sure {COMMO}'s default terminal parameters (see COMMO.SET)
  102. match your BBS parameters.  MacroBBS does not alter any parameters when you
  103. lock the baud rate via MacroBBS's configuration module.  For example, if
  104. you run your system locked at 19200, {COMMO} must be set at 19200 and
  105. MacroBBS must be locked at 19200.  If you don't lock the baud rate,
  106. MacroBBS will set {COMMO}'s parameters to the Caller's baud rate (the
  107. value of BD)..
  108.      You'd also want to add something like this to your BBS's midnight
  109. maintenance batch file:
  110.  
  111. set BD=mid
  112. cd \commo
  113. commo /iN /v10000 /mMACRODAT.MAC /:binkdoor
  114.  
  115. The above will cause MacroBBS to carry-out any pending events.
  116.  
  117.  
  118. *************************************
  119. III.  MacroNET configuration and Session Passwords
  120. *************************************
  121.  
  122. - MacroBBS now has its own built-in network facilities.  The following
  123. is a complete explanation of MacroNet...
  124.  
  125.  ┌───────┐
  126.  │ SETUP │
  127.  └───────┘
  128.  
  129.     If you are familiar with the idea of echomail, this setup will be
  130. quite easy.  If you are new to this echomail/netmail thing, please read the
  131. 'quick start' then, if necessary, continue with the section titled
  132. 'MacroNET in more detail'.
  133.  
  134. - Quick Start -
  135.  
  136. 1.  Run MacroBBS's configuration module to complete all necessary
  137. information about your system.  When you are asked to enter your
  138. MacroNET address,  please use the temporary address "M999".  To get an
  139. official MacroNET address, just send netmail to me at M1. (This can
  140. easily be done by entering the Offline Sysop Menu and selecting option
  141. "N" to Send Netmail.  No extra setup is needed to send netmail.)  Your
  142. netmail message should include your real first and last name, your BBS's
  143. name, location (city, state), and your BBS's phone member -- all as you
  144. would like theme to appear in the MacroNET nodelist.
  145.  
  146. 2.  Echomail, on the other hand, requires that you do a few more things:
  147.  
  148.   -  If you are interested in receiving/sending echomail, review the
  149. included list of current MacroNET echoes (MNETECHO.LST) to decide which
  150. echoes you want.
  151.  
  152.   -  Create the new echomail message areas using MacroBBS's "Add a
  153. Message Area" Master SysMenu option.  Be sure to enter the echotag
  154. exactly as it appears on the MacroNET echo list.  The "echotag" should
  155. not be confused with the message area NAME.  The ECHOTAG is the
  156. universal name, used primarily by the MacroBBS internal echomail system.
  157. The actual message area NAME can be anything you like.  As an example,
  158. the General Chatter echo's echotag is "GENERAL" but the name can be
  159. anything you like ... "General Chatter," "General Stuff," etc.)  Keep
  160. track of the message area numbers because you will need them for the
  161. next step.
  162.  
  163.   -  Use your favorite ASCII editor to edit the file M0BBSECHO.LST (or edit
  164. this file directly from MacroBBS's Offline Wait Screen- option 3). This
  165. file will contain your echomail configuration. (See the notes in
  166. M0BBSECHO.LST for the necessary format details.)  The MBBSMAID^ -- an
  167. automated echo add/delete house-cleaner designed for hub systems, to allow
  168. for almost-maintenance-free echo area addition/deleting by remote systems
  169. -- will maintain this file after you initially set it up.  You must specify
  170. which message area number corresponds with each echo you receive.  If you
  171. don't specify a message area number, the echomail you receive will not
  172. appear in any message areas, but rather it will be discarded.  Hub systems
  173. may specify area 0 for "pass-through" areas.
  174.      A "pass-through" area is an echo that you don't want to make available
  175. on your own BBS, bud one or more systems you scan-out echomail to want to
  176. carry on their BBS(es).  That means, hub systems can offer a thousand
  177. echoes to a MacroNET point-node system and not have to set up every area on
  178. his/her own BBS, and the list of MacroNET echoes available to you is not
  179. likely to be influenced by your hub SysOp's own likes and dislikes.
  180. ----
  181. ^ The MBBSMAID is the built-in echomail configuration handler, similar in
  182. theory to FidoNet's AREAFIX utility (by George Peace). Every MacroBBS 3.0
  183. system has an MBBSMAID, but only echomail distribution (hub) systems will
  184. fully appreciate her services.
  185.  
  186.   -  Edit the file MBBSSCAN.OUT.  This file is used to instruct MacroBBS
  187. on which "send primary" (flavor) to assign to echomail packets for the
  188. specified address.  Netmail will ask you for the "send priority"
  189. on-the-spot, since netmail is a direct means of sending a message to
  190. another system (node).  Echomail is designed more for general public
  191. access.  Because of this, the "send priority" for echomail must be
  192. pre-set by the SysOp.  I recommend you use "H" (Hold) unless you don't
  193. mine your system dialing-out to deliver newly posted echomail at all
  194. hours of the day.  The economical way is to collect echomail and deliver
  195. it one time per day as a manual poll or as a poll event.
  196.  
  197.  
  198. ┌───  SESSION PASSWORDS  ─────────────────────────────────────────────
  199. │     It is highly recommended (and sometimes mandatory) that you use a
  200. │ session password with each MacroNET system you communicate with.  This will
  201. │ protect you from other systems disguising themselves as your system.  Let's
  202. │ say your MacroNET address is M100.  Anyone could configure their system as
  203. │ "M100" and pick-up your mail and/or files from your HUB system.  To avoid
  204. │ this, just arrange a password with your HUB system.
  205. │     To implement a session password, just create a file called <mode#>.PW
  206. │ (Eg.  M200.PW) in your \{COMMO}\MSGS\NET directory containing ONLY the
  207. │ desired password.  BUT BE SURE TO DO THIS ONLY AFTER NOTIFYING THE SYSOP OF
  208. │ THE OTHER SYSTEM.  If you set up a session password with MacroNET node M200
  209. │ and the SysOp of that node doesn't set up the same password before he/she
  210. │ polls you for mail, that system will not be allowed to pick up its mail ...
  211. │ until he/she sets up the password on their own system.
  212. │ Here's an illustration:
  213. │                    ┌──────┐                ┌──────┐
  214. │                    │ M100 │                │ M200 │
  215. │                    └──────┘                └──────┘
  216. │                        │                       │
  217. │  \{COMMO}\MSGS\NET
  218. │      password file:   M200.PW                 M100.PW
  219. │      file contents:   <pword>                 <pword>
  220. │     The above two systems will successfully transfer mail only because they
  221. │ have the same password set up for each other.  Just as it's a good idea to
  222. │ use a different/unique password for each BBS you call, it's a good idea to
  223. │ use a different/unique password with each MacroNET system you communicate
  224. │ with.
  225. └─────────────────────────────────────────────────────────────────────
  226.  
  227.   -  The last step is to send a netmail message to your MacroNET hub
  228. system.  If you are the first MacroNET system in your area, contact me at
  229. MacroNET node M1 via netmail.  I'll either be your echomail hub or I'll
  230. direct you to a hub system closer to you.  After a hub system is assigned
  231. to you and you set up a session password with that system, you can send a
  232. netmail message to turn on all the MacroNET echoes you'd like to carry on
  233. your own system.  The netmail message should be addressed TO: MBBSMAID at
  234. the node address of the hub system.  The subject line must contain your
  235. session password.  Your netmail message to MBBSMAID should follow this
  236. format:
  237.  
  238. --------------------------------------
  239.   NODE#: <hub address>
  240.    FROM: <your name as it appears in the nodelist>
  241.      TO: MBBSMAID
  242. SUBJECT: <pword>
  243.  
  244. MACROBBS
  245. {COMMO}
  246. -TELIX
  247. --------------------------------------
  248.  
  249. This example netmail message, when processed by the hub system, will turn
  250. on the MACROBBS echo, turn on the {COMMO} echo, and turn off the TELIX
  251. echo.  The MBBSMAID will generate a reply informing you of the changes made
  252. to your echomail configuration on the hub system.  This message will be put
  253. on hold for you to pick up the next time your MacroBBS system connects with
  254. the hub system.
  255.  
  256. NOTE THE FOLLOWING REQUIREMENTS:
  257. - You must be listed in the MacroNET nodelist before MBBSMAID will process
  258.   your request.
  259. - You must have already set up a session password with the hub SysOp, or
  260.   MBBSMAID will not process your request.
  261. These requirements were programmed into MacroBBS to protect SysOps from
  262. unwanted access of their systems.
  263.  
  264. ===========================================================================
  265.     If you'd like more information, keep on reading.  If not, let me dear
  266. from ya!
  267. ===========================================================================
  268.  
  269.                             -  end of Quick Start -
  270.  
  271. -  MacroNET in more detail -
  272.  
  273. I.  MACROBBS'S CONFIG MODULE, YOUR MACRONET ADDRESS, AND MESSAGE SEND PRIORITY
  274.  
  275.  Enter MacroBBS's configuration module either by running MBCFG.BAT from
  276. the DOS prompt or by selecting option 8 from MacroBBS's "Offline SysOp
  277. Menu".  Once inside the configuration module, select option 3.  Answer
  278. the questions until you reach the question which asks you to enter your
  279. MacroNET note address.  This is where you would give your BBS a network
  280. address, similar in theory to a house's street address.  Each address is
  281. unique.  Mail addressed to your house's address is delivered to your
  282. house.  Likewise, mail addressed to your computer's network address is
  283. delivered to your computer.  But, you don't address your own house, the
  284. city does that.  So,  please use the temporary address of M999 until you
  285. are assigned an official MacroNET address.
  286.  
  287.  Your MacroNET node address?  M999
  288.  
  289.     To request an address, you need only send NETMAIL to MacroNET node M1.
  290. To do this from MacroBBS's Offline Wait Screen, select option "S" to go
  291. to the Offline SysOp Menu.  From there, select option "N" to Send
  292. Netmail.  At the Node ID prompt, enter M1 and press <ENTER>.  Please use
  293. your real name, "Jeff Oberlee" will appear automatically in the TO:
  294. field.  Press <ENTER> to accept this then enter a Subject for your
  295. message.  You will then be placed into MacroBBS's message editor.  Your
  296. message should contain information about your system such as your real
  297. first and last name, your BBS's name, your location (city, state), and
  298. your BBS's phone number.  All of this information will be used to create
  299. a nodelist entry for you, and to assign you a MacroNET node address.
  300.     When you go to save the message, it will ask you to choose the "send
  301. priority."  This means, you need to choose the method of delivery for
  302. the netmail message.  You have two choices: "H" for Hold and "C" for
  303. Crash.  HOLD instructs MacroBBS to "hold" the netmail message for you to
  304. deliver when you decide to manually poll the destination system,  You
  305. "manually poll" by choosing option "P" from MacroBBS's Offline Wait
  306. Screen.  MacroBBS will not automatically deliver mail marked "hold".
  307. CRASH Instructs MacroBBS to automatically attempt to deliver the mail
  308. Itself.  This pays NO attention to the time of day.  MacroBBS will
  309. attempt to send crash mail every ten minutes or so, until it is
  310. delivered.
  311.     The "Attach files" prompt allows you to send files to the
  312. destination node by merely specifying a path\filename.  You can send as
  313. many files as you wish.  The Outbound mail window will reflect the total
  314. size of the packet to be sent to the destination note.  Upto three
  315. outbound packets will be displayed in the Outbound mail window.
  316.  
  317. 2.  ECHOMAIL: WHAT IT IS, HOW IT WORKS, AND HOW TO MAKE IT WORK FOR YOU
  318.  
  319.     Echomail has been around for years now.  The idea behind it is:
  320. communication between people between more than 1 computer system.
  321. Echomail is now as common to the computer industry as ... water is to
  322. fish!  An example of echomail would be easily explained by suggesting
  323. you think of a vocal echo.  That's how echomail works, in theory.
  324. Echomail starts at one point and is echoed to (shared by) other BBS
  325. systems.  These other BBS systems are part of a network.  Anytime
  326. someone enters an echomail message on a network-member BBS, all other
  327. BBS's in that network will receive a copy of the message.  If you post a
  328. message in the MacroBBS echo on one MacroNET BBS, all other MacroNET
  329. BBSes that participate in the MacroBBS echo will receive a copy of your
  330. message for their message base.  It's a sharing thing. :)
  331.  
  332.     The rest of this document will explain what needs to the done in
  333. order for MacroBBS to successfully provide echomail services.
  334.  
  335.     A necessary first step would be to review the list of current
  336. MacroNET echoes.  This list is referred to as the "echo list" and is
  337. included in the MacroBBS package as MNETEC0O.LST.  Review this list and
  338. decide which echoes you would like to carry on your BBS.  Might I
  339. suggest the MacroBBS echo and the {COMMO} echo?
  340.     Next, you need to "classify" your system.  That is, you have to
  341. decide if your BBS will be an "independent system" (this type of system
  342. does not participate in MacroNET), a MacroNET "hub" (this type of system
  343. distributes MacroNET echoes to other MacroNET systems, usually local
  344. systems), or a point-node system (this type of system receives its
  345. echomail from a local hub system).  The reason this distinction must be
  346. made is because the MacroNET node address assigned to you will be
  347. slightly different.  There are no advantages to being a hub system
  348. versus being a point-node system.  It amounts to whether or not you want
  349. to be a hub system.  If there is already a MacroNET hub in your area,
  350. you should contact the SysOp of that system to receive your node
  351. address.  If you are the first in your area to join MacroNET, please
  352. contact me at MacroNET node M1.
  353.  
  354.     The next thing you'll need to do is to create the new echomail
  355. message areas using MacroBBS's "Add a Message Area" Master SysMenu
  356. option.  Be sure to enter the echotag exactly as it appears on the
  357. MacroNET echo list.  The "echotag" should not be confused with the
  358. message area NAME.  The ECHOTAG is the universal name, used primarily by
  359. the MacroBBS internal echomail processor as a means of telling messages
  360. apart.  Think of it this way: each BBS might have a slightly different
  361. NAME for the same echo, but the ECHOTAG is the same on all MacroNET
  362. BBSes.  The actual message area NAME can be anything you like.  As an
  363. example, the General Chatter echo's echotag is "GENERAL" but the name
  364. can be anything you like ... "General Chatter," "General Stuff," "Open
  365. Forum," etc.)
  366. ------------------------------------------------------------------------
  367. NOTE:  As you are creating your new echomail message areas, keep track
  368. of the message area numbers because you will need them for the next step.
  369. ------------------------------------------------------------------------
  370.  
  371.     MacroBBS uses an ASCII file to keep track of your echomail
  372. configuration.  This ASCII file is mostly maintained by MacroBBS, but
  373. you must get it started.  A sample file is included in the MacroBBS
  374. package, and should be on your disk already.  MBBSECHO.LST should be in
  375. your data directory (\{COMMO}\MACROBBS).  Use your favorite ASCII editor
  376. to edit this file, or use {COMMO}'s interval editor by selecting
  377. MacroBBS's Offline option "3" -- edit text menu.
  378.     For each echomail message area you wish to carry on
  379. your BBS, you must specify three lines of information about the area:
  380. the first line contains the ECHOTAG as shown below.  The second line
  381. contains the message area NUMBER.  This number acts as a directive for
  382. the MacroBBS echomail processor -- so it knows where to put incoming
  383. echomail.  The third line contains the MacroNET node address(es) your
  384. system sends echomail to.  If you are a hub, you might easily have more
  385. than one address listen on this line.  If you are a point-node system,
  386. you should have only your hub's address on this line.  An easy way to
  387. think about this concept is to think of each address as the recipient of
  388. a photocopy each time someone posts an echomail message on your BBS.
  389. Each echo message area requires these three lines.
  390.  
  391. MBBSECHO.LST
  392. ══════════════════════════════════════════════════════════════════════════════╗
  393. ;   List the areas you want to echo along with the message area number as it  ║
  394. ; is in your BBS message area listing.                                        ║
  395. ;                                                                             ║
  396. ;  Format:          <ECHOTAG>                                                 ║
  397. ;                   <MBBS Msg Area#>                                          ║
  398. ;                   <MacroNET hub address(es) separated by :'s>
  399. MACROBBS                                                                      ║
  400. 14                                                                            ║
  401. :M1:
  402. SYSOP
  403. 15
  404. :M1:
  405. GENERAL
  406. 16          ╔═════════════════════════════════════════════════════════════════╣
  407. :M1:        ║                                                                 ║
  408. TEENTALK    ║   You might want to use some of these ECHOTAGS, but be sure     ║
  409. 17          ║   to REPLACE the numbers with YOUR message area numbers.        ║
  410. :M1:        ║   You may also need to change the address field to your         ║
  411. {COMMO}     ║   hub's address.                                                ║
  412. 18          ║                                                                 ║
  413. :M1:        ║                                                                 ║
  414.             ║                                                                 ║
  415. ════════════╩═════════════════════════════════════════════════════════════════╝
  416.  
  417.     Next, edit the file MBBSSCAN.OUT.  This file is used to instruct
  418. MacroBBS on which "send primary" (flavor) to assign to echomail packets
  419. for the specified address.  Netmail will ask you for the "send priority"
  420. on-the-spot, since netmail is a direct means of sending a message to
  421. another system (node).  Echomail is designed more for general public
  422. access.  Because of this, the "send priority" for echomail must be
  423. pre-set by the SysOp.  I recommend you use "H" (Hold) unless you don't
  424. mine your system dialing-out to deliver newly posted echomail at all
  425. hours of the day.  The economical way is to collect echomail and deliver
  426. it one time per day as a manual poll or as a poll event.
  427.  
  428. MBBSSCAN.OUT
  429. ══════════════════════════════════════════════════════════════════════════════╗
  430. ;  List all mode numnbers to scan-out echomail to.                            ║
  431. ;  WARNING!  Only DESIGNATED HUBS should have more than one node listed.      ║
  432. ;                                                                             ║
  433. ;  Format:          <MacroNET node address>                                   ║
  434. ;                   <Send Priority (flavor)>   - (C)rash or (H)old            ║
  435. M1          ╔═════════════════════════════════════════════════════════════════╣            ║    This file should continue your echomail hub's MacroNET node  ║            ║    address ONLY.  If you are an echomail hub distributing echo- ║
  436. H           ║  This file should continue your echomail hub's MacroNET node    ║
  437.             ║  address ONLY.  If you are an echomail hub distributing echo-   ║
  438.             ║  mail to more than one system, then you should specify each     ║
  439.             ║  address in this file.                                          ║
  440. ════════════╩═════════════════════════════════════════════════════════════════╝
  441.  
  442.   -  The last step is to send a netmail message to your MacroNET hub
  443. system.  If you are the first MacroNET system in your area, contact me at
  444. MacroNET node M1 via netmail.  I'll either be your echomail hub or I'll
  445. direct you to a hub system closer to you.  After a hub system is assigned
  446. to you and you set up a session password with that system, you can send a
  447. netmail message to turn on all the MacroNET echoes you'd like to carry on
  448. your own system.  The netmail message should be addressed TO: MBBSMAID at
  449. the node address of the hub system.  The subject line must contain your
  450. session password.  Your netmail message to MBBSMAID should follow this
  451. format:
  452.  
  453. --------------------------------------
  454.   NODE#: <hub address>
  455.    FROM: <your name as it appears in the nodelist>
  456.      TO: MBBSMAID
  457. SUBJECT: <pword>
  458.  
  459. MACROBBS
  460. {COMMO}
  461. -TELIX
  462. --------------------------------------
  463.  
  464. This example netmail message, when processed by the hub system, will turn
  465. on the MACROBBS echo, turn on the {COMMO} echo, and turn off the TELIX
  466. echo.  The MBBSMAID will generate a reply informing you of the changes made
  467. to your echomail configuration on the hub system.  This message will be put
  468. on hold for you to pick up the next time your MacroBBS system connects with
  469. the hub system.
  470.  
  471. NOTE THE FOLLOWING REQUIREMENTS:
  472. - You must be listed in the MacroNET nodelist before MBBSMAID will process
  473.   your request.
  474. - You must have already set up a session password with the hub SysOp, or
  475.   MBBSMAID will not process your request.
  476. These requirements were programmed into MacroBBS to protect SysOps from
  477. unwanted access of their systems.
  478.  
  479.  
  480.  ┌─────────┐
  481.  │ SUMMARY │
  482.  └─────────┘
  483.  
  484.     The difference between NETMAIL and ECHOMAIL is that netmail is a
  485. message you send to a specified node.  You can send netmail to ANY node
  486. listed in the nodelist.  Echomail, on the uther hand, is always sent to
  487. the HUB system.  From there, the HUB distributes it to all other nodes
  488. in the net.  Netmail is private; Echomail is public.
  489.  
  490. * NETMAIL
  491.  
  492.   To compose a netmail message, go to the Offline SysOp Functions Menu.
  493. Choose option "N".  Enter the destination node#.  The sysop's name will
  494. be given as a default, but you can send netmail to anyone at the
  495. destination node as long as you use the person's real name, alias, or
  496. ID# EXACTLY AS IT IS AT THE DESTINATION NODE,  When the destination node
  497. receives netmail addresssed to someone that doesn't exist on that BBS,
  498. the netmail is as good as deleted.  Netmail is placed in the E-mailbox
  499. of the addressee--the person to whom it is addressed.
  500.  
  501. * ECHOMAIL
  502.  
  503.     MBBS will pack newly posted echomail after a caller lugs off and
  504. then it will either HOLD it (MBBS won't attempt to deliver it) or CRASH
  505. it (MBBS attempts z dial-out to deliver thA packet approximately every
  506. ten minutes) -- depending on whether you have an H or a C assigned to
  507. the destination node in MBBSSCAN.OUT.  If you choose HOLD, mail will
  508. accumulate until you (P)oll the destination node (ie. dial it manually
  509. from MBBS's Offline Wait Screen), or until the destination node dials
  510. you.  Echomail will keep your message base moving, even IF no one posts
  511. on your system.  But with the increased incentive that comes with
  512. echomail, you will likely see an increase in message base participation,
  513.  
  514.      (C)rash overrides (H)old, so if you have a packet for M1 marked
  515. (H)old, and you decide to (C)rash a netmail message to M1, MacroBBS will
  516. act upon the (C)rash and dial-out periodically.  The packet marked
  517. (H)old will be sent along with the Crash mail (since it's going to
  518. the same address).
  519.  
  520.  
  521. *************************************
  522. IV.  Multi-node configuration
  523. *************************************
  524.  
  525. - MacroBBS now has (experimental) malti-node capability.  I don't currently
  526. have the means to fully test this system and don't recommend it be used by
  527. anyone who doesn't have a working knowledge of multi-node setups and
  528. multi-tasking.  The following is an explanation of what needs to be down in
  529. order for MacroBBS to operate in a multi-node environment...
  530.  
  531.  ┌───────┐
  532.  │ SETUP │
  533.  └───────┘
  534.  
  535.     Create as many directories as you have phone lines.  If you have two
  536. phone lines and two modems to devote to your BBS, then you need to create
  537. two directories (e.g. BBS1 and BBS2).  Both of these directories must
  538. contain their own copy of {COMMO} configured for the directory that
  539. contains it -- that is, each {COMMO} must be independent of the others
  540. (e.g. the {COMMO} in the BBS1 directory must be configured for the BBS1
  541. directory).
  542.    Next, set up MacroBBS in the "primary" directory (e.g. BBS1) as you would
  543. normally, with all the directories.  All other directories need only a
  544. partial setup.  The reason is, "secondary" directories such as BBS2 will
  545. utilize the same message areas, file areas, caller files, and data
  546. directory as the primary directory.
  547.  
  548.  
  549.                       Primary                   Secondary
  550.  
  551.          ┌────────────\BBS1                       \BBS2
  552.          │   ┌────────┘│││└IN                        │└IN
  553.         MSGS │  CALLERS┘│└READER                     └READER
  554.            FILES   MACROBBS
  555.  
  556.  
  557.     You would have only one PRIMARY MacroBBS setup, but you would have as
  558. many SECONDARY directories as you have extra phone lines to use for the BBS
  559. -- that is, one secondary setup for each phone line beyond the first
  560. (primary) phone line.
  561.     Both the primary and secondary directories must contained {COMMO} and
  562. all the MacroBBS files.  This is fairly easy to do.  Make sure to configure
  563. {COMMO}, then run MacroBBS's configuration module -- repeat this procedure
  564. for each directory.  The primary setup requires no extra configuring --
  565. just be sure to set the node number and directory in the multi-node config
  566. (options 6 from the configuration many).  The secondary configuration, on
  567. the other hand, require that you specify the primary directories that are
  568. to be used rather than the default directories (remember, we're planning to
  569. create the SAME environment for more than one caller at a time.)
  570.  
  571.  
  572.  Primary configuration      1st Secondary config.      2na Secondary config.
  573.  Node 1                     Node 2                     Node 3
  574.  
  575.  Main dir: \BBS1            Main dir: \BBS2            Main dir: \BBS3
  576.  Data dir: \BBS1\MACROBBS\  Data dir: \BBS1\MACROBBS\  Data dir: \BBS1\MACROBBS\
  577.  Msgs dir: \BBS1\MSGS\      Msgs dir: \BBS1\MSGS\      Msgs dir: \BBS1\MSGS\
  578. Files dir: \BBS1\FILES\    Files dir: \BBS1\FILES\    Files dir: \BBS1\FILES\
  579.  User dir: \BBS1\CALLERS\   User dir: \BBS1\CALLERS\   User dir: \BBS1\CALLERS\
  580.  
  581.  
  582.     Notice that the only change from one directory configuration to the
  583. next is the main directory.  The other directories are common to each
  584. node.  Be sure to specify the node number and main directory for each
  585. configuration.  That is the only information MacroBBS has to tell which
  586. configuration is which (the other directories are all the same).
  587.  
  588.     A few things to keep in mind while configuring:
  589.  
  590.   * Each node of your BBS uses the same MacroNET address.
  591.   * All nodes utilize the same semaphore directory.
  592.   * If you don't want to use a multi-node chat program, remove MACROCHT.MAC
  593.      from your MacroBBS directories.
  594.  
  595.  
  596.      MULTI-NODE CHAT AND VARIABLES
  597.  
  598.     Multi-node chat is only possible by configuring an external program
  599. designed to facilitate communication between the nodes of a multi-node BBS.
  600. MacroBBS can easily be configured to use such a program.  Make sure to
  601. follow all setup instructions for the external chat program of your choice,
  602. then specify the DOS command line in MacroBBS's configuration module.
  603.     When a user enters the multi-node chat door, MacroBBS creates a
  604. DOOR.SYS dropfile in the %maindir (the home directory of that node). Thanks
  605. to Devnis Boone, it also creates a "dummy" USERON.BBS file in the %multidir
  606. (the semaphore directory).  Almost every chat door I looked at _requires_ a
  607. USERON.BBS file before it would even work.  The included file, DS2UOB.EXE,
  608. will generate the USERON.BBS file from the created DOOR.SYS file.  (All of
  609. this happens automatically, in about .5 seconds.)
  610.     There are only a few variables that might be helpful in configuring
  611. a multi-node chat program.
  612.  
  613.    %bud         - contains the active node number
  614.    %maindir     - contains the home directory of the active node
  615.    %multidir    - ontains the semaphore directory
  616.  
  617.     I tested the system, to some extent, using a chat door called
  618. SabreChat! by Shawn Gresham.  It worked well after following all the setup
  619. instructions Whichever chat door you decide to use, you will need to tell
  620. it where to find the USERON.BBS file.  As mentioned above, this file will
  621. be written to your %multidir -- that is, the directory you specify as the
  622. MacroBBS semaphore directory.  It also wanted to know where the DOOR.SYS
  623. file was. The command line I used is available as default text in the
  624. MacroBBS configuration module.
  625.  
  626.  
  627.     MULTI-TASKING
  628.  
  629.     The next important step is to configure a multi-tasker, such as
  630. DesqView.  To create a multi-node environment, you can fairly easily
  631. configure DV to run each of your MacroBBS nodes.  Given that you are
  632. familiar with how DV works, you have configured {COMMO} for each directory
  633. you plan to use, and you've configured each MacroBBS as shown above, you
  634. should have a working multi-node BBS.
  635.  
  636.     REMEMBER THAT THIS FACET OF MACROBBS IS STILL EXPERIMENTAL!
  637.  
  638.     {COMMO} is not SHARE.EXE-aware, so a fairly complex semaphore system
  639. was implemented into MacroBBS.  This system _attempts_ to protect your hard
  640. drive from crashes caused by multiple and simultaneous calls upon the same
  641. file.  This is highly likely in a multi-user BBS environment.  Say UserA
  642. is reading messages while User B is writing a message.  Care was taken to
  643. make sure that UserA wouldn't be allowed to read UserB's message until it
  644. was fully saved.  If UserA was allowed to read UserB's message while it
  645. was still being written to disk, your system would crash (simultaneous
  646. reads and writes of the SAME file must not occur).
  647.  
  648.     THE SEMAPHORE SYSTEM IS NOT PERFECT!  There are several considerations
  649. that must be made in order to avoid file access errors:
  650.  
  651.   * DELETE MACROSYS.MAC FROM EACH OF YOUR MACROBBS DIRECTORIES.  The
  652. performance of MacroBBS was severely hindered by attempts to make this
  653. macro functional in a multi-node environment.  Therefore, it was decided
  654. that MACROSYS.MAC was better-off deleted.  Deleting of this macro will not
  655. affect MacroBBS's performance.  It will simply disable the "! Remote
  656. Config" option.
  657.  
  658.   * Make sure that anyone with access to the Message SysOp Functions is
  659. aware that these functions (e.g. copy, move, etc.) are dangerous,
  660. especially the EDIT function.  These options are best left for use when no
  661. one else is online.
  662.  
  663.   * Offline Wait Screen functions should be used when no users are online.
  664. This is very much the same situation as with the MACROSYS.MAC macro file.
  665. Some of the functions, such as reading SysOp mail, are safe, but the
  666. majority should be avoided until no other users are online or until after
  667. you have taken down all other nodes.   As an example, if you are reading
  668. the system logs offline while a user is online, you will more than likely
  669. experience a system crash, because you were READING the log while the
  670. online user was doing something that made a log WRITE.  Be very careful!
  671.  
  672.                                ---
  673.