home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / TELECOM / OSKBox.lzh / MAILBOX / CC / DOCS / msgproc.doc < prev    next >
Text File  |  1993-03-02  |  5KB  |  129 lines
  1. NAME:
  2.  
  3.      msgproc - packet BBS message processor
  4.  
  5. AUTHOR:
  6.  
  7.      Eric Williams  WD6CMU, wd6cmu@netcom.com
  8.  
  9. SYSTEM CONFIGURATION:
  10.  
  11.      OS9/68K, MW C v2.0
  12.  
  13. SYNTAX:
  14.  
  15.      msgproc [<options>] <message #> ...
  16.  
  17. DESCRIPTION:
  18.  
  19.      msgproc is executed each time a new message is received by the OSKbox BBS
  20. system.  It is forked by either mailbox or suck and is normally run detached
  21. from the parent process at a reduced priority of 100. 
  22.  
  23.      Options to msgproc are:
  24.  
  25.             -b        Sender is a BBS
  26.             -s        Sender is a sysop
  27.             -q        Supress output of messages
  28.             -d[d...]  Provide debugging output (more d's yield added info)
  29.  
  30.      msgproc obsoletes the following programs: redirect, dateusa, bidscan,
  31. killer. 
  32.  
  33.      msgproc provides several different message processing functions and can
  34. be modified for site-specific requirements.  Listed below are typical
  35. operations:
  36.  
  37. MESSAGE COPYING
  38.  
  39.      Certain messages may require production of duplicate messages.  A common
  40. example is that of a message to all local sysops which would be copied to the
  41. sysop's call. 
  42.  
  43. MESSAGE HEADER PROCESSING
  44.  
  45.      Several types of processing need to be done on the basis of the
  46. forwarding headers added to the message by other BBSs.  Some of these
  47. functions are:
  48.  
  49.      If a bulletins is missing a BID, reconstruct one using the originating
  50.      BBSs callsign and message number.
  51.  
  52.      If a message has passed through this BBS more than once before,
  53.      place it on hold for sysop review.  Send a notifying message to sysop.
  54.  
  55.      If a bulletin has already passed through some of the BBSs in the
  56.      bulletin's distribution list, mark the message so forwarding is not
  57.      attempted to those BBSs.
  58.  
  59.      If a message is of a particular type and its age as determined by the
  60.      origination date is beyond a set limit, kill the message.
  61.  
  62. MESSAGE FIELD EDITING
  63.  
  64.      The sysop can specify the characteristics of messages of interest,
  65. as well as the modifications to be made to its various fields.  The file
  66. "hold.lst" in the DISDIR directory is read to obtain the parameters for
  67. selecting and editing: each line in the file contains one or more tests,
  68. and one or more field modification specifications.  All of the tests
  69. must succeed for the specified modification(s) to take place.  Each test
  70. consists of a single word separated by white space.  The following tests
  71. are available:
  72.  
  73.      >ADDR    The TO field of the message matches ADDR
  74.      <ADDR    The FROM field of the message matches ADDR
  75.      @ADDR    The BBS field (stripped of H-address) matches ADDR
  76.      TC       The message type matches C (single letter)
  77.      $PREFIX  The prefix of the BID field matches PREFIX
  78.      LWORD    The title field contains the word WORD (case insensitive)
  79.      -B       The station sending the message is a BBS
  80.      -S       The station sending the message is a sysop
  81.  
  82. The tests above can also be preceeded by the character '!', in which
  83. case the test is negated.  One or more test fields are followed on a
  84. line by the separating symbol ":", followed by one or more modification
  85. specifications, which may be any of the following:
  86.  
  87.      >ADDR    Modify the TO field of the message to ADDR
  88.      <ADDR    Modify the FROM field of the message to ADDR
  89.      @ADDR    Modify the BBS field of the message to ADDR
  90.      TC       Modify the message type field to C (single letter)
  91.      RC       Modify the message status field to C (single letter)
  92.  
  93. More than one modification specification can be on a line, separated by
  94. white space.  Changing a message's status to 'X' will kill the message. 
  95. Changing the status to 'H' will place it on hold, and a message to
  96. <MYCALL> notifying the sysop of the hold is sent by msgproc under the
  97. callsign "MPROC".  An example hold.lst might be:
  98.  
  99.      <WA6LID TB : RH
  100.      >FBB : RX
  101.      $RTDX : RX
  102.      $ARL !>ARRL : >ARRL
  103.      >4SALE : >SALE
  104.      >SELL : >SALE
  105.      TB @ALLUS LSALE : >SALE
  106.  
  107. WHITE PAGES LOOKUP
  108.  
  109. When the White Pages (WP) system is available, messages that have a blank BBS
  110. field are checked against the WP database for correct address.
  111.  
  112. HIERARCHICAL ADDRESS BUILDING
  113.  
  114. If the BBS field of a message does not contain a hierarchical address
  115. (eg: WD6CMU.#NOCAL.CA.USA.NA), the list of BBSs in the files in the
  116. /dd/MAILBOX/STATEBBS directory are scanned.  (The files contain one
  117. callsign per line starting in the first column, the rest of the line is
  118. ignored.)  If found, the BBSs H-address is built using the filename of
  119. the STATEBBS file it was found in.  The character '_' in the filename
  120. will be translated into the local address designator character '#'.  In
  121. the above example, the callsign "WD6CMU" would appear on its own line in
  122. the file "_nocal.ca.usa.na" in the STATEBBS directory. 
  123.  
  124. BUGS:
  125.  
  126.  
  127.  
  128.  
  129.