home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / NETMAIL / MKQWK102.ZIP / MKQWK.DOC < prev    next >
Encoding:
Text File  |  1991-11-02  |  43.3 KB  |  1,059 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.     ╔═══════════════════════════╦══════════════════════════════════════════╗
  8.     ║ Mythical Kingdom Software ║                                          ║
  9.     ║      ▄ ▄         ▄ ▄      ║      MKQwk - Qwk Mail Door for RA        ║
  10.     ║      ███  ▐▀ ▐▀  ███      ║       Copyright 1991 by Mark May         ║
  11.     ║      ███████████████      ║          All Rights Reserved             ║
  12.     ║      ██████░░░██████      ║                                          ║
  13.     ║  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  ║              Version 1.02                ║
  14.     ╚═══════════════════════════╩══════════════════════════════════════════╝
  15.  
  16.  
  17.  
  18.          (Note: MKQwk is pronounced "Emm Kay Quick" NEVER "McQuick")
  19.                (The MK stands for Mythical Kingdom Software)
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                           MKQwk Qwk Mail Door              Page 01
  28.  
  29.                             Table of Contents
  30.  
  31.  
  32.          Table of Contents ................................   1
  33.  
  34.          Features .........................................   2
  35.  
  36.          General Information ..............................   3
  37.  
  38.          Quick Installation ...............................   4
  39.  
  40.          Detailed Installation ............................   5
  41.  
  42.          General MKQwkCfg Information .....................   5
  43.  
  44.          Main Configuration ...............................   6
  45.  
  46.          Message Conference Configuration .................   8
  47.  
  48.          File Transfer Protocol Setup .....................   9
  49.  
  50.          Screens and Bulletins ............................  10
  51.  
  52.          File Archive Packers/UnPackers ...................  11
  53.  
  54.          MKQwk User Editor ................................  11
  55.  
  56.          Fast Ansi Config .................................  13
  57.  
  58.          Fast Hi-Bit Config ...............................  13
  59.  
  60.          Fast TagLine Stripping Config ....................  13
  61.  
  62.          NetMail ..........................................  14
  63.  
  64.          Configuration messages ...........................  15
  65.  
  66.          Batch Mode .......................................  16
  67.  
  68.          MKQStat ..........................................  17
  69.  
  70.          LastRead Pointers ................................  18
  71.  
  72.          Support ..........................................  19
  73.  
  74.          Registration .....................................  20
  75.  
  76.          Other Mythical Kingdom Software available ........  21
  77.  
  78.  
  79.  
  80.  
  81.                           MKQwk Qwk Mail Door              Page 02
  82.  
  83.          FEATURES:
  84.  
  85.          *  Uses the Remote Access config files to check for read,
  86.             write, and sysop access to each message area.  The only
  87.             exception is to callers you have given "Net-Status" for
  88.             transfering QWK format echomail.
  89.          *  It does the expected checking for time limits, carrier
  90.             detection and idle time timeouts.
  91.          *  Very user-friendly.  With ansi/ascii cursor positioning
  92.             to make conference selection quick and easy.
  93.          *  Hot-keys and default displays allow your callers to
  94.             easily select the options they need.
  95.          *  Care has been taken to optimize the extraction of mail
  96.             for fast operation.  A unique method of finding new files
  97.             allows that operation to proceed quickly as well.
  98.          *  Supports both echomail and netmail message areas, with
  99.             full netmail pending accounting using sysop selected values
  100.             for the costs of various types of netmail.
  101.          *  The user record is properly updated to reflect messages
  102.             posted.  Log-file entries in the proper format are also made.
  103.          *  Supports net-status for use in QWK format echomail networks.
  104.             Each message area may be assigned to multiple networks,
  105.             and in addition each caller can have access to multiple
  106.             networks.  Should handle gating between Fido technology
  107.             and QWK technology networks, if needed.
  108.          *  Very configurable for the sysop.  The sysop can set most
  109.             options to be forced on, forced off, or allowed to be
  110.             user-configured.  In additon each message area can be made
  111.             available, not available, or forced.
  112.          *  Fast set-up screens to make configuration of message area
  113.             options quick.  This allows the ansi, hi-bit, and tagline
  114.             stripping options to be easily set-up.
  115.          *  Configuration program allows editing user options and
  116.             adding new MKQwk users, so that you can help out those
  117.             callers that need it (or at least see what they're up to).
  118.          *  Uses RA envirnment varible and paths in Config.Ra to minimize
  119.             set-up.
  120.          *  Multinode aware with either old (v1.00) or new "alternate"
  121.             (v1.01) style message base locking.
  122.          *  Batch mode available for the sysop.
  123.          *  Full configurability of screens and bulletins sent to callers.
  124.          *  Handles both old and new style configuration messages.
  125.          *  Duplicate message upload detection.
  126.          *  Optional flagging of mail as received after successful
  127.             file transfer.
  128.          *  Support for all the common archive packer/unpacker types with
  129.             autodetection of file archive type.
  130.          *  Uses LastRead.Bbs pointers to allow proper operation when
  131.             areas are turned off and on.  Doesn't affect the user record
  132.             lastread pointer used for combined message reading.
  133.          *  Also supports plain text packets for callers on machines that
  134.             do not support the QWK mail packet format.
  135.  
  136.  
  137.  
  138.  
  139.                           MKQwk Qwk Mail Door              Page 03
  140.  
  141.                           General Information
  142.  
  143.  
  144.          DISCLAIMER:
  145.  
  146.          While reasonable care has been taken in creating this program,
  147.          no warranty is made that it will perform the way you would like.
  148.          You (and not the author) are responsible for any problems
  149.          occuring due to this program.  If you cannot accept this
  150.          responsibility, do not run this program.  However, if you
  151.          should run across a problem, please contact the author so
  152.          that it may be possible to fix the problem (see note at end
  153.          about info on contacting the author).  As with any complex
  154.          program, bugs are possible even though the product has been
  155.          tested.  To protect against this, you should be making
  156.          regular backups.
  157.  
  158.  
  159.          Note that this package is copyrighted, even though freely
  160.          available.  You may NOT ADD ADDITIONAL FILES to the
  161.          archive (although you may convert it to a different
  162.          archive type).  Also you are NOT PERMITTED TO MODIFY
  163.          any of the files here for further distribution.
  164.          Modification for your own personal use is permitted.
  165.  
  166.  
  167.  
  168.  
  169.                           MKQwk Qwk Mail Door              Page 04
  170.  
  171.  
  172.          QUICK INSTALLATION:
  173.  
  174.          Copy the *.EXE files into a directory that is on your path.
  175.  
  176.          Copy the *.A* files into your Bbs TxtFiles directory.
  177.          Copy the *.HLP file to your Bbs TxtFiles directory.
  178.  
  179.          Unpack the *.DOC files with the Del *.Doc command <grin>
  180.  
  181.          Change drives and/or directories to be in your main RA
  182.          directory.
  183.  
  184.          Run MKQwkCfg to create the config file in your Bbs
  185.          message base subdirectory.  At a minimum you need to
  186.          modify the following fields from the main configuration
  187.          option on the menu:
  188.  
  189.             BbsId - a name (up to 8 characters) used for the file
  190.                name of mail packets from your board.  Should be set
  191.                to something that identifies your Bbs.
  192.  
  193.             Locked Baud Rate - set it to the locked baud rate if
  194.                you are using one, otherwise you must leave it set
  195.                to zero.
  196.  
  197.          Everything else should default to reasonable values to
  198.          get started (protocols and archivers available are
  199.          defaulted based on which programs could be found on your
  200.          path).  You might want to try it out with default values
  201.          and get that working first before getting into all of
  202.          the options.
  203.  
  204.          Add MKQwk to one of your menus.  This can be done as a
  205.          "type 7 door" using the path to MKQwk as the optional
  206.          data.  MKQwk does not require any command line parameters,
  207.          so the only other thing necessary is the *M to enable
  208.          memory swapping.  Optionally you may also use *! to
  209.          not count time in the mail door against your callers.
  210.  
  211.                Type 7      C:\UTIL\MKQwk.EXE *M *!
  212.  
  213.          MKQwk should be normally be run direct and NOT from a batch
  214.          file except in local non-bbs mode.
  215.  
  216.          Some Bbs software does not allow LastRead.Bbs to be updated
  217.          during a type 7 door.  If LastRead pointers are not getting
  218.          updated you may need to switch to a type 15.
  219.  
  220.          MKQwk expects to find ExitInfo.Bbs and DorInfo1.Def in
  221.          the current directory when it starts up.
  222.  
  223.  
  224.  
  225.  
  226.                           MKQwk Qwk Mail Door              Page 05
  227.  
  228.  
  229.          DETAILED INSTALLATION:
  230.  
  231.          GENERAL MKQWKCFG INFO:
  232.  
  233.          Use the [Tab] and [BackTab] keys to move from field to
  234.          field.  If you have a mouse installed, you may also use
  235.          it to make selections.
  236.  
  237.          To get back out of any screen, simply hit [Esc].  [Esc]
  238.          will both save and exit, unless you are in the middle of
  239.          editing a field, in which case the original value of the
  240.          field is restored.
  241.  
  242.          For single-choice picklists just highlight the choice
  243.          you want and press [Enter].
  244.  
  245.          For multiple-choice picklists (like the Fast message option
  246.          configs), use the [Spacebar] to toggle the item on and off
  247.          (items selected are shown with an "*" in front of them.
  248.          To select a whole range of items, press [F7] on the first
  249.          item and [F8] on the last item and the whole range will
  250.          be toggled.  [Ctl][Enter] can be used to toggle ranges
  251.          back off.
  252.  
  253.          When you quit (by choosing Quit or pressing [Esc] from the
  254.          main menu), the currently chosen values are written to the
  255.          Config.Mkq file in the current directory.
  256.  
  257.          Text fields are set-up so that cursor movement keys allow
  258.          editing.  If the first key you hit is a character key, it
  259.          will clear the field to make it easier to enter a completely
  260.          new value.
  261.  
  262.          A few of the fields take you to an automatic picklist to
  263.          choose a value.  To get out of the picklist press [Enter]
  264.          to change the value or [Esc] to exit without changing it.
  265.  
  266.  
  267.  
  268.  
  269.                           MKQwk Qwk Mail Door              Page 06
  270.  
  271.  
  272.          MAIN MKQwk CONFIGURATION SCREEN:
  273.  
  274.          Bbs Id: a required identifier for your Bbs.  It may be up to
  275.             8 characters long, but may contain only the characters
  276.             that are valid in filenames.  It is used to create the
  277.             filename of the mail packet (ie BBSID.QWK).  You should
  278.             choose something that your callers can easily associate
  279.             with your Bbs.
  280.  
  281.          Locked Baud Rate:  If you are running with a locked baud
  282.            rate, place the locked baud rate here.  If you do not
  283.            have a locked baud rate (or maybe don't even know what
  284.            one is), then you should set this to zero.
  285.  
  286.          Direct Screen Writes:  Normally set this to YES for
  287.            faster screen displays and operation.  If you are
  288.            running a multitasker and it bleeds through your other
  289.            sessions, you will need to set this to NO.
  290.  
  291.          Force User Name:  Normally you will want to set this to
  292.            YES.  This will cause MKQwk to use the name of the caller
  293.            logged on as the From: on a message regardless of the
  294.            name the caller used in his mail reader (prevents him
  295.            from leaving messages that look like they were from
  296.            someone else).  Note that if you have the message area
  297.            set in Config.RA to allow alias that they will still
  298.            be allowed even with Force User Name set to yes.
  299.  
  300.          Alt File Locking:  If you are running single node or are
  301.            running RA v1.00, make sure this is set to NO.  If you
  302.            are running multinode RA v1.01 with SHARE loaded, you
  303.            need to set this to YES.  Multinode SuperBbs should have
  304.            this set to yes.  Quickbbs has switched between locking
  305.            methods, but appears that it is settling on a method
  306.            that requires this to be set to yes as well.
  307.  
  308.          Maximum Messages:  Set this to the maximum number of
  309.            messages you want to allow in one packet.  The absolute
  310.            maximum is 2000.  Callers can choose to limit there
  311.            maximum packet size to a smaller value in their set-up
  312.            options.  Keep in mind though, that you do need enough
  313.            disk space for both the unpacked and packed messages
  314.            while the archiver is running.
  315.  
  316.          Maximum Msgs Per Conf:  Set this to the maximum number of
  317.            messages per message area you want to allow.  Again
  318.            callers can configure a smaller limit if they need to.
  319.            A few mail readers can only handle 200 msgs per area, so
  320.            setting it to 200 will minimize questions from callers
  321.            using those readers.
  322.  
  323.          Redate Msgs:  Set this to yes if you want imported mail
  324.            to be dated with the import date instead of the date
  325.            written.
  326.  
  327.  
  328.  
  329.  
  330.                           MKQwk Qwk Mail Door              Page 07
  331.  
  332.  
  333.          New Files: Determines whether a new files list will be
  334.            sent as part of the callers QWK packet.  The choices are:
  335.  
  336.            YES - always include new files list regardless of whether
  337.                  the caller wants it.
  338.            NO -  never include a new files list
  339.            ASK - allow the caller to configure whether he/she wants
  340.                  a new files list or not.
  341.  
  342.          Send Screens: Determines whether the hello/news/goodbye
  343.            screens will be included in the QWK packet.  The YES,
  344.            NO, ASK choices work the same as in the New files options.
  345.  
  346.          Send Bulletins: Determines whether bulletin screens will
  347.            be sent as part of the QWK packet.  Again you have the
  348.            YES, NO, ASK options.
  349.  
  350.          Minimum Crash Security: minimum security level necessary
  351.            to send crash netmail.  If the caller is below this
  352.            level the message is moved to the default msg area.
  353.  
  354.          Minimum Immediate Security: minimum security level needed
  355.            to send Immediate netmail.  I'm not sure that all mailers
  356.            support the IMM flag, so immediate netmail may not
  357.            work on your system.
  358.  
  359.          Normal NetMail Cost: cost for a normal netmail message.
  360.            This is added to the users pending column when he
  361.            posts a normal netmail message.  If he does not have
  362.            enough netmail credit then the message is moved to the
  363.            default area.
  364.  
  365.          Crash NetMail Cost: cost of a crash netmail message.
  366.  
  367.          MyNet NetMail Cost: cost of a netmail message sent within
  368.            your net (based on the main address of the netmail
  369.            message area).
  370.  
  371.          Immediate NetMail Cost: cost of a netmail message that
  372.            is flagged as immediate.
  373.  
  374.          InterZone NetMail Cost: cost of a netmail message to a
  375.            different zone (based on the main address of the netmail
  376.            message area).
  377.  
  378.  
  379.  
  380.  
  381.                           MKQwk Qwk Mail Door              Page 08
  382.  
  383.  
  384.          Default Msg Area:  Messages are moved to this area when the
  385.            caller does not have write access (based on flags and
  386.            security levels) for the area he chose for a message.  It
  387.            is also used if the caller does not have enough netmail
  388.            credit for the type of message he was entering.
  389.  
  390.          Temp File Path: Normally you can leave this blank and temporary
  391.            files will be placed on the current drive.  If you have
  392.            sufficient space elsewhere (or a faster drive) you can put
  393.            a path to be used here.  A mail packet with 1000 to 2000
  394.            messages can be quite large, so consider carefully where
  395.            you want them built.
  396.  
  397.          Bbs Phone Number: Place your full Bbs phone number here.
  398.            Not really used for much, but some mail readers like to
  399.            be able to display it.
  400.  
  401.  
  402.          MESSAGE CONFERENCE CONFIGURATION:
  403.  
  404.          Select the message area you would like to configure by
  405.          highlighting it on the pick list an pressing enter (or
  406.          clicking for the rodent users out there).  It will bring
  407.          up a small window to allow options to be configured for
  408.          that area (you'll quickly learn why there are FAST options
  409.          at the bottom of the main menu).
  410.  
  411.          Short Name: Many of the mail readers only support a ten
  412.            to 12 character name for each message area (also the
  413.            online area selection screen has limited space for
  414.            names).  If you leave this field blank it will use the
  415.            first 12 characters of the area name in Config.Ra
  416.            which may look odd in some cases.  You can fill it in
  417.            here to get what you want instead.
  418.  
  419.          Available:  If set to YES, then this area is sent to the
  420.            caller regardless of whether they want it.  If it is
  421.            set to NO, then it is not available at all thru the
  422.            MKQwk door.  If it is set to ASK (which is the normal
  423.            choice), it will leave it up to the caller whether they
  424.            want the area or not.
  425.  
  426.          Network Type:  If you are participating in a QWK based
  427.            echomail network, this allows you to assign each message
  428.            area to one or more networks.  To assign it to a network
  429.            just toggle the "*" on in the multiple-choice picklist.
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.                           MKQwk Qwk Mail Door              Page 09
  437.  
  438.          Strip TagLines:  If you set this to YES, then mail reader
  439.            taglines that follow the normal QWK format will be
  440.            stripped from the messages.  NO leaves them as is.
  441.            Some FIDO echos may require that taglines be stripped.
  442.            Note: Taglines from NetStatus users are not stripped to
  443.            make gating possible.  Because of the current concern
  444.            in Fido over taglines, the current default is YES to
  445.            strip taglines.  Note that in EchoMail areas the reader
  446.            tearlines are ALWAYS stripped out.
  447.  
  448.          Allow Hi-Bit Characters: YES means that hi-bit IBM characters
  449.            are allowed in this area.  Setting it to NO will cause them
  450.            to be replaced with a "*".  Again some echos may require
  451.            this.
  452.  
  453.          Allow Ansi: YES means that the {esc} character needed to
  454.            start an ansi sequence is allowed in this area. NO will
  455.            cause it to be replaced with a ` character.  Most all
  456.            echos forbid ansi graphics unless they are especially
  457.            dedicated for that purpose.
  458.  
  459.          Keep TearLine Text: Yes means that any text on the mail
  460.            readers tearline (in echomail areas) will be kept on
  461.            with the tearline (up to 25 characters to avoid GMD
  462.            nastygrams).  Note that the whole tearline is moved
  463.            in EchoMail areas for Fido compatibility.
  464.  
  465.          Convert Taglines into Origin Lines:  Yes means that the
  466.            mail reader tagline text will be converted into a
  467.            "Fido" style origin line (in echomail areas only).
  468.            Note that the tagline text may be truncated to avoid
  469.            problems on maximum Origin Line length.  You SHOULD
  470.            set Strip Taglines to Yes when using this option to
  471.            avoid repetition.
  472.  
  473.  
  474.          FILE TRANSFER PROTOCOL SETUP:
  475.  
  476.          A picklist is shown with 10 slots for file transfer
  477.          protocols.  Ones that are flagged as active are shown
  478.          with an "*" in front of them.  Highlight the protocol
  479.          slot you want to setup and press [Enter].  Note that
  480.          default set-ups are included for DSZ, PCZ, and MPt.
  481.  
  482.          Active: YES means that this protocol is available to
  483.            callers.  NO means that it is not available.  Setting
  484.            it to no allows you to keep it set-up, but still
  485.            inactive.
  486.  
  487.          Choice Character:  The character to be used in menus and
  488.            config messages to choose the protocol.  You should be
  489.            careful to make sure that none of the active protocols
  490.            share the same choice character.
  491.  
  492.          Protocol Name: Used for display purposes only on menus
  493.            to help callers in choosing the protocol.  Note that
  494.            it does give room for comments as well, but that does
  495.            make a few of the screens look a bit odd.
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.                           MKQwk Qwk Mail Door              Page 10
  503.  
  504.          Protocol Path\Program.Ext:  This needs to contain the
  505.            FULL path to the transfer protocol.  If you leave
  506.            out the drive, path, or extension, MKQwk will not
  507.            find the transfer program.  (ie you need something
  508.            like C:\UTIL\DSZ.COM).
  509.  
  510.          Send Command Line: The command line that should be
  511.            given to the transfer program to send the mail
  512.            packet to the caller (download).
  513.  
  514.          Recv Command Line: The command line that should be
  515.            given to the transfer program to receive the reply
  516.            packet from the caller (upload).
  517.  
  518.            Either of the command lines can contain the following
  519.            macros:
  520.  
  521.            %1   is replaced with the current comm port number.
  522.  
  523.            %2   is replaced with the callers real baud rate.
  524.  
  525.            %4   is replaced with the name of the file to be
  526.                 transfered.
  527.  
  528.            %9   is replaced with the locked baud rate, unless
  529.                 you do not have a locked baud rate, in which
  530.                 case the callers baud rate is used instead.
  531.  
  532.  
  533.          SCREENS AND BULLETINS:
  534.  
  535.          You can choose which screens/bulletins you wish to have
  536.          available to your callers.  Any *.ANS or *.ASC files in
  537.          your Bbs TxtFiles directory can be set-up as a bulletin
  538.          or screen.  The user info and Bbs info codes will not
  539.          be translated (neither by MKQwk nor by the mail reader)
  540.          so you will want to avoid screens that contain those.
  541.          If the caller has ansi enabled, the *.ANS version is sent
  542.          if it exists, otherwise the *.ASC version is sent.  If
  543.          you wanted to move a copy of your "recent files in the
  544.          last 30 days" file to your txtfile directory and rename
  545.          it recent.asc, you could then set it up as a bulletin file.
  546.          I'm sure there are other uses some of you will find for this.
  547.          The screen names must be entered without file extensions as
  548.          MKQwk will pick the appropriate one.  You have up to 3 screens
  549.          and up to 10 bulletins.  Some QWK readers do not seem to
  550.          implement all of the ansi commands.  I've found that you can
  551.          minimize the problem by saving your ansi screens with the
  552.          line length set to "None" (ie start a new line only when a
  553.          new line occurs not on some shorter line length limit).
  554.          You will probably also want to save a block and not a full
  555.          screen, limiting the width since some readers add scroll
  556.          bars.
  557.  
  558.  
  559.  
  560.  
  561.                           MKQwk Qwk Mail Door              Page 11
  562.  
  563.  
  564.          FILE ARCHIVE PACKERS:
  565.  
  566.          MKQwk already knows the appropriate command lines for the
  567.          common file packers/unpackers.  All that is left for you
  568.          to configure is to indicate which ones you wish to make
  569.          available to your callers  (for unpacking replies, MKQwk
  570.          will detect which archive type the file is and call the
  571.          appropriate unpacker even if you have it set as not
  572.          active).  Use the normal [Spacebar] or [F7] [F8] keys to
  573.          toggle the active file packers.  DWC should be left
  574.          inactive since it will not handle the .QWK ane .REP file
  575.          extensions in any versions I have seen.
  576.  
  577.  
  578.          MKQwk USER EDITOR:
  579.  
  580.          A picklist of current users is shown as well as an item
  581.          called "---- New ----" which is optionally used to set
  582.          up users before they call.  Highlight the user you want to
  583.          edit and press [Enter].
  584.  
  585.          Protocol: a character A thru Z to choose which file transfer
  586.            protocol to use.  It should be set to match one of the
  587.            choice characters used during protocol setup.
  588.  
  589.          Packer: a character A thru Z to choose which file packer type
  590.            to use.  The current choices are L=Lzh Z=Zip A=Arc J=Arj
  591.            D=Dwc H=Hyp O=Zoo.
  592.  
  593.          Maximum Msgs: Set the maximum number of messages per QWK
  594.            packet.  Message pointers will be set to the highest
  595.            message exported, so multiple packet downloads can be
  596.            done (just make sure not to upload replies until the end
  597.            if you have it set not to receive mail back that you
  598.            send).
  599.  
  600.          Maximum Msgs Per Conference: Sets the maximum number
  601.            of messages that will be sent in each message area.
  602.            Some mail readers will need this set to 200.
  603.  
  604.          Send Screens: Determines whether Welcome, News, and Goodbye
  605.            screens will be included in the QWK packet.
  606.  
  607.  
  608.  
  609.  
  610.                           MKQwk Qwk Mail Door              Page 12
  611.  
  612.          Send Bulletins: Determines whether the bulletin screens
  613.            will be included in the QWK packet.
  614.  
  615.          New Files List: Determines whether a list of files dated
  616.            after the last time on will be included in the QWK
  617.            packet.  The New Files List creator is quite fast
  618.            (compared to an online new files search) and is worth
  619.            trying.
  620.  
  621.          Last Used MKQwk: Display Only - shows when the caller
  622.            last used MKQwk (or if they have never used it).
  623.  
  624.          Recv Own Msgs: Determines whether messages/replies that
  625.            have been uploaded should be included in the QWK packet
  626.            generated.  Note that it avoids sending them by setting
  627.            the message pointer higher than the uploaded messages
  628.            when the caller leaves the door.  In addition in non
  629.            net-status message areas it will also check the user
  630.            name against the from name on the message.
  631.  
  632.          Active Conferences: Another multiple choice picklist
  633.            that allows you to toggle message areas on or off.
  634.            Active areas are again flagged with an "*" in front
  635.            of them.
  636.  
  637.          Net Status Networks: A multiple choice picklist of
  638.            networks that the caller will have NetStatus in.
  639.            Unless you are participating in QWK format echomail
  640.            you should not set any of these.
  641.  
  642.          Flag Mail as Read: Determines whether mail that is
  643.            downloaded and is To You should be flagged on the
  644.            Bbs as having been received or not.  Flagging takes
  645.            place only after a successful download has been
  646.            completed.
  647.  
  648.          Recv All Your Mail: Determines whether a scan for mail
  649.            To You in message areas that you have not selected
  650.            will be done or not.  This keeps you from missing
  651.            your mail, but does add a little time to the scanning
  652.            process.  Note that only *unreceived* mail is sent, so
  653.            if you read your mail at log-on it will have already
  654.            been received (unless you're the sysop and unreceive
  655.            it).
  656.  
  657.          Mail Type: Currently on 2 types of mail packets are
  658.            supported.  Type 1 is the normal QWK format.  Type 2 is
  659.            a plain text packet.  Note that uploads (replies) are
  660.            NOT allowed with PLAIN TEXT packets.
  661.  
  662.          Send Empty Packets: Determines whether a packet should be
  663.            created (with Bulletins/screens/new files) when no msgs
  664.            are available for DL.
  665.  
  666.          Verify User Wants Packet:  When set to YES the caller will
  667.            be shown the packet size and asked if they want the
  668.            packet before it is sent.
  669.  
  670.  
  671.  
  672.  
  673.                           MKQwk Qwk Mail Door              Page 13
  674.  
  675.  
  676.          FAST ANSI CONFIG:
  677.  
  678.          Use this screen to quickly configure the areas that you
  679.          permit to contain ansi {esc} codes.  It is a multiple-
  680.          choice picklist, so you can use either [SpaceBar] or
  681.          [F7] [F8] and [Ctl] [Enter] to toggle the areas.  Press
  682.          either [Enter] or [Esc] when you have the areas set the
  683.          way you want them.
  684.  
  685.  
  686.          FAST HI-BIT CONFIG:
  687.  
  688.          A multiple-choice picklist to allow you to configure
  689.          message areas that will allow hi-bit characters.  Note
  690.          that most Fido echos do not allow this, but many other
  691.          echos do allow it.
  692.  
  693.  
  694.          FAST TAGLINE STRIPPING CONFIG:
  695.  
  696.          Another multiple-choice picklist.  This one allows you
  697.          to select which areas will strip the tagline put on by
  698.          the mail reader.  You need to know the rules for the
  699.          echos you are in to determine how to set this (generally
  700.          FIDO echos should strip taglines, while other networks
  701.          generally allow them).
  702.  
  703.  
  704.          FAST TEARLINE TEXT CONFIG:
  705.  
  706.          Another multiple-choice picklist.  This one allows you
  707.          to select which areas will keep any text with the readers
  708.          tearline when importing the message.  Note that this only
  709.          applies to echomail areas since tearlines are alwasy kept
  710.          in local and netmail areas.
  711.  
  712.  
  713.          FAST TAGLINE TO ORIGIN LINE CONFIG:
  714.  
  715.          Another multiple-choice picklist.  This one allows you
  716.          to select which areas will have reader taglines converted
  717.          into "Fido" compatible Origin lines (which may mean
  718.          truncating them if they are too long after the required
  719.          "Fido" info is added).  Again only applies to echomail
  720.          areas.  Generally when this is set, you should set
  721.          Strip Taglines to YES to avoid repetition.
  722.  
  723.  
  724.  
  725.  
  726.                           MKQwk Qwk Mail Door              Page 14
  727.  
  728.  
  729.          NETMAIL:
  730.  
  731.          MKQwk add support for Fido-style Netmail even though
  732.          the QWK readers were not designed to handle it normally.
  733.          The one thing missing from a normal message that is
  734.          required for netmail is the destination address and
  735.          flags.
  736.  
  737.          MKQwk interprets the subject of the message as containing
  738.          a destination address if it starts with an "@" sign.  It
  739.          understands both full addresses as well as a variety of
  740.          short-form addresses (where the remaining part of the
  741.          address is based on the main address or AKA for the netmail
  742.          message area.  After the address you may optionally
  743.          include the words CRASH IMM and/or DIR.  These will give
  744.          the message the attributes of crash, immediate and/or
  745.          direct netmail respectively.  Some examples (assuming an
  746.          address of 1:110/290 would be:
  747.  
  748.          @151/223 IMM       send to 1:151/223 and flag as immediate
  749.          @1:274/40          send to 1:274/40
  750.          @270 CRASH         send to 1:110/270 as crash mail
  751.          @.1                send to 1:110/290.1
  752.  
  753.          On messages exported from the Bbs, the subject line will
  754.          contain the originating address for netmail areas.  This
  755.          was done to allow you to reply without entering an address,
  756.          since it will already be in the subject line.
  757.  
  758.          If you want the subject to look normal on the netmail messages
  759.          you write, you need to use the first message text line as the
  760.          subject and start it with "Subj:".  Example:
  761.  
  762.          Subj: Qwk message readers
  763.  
  764.          Note that because of the security problems that would be
  765.          created, that MKQwk does not support File requests nor
  766.          File attaches.
  767.  
  768.  
  769.  
  770.  
  771.  
  772.                           MKQwk Qwk Mail Door              Page 15
  773.  
  774.  
  775.          CONFIGURATION MESSAGES:
  776.  
  777.          MKQwk supports both old and new style configuration messages
  778.          which may be addressed to MKQwk, Qmail, or most of the other
  779.          popular Qwk door names.
  780.  
  781.  
  782.  
  783.          Old style config messages have the following options for subjects:
  784.  
  785.          ADD            Adds the current message area
  786.          DROP           Drops the current message area
  787.          RESET nn       Resets message pointer to message number "nn"
  788.          BLTS On/Off    Turns bulletins on or off
  789.          FILES On/Off   Turns new files list on or off
  790.          WELCOME On/Off Turns screens on or off
  791.          GOODBYE On/Off Also turns screens on or off
  792.  
  793.  
  794.  
  795.          New style config messages have a subject of CONFIG and have
  796.          one command on each text line of the message.  The following
  797.          commands are available.
  798.  
  799.          ADD nn         Adds message area "nn"
  800.          DROP nn        Drops message area "nn"
  801.          RESET nn xx    Resets lastread pointer in area "nn" to number "xx"
  802.          PROTOCOL x     Sets protocol choice to "x"
  803.          PACKER x       Sets archive packer choice to "x"
  804.          MAXNUMBER nn   Sets maximum number of messages per area to "nn"
  805.  
  806.  
  807.  
  808.          The Qwk readers can create some of these messages on their
  809.          own when certain options are chosen from their menus.  Thus
  810.          users need not be aware that messages are used to pass the
  811.          config information.  The commands listed here are the only
  812.          ones supported currently by MKQwk.
  813.  
  814.  
  815.  
  816.  
  817.                           MKQwk Qwk Mail Door              Page 16
  818.  
  819.          BATCH MODE:
  820.  
  821.          MKQwk can also be run in batch mode without logging into
  822.          your Bbs.  To do this just run it with a command line
  823.          parameter of L followed by your first and last name
  824.          (matching what is in your Users.Bbs record).  In either
  825.          Batch mode or Local Log-On mode, MKQwk will check for
  826.          *.REP files in the current directory and also create its
  827.          *.QWK files in the current directory.
  828.  
  829.          If you want to upload only use a command line parameter
  830.          of U followed by first and last names.
  831.  
  832.          Examples:
  833.  
  834.          MKQwk L Mark May      {imports REP file and creates QWK file}
  835.  
  836.          MKQwk U Mark May      {imports REP file only}
  837.  
  838.  
  839.          Since the standard among QWK based readers is to handle
  840.          files named either *.QWK or *.QW1 thru *.QW9, you can
  841.          further automate the process by using something like the
  842.          example LOCAL.BAT file that is included with MKQwk.  It
  843.          does a series of If Exist ... Rename commands.  To use
  844.          LOCAL.BAT you should bring it up in a text editor and do
  845.          a search and replace on BBSID to change it to your BoardId.
  846.          You will also need to change the line with FirstName LastName
  847.          to your name.  You may also need to edit the commands at the
  848.          beginning that change drives and directories.  You can then
  849.          just add a line to your batch file that processes incomming
  850.          mail to do a "Call Local.Bat", and you will have your mail
  851.          all packed up and waiting for you.
  852.  
  853.          If you need to handle more than the QWK and QW1 thru QW9 that
  854.          the QWK standard allows, you will need to use one of the
  855.          utilities that merge multiple QWK packets into one QWK packet.
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.                           MKQwk Qwk Mail Door              Page 17
  865.  
  866.          MKQSTAT:
  867.  
  868.          This is an added little utility that you can run from the
  869.          command line.   It reads the MKQwk user file (Users.Mkq)
  870.          and counts how many users have each message area turned
  871.          on and produces a short report with the totals.
  872.  
  873.          By default this report is sent to the screen, but output
  874.          maybe redirected to a file ('>C:\TXTFILES\ACTIVE.ASC')
  875.          or to a printer ('>PRN') using the normal dos redirection
  876.          command line format (as shown).
  877.  
  878.          The time it takes to produce the report will depend on
  879.          the number of MKQwk users that you have.
  880.  
  881.          You may find this report useful when you need to decide
  882.          about adding or dropping message areas.
  883.  
  884.  
  885.  
  886.  
  887.  
  888.                           MKQwk Qwk Mail Door              Page 18
  889.  
  890.          LASTREAD POINTERS:
  891.  
  892.          MKQwk uses the LastRead.Bbs pointers (which has a separate
  893.          lastread pointer individually for each message area).  This
  894.          allows much greater flexibility to your callers than using
  895.          the "combined" lastread pointer that is located in the
  896.          user record.
  897.  
  898.          Because this may be different than how other offline mail
  899.          doors have handled LastRead pointers, it may seem confusing
  900.          to your callers.  In particular if they are CONVERTING from
  901.          ANOTHER MAIL DOOR they will need to make sure to update their
  902.          area LastRead pointers prior to downloading a mail packet to
  903.          prevent getting messages they have already received.  To do
  904.          this they should first select the areas they want to receive
  905.          and then choose (R)ESET lastread pointers in all selected
  906.          areas from the main menu.  It will show them what their
  907.          "combined" lastread pointer was set to and allow them to
  908.          enter it to globally reset their lastread pointers to this
  909.          value.
  910.  
  911.          Another difference from other offline mail doors is in
  912.          how the scan for "Your" messages is done.  When you have
  913.          enabled the scan all areas for Your Mail, MKQwk looks
  914.          through all messages in unselected areas and includes ones
  915.          that are to you and also marked as unreceived.  This allows
  916.          you to get messages below your lastread pointers if you haven't
  917.          seen them and keeps you from getting messages above your last
  918.          read pointers that you have read (sysops who want to get their
  919.          mail after reading it at log-on need to use the "=" toggle to
  920.          mark messages as unreceived when reading it online).  (Note
  921.          the scan for yours in all areas could be compared to what
  922.          RA will do in a full mailcheck for your mail).
  923.  
  924.          I may add a config option to allow MKQwk to use the combined
  925.          LastRead pointer in a future version, but I strongly believe
  926.          that the current approach is better.
  927.  
  928.  
  929.  
  930.                           MKQwk Qwk Mail Door              Page 19
  931.  
  932.  
  933.          SUPPORT:
  934.  
  935.          You may leave questions or get the latest version by
  936.          calling:
  937.  
  938.          Mythical Kingdom Tech Bbs
  939.  
  940.          Phone (513) 237-7737 9600 baud HST/V32
  941.          FidoNet            1:110/290
  942.          RIME (RelayNet)    ->MYTHKING
  943.  
  944.          Since this is a Free utility, if you Netmail a question you
  945.          will need to poll (in a day or two normally) to get your
  946.          answer.  If you fail to poll for a reply, I will delete the
  947.          answer after a week or two.
  948.  
  949.          For more generic questions that may also help others you may
  950.          want to use the FIDO RA_UTIL echo (but NOT RA_SUPPORT) or the
  951.          RIME Remote Access conference or RIME Offline Mail conference.
  952.          I also normally read the FIDO SUPERBBS and FIDO QUICKBBS echos.
  953.  
  954.          If you would like more ongoing support access, you may want to
  955.          pick up the MK echo (Fido style) for info/support on all of
  956.          the M K Software programs.  Currently it is available from a
  957.          few Bbs's, although it will hopefully become more widely
  958.          available.
  959.  
  960.  
  961.  
  962.  
  963.  
  964.                           MKQwk Qwk Mail Door              Page 20
  965.  
  966.  
  967.  
  968.          REGISTRATION:
  969.  
  970.          A registration fee is not required for these programs.  I
  971.          believe that the Bbs world is becoming too commercialized
  972.          and distribute my programs as FREEWARE to fight against
  973.          that trend.  If you are a shareware author, consider
  974.          sending me a registered version of your program in
  975.          exchange for your use of this program.
  976.  
  977.          I would appreciate it if you would either fill in the
  978.          form below and return it to me, or to drop me a postcard.
  979.          This will help in measuring the usefulnes of MKQwk and
  980.          help in determining how time is allocated between this
  981.          and other projects.
  982.  
  983.  
  984.          Registration Information:                  MKQwk v1.02
  985.  
  986.  
  987.           Name:         ____________________________________________
  988.  
  989.           Address:      ____________________________________________
  990.  
  991.                         ____________________________________________
  992.  
  993.           City, ST Zip  ____________________________________________
  994.  
  995.  
  996.           Bbs Name:     ____________________________________________
  997.  
  998.  
  999.           Bbs Phone Number  (     )        -
  1000.  
  1001.           Any suggestions or comments ______________________________
  1002.  
  1003.           __________________________________________________________
  1004.  
  1005.           __________________________________________________________
  1006.  
  1007.  
  1008.           Registrations should be mailed to:
  1009.  
  1010.           Mark May
  1011.           Mythical Kingdom Software
  1012.           P.O. Box 24808
  1013.           Huber Heights, OH 45424
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.                           MKQwk Qwk Mail Door              Page 21
  1020.  
  1021.  
  1022.          Other Mythical Kingdom Software Bbs utilities include:
  1023.  
  1024.          MKTODAY - a configurable today's callers screen
  1025.             generator.  With this your Today's callers screen won't
  1026.             have to look like everyone elses. (RA/Qbbs/Sbbs).  Also
  1027.             generates yesterday's callers and summary history screens.
  1028.  
  1029.          MKUTI - a set of UTI drivers to allow Quickbbs, Remote Access,
  1030.             and SuperBbs to work with PC-Relay (RIME) and with the
  1031.             MegaMail mail door (although now that MegaMail reader supports
  1032.             the QWK format, you'll probably just want to use MKQwk)
  1033.  
  1034.          MKWAM - a Quickbbs/Remote Access interface to WAM format messages
  1035.             for use with HyperMail style networks.
  1036.  
  1037.          MKNEW - a FAST new files lister for Quickbbs. (NOTE - has
  1038.             problems with some systems due to use of direct COMM support
  1039.             the next version will use the fossil driver and will also
  1040.             even further substantially increase speed by switching to
  1041.             the method used in MKQwk).
  1042.  
  1043.          MKXRS - an XRS message/reply tosser that improves
  1044.             security over the normal method of using an echomail
  1045.             tosser and provides the sysop with several options.
  1046.             Messages are quickly tossed while the caller is still
  1047.             online.
  1048.  
  1049.          MKNET - a QWK mail network interface for Remote Access
  1050.             (preforms the function that Qnet or Rnet perform for PCB
  1051.             for RA, so that RA Bbs's can participate in QWK networks).
  1052.  
  1053.          Special thanks to the people who helped in Beta testing this
  1054.          program, especially to Jim Hale for putting together the
  1055.          docs on how to use it with Quickbbs (once Quickbbs is out of
  1056.          beta/gamma I hope to again add direct support for Quickbbs).
  1057.          Thanks to the many people who have made suggestions that
  1058.          have allowed newer versions to be improved.
  1059.