home *** CD-ROM | disk | FTP | other *** search
/ Hacker Chronicles 2 / HACKER2.BIN / 1085.SERVER.DOC < prev    next >
Text File  |  1989-05-03  |  7KB  |  261 lines
  1.  
  2.  
  3.      Server operation: Automatic Export/Import of messages.
  4.  
  5.  
  6. The file SERVER.MB contains information that drives the automatic
  7. Export/Import of messages. If the file does not exist, no Export/Import is done.
  8.  
  9. There are two types of server; "simple" and "complex".
  10. The information required in SERVER.MB, and the type of processing done,
  11. is slightly different for each type.
  12.  
  13.  
  14.    Simple Server:
  15.  
  16.  
  17. A simple server first checks for messages to export. If there are
  18. none, it does nothing. If there were messages to export, it exports them,
  19. and runs the server process. If the server process completes normally,
  20. then an import is done. If the server process does not complete normally,
  21. no import is done. A line like the one below, placed into SERVER.MB, is
  22. all that is required to define a simple server.
  23.  
  24. S SNAME SNAME.EXE SNAME.OUT fmt SNAME.IN fmt
  25.  
  26. "SNAME" is the name of the server. Messages addressed to SNAME or SNAME @ SYSOP
  27. will be processed. SNAME.EXE is the name of the server program to execute.
  28. If the server executable has extension EXE or COM, COMMAND.COM is not loaded.
  29. If the server executable has extension BAT, then COMMAND.COM will be loaded,
  30. and about 23k more memory will be required.
  31.  
  32. To activate the "echo" server, which reads file ECHO.OUT and
  33. creates file ECHO.IN, with ECHO.EXE in directory \MB :
  34.  
  35. S ECHO \MB\ECHO.EXE ECHO.OUT H8 ECHO.IN H8
  36.  
  37.  
  38.  
  39.    Complex Server:
  40.  
  41. A complex server first exports any messages that match the designators in
  42. the designaotor list. Then the server process is run. Then any generated
  43. messages are imported. Note that, unlike a simple server, all three functions
  44. always take place. Thus a complex server can function (for example) to
  45. transfer messages both ways between the MailBox and smtp.
  46. A list like the one below, placed into SERVER.MB, is required to define a
  47. complex server. If the server file extension is EXE or COM, then COMMAND.COM
  48. is not loaded. If the server file extension is BAT, then COMMAND.COM is
  49. loaded, and you must take it's memory requirement into account.
  50.  
  51.  
  52. C SNAME SNAME.EXE SNAME.OUT fmt SNAME.IN fmt
  53. list
  54. *** EOF
  55.  
  56. Messages will be processed acording to the list, just as in FWD.MB.
  57.  
  58.  
  59.  
  60.       Export, Import, and Execute, with no Server process.
  61.  
  62.  
  63.    Export Only:
  64.  
  65.  
  66. O FILE.OUT fmt
  67. list
  68. *** EOF
  69.  
  70.  
  71.    Import Only:
  72.  
  73.  
  74. I FILE.IN fmt
  75.  
  76.  
  77.    Execute Only:
  78.  
  79.  
  80. ! FILE
  81.  
  82.  
  83.       Summary of list types within SERVER.MB
  84.  
  85.  
  86. Item    Function
  87.  
  88. C  "Activate a Complex server"
  89. I  "Input from File"
  90. O  "Output to File"
  91. S  "Activate a Simple server"
  92. !  "Run program or batch file"
  93.  
  94.  
  95.  
  96. Available format modifiers are:
  97.  
  98. O - Use the old style "standard" (WA7MBL) export/import format.
  99. 8 - Use RFC-822 headers.
  100. B - Include the BBS message headers.
  101.  
  102. If no modifier is given, then ONLY the message text is put into the file.
  103.  
  104. To Export messages TO the file MSG.OUT in old (WA7MBL) format :
  105.  
  106. O MSG.OUT O
  107. WA6XXX
  108. *** EOF
  109.  
  110. To Export messages TO the file MSG.OUT, with only RFC-822 headers
  111. and message text, (as might be used by a user written smtp interface):
  112.  
  113. O MSG.OUT 8
  114. WA6XXX
  115. *** EOF
  116.  
  117. To Export messages TO the file MSG.OUT,
  118. with RFC-822 headers, existing BBS headers, and message text :
  119.  
  120. O MSG.OUT H8
  121. WA6XXX
  122. *** EOF
  123.  
  124. To Export messages TO the file MSG.OUT, with only the message text :
  125.  
  126. O MSG.OUT
  127. WA6XXX
  128. *** EOF
  129.  
  130.  
  131. To Import messages FROM the file MSG.IN, which is in "standard" format :
  132.  
  133. I MSG.IN O
  134.  
  135.  
  136.  
  137.      DOS commands.
  138.  
  139. A "!" list is a program or batch file to run. A file extension must be given.
  140. If the extension is BAT, the window size must be large enough for COMMAND.COM
  141. as well as the largest program run from the batch file.
  142.  
  143.  
  144.      Example:
  145.  
  146. ! CLOCK.BAT
  147.  
  148. This will run CLOCK.BAT, which can do multiple DOS commands.
  149.  
  150. ! CLOCK.EXE
  151.  
  152. This will load and run CLOCK.EXE
  153.  
  154.  
  155.       Wildcards and special "callsigns" in lists.
  156.  
  157.  
  158. When the designator in SERVER.MB is compared to the TO or @ BBS call,
  159. the characters "?" and "*" appearing in the designator act as
  160. wildcards. "?" will match any character. "*" causes the remaining
  161. characters to match.
  162.  
  163.  
  164.       Sublists.
  165.  
  166. At any place in the SERVER.MB file you can refer to another file.
  167. What happens is that the contents of the sublist are treated exactly
  168. as if they were in the SERVER.MB file. A sublist is given by a line
  169. starting with "@". The rest of the line is the device, path, and file
  170. name of the sublist file.
  171.  
  172.  
  173.  
  174.      File formats.
  175.  
  176. The following is an example export file produced using format H8.
  177.  
  178. Things to note about this file:
  179.  
  180. 1. There is a blank line following the RFC-822 header, and another
  181.    following the MailBox header.
  182.  
  183. 2. The special header item "X-msgtype" is used to show whether the
  184.    message is a Bullletin, is Personal, or is an NTS message.
  185.  
  186. 3. The file can contain multiple messages.
  187.  
  188.  
  189. Date: 12 Mar 89 17:09           <- Date at originating MailBox
  190. Message-ID: <8988@N6IYA>       <- Message number at orig MailBox
  191. X-msgtype: P               <- Message type (B, P, T)
  192. From: N6IYA@N6IYA           <- User at orig MailBox
  193. To: ECHO@W0RLI.CA.NA           <- Full location as sent
  194. Subject: Testing path turnaround.  <- Message title
  195.                    <- Blank between RFC-822 hdr and MailBox hdrs
  196. R:890312/1722z @:W0RLI Santa Cruz, CA #:3571 Z:95060
  197. R:890312/1709z @:N6IYA Felton, CA #:8988 Z:95008
  198.                    <- Blank between MailBox hdrs and text.
  199. Test message.               <- Message text.
  200. ../EX                   <- ".." added, not there in actual format
  201.  
  202.  
  203.  
  204.  
  205.  
  206. It appears that there will be a large number of servers created.
  207. These are servers I have heard about. Some are ready for use, some
  208. are in the planning/coding stage.
  209.  
  210.  
  211. ECHO   - "echo" the message back to sender for path testing.
  212. FILES  - Simulate W command.
  213. INFO   - Request BBS info.
  214. REQDIR - Request directory information.
  215. REQFIL - Request a file.
  216. REQQSL - Request qsl manger info for dx callsign.
  217. REQQTH - Request name/address for callsign.
  218. SMTP   - smtp/BBS message interface.
  219.      (There are at least two with this name.)
  220.  
  221.  
  222.  
  223. Some of these are available from the WA6RDH LL BBS - (916) 678-1535
  224.  
  225. 1. SMTP - by k3mc
  226.  
  227. 2. INFO - by n6vv
  228.  
  229.  
  230. Some are available by mail from g0bsx:
  231. (Peter's message follows)
  232.  
  233. I have created a few servers to run with W0RLI 10.x code. These are:
  234.  
  235. * An SMTP import export system that supports bulletin uploading as well as
  236.   selective bulletin downloading in addition to mail forwarding. It is possible
  237.   to select mail and bulletins to be forwarded to hosts on the To:, From: or
  238.   At: fields.
  239.  
  240. * A REQDIR system for accessing DOS directories remotely. This follows the
  241.   DOS hierarchichal access system and DOS style directory and file path
  242.   specifications are used. This is paired with a REQFIL system to access files.
  243.  
  244. * A FILES server that looks like the W0RLI flat filing system which reads the
  245.   CONFIG.MB file for directory names and areas. Sending a W0RLI type command
  246.   in the subject field will produce output in the same format as a user
  247.   accessing the mailbox would.
  248.  
  249. If you want any of these servers, drop me a floppy in a mailer with return
  250. postage (360k formatted preferable) to:
  251. Peter Meiring (G0BSX)
  252. 13 Venn Crescent
  253. Hartley
  254. Plymouth
  255. PL3 5PJ
  256.  
  257. Best Wishes, Peter.
  258.  
  259.  
  260.  
  261.