home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-387-Vol-3of3.iso
/
f
/
fidoq112.zip
/
FIDOQWK.DOC
< prev
next >
Wrap
Text File
|
1993-03-12
|
15KB
|
429 lines
FidoQWK v1.12 (March 12, 1993)
FidoNet(tm) <=> QWK echomail processor
Copyright 1992 by Geoffrey Sy
FidoQWK is supported by:
Residence: Support BBS:
Geoffrey Sy UNDER CONSTRUCTION
51 Wyatt Walk
Toronto, Ontario CANADA
M5A 3T3
═════[INTRODUCTION]══════════════════════════════════════════
FidoQWK is for anyone running a FidoNet compatible BBS system
and wants to carry any .QWK type nets or vice versa. It can
also be used for QWK door to QWK door mail transfer.
The basic concept for FidoNet <=> QWK tranfer:
FidoNet *.MSG => BBS_ID.REP => QWK Mail door =>
QWK mail door => BBS_ID.QWK => FidoNet *.MSG
Additional step(s) may be required to convert from your BBS's
native message format into the standard FidoNet *.MSG format
and vise versa.
For situations where a QWK mail door is available on both
BBS, QWK2REP will allow mail transfers between the doors:
HOSTBBS.QWK => THISBBS.REP => This BBS mail door =>
THISBBS.QWK => HOSTBBS.REP => Host BBS mail door
In this documentation I'm assuming that you know how to do
this as well as the basic concept of echomail transfers. If
you are not sure, leave a message on the appropriate
conference on the echo, the SysOps conference on most
echomail network is usually appropriate.
_____________________________________________________________
FidoQWK echomail processor documentation ................. 1
═════[OVERVIEW]══════════════════════════════════════════════
There are 5 modules to the FidoQWK package. There's FQSETUP
that sets up the needed data for the other modules.
The MSG2REP module packs the *.MSG files into a REP packet
for uploading to a QWK mail door. The QWK2MSG module unpacks
the QWK packet and tosses *.MSG files into the appropriate
message areas. The PURGE module is used to delete all *.MSG
files in the message areas.
The QWK2REP module allows conversion of one BBS's .QWK mail
packet into another BBS's .REP packet. It lets BBSes with
QWK mail doors to exchange messages in situations where
echomail processors for the BBSes don't exist.
In summary:
FQSETUP.EXE - Sets up data files for all modules.
For Fido *.MSG <=> QWK, the following modules are needed:
MSG2REP.EXE - Packs *.MSG into a REP packet for sending
out to the host BBS.
QWK2MSG.EXE - Inserts messages from the host BBS into
your BBS.
PURGE.EXE - Wipes out all *.MSG files for a BBS.
For QWK door <=> QWK door:
QWK2REP.EXE - Converts .QWK packet from one BBS to a
.REP packet for uploading to another
BBS's QWK mail door.
_____________________________________________________________
FidoQWK echomail processor documentation ................. 2
═════[FQSETUP]═══════════════════════════════════════════════
When FQSETUP is executed a menu with 3 options will be shown.
If the help system was completed, the F1 key calls up the
context-sensitive help items. Option 'A' sets up the general
information. These general information includes:
1 - Your name
2 - Registration key (if you're registered)
3 - Serial number (if you're registered)
4 - The location where you want FidoQWK to send the
BBS_ID.REP package.
5 - The location where you've downloaded the host BBS's
BBS_ID.QWK mail package.
6 - The location where FidoQWK can store its temporary
work files. A RAM or fast hard disk is recommended.
Option 'B' sets up the data compressor characteristics. Each
compressor definition requires the following information:
1 - The make and model of the compressor
2 - The full pathname (including extension) and switches
needed to compress a file.
3 - The full pathname (including extension) and switches
needed to de-compress a file.
4 - The ASCII value of the first byte found in files that
have been compressed with this compressor. This will
be used for detection of the compressed file type.
(* NOTE: Automatic detection of compressed file type has
not yet been programmed into v1.00 of FidoQWK *)
Option 'C' sets up host BBS information and message bases.
These options include:
1 - The name of the .QWK packet (Host ID).
2 - The BBS name of the host.
3 - The tagline of the host BBS to be placed on all
incoming messages.
4 - The compressor type used on this BBS.
5 - The tagline to be placed on all outgoing messages.
There may be features not documented here, press F1 in
FQSETUP to display additional help. To insert more host BBS,
press Alt-I. To delete a host BBS, press Alt-D. To locate a
host BBS, press F4. To repeat the same data for a new BBS,
press Alt-D. The Page Up and Page Down keys selects the
previous and next host BBS. Press the F2 key at anytime while
under option 'C' to edit the message base names and paths.
_____________________________________________________________
FidoQWK echomail processor documentation ................. 3
These include:
1 - The conference number used on the host BBS.
2 - The name of the message area.
3 - The location on your hard drive to store these
messages.
4 - The last message sent to the host BBS.
5 - The last message written to disk by FidoQWK.
The available functions are listed above, press the Esc key
to return to the previous function.
═════[MSG2REP/QWK2MSG/QWK2REP]═══════════════════════════════
MSG2REP: Scans *.MSG from your BBS to send to the host BBS
QWK2MSG: Inserts messages from the host BBS into your BBS
To use the above modules, type the module name followed by
the host BBS ID.
EXAMPLES:
To toss messages from BBS_ID.QWK packet to Fido *.MSG:
QWK2MSG BBS_ID [switches]
To scan messages from Fido *.MSG into BBS_ID.REP:
MSG2REP BBS_ID [switches]
To convert from BBS_ID.QWK to BBS_ID.REP:
QWK2REP BBS_ID [switches]
SWITCHES:
The following switches are available to all modules:
/NS - No Shell:
Use this option to tell FidoQWK not to run the
compression/decompression programs. Be sure to manually
decompress the QWK packet into FidoQWK's work directory
when using this option. The resultant BBS_ID.MSG will
need to be manually compressed into BBS_ID.REP also.
/SWAP /EMS - Swap out when shelling:
Use these options to swap to disk or EMS when executing
the compression utilities.
_____________________________________________________________
FidoQWK echomail processor documentation ................. 4
/FS - Full Screen shell:
Use this option to execute the compression utilities in
full-screen mode. This should be used in situations when
your compression utility writes all over the screen.
FidoQWK normally executes the compression utilities in a
small window.
/TF: - Translate the "FROM:" field in the messages:
Ex: /TF:SYSOP=GEOFFREY;SY would replace any occurrence of
'SYSOP' from the "FROM:" fields with 'GEOFFREY SY'
/TT: - Translate the "TO:" field in messages:
Ex: /TT:SYSOP=GEOFFREY;SY would replace any occurrence of
'SYSOP' from the "TO:" fields with 'GEOFFREY SY'
The following switches are available to MSG2REP only:
/IS - Ignore Sent Marker:
Normally MSG2REP will NOT send messages that have been
marked as sent. Use this message if your messages
aren't being sent out.
/IP - Ignore last scanned pointers:
Normally MSG2REP will scan *.MSG files from the highest
number it scanned last. This may not be desirable in
some cases. Use this switch to scan all available *.MSG
packets.
/NoSEENBY - Strip FidoNet 'SEEN-BY: ' lines.
/NoOrigin - Strip FidoNet '* Origin: ', lines.
_____________________________________________________________
FidoQWK echomail processor documentation ................. 5
═════[FREQUENTLY ASKED QUESTIONS]════════════════════════════
Q: QWK2MSG can't find messages when it opens my .QWK packet.
A: Does your .QWK packet contain index (*.NDX) files?
Did you tell FidoQWK where your compression utilities are?
Q: QWK2MSG is tossing messages to the wrong areas.
A: In some network environment, FidoQWK may not be able to
delete files in its work directory. Make sure FidoQWK's
work directory is empty before running QWK2MSG.
Q: My screen gets messed up when FidoQWK runs my compression
utility.
A: Run FidoQWK with the /FS switch to tell it to give-up
screen control to the compression program.
_____________________________________________________________
FidoQWK echomail processor documentation ................. 6
═════[REGISTRATION/SUPPORT]══════════════════════════════════
If you have questions, bugs, comments or suggestions, please
contact me. I may be reached on the PCBoard, Doors, OffLine
conferences on City2City(tm), Intelec(tm), and ILink(tm), the
PCBNet and Offline conference on FidoNet(tm). I can also be
reach on my support BBS or by snail-mail to the above
address. Registered users of any one of my shareware packages
may contact me using the voice number in the registration
document.
Since FidoQWK is user supported software, I don't expect you
to register if you don't like it or if it doesn't meet your
needs. Just stop using it after a reasonable trial period
(1-2 weeks). The program is not crippled in any way, there is
a few seconds delay at the exit of the program.
FidoQWK is an on-going project, as with all programming
projects, it will never be finished. I have a long list of
features I'm ready to implement, but your support is needed
if these features are to be implemented. I have to know that
I'm not wasting my time and efforts on this, if you find the
program useful, please send your support.
If you like the program and use it regularly, please register
it. The registration cost is a one-time fee of $20.00. With
the registration you'll receive unlimited voice support and
upgrades. Your registration encourages further development,
enhancement and my continued support of the product. Please
send your registration in the form of a Money Order, Personal
cheque, or Cashier's cheque to the above address.
═════[STANDARD DISCLAIMER]═══════════════════════════════════
This program is provided on an "AS IS" basis. No warranty of
any kind is expressed or implied. YOU USE THIS PROGRAM AT
YOUR OWN RISK. I take no responsibility for any damage caused
directly or indirectly from the use or the inability to use
this program.
═════[CREDITS/COPYRIGHTS]════════════════════════════════════
QWK/Qmail: Copyrights of Mark "Sparky" Herring of
Sparkware, the original creator of QWK.
"Fido", "FidoNet": U.S. registered trademarks of Tom
Jennings of Fido Software.
Other: Respected copyright/trademark holders.
_____________________________________________________________
FidoQWK echomail processor documentation ................. 7