home *** CD-ROM | disk | FTP | other *** search
Text File | 1991-11-02 | 43.3 KB | 1,059 lines |
-
-
-
-
-
-
- ╔═══════════════════════════╦══════════════════════════════════════════╗
- ║ Mythical Kingdom Software ║ ║
- ║ ▄ ▄ ▄ ▄ ║ MKQwk - Qwk Mail Door for RA ║
- ║ ███ ▐▀ ▐▀ ███ ║ Copyright 1991 by Mark May ║
- ║ ███████████████ ║ All Rights Reserved ║
- ║ ██████░░░██████ ║ ║
- ║ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║ Version 1.02 ║
- ╚═══════════════════════════╩══════════════════════════════════════════╝
-
-
-
- (Note: MKQwk is pronounced "Emm Kay Quick" NEVER "McQuick")
- (The MK stands for Mythical Kingdom Software)
-
-
-
-
-
-
-
- MKQwk Qwk Mail Door Page 01
-
- Table of Contents
-
-
- Table of Contents ................................ 1
-
- Features ......................................... 2
-
- General Information .............................. 3
-
- Quick Installation ............................... 4
-
- Detailed Installation ............................ 5
-
- General MKQwkCfg Information ..................... 5
-
- Main Configuration ............................... 6
-
- Message Conference Configuration ................. 8
-
- File Transfer Protocol Setup ..................... 9
-
- Screens and Bulletins ............................ 10
-
- File Archive Packers/UnPackers ................... 11
-
- MKQwk User Editor ................................ 11
-
- Fast Ansi Config ................................. 13
-
- Fast Hi-Bit Config ............................... 13
-
- Fast TagLine Stripping Config .................... 13
-
- NetMail .......................................... 14
-
- Configuration messages ........................... 15
-
- Batch Mode ....................................... 16
-
- MKQStat .......................................... 17
-
- LastRead Pointers ................................ 18
-
- Support .......................................... 19
-
- Registration ..................................... 20
-
- Other Mythical Kingdom Software available ........ 21
-
-
-
-
- MKQwk Qwk Mail Door Page 02
-
- FEATURES:
-
- * Uses the Remote Access config files to check for read,
- write, and sysop access to each message area. The only
- exception is to callers you have given "Net-Status" for
- transfering QWK format echomail.
- * It does the expected checking for time limits, carrier
- detection and idle time timeouts.
- * Very user-friendly. With ansi/ascii cursor positioning
- to make conference selection quick and easy.
- * Hot-keys and default displays allow your callers to
- easily select the options they need.
- * Care has been taken to optimize the extraction of mail
- for fast operation. A unique method of finding new files
- allows that operation to proceed quickly as well.
- * Supports both echomail and netmail message areas, with
- full netmail pending accounting using sysop selected values
- for the costs of various types of netmail.
- * The user record is properly updated to reflect messages
- posted. Log-file entries in the proper format are also made.
- * Supports net-status for use in QWK format echomail networks.
- Each message area may be assigned to multiple networks,
- and in addition each caller can have access to multiple
- networks. Should handle gating between Fido technology
- and QWK technology networks, if needed.
- * Very configurable for the sysop. The sysop can set most
- options to be forced on, forced off, or allowed to be
- user-configured. In additon each message area can be made
- available, not available, or forced.
- * Fast set-up screens to make configuration of message area
- options quick. This allows the ansi, hi-bit, and tagline
- stripping options to be easily set-up.
- * Configuration program allows editing user options and
- adding new MKQwk users, so that you can help out those
- callers that need it (or at least see what they're up to).
- * Uses RA envirnment varible and paths in Config.Ra to minimize
- set-up.
- * Multinode aware with either old (v1.00) or new "alternate"
- (v1.01) style message base locking.
- * Batch mode available for the sysop.
- * Full configurability of screens and bulletins sent to callers.
- * Handles both old and new style configuration messages.
- * Duplicate message upload detection.
- * Optional flagging of mail as received after successful
- file transfer.
- * Support for all the common archive packer/unpacker types with
- autodetection of file archive type.
- * Uses LastRead.Bbs pointers to allow proper operation when
- areas are turned off and on. Doesn't affect the user record
- lastread pointer used for combined message reading.
- * Also supports plain text packets for callers on machines that
- do not support the QWK mail packet format.
-
-
-
-
- MKQwk Qwk Mail Door Page 03
-
- General Information
-
-
- DISCLAIMER:
-
- While reasonable care has been taken in creating this program,
- no warranty is made that it will perform the way you would like.
- You (and not the author) are responsible for any problems
- occuring due to this program. If you cannot accept this
- responsibility, do not run this program. However, if you
- should run across a problem, please contact the author so
- that it may be possible to fix the problem (see note at end
- about info on contacting the author). As with any complex
- program, bugs are possible even though the product has been
- tested. To protect against this, you should be making
- regular backups.
-
-
- Note that this package is copyrighted, even though freely
- available. You may NOT ADD ADDITIONAL FILES to the
- archive (although you may convert it to a different
- archive type). Also you are NOT PERMITTED TO MODIFY
- any of the files here for further distribution.
- Modification for your own personal use is permitted.
-
-
-
-
- MKQwk Qwk Mail Door Page 04
-
-
- QUICK INSTALLATION:
-
- Copy the *.EXE files into a directory that is on your path.
-
- Copy the *.A* files into your Bbs TxtFiles directory.
- Copy the *.HLP file to your Bbs TxtFiles directory.
-
- Unpack the *.DOC files with the Del *.Doc command <grin>
-
- Change drives and/or directories to be in your main RA
- directory.
-
- Run MKQwkCfg to create the config file in your Bbs
- message base subdirectory. At a minimum you need to
- modify the following fields from the main configuration
- option on the menu:
-
- BbsId - a name (up to 8 characters) used for the file
- name of mail packets from your board. Should be set
- to something that identifies your Bbs.
-
- Locked Baud Rate - set it to the locked baud rate if
- you are using one, otherwise you must leave it set
- to zero.
-
- Everything else should default to reasonable values to
- get started (protocols and archivers available are
- defaulted based on which programs could be found on your
- path). You might want to try it out with default values
- and get that working first before getting into all of
- the options.
-
- Add MKQwk to one of your menus. This can be done as a
- "type 7 door" using the path to MKQwk as the optional
- data. MKQwk does not require any command line parameters,
- so the only other thing necessary is the *M to enable
- memory swapping. Optionally you may also use *! to
- not count time in the mail door against your callers.
-
- Type 7 C:\UTIL\MKQwk.EXE *M *!
-
- MKQwk should be normally be run direct and NOT from a batch
- file except in local non-bbs mode.
-
- Some Bbs software does not allow LastRead.Bbs to be updated
- during a type 7 door. If LastRead pointers are not getting
- updated you may need to switch to a type 15.
-
- MKQwk expects to find ExitInfo.Bbs and DorInfo1.Def in
- the current directory when it starts up.
-
-
-
-
- MKQwk Qwk Mail Door Page 05
-
-
- DETAILED INSTALLATION:
-
- GENERAL MKQWKCFG INFO:
-
- Use the [Tab] and [BackTab] keys to move from field to
- field. If you have a mouse installed, you may also use
- it to make selections.
-
- To get back out of any screen, simply hit [Esc]. [Esc]
- will both save and exit, unless you are in the middle of
- editing a field, in which case the original value of the
- field is restored.
-
- For single-choice picklists just highlight the choice
- you want and press [Enter].
-
- For multiple-choice picklists (like the Fast message option
- configs), use the [Spacebar] to toggle the item on and off
- (items selected are shown with an "*" in front of them.
- To select a whole range of items, press [F7] on the first
- item and [F8] on the last item and the whole range will
- be toggled. [Ctl][Enter] can be used to toggle ranges
- back off.
-
- When you quit (by choosing Quit or pressing [Esc] from the
- main menu), the currently chosen values are written to the
- Config.Mkq file in the current directory.
-
- Text fields are set-up so that cursor movement keys allow
- editing. If the first key you hit is a character key, it
- will clear the field to make it easier to enter a completely
- new value.
-
- A few of the fields take you to an automatic picklist to
- choose a value. To get out of the picklist press [Enter]
- to change the value or [Esc] to exit without changing it.
-
-
-
-
- MKQwk Qwk Mail Door Page 06
-
-
- MAIN MKQwk CONFIGURATION SCREEN:
-
- Bbs Id: a required identifier for your Bbs. It may be up to
- 8 characters long, but may contain only the characters
- that are valid in filenames. It is used to create the
- filename of the mail packet (ie BBSID.QWK). You should
- choose something that your callers can easily associate
- with your Bbs.
-
- Locked Baud Rate: If you are running with a locked baud
- rate, place the locked baud rate here. If you do not
- have a locked baud rate (or maybe don't even know what
- one is), then you should set this to zero.
-
- Direct Screen Writes: Normally set this to YES for
- faster screen displays and operation. If you are
- running a multitasker and it bleeds through your other
- sessions, you will need to set this to NO.
-
- Force User Name: Normally you will want to set this to
- YES. This will cause MKQwk to use the name of the caller
- logged on as the From: on a message regardless of the
- name the caller used in his mail reader (prevents him
- from leaving messages that look like they were from
- someone else). Note that if you have the message area
- set in Config.RA to allow alias that they will still
- be allowed even with Force User Name set to yes.
-
- Alt File Locking: If you are running single node or are
- running RA v1.00, make sure this is set to NO. If you
- are running multinode RA v1.01 with SHARE loaded, you
- need to set this to YES. Multinode SuperBbs should have
- this set to yes. Quickbbs has switched between locking
- methods, but appears that it is settling on a method
- that requires this to be set to yes as well.
-
- Maximum Messages: Set this to the maximum number of
- messages you want to allow in one packet. The absolute
- maximum is 2000. Callers can choose to limit there
- maximum packet size to a smaller value in their set-up
- options. Keep in mind though, that you do need enough
- disk space for both the unpacked and packed messages
- while the archiver is running.
-
- Maximum Msgs Per Conf: Set this to the maximum number of
- messages per message area you want to allow. Again
- callers can configure a smaller limit if they need to.
- A few mail readers can only handle 200 msgs per area, so
- setting it to 200 will minimize questions from callers
- using those readers.
-
- Redate Msgs: Set this to yes if you want imported mail
- to be dated with the import date instead of the date
- written.
-
-
-
-
- MKQwk Qwk Mail Door Page 07
-
-
- New Files: Determines whether a new files list will be
- sent as part of the callers QWK packet. The choices are:
-
- YES - always include new files list regardless of whether
- the caller wants it.
- NO - never include a new files list
- ASK - allow the caller to configure whether he/she wants
- a new files list or not.
-
- Send Screens: Determines whether the hello/news/goodbye
- screens will be included in the QWK packet. The YES,
- NO, ASK choices work the same as in the New files options.
-
- Send Bulletins: Determines whether bulletin screens will
- be sent as part of the QWK packet. Again you have the
- YES, NO, ASK options.
-
- Minimum Crash Security: minimum security level necessary
- to send crash netmail. If the caller is below this
- level the message is moved to the default msg area.
-
- Minimum Immediate Security: minimum security level needed
- to send Immediate netmail. I'm not sure that all mailers
- support the IMM flag, so immediate netmail may not
- work on your system.
-
- Normal NetMail Cost: cost for a normal netmail message.
- This is added to the users pending column when he
- posts a normal netmail message. If he does not have
- enough netmail credit then the message is moved to the
- default area.
-
- Crash NetMail Cost: cost of a crash netmail message.
-
- MyNet NetMail Cost: cost of a netmail message sent within
- your net (based on the main address of the netmail
- message area).
-
- Immediate NetMail Cost: cost of a netmail message that
- is flagged as immediate.
-
- InterZone NetMail Cost: cost of a netmail message to a
- different zone (based on the main address of the netmail
- message area).
-
-
-
-
- MKQwk Qwk Mail Door Page 08
-
-
- Default Msg Area: Messages are moved to this area when the
- caller does not have write access (based on flags and
- security levels) for the area he chose for a message. It
- is also used if the caller does not have enough netmail
- credit for the type of message he was entering.
-
- Temp File Path: Normally you can leave this blank and temporary
- files will be placed on the current drive. If you have
- sufficient space elsewhere (or a faster drive) you can put
- a path to be used here. A mail packet with 1000 to 2000
- messages can be quite large, so consider carefully where
- you want them built.
-
- Bbs Phone Number: Place your full Bbs phone number here.
- Not really used for much, but some mail readers like to
- be able to display it.
-
-
- MESSAGE CONFERENCE CONFIGURATION:
-
- Select the message area you would like to configure by
- highlighting it on the pick list an pressing enter (or
- clicking for the rodent users out there). It will bring
- up a small window to allow options to be configured for
- that area (you'll quickly learn why there are FAST options
- at the bottom of the main menu).
-
- Short Name: Many of the mail readers only support a ten
- to 12 character name for each message area (also the
- online area selection screen has limited space for
- names). If you leave this field blank it will use the
- first 12 characters of the area name in Config.Ra
- which may look odd in some cases. You can fill it in
- here to get what you want instead.
-
- Available: If set to YES, then this area is sent to the
- caller regardless of whether they want it. If it is
- set to NO, then it is not available at all thru the
- MKQwk door. If it is set to ASK (which is the normal
- choice), it will leave it up to the caller whether they
- want the area or not.
-
- Network Type: If you are participating in a QWK based
- echomail network, this allows you to assign each message
- area to one or more networks. To assign it to a network
- just toggle the "*" on in the multiple-choice picklist.
-
-
-
-
-
-
- MKQwk Qwk Mail Door Page 09
-
- Strip TagLines: If you set this to YES, then mail reader
- taglines that follow the normal QWK format will be
- stripped from the messages. NO leaves them as is.
- Some FIDO echos may require that taglines be stripped.
- Note: Taglines from NetStatus users are not stripped to
- make gating possible. Because of the current concern
- in Fido over taglines, the current default is YES to
- strip taglines. Note that in EchoMail areas the reader
- tearlines are ALWAYS stripped out.
-
- Allow Hi-Bit Characters: YES means that hi-bit IBM characters
- are allowed in this area. Setting it to NO will cause them
- to be replaced with a "*". Again some echos may require
- this.
-
- Allow Ansi: YES means that the {esc} character needed to
- start an ansi sequence is allowed in this area. NO will
- cause it to be replaced with a ` character. Most all
- echos forbid ansi graphics unless they are especially
- dedicated for that purpose.
-
- Keep TearLine Text: Yes means that any text on the mail
- readers tearline (in echomail areas) will be kept on
- with the tearline (up to 25 characters to avoid GMD
- nastygrams). Note that the whole tearline is moved
- in EchoMail areas for Fido compatibility.
-
- Convert Taglines into Origin Lines: Yes means that the
- mail reader tagline text will be converted into a
- "Fido" style origin line (in echomail areas only).
- Note that the tagline text may be truncated to avoid
- problems on maximum Origin Line length. You SHOULD
- set Strip Taglines to Yes when using this option to
- avoid repetition.
-
-
- FILE TRANSFER PROTOCOL SETUP:
-
- A picklist is shown with 10 slots for file transfer
- protocols. Ones that are flagged as active are shown
- with an "*" in front of them. Highlight the protocol
- slot you want to setup and press [Enter]. Note that
- default set-ups are included for DSZ, PCZ, and MPt.
-
- Active: YES means that this protocol is available to
- callers. NO means that it is not available. Setting
- it to no allows you to keep it set-up, but still
- inactive.
-
- Choice Character: The character to be used in menus and
- config messages to choose the protocol. You should be
- careful to make sure that none of the active protocols
- share the same choice character.
-
- Protocol Name: Used for display purposes only on menus
- to help callers in choosing the protocol. Note that
- it does give room for comments as well, but that does
- make a few of the screens look a bit odd.
-
-
-
-
-
-
- MKQwk Qwk Mail Door Page 10
-
- Protocol Path\Program.Ext: This needs to contain the
- FULL path to the transfer protocol. If you leave
- out the drive, path, or extension, MKQwk will not
- find the transfer program. (ie you need something
- like C:\UTIL\DSZ.COM).
-
- Send Command Line: The command line that should be
- given to the transfer program to send the mail
- packet to the caller (download).
-
- Recv Command Line: The command line that should be
- given to the transfer program to receive the reply
- packet from the caller (upload).
-
- Either of the command lines can contain the following
- macros:
-
- %1 is replaced with the current comm port number.
-
- %2 is replaced with the callers real baud rate.
-
- %4 is replaced with the name of the file to be
- transfered.
-
- %9 is replaced with the locked baud rate, unless
- you do not have a locked baud rate, in which
- case the callers baud rate is used instead.
-
-
- SCREENS AND BULLETINS:
-
- You can choose which screens/bulletins you wish to have
- available to your callers. Any *.ANS or *.ASC files in
- your Bbs TxtFiles directory can be set-up as a bulletin
- or screen. The user info and Bbs info codes will not
- be translated (neither by MKQwk nor by the mail reader)
- so you will want to avoid screens that contain those.
- If the caller has ansi enabled, the *.ANS version is sent
- if it exists, otherwise the *.ASC version is sent. If
- you wanted to move a copy of your "recent files in the
- last 30 days" file to your txtfile directory and rename
- it recent.asc, you could then set it up as a bulletin file.
- I'm sure there are other uses some of you will find for this.
- The screen names must be entered without file extensions as
- MKQwk will pick the appropriate one. You have up to 3 screens
- and up to 10 bulletins. Some QWK readers do not seem to
- implement all of the ansi commands. I've found that you can
- minimize the problem by saving your ansi screens with the
- line length set to "None" (ie start a new line only when a
- new line occurs not on some shorter line length limit).
- You will probably also want to save a block and not a full
- screen, limiting the width since some readers add scroll
- bars.
-
-
-
-
- MKQwk Qwk Mail Door Page 11
-
-
- FILE ARCHIVE PACKERS:
-
- MKQwk already knows the appropriate command lines for the
- common file packers/unpackers. All that is left for you
- to configure is to indicate which ones you wish to make
- available to your callers (for unpacking replies, MKQwk
- will detect which archive type the file is and call the
- appropriate unpacker even if you have it set as not
- active). Use the normal [Spacebar] or [F7] [F8] keys to
- toggle the active file packers. DWC should be left
- inactive since it will not handle the .QWK ane .REP file
- extensions in any versions I have seen.
-
-
- MKQwk USER EDITOR:
-
- A picklist of current users is shown as well as an item
- called "---- New ----" which is optionally used to set
- up users before they call. Highlight the user you want to
- edit and press [Enter].
-
- Protocol: a character A thru Z to choose which file transfer
- protocol to use. It should be set to match one of the
- choice characters used during protocol setup.
-
- Packer: a character A thru Z to choose which file packer type
- to use. The current choices are L=Lzh Z=Zip A=Arc J=Arj
- D=Dwc H=Hyp O=Zoo.
-
- Maximum Msgs: Set the maximum number of messages per QWK
- packet. Message pointers will be set to the highest
- message exported, so multiple packet downloads can be
- done (just make sure not to upload replies until the end
- if you have it set not to receive mail back that you
- send).
-
- Maximum Msgs Per Conference: Sets the maximum number
- of messages that will be sent in each message area.
- Some mail readers will need this set to 200.
-
- Send Screens: Determines whether Welcome, News, and Goodbye
- screens will be included in the QWK packet.
-
-
-
-
- MKQwk Qwk Mail Door Page 12
-
- Send Bulletins: Determines whether the bulletin screens
- will be included in the QWK packet.
-
- New Files List: Determines whether a list of files dated
- after the last time on will be included in the QWK
- packet. The New Files List creator is quite fast
- (compared to an online new files search) and is worth
- trying.
-
- Last Used MKQwk: Display Only - shows when the caller
- last used MKQwk (or if they have never used it).
-
- Recv Own Msgs: Determines whether messages/replies that
- have been uploaded should be included in the QWK packet
- generated. Note that it avoids sending them by setting
- the message pointer higher than the uploaded messages
- when the caller leaves the door. In addition in non
- net-status message areas it will also check the user
- name against the from name on the message.
-
- Active Conferences: Another multiple choice picklist
- that allows you to toggle message areas on or off.
- Active areas are again flagged with an "*" in front
- of them.
-
- Net Status Networks: A multiple choice picklist of
- networks that the caller will have NetStatus in.
- Unless you are participating in QWK format echomail
- you should not set any of these.
-
- Flag Mail as Read: Determines whether mail that is
- downloaded and is To You should be flagged on the
- Bbs as having been received or not. Flagging takes
- place only after a successful download has been
- completed.
-
- Recv All Your Mail: Determines whether a scan for mail
- To You in message areas that you have not selected
- will be done or not. This keeps you from missing
- your mail, but does add a little time to the scanning
- process. Note that only *unreceived* mail is sent, so
- if you read your mail at log-on it will have already
- been received (unless you're the sysop and unreceive
- it).
-
- Mail Type: Currently on 2 types of mail packets are
- supported. Type 1 is the normal QWK format. Type 2 is
- a plain text packet. Note that uploads (replies) are
- NOT allowed with PLAIN TEXT packets.
-
- Send Empty Packets: Determines whether a packet should be
- created (with Bulletins/screens/new files) when no msgs
- are available for DL.
-
- Verify User Wants Packet: When set to YES the caller will
- be shown the packet size and asked if they want the
- packet before it is sent.
-
-
-
-
- MKQwk Qwk Mail Door Page 13
-
-
- FAST ANSI CONFIG:
-
- Use this screen to quickly configure the areas that you
- permit to contain ansi {esc} codes. It is a multiple-
- choice picklist, so you can use either [SpaceBar] or
- [F7] [F8] and [Ctl] [Enter] to toggle the areas. Press
- either [Enter] or [Esc] when you have the areas set the
- way you want them.
-
-
- FAST HI-BIT CONFIG:
-
- A multiple-choice picklist to allow you to configure
- message areas that will allow hi-bit characters. Note
- that most Fido echos do not allow this, but many other
- echos do allow it.
-
-
- FAST TAGLINE STRIPPING CONFIG:
-
- Another multiple-choice picklist. This one allows you
- to select which areas will strip the tagline put on by
- the mail reader. You need to know the rules for the
- echos you are in to determine how to set this (generally
- FIDO echos should strip taglines, while other networks
- generally allow them).
-
-
- FAST TEARLINE TEXT CONFIG:
-
- Another multiple-choice picklist. This one allows you
- to select which areas will keep any text with the readers
- tearline when importing the message. Note that this only
- applies to echomail areas since tearlines are alwasy kept
- in local and netmail areas.
-
-
- FAST TAGLINE TO ORIGIN LINE CONFIG:
-
- Another multiple-choice picklist. This one allows you
- to select which areas will have reader taglines converted
- into "Fido" compatible Origin lines (which may mean
- truncating them if they are too long after the required
- "Fido" info is added). Again only applies to echomail
- areas. Generally when this is set, you should set
- Strip Taglines to YES to avoid repetition.
-
-
-
-
- MKQwk Qwk Mail Door Page 14
-
-
- NETMAIL:
-
- MKQwk add support for Fido-style Netmail even though
- the QWK readers were not designed to handle it normally.
- The one thing missing from a normal message that is
- required for netmail is the destination address and
- flags.
-
- MKQwk interprets the subject of the message as containing
- a destination address if it starts with an "@" sign. It
- understands both full addresses as well as a variety of
- short-form addresses (where the remaining part of the
- address is based on the main address or AKA for the netmail
- message area. After the address you may optionally
- include the words CRASH IMM and/or DIR. These will give
- the message the attributes of crash, immediate and/or
- direct netmail respectively. Some examples (assuming an
- address of 1:110/290 would be:
-
- @151/223 IMM send to 1:151/223 and flag as immediate
- @1:274/40 send to 1:274/40
- @270 CRASH send to 1:110/270 as crash mail
- @.1 send to 1:110/290.1
-
- On messages exported from the Bbs, the subject line will
- contain the originating address for netmail areas. This
- was done to allow you to reply without entering an address,
- since it will already be in the subject line.
-
- If you want the subject to look normal on the netmail messages
- you write, you need to use the first message text line as the
- subject and start it with "Subj:". Example:
-
- Subj: Qwk message readers
-
- Note that because of the security problems that would be
- created, that MKQwk does not support File requests nor
- File attaches.
-
-
-
-
-
- MKQwk Qwk Mail Door Page 15
-
-
- CONFIGURATION MESSAGES:
-
- MKQwk supports both old and new style configuration messages
- which may be addressed to MKQwk, Qmail, or most of the other
- popular Qwk door names.
-
-
-
- Old style config messages have the following options for subjects:
-
- ADD Adds the current message area
- DROP Drops the current message area
- RESET nn Resets message pointer to message number "nn"
- BLTS On/Off Turns bulletins on or off
- FILES On/Off Turns new files list on or off
- WELCOME On/Off Turns screens on or off
- GOODBYE On/Off Also turns screens on or off
-
-
-
- New style config messages have a subject of CONFIG and have
- one command on each text line of the message. The following
- commands are available.
-
- ADD nn Adds message area "nn"
- DROP nn Drops message area "nn"
- RESET nn xx Resets lastread pointer in area "nn" to number "xx"
- PROTOCOL x Sets protocol choice to "x"
- PACKER x Sets archive packer choice to "x"
- MAXNUMBER nn Sets maximum number of messages per area to "nn"
-
-
-
- The Qwk readers can create some of these messages on their
- own when certain options are chosen from their menus. Thus
- users need not be aware that messages are used to pass the
- config information. The commands listed here are the only
- ones supported currently by MKQwk.
-
-
-
-
- MKQwk Qwk Mail Door Page 16
-
- BATCH MODE:
-
- MKQwk can also be run in batch mode without logging into
- your Bbs. To do this just run it with a command line
- parameter of L followed by your first and last name
- (matching what is in your Users.Bbs record). In either
- Batch mode or Local Log-On mode, MKQwk will check for
- *.REP files in the current directory and also create its
- *.QWK files in the current directory.
-
- If you want to upload only use a command line parameter
- of U followed by first and last names.
-
- Examples:
-
- MKQwk L Mark May {imports REP file and creates QWK file}
-
- MKQwk U Mark May {imports REP file only}
-
-
- Since the standard among QWK based readers is to handle
- files named either *.QWK or *.QW1 thru *.QW9, you can
- further automate the process by using something like the
- example LOCAL.BAT file that is included with MKQwk. It
- does a series of If Exist ... Rename commands. To use
- LOCAL.BAT you should bring it up in a text editor and do
- a search and replace on BBSID to change it to your BoardId.
- You will also need to change the line with FirstName LastName
- to your name. You may also need to edit the commands at the
- beginning that change drives and directories. You can then
- just add a line to your batch file that processes incomming
- mail to do a "Call Local.Bat", and you will have your mail
- all packed up and waiting for you.
-
- If you need to handle more than the QWK and QW1 thru QW9 that
- the QWK standard allows, you will need to use one of the
- utilities that merge multiple QWK packets into one QWK packet.
-
-
-
-
-
-
-
-
- MKQwk Qwk Mail Door Page 17
-
- MKQSTAT:
-
- This is an added little utility that you can run from the
- command line. It reads the MKQwk user file (Users.Mkq)
- and counts how many users have each message area turned
- on and produces a short report with the totals.
-
- By default this report is sent to the screen, but output
- maybe redirected to a file ('>C:\TXTFILES\ACTIVE.ASC')
- or to a printer ('>PRN') using the normal dos redirection
- command line format (as shown).
-
- The time it takes to produce the report will depend on
- the number of MKQwk users that you have.
-
- You may find this report useful when you need to decide
- about adding or dropping message areas.
-
-
-
-
-
- MKQwk Qwk Mail Door Page 18
-
- LASTREAD POINTERS:
-
- MKQwk uses the LastRead.Bbs pointers (which has a separate
- lastread pointer individually for each message area). This
- allows much greater flexibility to your callers than using
- the "combined" lastread pointer that is located in the
- user record.
-
- Because this may be different than how other offline mail
- doors have handled LastRead pointers, it may seem confusing
- to your callers. In particular if they are CONVERTING from
- ANOTHER MAIL DOOR they will need to make sure to update their
- area LastRead pointers prior to downloading a mail packet to
- prevent getting messages they have already received. To do
- this they should first select the areas they want to receive
- and then choose (R)ESET lastread pointers in all selected
- areas from the main menu. It will show them what their
- "combined" lastread pointer was set to and allow them to
- enter it to globally reset their lastread pointers to this
- value.
-
- Another difference from other offline mail doors is in
- how the scan for "Your" messages is done. When you have
- enabled the scan all areas for Your Mail, MKQwk looks
- through all messages in unselected areas and includes ones
- that are to you and also marked as unreceived. This allows
- you to get messages below your lastread pointers if you haven't
- seen them and keeps you from getting messages above your last
- read pointers that you have read (sysops who want to get their
- mail after reading it at log-on need to use the "=" toggle to
- mark messages as unreceived when reading it online). (Note
- the scan for yours in all areas could be compared to what
- RA will do in a full mailcheck for your mail).
-
- I may add a config option to allow MKQwk to use the combined
- LastRead pointer in a future version, but I strongly believe
- that the current approach is better.
-
-
-
- MKQwk Qwk Mail Door Page 19
-
-
- SUPPORT:
-
- You may leave questions or get the latest version by
- calling:
-
- Mythical Kingdom Tech Bbs
-
- Phone (513) 237-7737 9600 baud HST/V32
- FidoNet 1:110/290
- RIME (RelayNet) ->MYTHKING
-
- Since this is a Free utility, if you Netmail a question you
- will need to poll (in a day or two normally) to get your
- answer. If you fail to poll for a reply, I will delete the
- answer after a week or two.
-
- For more generic questions that may also help others you may
- want to use the FIDO RA_UTIL echo (but NOT RA_SUPPORT) or the
- RIME Remote Access conference or RIME Offline Mail conference.
- I also normally read the FIDO SUPERBBS and FIDO QUICKBBS echos.
-
- If you would like more ongoing support access, you may want to
- pick up the MK echo (Fido style) for info/support on all of
- the M K Software programs. Currently it is available from a
- few Bbs's, although it will hopefully become more widely
- available.
-
-
-
-
-
- MKQwk Qwk Mail Door Page 20
-
-
-
- REGISTRATION:
-
- A registration fee is not required for these programs. I
- believe that the Bbs world is becoming too commercialized
- and distribute my programs as FREEWARE to fight against
- that trend. If you are a shareware author, consider
- sending me a registered version of your program in
- exchange for your use of this program.
-
- I would appreciate it if you would either fill in the
- form below and return it to me, or to drop me a postcard.
- This will help in measuring the usefulnes of MKQwk and
- help in determining how time is allocated between this
- and other projects.
-
-
- Registration Information: MKQwk v1.02
-
-
- Name: ____________________________________________
-
- Address: ____________________________________________
-
- ____________________________________________
-
- City, ST Zip ____________________________________________
-
-
- Bbs Name: ____________________________________________
-
-
- Bbs Phone Number ( ) -
-
- Any suggestions or comments ______________________________
-
- __________________________________________________________
-
- __________________________________________________________
-
-
- Registrations should be mailed to:
-
- Mark May
- Mythical Kingdom Software
- P.O. Box 24808
- Huber Heights, OH 45424
-
-
-
-
-
- MKQwk Qwk Mail Door Page 21
-
-
- Other Mythical Kingdom Software Bbs utilities include:
-
- MKTODAY - a configurable today's callers screen
- generator. With this your Today's callers screen won't
- have to look like everyone elses. (RA/Qbbs/Sbbs). Also
- generates yesterday's callers and summary history screens.
-
- MKUTI - a set of UTI drivers to allow Quickbbs, Remote Access,
- and SuperBbs to work with PC-Relay (RIME) and with the
- MegaMail mail door (although now that MegaMail reader supports
- the QWK format, you'll probably just want to use MKQwk)
-
- MKWAM - a Quickbbs/Remote Access interface to WAM format messages
- for use with HyperMail style networks.
-
- MKNEW - a FAST new files lister for Quickbbs. (NOTE - has
- problems with some systems due to use of direct COMM support
- the next version will use the fossil driver and will also
- even further substantially increase speed by switching to
- the method used in MKQwk).
-
- MKXRS - an XRS message/reply tosser that improves
- security over the normal method of using an echomail
- tosser and provides the sysop with several options.
- Messages are quickly tossed while the caller is still
- online.
-
- MKNET - a QWK mail network interface for Remote Access
- (preforms the function that Qnet or Rnet perform for PCB
- for RA, so that RA Bbs's can participate in QWK networks).
-
- Special thanks to the people who helped in Beta testing this
- program, especially to Jim Hale for putting together the
- docs on how to use it with Quickbbs (once Quickbbs is out of
- beta/gamma I hope to again add direct support for Quickbbs).
- Thanks to the many people who have made suggestions that
- have allowed newer versions to be improved.