home *** CD-ROM | disk | FTP | other *** search
-
-
-
-
- KQCAP version 1.05
- KQCAP version 1.05
- (C) Copyright 1991, 1992 by Dataware, Inc. All rights reserved.
- (C) Copyright 1991, 1992 by Dataware, Inc. All rights reserved.
-
- HOW IT WORKS
- ----------------------------------------------------------------------
- KQCAP is a very smart little program that does all the work for you of
- automatically running the unarchiver program and the KILLQ program in
- harmony for your mail door. The following are the 6 conditions that it
- handles and how it responds to each of them:
-
- 1) A .REP packet is uploaded by a user into the mail door:
-
- KQCAP will run the unarchiver first, then run KILLQ to scan the
- BBSID.MSG file for duplicates. It will pass the -IS switch to
- KILLQ to force scanning of the entire packet. This is just in
- case the packet has a Scan Stamp already stored in it (it may
- have been previously scanned by the user uploading it). When it's
- finished, control is returned to the mail door to process the
- resulting BBSID.MSG file.
-
- 2) A netmail .QWK packet is received from the network
-
- KQCAP will run the unarchiver first, then run KILLQ to scan the
- MESSAGES.DAT file for duplicates. When it's finished, control is
- returned to the mail door to process the resulting MESSAGES.DAT
- file.
-
- 3) A .QWK packet is being generated for the user by the mail door:
-
- KQCAP will only run the archiver to generate the users .QWK
- packet. It will NOT run KILLQ to scan the MESSAGES.DAT file being
- compressed in the .QWK packet. The reason for this is that if
- KILLQ were to scan this packet, most (if not all) of the messages
- being sent to the user would be removed because KILLQ would just
- see them as duplicates.
-
- 4) A prescanned .QWK packet is being appended:
-
- KQCAP checks the BBSID stored in the CONTROL.DAT to verify it is
- a prescanned packet and not an incoming netmail packet.
-
- 5) An outgoing netmail .REP packet is being generated by the mail
- door:
-
- KQCAP will scan the NETMAIL.MSG file and then run the archiver to
- compress it, generating the .REP file. It will tell KILLQ to use
- a different CRC file then whatever you have configured in your
- KILLQDUP environment variable. The CRC file name will be
- netmail.CRC. For example, if I were creating a .REP packet to
- upload to Intelec, the .REP file would be INTELEC.REP and the CRC
- file would be INTELEC.CRC. The reason for this is that if KILLQ
- were to use the same CRC file, most (if not all) of the messages
- being sent out to the network would be removed because KILLQ
- would just see them as duplicates. By using a different CRC file,
- the new messages coming from your system will be allowed to get
- through. But you will still be protected against configuration
- errors causing old messages to be regurgitated back into the
- network.
-
-
-
- 6) An outgoing netmail .REP packet is being appended to:
-
- KQCAP recognizes the .REP extension during the decompression
- phase and doesn't bother with running KILLQ to scan the packet.
- During the compression phase, KQCAP will run KILLQ to scan the
- packet. KILLQ will pick up on the Scan Stamp and only scan the
- new appended messages (i.e. it will resume scanning from where it
- last left off in that packet).
-
- 7) A prescan .QWK packet is being generated:
-
- This condition is handled just like condition 3. That is, the
- packet will KQCAP will not run KILLQ to scan the packet.
-
- 8) A prescan .QWK packet is being appended to:
-
- In this condition, KQCAP will decompress the .QWK packet using
- the unarchiving program. KQCAP will recognize that this isn't an
- incoming netmail packet and won't bother with running KILLQ after
- it's been decompressed. Next, KQCAP is activated again to
- compress the .QWK packet after the mail door has appended to it.
- KQCAP again recognizes this is a .QWK packet being generated for
- a user and will only run the archiving program to compress it.
-
-
- KQCAP recognizes 3 command line switches. They are as follows:
-
- -A = Tells KQCAP that the mail door is attempting to create a
- mail packet. Either this or the -X switch MUST be present.
-
- -X = Tells KQCAP that the mail door is attempting to processed a
- receive packet. Either this or the -A switch MUST be present.
-
- -ID:BBSID = Identifies the BBSID you have configured your mail
- door for. This MUST be the BBSID that your users will see. NOT
- THE NETMAIL BBSID. This switch can also be appended to your
- KILLQDUP environment variable setting, and in fact is the
- recommended way. This switch MUST be present either on the
- command line, or in the KILLQDUP environment variable.
-
-
-
- To activate the use of KQCAP, modify your archive and unarchive lines
- in your mail door configuration. For example, if your unarchive line
- reads:
-
- PKUNZIP -O
-
- change it to read:
-
- KQCAP -X PKUNZIP -O
-
- The -X instructs KQCAP that the mail door is attempting to eXtract
- files from a mail packet. Now, if your archive line reads:
-
- PKZIP
-
- change it to read:
-
- KQCAP -A PKZIP -A
-
- The -A instructs KQCAP that the mail door is attempting to create a
- mail packet from individual files.
-
- For Tomcat!, you need to modify your PACKER lines in your TOMCAT.CFG
- file to read like this:
-
- PACKER = Z, PKZIP, ZIP, PKZIP -es !, KQCAP -X PKUNZIP -o !
- PACKER = A, PKPAK, ARC, PKPAK -a !, KQCAP -X PKUNPAK -r !
- PACKER = L, LHA, LZH, LHA a -m !, KQCAP -X LHA e -m !
- PACKER = J, ARJ, ARJ, ARJ a !, KQCAP -X ARJ e -y !
-
- For Tnet, you need to modify your PACKER line(s) in your network .CFG
- file(s) to read like this:
-
- PACKER = KQCAP -A PKZIP -es !, KQCAP -X PKUNZIP -o !
-
- If you are running the Auntie BBS, you don't need this program. When
- a .REP packet is received by the mail door, it will automatically run
- KILLQ on its own accord.
-
- Common Problems and Solutions:
- ----------------------------------------------------------------------
- PROBLEM:
- I installed KQCAP and it doesn't seem to be doing anything.
-
- ANSWER:
- Make sure you have specified the correct BBSID in your KILLQDUP
- environment variable or on the command line.
-
- PROBLEM:
- I installed KQCAP and it's removing ALL the messages from the users
- packets.
-
- ANSWER:
- You specified the wrong BBSID value and it thinks all the packets are
- netmail packets, removing the messages as duplicates.