home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / acs_deng / acs_eng3.doc < prev    next >
Text File  |  1989-04-07  |  42KB  |  1,003 lines
  1.  
  2.  
  3.                                P A R T   3 
  4.  
  5.                     (Appendix with Detail Information)
  6.  
  7.  
  8.  
  9.  
  10. You'll find, in this part, specific information within the individual
  11. appendixes about the ACS Package.
  12.  
  13.           
  14.       - Appendix 1: ACS.CFG and Binkley.RTE Files documentation (R.Bohn)
  15.  
  16.       - Appendix 2: Graphical overview  (M.Dominick)
  17.  
  18.       - Appendix 3: When do the different Packers work (M.Dominick)
  19.  
  20.       - Appendix 4: File Request from other Nodes (E.Jeckl)
  21.  
  22.       - Appendix 5: Crashmails (E.Jeckl)
  23.  
  24.       - Appendix 6: Domains (R.Bohn)
  25.  
  26.                           Translator: Frank Bell
  27.  
  28.  
  29. A P P E N D I X  1:
  30.  
  31. ACS.CFG and Binkley.RTE Files documentation (by Roland Bohn):
  32. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  33.  
  34.  
  35.                             ---  ACS.CFG  ---
  36.  
  37.        An Example of the Area-Cleaner-Software Configuration File.
  38.        ===========================================================
  39.  
  40. General Parameters:
  41. ^^^^^^^^^^^^^^^^^^^
  42.  
  43. So that Come_In and Go_Out know what Packer program to use and what 
  44. parameters to pass to these Packers the following keywords are needed.
  45. The *Imp paths are for - who would have thought of that - Come_In and
  46. the *Exp paths influence Go_Out accordingly.
  47. The '+' just after the keyword means that the parameter used on the 
  48. file to be unpacked is separate from the Path, just like its done 
  49. with LHarc version 1.13.
  50.  
  51. Format: ArcImp[+] <File path of the Arcer> [Packer Parameters]
  52.         ArcExp    <File path of the Arcer> [Packer Parameters]
  53.  
  54. ArcImp      \NODE\PACKER\ARC_602.TTP x
  55. ArjImp      \NODE\PACKER\UNARJ.TTP -x
  56. LzhImp+     \NODE\PACKER\LHARC.TTP x
  57. ZipImp      \NODE\PACKER\UNZIP.TTP
  58. ZooImp+     \NODE\PACKER\ZOO.TTP xO      (Oh, not zero!)
  59.  
  60. ArcExp      \NODE\PACKER\ARC_602.TTP a
  61. ArjExp      \NODE\PACKER\ARJ.TTP -a      (Note that there isn't any ARJ yet)
  62. LzhExp      \NODE\PACKER\LHARC.TTP a
  63. ZipExp      \NODE\PACKER\ZIP.TTP a    
  64. ZooExp      \NODE\PACKER\ZOO.TTP aP:
  65.  
  66. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  67.  
  68. Normally Tidy_Up works in all Areas that are listed in AREAS.BBS.  But 
  69. most of the time not all Areas have been changed so there is no reason 
  70. for these Areas to be processed.  LED and Come_in can create a file 
  71. where only those Areas which have changes are listed.  Tidy_Up can read
  72. this and then process only the Areas included in the file (except of
  73. course for the Netmail and two other 'help' Areas).  The file is deleted
  74. as soon as Tidy_Up has done its job and recreated by LED and/or Come_In
  75. when they're loaded the next time. 
  76.  
  77. Format: EchoList <File Path>
  78.  
  79. Example:  EchoList \NODE\NEWECHOS.LST
  80.  
  81. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  82.  
  83. When Tidy_Up scan Areas it has to make copy all Echomails which are to 
  84. be exported so that Go_Out can process them.  Normally the Netmail 
  85. Area is used for this propose.  But because Netmail is also used for 
  86. private messages its very inconvenient to search for these mails which 
  87. may lay between the temporary Echomail copies.  
  88.  
  89. So its possible to tell Tidy_Up and Go_Out to use an extra Area for 
  90. their Echomail processing.
  91.  
  92. Format:  ExtraExpArea <File Path without Extension>
  93.  
  94. Example:  ExtraExpArea \NODE\MSGS\EXPAREA
  95.  
  96. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  97.  
  98. Its sometimes possible that Points (or even their Boss) create messages 
  99. in Areas which don't even exist or which haven't been requested.  
  100. Simply said: when Come_In has to process an Area in which it hasn't 
  101. the slightest idea of what's going on, its shove the incoming messages 
  102. into the Bad_Msgs Area (if it exist) or into Netmail (if it doesn't). 
  103.  
  104. The Bad_Msgs Area is a Help Area used to keep such messages out of the 
  105. Netmail.  Further processing of these messages has to be done by hand.
  106.  
  107. Format:  Bad_Msgs <File Path without Extension>
  108.  
  109. Example:  Bad_Msgs \NODE\MSGS\BADMSGS
  110.  
  111. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  112.  
  113. Special Flags for Come_In:
  114. ^^^^^^^^^^^^^^^^^^^^^^^^^^
  115.  
  116. Note: - All flags are activated with '+' and deactivated with a '-'.
  117.       - Not all Commandline-Flags are also saved in the ACS.CFG.
  118.  
  119. ACS.CFG   Command Line   Description 
  120. -----------------------------------------------------------------------
  121. LogInfo         -l       An extract of the screen messages is written
  122.                          to the Log File which is defined in BINKLEY.CFG.
  123. Verbose         -v       Comprehensive information concerning Packet 
  124.                          File is written to the screen and the Logfile.  
  125. Keep_ArcImport  -k       The packed Packets (*.mo0, *.tu0, etc.) are not 
  126.                          deleted after they have been Imported.
  127.                          Just in case an error occurs during mail importing
  128.                          (because of ARC, LHarc or TOS error (disk full)) 
  129.                          the mail packet won't be deleted.  This gives one 
  130.                          the possibility to unpack the files again after 
  131.                          correcting the problem.
  132. AreaFix                  The integrated AreaFix is activated. (for Nodes)
  133. FileFix                  The integrated FileFix is activated.
  134. PrintMyMail              All incoming own Netmails will be printed out, if 
  135.                          the printer is online.
  136. Diskfree        -f       Before an Area is processed, the partition is 
  137.                          checked for enough room.  If room is not 
  138.                          available, the process is cancelled. 
  139. Wait            -w       Come_In waits for a 'key press' when finished.
  140. Quiet           -q       No messages will be displayed on the screen.
  141.  
  142. Example:
  143.  
  144. Come_In:
  145. +LogInfo
  146. +Verbose
  147. -Keep_ArcImport
  148. -Diskfree
  149. -Wait
  150. -Quiet
  151. -AreaFix
  152. -FileFix
  153. -PrintMyMail
  154.  
  155. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  156.  
  157. Special Flags for Tidy_Up:
  158. ^^^^^^^^^^^^^^^^^^^^^^^^^^
  159.  
  160. ACS.CFG   Command Line   Description 
  161. -----------------------------------------------------------------------
  162. Days xx         -dxx     The number of days after which messages are
  163.                          automatically deleted.
  164. HeaderLevel xx  -hxx     The minimum number of messages which should be
  165.                          left in an Area.  If the number of messages
  166.                          in an Area is less than this number then the 
  167.                          Area is skipped over.
  168. LogInfo         -l       Refer to Come_In.
  169. Verbose         -v       Refer to Come_In.
  170. KillDupes       -k       Duplicate Messages are delete.
  171. UseExtraExpArea -e       Refer to ExtraExpArea - This parameter says
  172.                          everything anyway doesn't it?
  173. LastCall        -c       Just in case an eccentric clock shows the
  174.                          wrong date (2049 for example) Tidy_Up would
  175.                          is sure to remove all messages because it 
  176.                          would interpret them as being too old.  If 
  177.                          this flag is turned on, then Tidy_Up checks to
  178.                          see if it has been called within the last 10
  179.                          days.  If not, then a messages is displayed and
  180.                          Tidy_Up waits for an answer.
  181. Keep_OldMsgs    -o       A copy of Netmail is made before Tidy_Up starts
  182.                          processing.
  183. Diskfree        -f       Refer to Come_In.
  184. Wait            -w       Refer to Come_In.
  185. Quiet           -q       Refer to Come_In.
  186.  
  187. Example:
  188.  
  189. Tidy_Up:
  190. +Days             4
  191. +HeaderLevel      20
  192. +Loginfo
  193. -Verbose
  194. +KillDupes
  195. +UseextraExpArea
  196. -Keep_OldMsgs
  197. +LastCall
  198. -Diskfree
  199. -Wait
  200. -Quiet
  201.  
  202. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  203.  
  204. Special Flags for Go_Out:
  205. ^^^^^^^^^^^^^^^^^^^^^^^^^
  206.  
  207. ACS.CFG   Command Line   Description 
  208. -----------------------------------------------------------------------
  209. Deletemode #|^  -d#|^    Refer to the "BinkleyTerm User's Guide".  The
  210.                          characters '#' or '^' are written to the 
  211.                          corresponding Binkley-Outbound-Flow-File to 
  212.                          tell BinkleyTerm what to do with the files
  213.                          after exporting them.
  214.                          Using a '^' the files will be deleted.
  215.                          Using a '#' the files will reduced to a length
  216.                          of zero.  Because the file name remains on 
  217.                          disk, when using the second method, the 
  218.                          so-called FlowFile-Counter is activated. The File 
  219.                          then exist with the ending *.MO0. After the 
  220.                          next Poll, then *.MO1, *.MO2, etc.
  221. LogInfo         -l       Refer to Come_In.
  222. Verbose         -v       Refer to Come_In.
  223. Crashmail       -c       When a Netmail is flagged 'Crash', its not 
  224.                          routed like a normal Netmail, its packed for 
  225.                          direct transmission to the addressee. If this Flag 
  226.                          is turned off the Crash Flag will be ignored.
  227. UseExtraExpArea -e       Refer to Come_In.
  228. Keep_NetHdr     -o       A NETMAIL.HDR is first renamed to to 
  229.                          NETMAIL.OLD.  Just in case something happens 
  230.                          the old Netmail structure can be easily 
  231.                          recreated.                          
  232. Unarced_Netmail -u       Netmails won't be packed and are sent out as
  233.                          *.PKT files.
  234. SaveWorkList    -s       Go_Out creates a small Worklist in memory from
  235.                          NODELIST.DAT, this means Go_Out has process
  236.                          a little longer.  When this flag is turned on,
  237.                          the Worklist is saved to disk.  The next time
  238.                          Go_Out is called it just has to load the 
  239.                          Worklist. 
  240. Wait            -w       Refer to Come_In.
  241. Quiet           -q       Refer to Come_In.
  242.  
  243. Example:
  244.  
  245. Go_Out:
  246. -Deletemode
  247. +Loginfo
  248. +Verbose
  249. +Crashmail
  250. +UseExtraExpArea
  251. -Keep_NetHdr
  252. -Unarced_Netmail
  253. +SaveWorklist
  254. -Wait
  255. -Quiet
  256.  
  257. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  258.  
  259. Parameters for Come_In's integrated AreaFix and FileFix:
  260. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  261.  
  262. AreaFix:
  263. ^^^^^^^^
  264.  
  265. With the help of AreaFix connected Nodes and Points have the possibility 
  266. to independently connect or disconnect their Areas.  That happens via 
  267. Netmail, addressed on AreaFix, in which line for line the Areas are 
  268. listed which are to be connected or disconnected (this is described 
  269. further in the documentation to BTS).  As not everybody is allowed to 
  270. order or remove all Areas, passwords have to be used.  The password, as 
  271. an authorization, is written in the subject line of the AreaFix Netmail, 
  272. parameters can follow.
  273.  
  274. A password, for AreaFix, must be given to every Node/Point who wants to 
  275. receive Areas from the system and who want to do their own management.
  276.  
  277. Format: AreaFixPwd <4D-Address> <Password>
  278.  
  279. Example:  AreaFixPwd 2:241/5811.1 TEST
  280.           AreaFixPwd 2:310/12.0 HELLO
  281.  
  282. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  283.  
  284. With AreaFix, an overview of Areas can be requested, then one receives
  285. a complete list of existing Areanames.  But if one doesn't know anything 
  286. about some Areas, then its impossible to know if those Areas are 
  287. interesting or not.  A text file with Area descriptions would be very 
  288. helpful in this case.  Using the parameter -l, after AreaFix in the 
  289. Netmail subject line, such a text file can be requested.  With 
  290. AreaFixAvail a file path is defined which points to this file.
  291.  
  292. Format: AreaFixAvail <File Path>
  293.  
  294. Example:  AreaFixAvail \NODE\FILES\AREALIST.LZH 
  295.  
  296. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  297.  
  298. FileFix:
  299. ^^^^^^^^
  300.  
  301. In Fidonet messages are constantly passed back and forth and it works 
  302. pretty good too, but files are a different matter, its not so easy.  
  303. There is a way, actually many methods have been thought out for file
  304. routing and TICK is, for example, a very well known routing program on 
  305. PC compatibles.  
  306.  
  307. Come_In's integrated FileFix is a simple File Router (TICK compatible to 
  308. a certain extent) which controls the routing of files.  
  309.  
  310. Just like AreaFix the connected Nodes/Points have the possibility to 
  311. connect or disconnect FileEchos independently.  A password is also 
  312. needed for FileFix, refer to AreaFix. 
  313.  
  314. Format:  FileFixPwd <4D-Address> <Password>
  315.  
  316. Example:  FileFixPwd 2:241/5811.1 NOTHING
  317.           FileFixPwd 2:310/12.0 SPECIAL
  318.  
  319. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  320.  
  321. FileFix also has a text file with FileEchos descriptions.  Using 
  322. FileFixAvail a file path is defined for this file which can also be 
  323. requested from connect Nodes/Points with the -l parameter.
  324.  
  325. Format:  FileFixAvail <File Path>
  326.  
  327. Example:  FileFixAvail \NODE\FILES\FILELIST.LZH
  328.  
  329. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  330.  
  331. When one is connected to a FileEcho then one knows when a new file is 
  332. received.  But an outsider doesn't get much out of it.  FileFix has the 
  333. possibility to send notes that new files are available to a Message- 
  334. Area indicated below.
  335.  
  336. Format: FileFixReportArea <Areaname>
  337.  
  338. Example:  FileFixReportArea   NEWFILES
  339.  
  340. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  341.  
  342. Area-Gating with Come_In:
  343. ~~~~~~~~~~~~~~~~~~~~~~~~~
  344.  
  345. With the steady increase of the Online-Users during the last years there 
  346. were many new Networks born and all of them naturaly want to use own Areas.
  347. But some of the Users maybe want to read some foreign Areas from the other 
  348. Networks without using also the foreign name.
  349. A single Node must take the Messages of the foreign Area, copy them to 
  350. the own Area and distribute the Messages within this Areas through his 
  351. Network. This Node acts as an Area-Gate from his Network to the foreign one.
  352. ACS can either copy or move the Messages received in the foreign Area to one
  353. or more Areas (up to 4) of his Network.
  354. If the Gate Node doesn't have to distribute the foreign Msgs further to 
  355. other Nodes in the foreign Network, so he doesn't need to save the incoming
  356. Msgs in the foreign Area. In this case he should/can use the move Command.
  357.  
  358. Note: copy and move mean of course that the incoming Messages for the 
  359.       foreign Area will be copied/moved to the own Areas.
  360.       If the incoming Messages for the own Areas should be copied back to
  361.       the foreign one, then it is required to install a copy or move 
  362.       Command for each own Area backwards to the foreign one.
  363.       (This helps to make also a 'oneway' Gate possible.)
  364.  
  365. Format:  Crosslinked_Areas:                      (as a Keyword in ACS.CFG)
  366.             copy <other_area> to <my_area>, ...  (1 to 4 Areas allowed)
  367.             move <other_area> to <my_area>, ...  (1 to 4 Areas allowed)
  368.  
  369. Example: 
  370.  
  371. Crosslinked_Areas:
  372.    move SFFAN to N_SF
  373.    copy N_SF  to SFFAN
  374.  
  375. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  376.  
  377. Readdressing with Come_In:
  378. ^^^^^^^^^^^^^^^^^^^^^^^^^^
  379.  
  380. It happens sometimes that the address of Nodes/Points change.  Other 
  381. Fidonet users can't react to the changed address very fast especially as 
  382. they may not know about the changes.  It makes sense that all Netmails 
  383. that were sent with the old address get rerouted to the new address.  
  384.  
  385. Come_In, with Readdress, has the ability to readdress individual Points 
  386. or Nodes or even whole Nets.  Here the '*' means that an element doesn't
  387. have to be considered or it doesn't have to be changed.
  388.  
  389. Format: Readdress "Change Receiver's Name" <Old 4D-Receiver's Address>
  390.                   "New Receiver's Name"    <New 4D-Receiver's Address>
  391.  
  392. Example:  Readdress "Roland Bohn" 2:241/5811.0 "Nobody Else" 2:241/5811.99
  393.           Readdress "Juergen Moellenhoff" 2:507/*.* "*" 2:241/5811.5
  394.           Readdress "*" 2:507/203.* "*" 2:241/5811.*
  395.  
  396. ============================================================================
  397.  
  398.  
  399.                           ---  BINKLEY.RTE  ---
  400.  
  401.             An Example of Area-Cleaner-Software Routing File.
  402.             =================================================
  403.  
  404. The Routing File helps to control where messages are sent and the 
  405. packing method used.  For example, Points, normally, only send their 
  406. messages to their Boss and he passes them on to other Nodes and so on, 
  407. till the Addressee is reached.  
  408.  
  409. The following macro names are used in all Route Commands: 
  410.  
  411. ALL      Example: 2:241/ALL, 2:ALL, ALL
  412. HOSTS    Example: 2:HOSTS  (Means: 2:241/0, 2:242/0, etc.)
  413. OURNET   (Means: all those in your own Net. I'm in Net 241.)
  414. POINTS   (Means: all my Points.)
  415.  
  416.  
  417. Important: Go_Out analyses the Routing Commands in the order that they 
  418.            appear.  The last command encountered by the referenced Node 
  419.            is always processed.  
  420.  
  421.            Example:
  422.            ROUTE-TO 241/5800 ALL     ;everything to 241/5800
  423.            ROUTE-TO 310/12 310/ALL   ;Net 310 to 310/12
  424.            A message to 310/3 is routed over 310/12.
  425.  
  426.            But:
  427.            ROUTE-TO 310/12 310/ALL   ;Net 310 to 310/12
  428.            ROUTE-TO 241/5800 ALL     ;everything else to 241/5800
  429.            A message to 310/3 is routed over 241/5800.  Because
  430.            the last command routes everything over 241/5800.
  431.  
  432.            All Node entries in Binkley.RTE are maximum 3D (that is 
  433.            2:241/5811).  When Routing is performed on ones own Zone 
  434.            the Zone entry isn't needed (241/5811).
  435.  
  436. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  437.  
  438.  
  439. Packing Methods:
  440. ^^^^^^^^^^^^^^^^
  441.  
  442. ACS only knows five Packers: Arc, Arj, LHarc, Zip and Zoo (also see ACS.CFG)
  443. Its possible to define that certain Nodes are to receive ARC files and, 
  444. other Nodes LZH files if they rather have them.
  445.  
  446. Format: ARCMAIL <node> <node> ...
  447.         ARJMAIL <node> <node> ...
  448.         LZHMAIL <node> <node> ...
  449.         ZIPMAIL <node> <node> ...
  450.         ZOOMAIL <node> <node> ...
  451.  
  452. Example:  ARCMAIL ALL                    ;send ARCed Mail to everybody 
  453.           LZHMAIL 241/5800 247/43 310/12 ;send LHarc Mail to these Nodes
  454.  
  455. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  456.  
  457. If ARCMAIL ALL is defined and a certain Node shouldn't be packed, then 
  458. the Pack flag has to be turned off. 
  459.  
  460. Format:  NOTPACKED <node> <node> ...
  461.  
  462. Example:  NOTPACKED 252/25 241/5800 ;these Nodes receive unpacked Mail
  463.  
  464. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  465.  
  466. Packet-Types:
  467. ~~~~~~~~~~~~~
  468.  
  469. Every Message is packed in a Packet (special Fileformat) before sending 
  470. to the destination. This way the addressee of the Packet knows who the 
  471. originator of the Packet was and what is further to do with the Packet.
  472. The format of the Packet-Header was developed some years ago and it is 
  473. no wonder that since then new Situations required to change this format. 
  474. But because one (still) cannot know that the destination Node can 
  475. handle with the new format, there have to be a way to declare which format
  476. has to be sent.
  477.  
  478. Format: 4D-PACKETS <node1> <node2> ...
  479.         or
  480.         2D-PACKETS <node1> <node2> ...
  481.  
  482. Example: 4D-PACKETS 241/ALL        ; send 4D Packets to all Nodes in Net 241
  483.          2D-PACKETS 241/5806 7902  ; but send only 2D Packets to 241/5806
  484.                                    ; and 241/7902
  485.  
  486. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  487.  
  488. Forward:
  489. ^^^^^^^^
  490.  
  491. Some Nodes, possibly for security reasons, want to receive/send messages 
  492. only on certain Nodes via their own system.  Normally this is not 
  493. necessary, but the number of Nodes can be reduced from which messages 
  494. will be accepted or sent on to. 
  495.  
  496. A Netmail is then passed on when the Origin-Node's FORWARD-FOR flag
  497. is set on and the Destination-Node's FORWARD-TO flag is set on. 
  498. (Normally, always on for everybody.)
  499.  
  500. Format:  FORWARD-FOR <node> <node> ...
  501.          FORWARD-TO  <node> <node> ...
  502.  
  503. Example:  FORWARD-FOR ALL
  504.           FORWARD-TO  ALL
  505.  
  506. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  507.  
  508. Routing:
  509. ^^^^^^^^
  510.  
  511. Routing is included because its impossible to call every addressee when 
  512. a message is to be sent.  That means, that messages must be passed 
  513. through many Nodes before the recipient is finally reached.  Every Sysop 
  514. controls which Node is to receive his Netmails via the Routing file.
  515.  
  516. Format:  ROUTE-TO <route-node> <node> ...
  517.  
  518. Example:  ROUTE-TO 241/5800 ALL             ;all Nodes to 241/5800
  519.           ROUTE-TO 310/12   310/ALL 302/ALL ;Net 310 and Net 302 to 310/12
  520.  
  521. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  522.  
  523. All Nodes are covered and provided for using ROUTE-TO.  But what about 
  524. when one certain Node is to directly receive Mail?  Then its possible to 
  525. write ROUTE-TO 247/43 247/43, but there is a more elegant way.  
  526.  
  527. Format:  NO-ROUTE <node>
  528.  
  529. Example:  NO-ROUTE 247/43 252/25  ;Mail goes directly to 247/43 and 252/25
  530.  
  531. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  532.  
  533. Polling:
  534. ^^^^^^^^
  535.  
  536. The above Routing information isn't enough to distribute all Mail to 
  537. every Nodes/Point correctly.  Things have to be set so that one knows 
  538. whether calls are made or that calls are only received.  Normally one 
  539. expects to make calls himself, so things have to explicitly be set up 
  540. so that messages will be held for certain caller. 
  541.  
  542.  
  543. Format:  HOLD <node> <node> ...
  544.  
  545. Example:  HOLD POINTS 247/43 246/18 282/352  ;Messages for Points and 
  546.                                              ;the indicated Nodes are 
  547.                                              ;held on the system
  548.  
  549. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  550.  
  551. When calls are originated the system has to know if the call is always 
  552. made or to be made only when Messages are present to be sent out.  
  553.  
  554. POLL is used when a call is always originated and PICKUP when one waits 
  555. till Messages are waiting to be sent.
  556.  
  557. Format:  POLL   <node> <node> ...
  558.          PICKUP <node> <node> ...  (or SEND-TO <node> <node> ...)
  559.  
  560. Example:  POLL 241/5800         ;always call 241/5800, even if nothing 
  561.                                 ;is be to sent.
  562.           PICKUP 310/12 252/25  ;only if there is something to send.
  563.           SEND-TO 244/1         ;just like PICKUP.
  564.  
  565. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  566.  
  567. It sometimes happens that Netmails should be sent directly (not Routed) 
  568. to the whole Net (for whatever reason).  Then, for example, SEND-TO 
  569. 241/ALL should be written to the Routefile.  In case NetMails for some 
  570. Nodes (example 241/5800) shouldn't be SEND-TOed because they are planed 
  571. for later export (in another Event) then NO-SEND has to be used to switch 
  572. off the above SEND-TO for the intended Nodes (241/4300)  NO-SEND can also 
  573. be used for POLL, HOLD and PICKUP.
  574.  
  575. Format: NO-SEND <node1> <node2> ...
  576.  
  577. Example:  NO-SEND 252/25  ; don't export mail for this node.
  578.  
  579. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  580.  
  581. Flowchange:
  582. ^^^^^^^^^^^
  583.  
  584. Generally the most favorable calling time is selected when someone wants 
  585. to Poll another Node.  Schedules (Events) are used so that the least 
  586. expensive Polling is used.  It can happen that the Node in question calls 
  587. us from time to time so why not give him his mail while he is online.  
  588. That's why its necessary to process Mails for the Nodes as early as possible
  589. and have them ready at all times.
  590.  
  591. As our computer should call only during the most convenient time then 
  592. Mails for the target Node must be made ready but on 'Hold'.  When 
  593. the time comes (Schedule) that we should do the calling then the Mail 
  594. shouldn't remain packed on 'Hold'.  The Mail has to be changed to 'Crash'
  595. or 'Normal' so that Binkley knows to make the call.  After the call 
  596. everything should be changed back to 'Hold'.
  597.  
  598. Format:  CHANGE <from> <to> <node1> ...
  599.  
  600.          where <from> and <to> equal HOLD, NORMAL and CRASH.
  601.  
  602. Example:  CHANGE HOLD CRASH 247/43 246/18  ;Holdmail for these Nodes 
  603.                                            ;is changed to Crash
  604.                                            ;(*.HLO -> *.CLO)
  605.           CHANGE NORMAL HOLD 252/25        ;Normalmail for these Nodes
  606.                                            ;is changed to Hold
  607.                                            ;(*.FLO -> *.HLO)
  608.  
  609. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  610.  
  611. Naturally there's a way to turn everything off in case a general 
  612. conversion is made and only a few Nodes are to remain uneffected.
  613.  
  614. Format:  NO-CHANGE <node1> ...
  615.  
  616. Example:  NO-CHANGE 241/5800  ;no changes are made to this node.
  617.  
  618. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  619.  
  620. Schedules:
  621. ^^^^^^^^^^
  622.  
  623. During normal operations a Box with fixed Routing isn't the most perfect 
  624. system.  A BBS system has many different tasks to perform and request 
  625. to make during a day.  Netmails have to be sent to certain Nodes at 
  626. certain times while other Nodes/Points doesn't have to be taken into 
  627. consideration at all, and more.
  628.  
  629. When using Binkley as a Mailer there is the Binkley.EVT file where all 
  630. Events for a day are processed.  Events in Go_Out are numbered exactly 
  631. like Binkley and are selected for SCHEDULES. 
  632.  
  633. Event 4 using Binkley also means SCHEDULE 4 when Routing.
  634.  
  635. Format:  SCHEDULE <number>            (or maybe a String used with -r)
  636.  
  637. Example:  SCHEDULE 2
  638.           SEND-TO 252/25
  639.           POLL 310/12
  640.  
  641.           SCHEDULE 4
  642.           SEND-TO 1:102/346
  643.  
  644. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  645.  
  646. Domains in the Routefile:
  647. ~~~~~~~~~~~~~~~~~~~~~~~~~
  648.  
  649. All Statements and Parameters in the Routefile mentioned above are reffering
  650. naturally to only one Nodelist.
  651. But if you are active in different Networks which are requiring the use of
  652. multiple Nodelists then you have to tell the Software the names of the used
  653. Lists and how the routing for the different Lists should be done. Since each
  654. List is individual there has to be also an individual routing method for 
  655. each List.
  656. Which Lists are used by the System is defined in Binkley.CFG with the 
  657. Statement "Domain <designator> <abbreviation> <nodelist>". To define the 
  658. routing for each of these Statements (and therefore for each Nodelist), the
  659. Routefile will be splitted in small Blocks. Each of these Blocks starts with
  660. a Keyword (defined by the <abbreviation> plus a colon).
  661. That means that you have to write the Networkname followed by a colon in a 
  662. line at the start of the Block of Statements which is reffering to the 
  663. same Network.
  664.  
  665. Format: Abbreviation:
  666.  
  667. Example: Fidonet:
  668.          ARCMAIL 241/5800
  669.          FORWARD-FOR ALL
  670.          FORWARD-TO  ALL
  671.          ROUTE-TO 241/5800 ALL
  672.          POLL 241/5800
  673.  
  674.          NeST:
  675.          ARCMAIL 90:6000/0         (Important: All Zones other than the 
  676.          FORWARD-FOR ALL                       own (from the 1. Address)
  677.          FORWARD-TO  ALL                       must be written down in the 
  678.          ROUTE-TO 90:6000/0 ALL                Routfile.)
  679.          SEND-TO  90:6000/0
  680.  
  681. ============================================================================
  682.  
  683. A P P E N D I X   2:
  684.  
  685. Graphical Representation of a Poll Session (by Matthias Dominick):
  686. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  687.  
  688. +------------------------------------------------------------------+
  689. |        Fido Mailnode (Boss), who holds your Packets              |
  690. +------------------------------------------------------------------+
  691.              |                                / \
  692.              |                                 |
  693.      +---------------+                 +---------------+
  694.      | Mail for You  |                 | Mail for Boss |
  695.      |    packed     |                 |    packed     |
  696.      +---------------+                 +---------------+
  697.              |                                 |
  698.             \ /                                |
  699. +------------------------------------------------------------------+
  700. |       Fido Mailer (for example: BinkleyTerm 2.4)                 |
  701. +------------------------------------------------------------------+
  702.              |                                  / \
  703.              |                                   |
  704.      +---------------+   +-----------+   +---------------+
  705.      |   Importer    |-->|  Packer   |<--|   Exporter    |
  706.      |   Come_In     |<--| i.e. ARC  |-->|    Go_Out     |
  707.      +---------------+   +-----------+   +---------------+
  708.              |                                   |
  709.              |                      +----------->+
  710.              |                      |            | MsgBase-Scan is
  711.              |              +---------------+    | optional and only
  712.              |              | MsgBase-Scan  |    | necessary, when
  713.              |              | i.e. Tidy_Up  |    | your a Node or use
  714.              |              +---------------+    | another MsgEditor
  715.              |                      |            | and not LED.
  716.              |                      +------------+
  717.              |                                   |
  718.      +-------+------+----------------+           |
  719.      |              |                |           |
  720.     \ /            \ /              \ /          |
  721. +---------+    +---------+      +---------+      |
  722. | Area 1  |    | Area 2  | ...  | Area n  |      |
  723. +---------+    +---------+      +---------+      |
  724.     / \            / \              / \          |
  725.      |              |                |           |
  726.      +--------------+----------------+---------->+
  727.      |              |                |
  728.     \ /            \ /              \ /
  729. +------------------------------------------------------------------+
  730. |       Message Editor (for example: LED)                          |
  731. +------------------------------------------------------------------+
  732.  
  733.  
  734. A P P E N D I X   3
  735.  
  736. How do the different Packers work (by Matthias Dominick):
  737. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  738.  
  739. +-------------------+-------------------------+-------------------------+
  740. |                   |      relative Path      |      absolute Path      |
  741. |                   |   Imp+    Imp     Exp   |   Imp+    Imp     Exp   |
  742. +-------------------+-------------------------+-------------------------+
  743. | LHArc 0.60 (Webb) |   Yes     Yes     Yes   |   Yes     Yes     Yes   |
  744. | UnLzh 1.72 (PRG)  |   No      No      ---   |   Yes 1)  Yes     ---   |
  745. | LHArc 1.13 (Yoshi)|   No      No      Yes 2)|   Yes     No      Yes 2)|
  746. | LHArc 1.13 (009As)|   No      No      Yes 2)|   Yes     No      Yes 2)|
  747. | FastLzh5          |   No      No      No  3)|   Yes     No      No  3)|
  748. +-------------------+-------------------------+-------------------------+
  749.  
  750. 1) UnLzh has to be appropriately configured:
  751.    Create Folder: No
  752.    1x manually uncrunch from Inbound Folder to Inbound Folder
  753.    These paths have to saved in all cases, otherwise the packets will be
  754.    save just about any place.
  755.  
  756. 2) To turn off the Prompt or the the incorrect File Extension pass the
  757.    '-m' Parameter.
  758.  
  759. 3) Only the *.FLO File is created; the actual Archive is not created!
  760.  
  761. To sum it up: When the received Packet isn't too big then the universal 
  762. unpacker, LHArc, should be used.  If the Inbound Mail Packet is greater 
  763. then 100kb then a special configuration of Unlzh for Importing should be 
  764. used; for Exporting the normal LHArc should be used.
  765.  
  766.  
  767. A P P E N D I X   4
  768.  
  769.   File Requests from other Nodes ((Nodelist necessary) by Erich Jeckl):
  770.   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  771.  
  772. Here we differentiate in
  773.  
  774.    - Requests in your own Zone
  775.    - Requests in other Zones
  776.  
  777.  
  778.                       FILE REQUEST IN YOUR OWN ZONE
  779.                       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  780.  
  781. The Binkley Philosophy says, that a Point Polls his Boss exclusively and 
  782. nobody else.  And this was the case for a long time, but with the 
  783. increasing size of the Net and the huge existing base of Files makes it 
  784. just about impossible for a Boss to meet his Points wishes.  
  785.  
  786. The ACS Packet gives the user the possibility, with Binkley, to make File 
  787. Request from other Nodes. 
  788.  
  789. It works like this:
  790.  
  791.         Click on BTS - "Extras" --> "Make Requests".
  792.         A Dialog box is displayed, in which the Point's Boss' NodeNumber 
  793.         is already shown.  With "ESC" you can delete the field contents 
  794.         and enter the NodeNumber of the target Node.  Then the individual 
  795.         files can be entered (and if necessary the Password in the next 
  796.         field) or when a Filelist of the target Node exist, the Filelist 
  797.         can be displayed and the wish for files can be marked for 
  798.         Requesting (the marked files are shown in inverse).
  799.  
  800.         After the last file is selected, click on the "Save" button.  In 
  801.         the next Dialog box click on either "NORMAL" or "CRASH".  Normal 
  802.         or Crash are to be differentiated because a corresponding dummy 
  803.         file has to be written into the Outbound Folder (some Nodes 
  804.         demand it) with either the .FLO file extension or, for Crash, 
  805.         with the extension .CLO.
  806.  
  807.         When this is finished, start the Binkley Terminal program via BTS, 
  808.         press ALT + M keys.  You then have the possibility to enter either 
  809.         the Sysop's name or his NodeNumber.  If you enter a NodeNumber a 
  810.         FIDOUSER.LST isn't necessary, but you need a compiled Nodelist 
  811.         (and a FIDOUSER.LST if you want to use the name of the Sysop).
  812.  
  813.         Binkley switches to Mailer Mode, searches out of the Nodelist the 
  814.         correct telephone number of the target Node and Polls it.  The 
  815.         target Node also knows in Mail-Only operation that a FidoNode or 
  816.         Point wants to log-on and if the Node allows Request nothing 
  817.         stands in your way.
  818.  
  819.         I'm not going to go into the many possibilities of BinkleyTerm 
  820.         here, you can read all about it in the BinkleyTerm manuals.
  821.  
  822.                        FILE REQUEST IN OTHER ZONES
  823.                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  824.  
  825. There's a couple of preparations to make first, then things function just 
  826. like in your own Zone.
  827.  
  828. What "preparations"?  Now, BinkleyTerm needs for every Zone its own 
  829. Outbound Folder, that means, that you have to create for every Zone you 
  830. want to request into its own OUTBOUND.xxx folder.  (The Zone number 'xxx' 
  831. has to be given in hexadecimal Notation).
  832.  
  833. That is -
  834.  
  835.                 Requesting in Zone  1 = OUTBOUND.001
  836.                 Requesting in Zone  3 = OUTBOUND.003
  837.                 Requesting in Zone 27 = OUTBOUND.01b and so on.
  838.  
  839. In BTS, from "Make Request" change the preset NodeNumber to the target 
  840. Node's Zone, enter the files to be requested, click on "SAVE", and then 
  841. "CRASH".  BTS then writes the Request file into the correct folder.  
  842. Selection of the target Nodes functions just like a Request in your own 
  843. Zone:
  844.  
  845.         - BinkleyTerm (in single call mode)
  846.         - Press ALT + M
  847.         - Enter NodeNumber (completely, with Zone)
  848.         - BT searches the correct telephone number out of the Nodelist
  849.         - After a Connect, your Request file is sent to the target Node.
  850.  
  851. Most Nodes use the so-called Magic Word "FILES"; you can, when you use 
  852. this Magic Word in your first Request file, the target Node will send a 
  853. Filelist which you can use just like the one from your Boss.
  854.  
  855.  
  856. A P P E N D I X   5
  857.  
  858.  
  859.                   C R A S H M A I L S (by Erich Jeckl):
  860.                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  861.  
  862. Here too we want to differentiate between Crashes in your own Zone or in 
  863. other Zones.
  864.  
  865. CRASHMAIL TO YOUR ZONE:
  866. =======================
  867. First some important points:
  868. - Crashmails are always NetMails (Matrix) and never EchoMails
  869. - Crashmails without a Nodelist are impossible!!
  870. - Crashmails must be allowed by the target Node!  Some Nodes refuse  
  871.   unlisted Nodes or Points from logging on (not password protected) with 
  872.   the idea that a virus could be uploaded into his system. 
  873.  
  874. To generate CrashMails do the following:
  875.  
  876.         - Set 'on' the ACS Flag "CrashMail" (if you don't have it already)
  877.         - Write with LED a Header for the Netmail (Node Number!)
  878.         - And then click on "Private Local", above right in LED (or ALT+V)
  879.         - A Dialog box is displayed 
  880.         - Click on "Crash"
  881.         - Then write your message
  882.         - Then "Save" (you can also use CTRL + S)
  883.         - Then leave LED (use CTRL + Q)
  884.  
  885. As mentioned before, Crashmail cannot be sent without Nodelist. That means
  886. you will have to use a compiled Nodelist and therefore use Go_Out without
  887. the Parameter -m in the Commandline. This installation differs from the one
  888. described in Part 1 of the ACS Documents. You will need a Routefile.
  889.  
  890.         - Start Go_Out and you will see that your Netmail is sent with the 
  891.           Crash-Flag on.
  892.         - Call BinkleyTerm in single call mode
  893.         - Press the ALT + M keys
  894.         - Enter target NodeNumber, press RETURN
  895.         - And thats it. 
  896.  
  897. Now nothing stand in the way of sending CrashMails.
  898.  
  899. CRASHMAIL TO OTHER ZONES:
  900. =========================
  901.  
  902. Crashing into other Zone works exactly the same as in your own Zone, with 
  903. the exception the every Zone must have its own OUTBOUND folder (also see 
  904. File Request in other Zones).
  905.  
  906.         for Zone  1  =  OUTBOUND.001
  907.         for Zone  3  =  OUTBOUND.003
  908.         for Zone 27  =  OUTBOUND.016 and so on.
  909.  
  910. Go_Out then writes into the corresponding OUTBOUND.xxx folder, just like 
  911. Crashmails in your own Zone, the necessary files.
  912.  
  913.  
  914. A P P E N D I X   6
  915.  
  916.  
  917.                    Domains in Fidonet (by Roland Bohn):
  918.                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  919.  
  920. Domain Addressing is relatively new concept in Fidonet.  It puts in 
  921. another and more complicated form of Addressing.  With the addition of 
  922. another field in the Address its possible to clearly address other 
  923. networks (Fidonet, Signet, Eggnet, etc.), without addressing conflicts 
  924. between networks with identical Zones or Net Numbers. 
  925.  
  926. To support Domains its necessary to have the different Nodelist (NODELIST, 
  927. SIGLIST, etc.) which the other Net needs.  Also the Address Statements 
  928. must have the correct Domain Addressing.
  929.  
  930. Therefore a universal indication or Complement has to be connected to 
  931. the Address Statements of the corresponding Network. The Complement of a 
  932. Network has to have a certain ending.  Our, primary, Network has to have 
  933. the ending ".org".  All of the alternate Network indications have to have 
  934. ".ftn" as an ending.  That means that the alternate Networks work using 
  935. the Fido Standard.
  936.  
  937.       Address 2:241/5800@fidonet.org
  938.       Address 7:520/1015@alternet.ftn
  939.  
  940. The Domain Statement need many entries so that it functions correctly.
  941.  
  942. Format: Domain <Complement> ShortForm> <Nodelist>
  943.  
  944. Example:  Domain fidonet.org fidonet nodelist
  945.           Domain alternet.ftn alternet anetlist
  946.  
  947. IMPORTANT:  For every Domain Complement, of an Address Statement, the 
  948. corresponding Domain Statement must exist.
  949.  
  950.      <Complement> is the actual Domain Name along with the corresponding 
  951.                   ending, see above. 
  952.  
  953.      <ShortForm>  can have a maximum of 8 characters.  Mailers exchanged 
  954.                   it with each other during a connect.  Its almost always
  955.                   a universally know name of the target Network.  As in 
  956.                   the above example the ShortForm is "fidonet" and 
  957.                   "alternet".
  958.  
  959.      <Nodelist>   points to the name of the Nodelist of the appropriate 
  960.                   Network.  In the above example "nodelist" is for 
  961.                   Fidonet and "anetlist" is for Alternet.  
  962.  
  963. With the entry of the Domain Statements were not finished with the Domain 
  964. installation.  Just like with different Zones which have different 
  965. Outbound paths, Domains have to have their own paths too.
  966.  
  967.  
  968. The path are differentiated only by the name of the last folder of the 
  969. path of the primary Outbound Folder (indicated by the 'Hold' statement). 
  970. For the alternate Network, the last folder name of the 'Hold' statement is 
  971. replaced by the ShortForm of the Domain Statement.  
  972.  
  973. When you yourself are in Fidonet and the Hold statement points, for 
  974. example, to:
  975.      
  976.      C:\NODE\OUT\OUTBOUND\
  977.  
  978.                               then for Alternet the path
  979.   
  980.      C:\NODE\OUT\ALTERNET.xxx\ 
  981.  
  982.                               is used. 
  983.  
  984. Note: The path for other Domains, not your own, must always include the 
  985.       Zone-Number.
  986.  
  987. Example:
  988.  
  989.      Hold c:\node\out\outbound\
  990.      Address 2:241/4306@fidonet.org
  991.      Address 7:520/1015@alternet.ftn
  992.      Domain fidonet.org fidonet nodelist
  993.      Domain alternet.ftn alternet anetlist
  994.      
  995. The Outbound Paths look like the following:
  996.  
  997.      c:\node\out\outbound\      ;Default Outbound
  998.      c:\node\out\outbound.001\  ;Fidonet Zone 1
  999.      c:\node\out\outbound.003\  ;Fidonet Zone 3
  1000.      c:\node\out\alternet.007\  ;Alternet Zone 7
  1001.      c:\node\out\alternet.059\  ;Alternet Zone 89
  1002.  
  1003.