home *** CD-ROM | disk | FTP | other *** search
/ Chip 1997 December / CHIP_CD_1997_12_PL.iso / knowhow / packet / fbbwin / disk1 / multi.do_ / multi.do
Encoding:
Text File  |  1997-05-22  |  8.2 KB  |  195 lines
  1. MULTI.EXE, server for FBB-BBS.
  2. (By LA6CU, Per)
  3.  
  4. This server is used to send personal copies of special messages.  The 
  5. original is adressed to a special "call", and then there is automatically
  6. made personal copies to everyone that shall have one.
  7.  
  8. MULTI may work in 2 ways.  You may use one of them, or both.  I use both at
  9. the same time.
  10.  
  11. New in version 3.00:
  12. The server may use different languages.  There is a new file MULTI.TXT (reside
  13. in SYSTEM-directory) that holds all languages.  There is one "module" for
  14. each language.  See the text in MULTI.TXT for more info.
  15.  
  16. 1:  WITH DAT-FILES:
  17. -------------------
  18.  
  19. Installation:
  20.  
  21. MULTI.EXE is put in the same directory as SERV.EXE.   MULTI will read from
  22. INIT.SRV...
  23.  
  24. In INIT.SRV, MULTI is included together with REQFIL, REQDIR etc.  Example:
  25. #
  26. ------
  27. #
  28. REQFIL  REQFIL
  29. REQDIR  REQDIR
  30. CLUB    MULTI
  31. TEST    MULTI
  32. #
  33.  
  34. In this example all messages sent to
  35. SP CLUB
  36. will be copied to all callsigns in the file CLUB.DAT, while messages sent to
  37. SP TEST
  38. will be copied to all callsigns in the file TEST.DAT.
  39.  
  40. CLUB.DAT and TEST.DAT (in this example) must stay in the SYSTEM-directory.
  41. You must make one such .DAT-file for every to-field you define in INIT.SRV.
  42.  
  43. The .DAT-files must consist of callsigns (@BBS and H-adresses allowed) for 
  44. all those that shall have a copy.
  45.  
  46. There are 4 different copy-types.
  47. A (action)      :  This is the callsign that will receive the message, or
  48.                    perform the action described in the message.
  49. C (copy)        :  This callsign receives a copy of the message.
  50. I (information) :  This callsign receives a copy for information.
  51. H (hidden)      :  This callsign receives a copy, but his callsign will not
  52.                    appear in the footnotes of the message, telling who has
  53.                    received a copy.
  54.                    
  55. There may be more than one callsign on each line (starting with A, I, C or H)
  56. seperated by a comma.  There may be maximum 100 callsigns altogether.  
  57. Comment-lines are extras, they MUST start with a #
  58.  
  59. From version 3.00 there will also be a seperate line with a letter 
  60. corresponding to the language the server will use.  What letter corresponds
  61. to what language, is explained in MULTI.TXT.
  62.  
  63. Example of CLUB.DAT:
  64.  
  65. E                           <-----  Use ENGLISH language for CLUB-server
  66. A LA6CU, LA1B, LA2D         <-----  Copies to the people doing the job
  67. A LA6GDA                    <-----    "     "   "   "    "     "     "
  68.                                     May be several lines if there is not 
  69.                                     enough room in one line. 
  70. I LA5RBA                    <-----  LA5RBA is informed on the matter
  71. C LA6IM @ LA6IM             <-----  LA6IM receives a copy for updating his
  72.                                     node-lists
  73. H LA2GIA                    <-----  LA2GIA receives a copy, but will not appear
  74.                                     in the list of callsigns at the end of
  75.                                     each message.
  76.  
  77. Beware:  The .DAT-files shall consist of callsigns and comments, nothing 
  78.          else !  No /EX, no * and no *** end of file.
  79.  
  80. MULTI will NOT send a copy back to the originator, even if he also is in
  81. the .DAT-file.  This to avoid "looping" of messages.
  82. MULTI will send an acknowledge-message back to the originator, telling 
  83. him that the copying was successful, and show him a list of all callsigns
  84. that will receive such a copy.
  85.  
  86. R:lines on incoming messages are removed, untill there has arrived 2 lines
  87. without R:  After that. R:lines are accepted again.  This is done to make it
  88. possible also to forward messages back the same route, and at the same time
  89. make it possible to include R:lines in the message itself.
  90.  
  91. R:lines are NOT checked to prevent forward to BBSs that are already in
  92. these R:lines, because a message to a MULTI-server only will be processed
  93. at the end-BBS anyway.
  94.  
  95. MULTI needs very little memory (I have not checked how much..), but I have
  96. been told that it needs less than 35k.  MULTI does not write to screen.
  97.  
  98. MULTI.EXE must be in the same directory as SERV.EXE.
  99. From version 3.00 the .DAT-files must be in the SYSTEM-directory.
  100. MULTI.TXT must also be in SYSTEM-directory.
  101.  
  102. MULTI makes a temporary file MULTI.TMP on disk, and delete it afterwards.
  103. Everything else is done in memory, and the result is placed in MAIL.IN, as
  104. all servers do.
  105.  
  106.  
  107. 2:  WITH ALL CALLSIGNS DIRECTLY IN THE ORIGINAL-MESSAGE.
  108. --------------------------------------------------------
  109.  
  110. MULTI still works exactly as before, with the same installation.  But after
  111. a request from F6ABJ and F6FBB I have made a modification so that users
  112. themselves can decide what callsigns will receive a copy.  This is done
  113. by including the callsigns in the message itself.
  114.  
  115. In INIT.SRV, MULTI is still included like bfore (see further up).  But
  116. in addition, you now must have 1 extra line, like this:
  117.  
  118. #
  119. ------
  120. #
  121. REQFIL  REQFIL
  122. REQDIR  REQDIR
  123. CLUB    MULTI
  124. TEST    MULTI
  125. MULTI   MULTI               <----  This line is new.
  126. #
  127.  
  128. From version 3.00 SP MULTI uses the default language (see MULTI.TXT).
  129. Other languages may be configured.  For example you may have:
  130. MULTI   MULTI   (for default language)
  131. MULTIE  MULTI   (for english language)
  132. MULTIF  MULTI   (for french language)
  133. MULTIH  MULTI   (for netherlands language)
  134. MULTIN  MULTI   (for norwegian language)
  135. So, you may send the same message SP MULTI, SP MULTIE, SP MULTIF, SP MULTIH,
  136. SP MULTIN etc.  The first 5 letters must always be MULTI, when used without
  137. DAT-file.  Default language will typically be english (SP MULTI), but the
  138. users will have the possibillity to use others, as configured.
  139.  
  140. Users will now be able to send messages to MULTI, like this:
  141. SP MULTI     The program will now collect the info on who will receive a 
  142. copy, from the message itself, and not from a seperat .DAT-file like 
  143. SP CLUB or SP TEST still will do.
  144.  
  145. There are 4 different copy-types.
  146. A (action)      :  This is the callsign that will receive the message, or
  147.                    perform the action described in the message.
  148. C (copy)        :  This callsign receives a copy of the message.
  149. I (information) :  This callsign receives a copy for information.
  150. H (hidden)      :  This callsign receives a copy, but his callsign will not
  151.                    appear in the footnotes of the message, telling who has
  152.                    received a copy.
  153. (In addition one may use CC: instead of only C for Copy.  Special request..)
  154.  
  155. There may be more than one callsign on each line (starting with A, I, C or H)
  156. seperated by a comma.  There may be maximum 100 callsigns altogether.  
  157. Comment-lines are extras, they MUST start with a #
  158.  
  159. Example:
  160. SP MULTI
  161. Digipeater upgrade          <-----  Title of message
  162. A LA6CU, LA1B, LA2D         <-----  Copies to the people doing the job
  163. A LA6GDA                    <-----    "     "   "   "    "     "     "
  164. I LA5RBA                    <-----  LA5RBA is informed on the matter
  165. C LA6IM @ LA6IM             <-----  LA6IM receives a copy for updating his
  166.                                     node-lists
  167. H LA2GIA                    <-----  LA2GIA receives a copy, but will not appear
  168.                                     in the list of callsigns at the end of
  169.                                     each message.
  170. ---------                   <-----  After the last callsign, there must be a
  171.                                     string of at least 5 '-' before the
  172.                                     actual message.
  173.                                     
  174. Then follows the contents of the message, and end with Ctrl-Z or /EX.
  175.  
  176. As ususal, the sender will receive a message saying that the copies were
  177. made.  The messages to all the other calligns will be identical, and look
  178. like this:
  179.  
  180. Message via LA6CU MULTI-server (v3.00) :
  181.  
  182. Contents of message
  183.  
  184. ============================================================================
  185. For action       : LA6GDA, LA6CU, LA1B, LA2D.
  186. For copy         : LA6IM.
  187. For information  : LA5RBA.
  188. ============================================================================
  189.  
  190. All copies are identical, but A, C and I determines in which line in the
  191. footnotes the callsigns will appear.  A callsign after an H will not 
  192. appear in the footnotes.
  193.  
  194. 73 de Per, LA6CU.
  195.