home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / modem.madness / SMMNETML / KQDUP110.ZIP / KQCAP.DOC < prev    next >
Encoding:
Text File  |  1992-07-29  |  7.0 KB  |  162 lines

  1.  
  2.  
  3.  
  4.  
  5.                                KQCAP version 1.05
  6.                                KQCAP version 1.05
  7.         (C) Copyright 1991, 1992 by Dataware, Inc.  All rights reserved.
  8.         (C) Copyright 1991, 1992 by Dataware, Inc.  All rights reserved.
  9.  
  10.      HOW IT WORKS
  11.      ----------------------------------------------------------------------
  12.      KQCAP is a very smart little program that does all the work for you of
  13.      automatically running the unarchiver program and the KILLQ program in
  14.      harmony for your mail door. The following are the 6 conditions that it
  15.      handles and how it responds to each of them:
  16.  
  17.      1) A .REP packet is uploaded by a user into the mail door:
  18.  
  19.           KQCAP will run the unarchiver first, then run KILLQ to scan the
  20.           BBSID.MSG file for duplicates. It will pass the -IS switch to
  21.           KILLQ to force scanning of the entire packet. This is just in
  22.           case the packet has a Scan Stamp already stored in it (it may
  23.           have been previously scanned by the user uploading it). When it's
  24.           finished, control is returned to the mail door to process the
  25.           resulting BBSID.MSG file.
  26.  
  27.      2) A netmail .QWK packet is received from the network
  28.  
  29.           KQCAP will run the unarchiver first, then run KILLQ to scan the
  30.           MESSAGES.DAT file for duplicates. When it's finished, control is
  31.           returned to the mail door to process the resulting MESSAGES.DAT
  32.           file.
  33.  
  34.      3) A .QWK packet is being generated for the user by the mail door:
  35.  
  36.           KQCAP will only run the archiver to generate the users .QWK
  37.           packet. It will NOT run KILLQ to scan the MESSAGES.DAT file being
  38.           compressed in the .QWK packet. The reason for this is that if
  39.           KILLQ were to scan this packet, most (if not all) of the messages
  40.           being sent to the user would be removed because KILLQ would just
  41.           see them as duplicates.
  42.  
  43.      4) A prescanned .QWK packet is being appended:
  44.  
  45.           KQCAP checks the BBSID stored in the CONTROL.DAT to verify it is
  46.           a prescanned packet and not an incoming netmail packet.
  47.  
  48.      5) An outgoing netmail .REP packet is being generated by the mail
  49.      door:
  50.  
  51.           KQCAP will scan the NETMAIL.MSG file and then run the archiver to
  52.           compress it, generating the .REP file. It will tell KILLQ to use
  53.           a different CRC file then whatever you have configured in your
  54.           KILLQDUP environment variable.  The CRC file name will be
  55.           netmail.CRC. For example, if I were creating a .REP packet to
  56.           upload to Intelec, the .REP file would be INTELEC.REP and the CRC
  57.           file would be INTELEC.CRC. The reason for this is that if KILLQ
  58.           were to use the same CRC file, most (if not all) of the messages
  59.           being sent out to the network would be removed because KILLQ
  60.           would just see them as duplicates. By using a different CRC file,
  61.           the new messages coming from your system will be allowed to get
  62.           through. But you will still be protected against configuration
  63.           errors causing old messages to be regurgitated back into the
  64.           network.
  65.  
  66.  
  67.  
  68.      6) An outgoing netmail .REP packet is being appended to:
  69.  
  70.           KQCAP recognizes the .REP extension during the decompression
  71.           phase and doesn't bother with running KILLQ to scan the packet.
  72.           During the compression phase, KQCAP will run KILLQ to scan the
  73.           packet. KILLQ will pick up on the Scan Stamp and only scan the
  74.           new appended messages (i.e. it will resume scanning from where it
  75.           last left off in that packet).
  76.  
  77.      7) A prescan .QWK packet is being generated:
  78.  
  79.           This condition is handled just like condition 3. That is, the
  80.           packet will KQCAP will not run KILLQ to scan the packet.
  81.  
  82.      8) A prescan .QWK packet is being appended to:
  83.  
  84.           In this condition, KQCAP will decompress the .QWK packet using
  85.           the unarchiving program. KQCAP will recognize that this isn't an
  86.           incoming netmail packet and won't bother with running KILLQ after
  87.           it's been decompressed. Next, KQCAP is activated again to
  88.           compress the .QWK packet after the mail door has appended to it.
  89.           KQCAP again recognizes this is a .QWK packet being generated for
  90.           a user and will only run the archiving program to compress it.
  91.  
  92.  
  93.      KQCAP recognizes 3 command line switches. They are as follows:
  94.  
  95.           -A = Tells KQCAP that the mail door is attempting to create a
  96.           mail packet. Either this or the -X switch MUST be present.
  97.  
  98.           -X = Tells KQCAP that the mail door is attempting to processed a
  99.           receive packet. Either this or the -A switch MUST be present.
  100.  
  101.           -ID:BBSID = Identifies the BBSID you have configured your mail
  102.           door for. This MUST be the BBSID that your users will see. NOT
  103.           THE NETMAIL BBSID. This switch can also be appended to your
  104.           KILLQDUP environment variable setting, and in fact is the
  105.           recommended way. This switch MUST be present either on the
  106.           command line, or in the KILLQDUP environment variable.
  107.  
  108.  
  109.  
  110.      To activate the use of KQCAP, modify your archive and unarchive lines
  111.      in your mail door configuration.  For example, if your unarchive line
  112.      reads:
  113.  
  114.      PKUNZIP -O
  115.  
  116.      change it to read:
  117.  
  118.      KQCAP -X PKUNZIP -O
  119.  
  120.      The -X instructs KQCAP that the mail door is attempting to eXtract
  121.      files from a mail packet. Now, if your archive line reads:
  122.  
  123.      PKZIP
  124.  
  125.      change it to read:
  126.  
  127.      KQCAP -A PKZIP -A
  128.  
  129.      The -A instructs KQCAP that the mail door is attempting to create a
  130.      mail packet from individual files.
  131.  
  132.      For Tomcat!, you need to modify your PACKER lines in your TOMCAT.CFG
  133.      file to read like this:
  134.  
  135.      PACKER = Z, PKZIP, ZIP, PKZIP -es !, KQCAP -X PKUNZIP -o !
  136.      PACKER = A, PKPAK, ARC, PKPAK -a !,  KQCAP -X PKUNPAK -r !
  137.      PACKER = L, LHA,   LZH, LHA a -m !,  KQCAP -X LHA e -m !
  138.      PACKER = J, ARJ,   ARJ, ARJ a !,     KQCAP -X ARJ e -y !
  139.  
  140.      For Tnet, you need to modify your PACKER line(s) in your network .CFG
  141.      file(s) to read like this:
  142.  
  143.      PACKER = KQCAP -A PKZIP -es !, KQCAP -X PKUNZIP -o !
  144.  
  145.      If you are running the Auntie BBS, you don't need this program.  When
  146.      a .REP packet is received by the mail door, it will automatically run
  147.      KILLQ on its own accord.
  148.  
  149.      Common Problems and Solutions:
  150.      ----------------------------------------------------------------------
  151.      PROBLEM:
  152.      I installed KQCAP and it doesn't seem to be doing anything.
  153.  
  154.      ANSWER:
  155.      Make sure you have specified the correct BBSID in your KILLQDUP
  156.      environment variable or on the command line.
  157.  
  158.      PROBLEM:
  159.      I installed KQCAP and it's removing ALL the messages from the users
  160.      packets.
  161.  
  162.      ANSWER:
  163.      You specified the wrong BBSID value and it thinks all the packets are
  164.      netmail packets, removing the messages as duplicates.