home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / comm / Mail+News / UMS11 / Doc / english / UMS-QWK.doc < prev    next >
Text File  |  1995-02-03  |  5KB  |  157 lines
  1.         QWKImport 1.13
  2.         QWKExport 1.16                  for UMS 10.8+
  3.                  by Iain Hibbert               by Martin Horneffer
  4.  
  5.                              31 January 1995
  6.  
  7.   QWKImport and QWKExport are a pair of programs to enable you to use your
  8. favourite UMS NewsReader as an OLR for QWK mail.
  9.  
  10. Usage.
  11. ------
  12.  
  13.  QWKImport SITE/A,PASSWORD,SERVER/K,KEEP/S
  14.  
  15.         SITE is the qwk BBS to import from
  16.         PASSWORD is the UMS password for that BBS
  17.  
  18.         SERVER is the server to use (defaults to the usual one)
  19.  
  20.         KEEP means to keep the .QWK bundle after processing, but if there
  21.              was any error whilst importing, the packet will always be kept
  22.  
  23.     QWKImport unpacks the bundle named <SITE>.QWK from the Inbound
  24.   directory, and scans the CONTROL.TXT file for Conference names.. then it
  25.   scans the MESSAGES.DAT file for messages and writes them to groups named
  26.   "qwk.<SITE>.<number> `Conference Name'"
  27.  
  28.     NOTE, there is no message threading information in QWK packets, so you
  29.   are limited to subject searches
  30.  
  31.  QWKExport SITE/A,PASSWORD,SERVER/K,ADD/S
  32.  
  33.         SITE is the qwk BBS to export to
  34.         PASSWORD is the UMS password for that BBS
  35.  
  36.         SERVER is the UMS server to use (defaults to the usual one)
  37.  
  38.         ADD means to add to the packet waiting in your uploads directory,
  39.             instead of replacing it.
  40.  
  41.     QWKExport scans your messagebase and writes the messages to a file
  42.   called <SITE>.MSG, which it then compresses into <SITE>.REP using your
  43.   specified packer and Outbound directory.
  44.  
  45.     NOTE, QWKExport gets the area number from the conference name, so you
  46.   will get problems if you try to export mail in areas not from the
  47.   original BBS (use netgroups). When there is no group name (ie, it is a
  48.   private message to bbs@qwk), then the message is put into the conference
  49.   number from qwk.pvtarea, with the private flag set.
  50.  
  51. Configuration.
  52. --------------
  53.  
  54.     There are several UMS qwk. variables to specify, these can be local (to
  55. the user) or global, whichever you prefer, but all have defaults.
  56.  
  57. qwk.inbound     ; Where to find the .QWK bundles
  58.  
  59.     default:  "Comms:Downloads/"
  60.  
  61. qwk.outbound    ; Where to put the .REP bundles
  62.  
  63.     default:  "Comms:Uploads/"
  64.  
  65. qwk.keeppacket  ; if "Yes", the QWK bundles are not deleted after processing
  66.  
  67.     default:  "No"
  68.  
  69. qwk.addpacket   ; if "Yes" then QWKExport will always add to the .REP packet
  70.  
  71.     default:  "No"
  72.  
  73. qwk.pvtarea     ; area to put private mail into, with the Private flag set
  74.  
  75.     default:  "0"
  76.  
  77. qwk.packer      ; command to use when packing the .MSG file into the
  78.                 ; .REP bundle. Should contain two %s strings, the first is the
  79.                 ; name of the archive, the second is the file to compress
  80.  
  81.     default:  "lharc a %s %s"
  82.  
  83. qwk.unpacker    ; command to use when unpacking the .QWK file to the temporary
  84.                 ; directory. The %s is replaced with the bundle name
  85.  
  86.     default:  "lharc e %s"
  87.  
  88. qwk.tempdir     ; where to unpack the .QWK file to
  89.                 ; QWKImport will attempt to make this directory if it
  90.                 ; can't CD to it, so don't include a trailing /
  91.  
  92.     default:  "T:"
  93.  
  94. qwk.no-hi-conf  ; some QWK doors don't use two bytes for the conference number
  95.                   so we can turn off the hi byte so we don't get junk for the
  96.                   conference number (its usually 0x20, so the areas are +8192)
  97.                   change to "Yes" if you get strange area numbers and no names.
  98.  
  99.     default:  "No"
  100.  
  101. Example.
  102. --------
  103.  
  104. qwk.inbound               = "Comms:Downloads/"
  105. qwk.outbound              = "Comms:Uploads/"
  106. qwk.keeppacket            = "No"
  107. qwk.addpacket             = "No"
  108. qwk.tempdir               = "T:Qwk"
  109. qwk.packer                = "LhA -I -u -m -U2048 m %s %s"
  110. qwk.unpacker              = "LhA -I -m -f -x0 -U8192 e %s"
  111.  
  112. User
  113.     Name  "Highlander BBS"
  114.     Alias "qwk.highland"
  115.     Distribution    = "#?"
  116.     Export          = "highland@qwk"
  117.     GroupFilter     = "#?"
  118.     Import          = "highland@qwk"
  119.     NetAccess       = "%"
  120.     Password
  121.     ReadAccess      = "qwk.highland.#?"
  122.     WriteAccess     = "qwk.highland.#?"
  123.     qwk.pvtarea     = "2"
  124.     qwk.tempdir     = "T:Highlander"
  125. EndUser
  126.  
  127. Source.
  128. -------
  129.  
  130.     Source is included, as is a DMakefile for DICE. Please feel free to
  131. make any enhancements or bugfixes (!), but I would appreciate it if you'd
  132. return the changes to me for inclusion in my source.  The ReadArgs bit is
  133. done by an autoinit function to make it easier to read. If you need the
  134. link lib, just let me know..
  135.  
  136. Copyright.
  137. ----------
  138.  
  139.      QWKImport and QWKExport are (C) 1994  Iain  Hibbert  and  are  freely
  140.  distributable as long as all of the files are included in their  original
  141.  form without additions, deletions, or modifications of any kind, and only
  142.  a nominal fee is charged for its distribution.
  143.  
  144.      This software is provided "AS IS" without warranty of any kind, either
  145.  expressed or implied. Reading legal mush can turn your brain to guacamole.
  146.  By using QWKImport and QWKExport, you accept either the whole risk or  the
  147.  quality and performance of the programs.
  148.  
  149. Author.
  150. -------
  151.  
  152.   Iain Hibbert                  plunky@skate.demon.co.uk
  153.   4 Avondale Road               2:250/320.33@fidonet
  154.   Bath                          39:138/14.33@amiganet
  155.   Avon BA1 3EG
  156.   ENGLAND
  157.