




























                   __________________________________________
                  <                                          >
                  < MTQwk -- Version 1.1                     >
                  < Copyright 1994 by Tom Johnson            >
                  < A QWK door for Mutant BBS - Jan 08, 1994 >
                  <__________________________________________>
                   




                                Table of Contents


     Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . .    1

     Legal Stuff . . . . . . . . . . . . . . . . . . . . . . . . . . .    1

     Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    1

     MTQWKCFG  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    2
          Main MTQwk Configuration . . . . . . . . . . . . . . . . . .    2
          Message Area Configuration . . . . . . . . . . . . . . . . .    5
          Protocol Configuration . . . . . . . . . . . . . . . . . . .    5
          Screen Filenames . . . . . . . . . . . . . . . . . . . . . .    6
          Packer Configuration . . . . . . . . . . . . . . . . . . . .    7
          Edit Users . . . . . . . . . . . . . . . . . . . . . . . . .    7
          Quick Area Config  . . . . . . . . . . . . . . . . . . . . .   10

     MTQWK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   11

     Running MTQWK . . . . . . . . . . . . . . . . . . . . . . . . . .   11
          Main Menu  . . . . . . . . . . . . . . . . . . . . . . . . .   12

     Cavets  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   13
          Limitations of QWK . . . . . . . . . . . . . . . . . . . . .   13
          Net Mail . . . . . . . . . . . . . . . . . . . . . . . . . .   14
          Add/Drop . . . . . . . . . . . . . . . . . . . . . . . . . .   14

     Net-Status  . . . . . . . . . . . . . . . . . . . . . . . . . . .   14
          Creating a Net-Status User . . . . . . . . . . . . . . . . .   14
          Pre-Generating Packets . . . . . . . . . . . . . . . . . . .   15




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----           Page 1

                                  ------------
                                  Introduction
                                  ------------

          MTQWK is a QWK door for Mutant BBS.  QWK is the most popular file
     format for  offline mail reading.   It is  also used in  many echomail
     networks instead of the Fido standard.  MTQWK will allow your users to
     download new messages and  upload posts/replies into Mutant.   It also
     allows for you  to be the hub in a QWK  network by giving "net-status"
     access to certain users.

                                   -----------
                                   Legal Stuff
                                   -----------

          MTQWK is  provided AS IS  and no  express warranties apply.   You
     (not the  author) assume  responsibility for  any problems or  damages
     that you  may encounter while running this  software.  However, if you
     do  find problems,  please let  the author  know so  that they  can be
     corrected.   This program  is  not guaranteed  to be  bug  free, so  I
     recommend backing up often.

          MTQWK can  be distributed freely.   You may not  modify any files
     found within the MTQWK archive (you may modify the archive format).

                                      -----
                                      Setup
                                      -----

     To setup MTQWK, follow these simple steps:

     1.   Make a subdirectory somewhere on a hard drive.
     2.   Place all files in the archive into that directory.
     3.   Move MTQ-*.* into your Mutant screens directory.
     4.   Run MTQWKCFG (see below)
     5.   In Mutant create a type 501 door with optional data:
               "dir\mtqwk", 

               "dir" is the directory you made.
     6.   Create an  event to run at  least once a week  with the following
          data:
               "dir\mtqwk /D30" (see below)
     7.   You may wish to  add a sysop command to pass in  the /M parameter
          to  MTQWK, i.e. "dir\mtqwk /M" which allows MTQWK to move invalid
          messages to where they were supposed to go.




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----           Page 2

     NOTE: If you had SETUP unpack the QWK files, it has already done steps
     1-3.  The sample files are also setup to handle step 5 with  'X' being
     a global command to access MTQwk as a door and step 6 except the event
     is not active like most of the other events in the sample files.

     SUGGESTION: Setup your message areas within Mutant first!

                                    --------
                                    MTQWKCFG
                                    --------

          You can run  MTQWKCFG without  any parameters as  long as  Mutant
     resides  in  your path.   Otherwise,  run it  with  the full  path and
     filename  of  Mutant's configuration  file.    For example,  "MTQWKCFG
     c:\mutant\config.dat".  You will  then see the main  menu.  Using  the
     cursor keys select an option and hit ENTER.   Hit ESC (or select Quit)
     to exit MTQWKCFG and save the configuration.

     Main MTQwk Configuration
     ------------------------
          Using all  four cursor keys move  around the screen and  edit the
     fields.  You do not have to hit ENTER to edit a field unless it has  a
     "*" in  the field.   If you the  first key you hit  at the start  of a
     field is a character key, the field  is cleared to allow you to  enter
     new data.  Otherwise, you can insert/delete the data.

     Bbs Id:             This is a  required identification  for your  BBS.
                         It can be  up to  8 characters long  and can  only
                         contain   characters  which   are  valid   in  DOS
                         filenames.   It should be an  abbreviation of your
                         BBS name  so that  your users can  easily identify
                         it.   This is used to generate the QWK packets and
                         other associated files.

     Force User Name:    If  set to "Yes", MTQwk will use the users name on
                         the  BBS  in the  "From:"  fields.   If  the  base
                         supports  anonymous  strings,  MTQWK   will  allow
                         whatever  was used  if  the user  meets  anonymous
                         SACS.   If the base is any sort of echotype, MTQWK
                         will always force the user name.

     Maximum Msgs:       This  is maximum  number  of messages  a user  may
                         download  in one packet.  I allow up to 32767, but
                         most  QWK  documentation  I have  states  that  it
                         should  be set to a maximum  of 2000.  I find this
                         limiting especially  if you have 1000  areas!  You
                         can also use  -1 for unlimited!   NOTE: this  only
                         affects  what  the user  can select  within MTQWK.
                         You may  set this higher  for the user  within the




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----           Page 3

                         user editor.

     Max Msgs Per Conf:  This is  the maximum number of messages a user may
                         download per area.  All notes about "maximum msgs"
                         apply.

     Redate Msgs:        If this is  set "Yes", MTQWK will use  the current
                         time as the post  time instead of the time  in the
                         QWK header.   NOTE: if the QWK  header is invalid,
                         MTQWK does this anyway.

     New Files:          This allows  you to  control whether the  user may
                         receive a  new file listing in  their mail packet.
                         Set  to "No" to disable the feature.  Set to "Yes"
                         to force the list.   Set to "Ask" to allow them to
                         choose.

     Send Screens:       This   determines    whether   Welcome/News/Logoff
                         screens  are sent  to  the user.   The  No/Yes/Ask
                         options work the same as new files.

     Send Bulletins:     This  controls whether Bulletins  are sent  to the
                         user.  The options  are the same as above.   NOTE:
                         when MTQWK  only sends "new"  bulletins, i.e. ones
                         whose  file date is greater than the last time the
                         user logged on.

     Norm Netmail Cost:  This controls  the cost of a  netmail message when
                         none of the following costs are used.  NOTE: MTQWK
                         uses these  rather than perform a  nodelist lookup
                         like Mutant  does.  I  recommend disabling netmail
                         bases if you desire the nodelist lookup.

     Crash Netmail Cost: This specifies the cost  of a netmail message when
                         it  has its "crash" bit set.  This only applies if
                         the following are not used.

     MyNet Netmail Cost: This specifies the cost  of a netmail message that
                         is sent  within your zone  and net.   MTQWK checks
                         both the  base  address  and  the  system  configs
                         address  to make  sure  this is  valid.   Normally
                         you'd  set this  0, but  I know  I have  some FIDO
                         nodes  in Richmond's  net  that I  can't call  for
                         free.

     InterZone Nm Cost:  This specifies  the cost  of sending a  message to
                         another zone (i.e. from the US to Europe).




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----           Page 4

     Default Msg Area:   This is  required  and specifies  a valid  message
                         area  where MTQWK  should  toss  messages when  it
                         can't post them in  the correct area. MTQWK writes
                         out all the problems to  the message text and sets
                         its invalid flag.  You can  then either delete the
                         message,  or  remove  the  invalid  flag  and  use
                         MTQWK's "/M" parameter to move them.

     Limits.Ctl:         Mutant features the ability  to limit postings per
                         call.  However, you may not wish these to apply to
                         mail  packets since  the  user is  saving time  by
                         posting them offline.  The three options are:

                         "Ignore&add" - Don't treat the  message as bad  if
                                        the   user   exceeds  the   limits.
                                        However,  the  variables are  still
                                        incremented.
                         "Use" -        Limits  are  checked and  variables
                                        are  incremented.    This  is  what
                                        Mutant uses.
                         "Ignore" -     Limits   are    ignored   and   the
                                        variables aren't  incremented.  All
                                        Net-Status  users  for an  area are
                                        treated this way.

     Attach Limit:       This is the  total size of  all file attaches  the
                         user may download  in Kilobytes.  If  you set this
                         to  65535, it  is  unlimited.   Like the  maxmimum
                         messages, you may set a number higher than this in
                         the  user  editor  in  order  to  give  net  users
                         unlimited access.

     Bbs Phone Number:   This is  used to  generate CONTROL.DAT in  the QWK
                         packet.  I didn't specifically require any format,
                         so you can enter anything if you want.

     BBS City, State:    Like above, this is only  used in the QWK  packet.
                         I recommend using the format "City, ST".

     Local Path:         If  you desire  to use  MTQWK locally,  MTQWK will
                         place .QWK  packets in this path,  and expect .REP
                         packets in this path.




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----           Page 5

     Message Area Configuration
     --------------------------
          You will be displayed a list of  all 1000 areas.  An '*' will  be
     placed to the left  of the area number if the area  is available.  Use
     Up/Down/Left/Right/PgUp/PgDn, to select an area and  hit ENTER to edit
     it.  Hit ESC when done.

     Short Name:         This is a 12-charcter  name for the base.   If you
                         leave  it  blank,  MTQWK  will use  the  first  12
                         characters   of  the  base   name  when  exporting
                         messages.

     Available:          If you set this to "No", the user can never access
                         the area.  If you  set this to "Yes", the  user is
                         forced  to receive  the area.   If  you set  it to
                         "Ask",  the user can select  it.  NOTE:  if a user
                         has net-status  for a  base, it  is always set  to
                         "Ask".

     Strip Taglines:     Allows you to  strip taglines  from either  normal
                         users, netusers, or both.   If the base is  a FIDO
                         base, I  recommend setting this.   NOTE: a tagline
                         begins  with  a  space,   followed  by  either  an
                         asterisk or ASCII-254, and then another space.

     Net Tearlines:      This controls  how lines  that begin with  a "---"
                         are treated.   Some Fidos  frown on more  than one
                         tearline per  message.  By setting  this to "keep"
                         it  is left  as is.   "Remove" removes  the entire
                         line.   "Translate"  turns the  "---" into  "===".
                         This option is for net-status users.

     Normal Tearlines:   Like above but applies to normal users.

     Networks:           Allows  you to  specify the  "networks"  that this
                         area  belongs to.  An area can belong to more than
                         one network  to allow  gating.  Users  are granted
                         "net-status" to the area if one (or more) of their
                         networks  matches  one  (or  more)  of  the  areas
                         networks.

     Protocol Configuration
     ----------------------
          MTQWK allows for up to 10 protocols.  At this time MTQWK does not
     support bidirectional protocols.

     Name:               This  is   the  name   of  the  procotol   to  aid
                         recognition of the protocol.




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----           Page 6

     Active:             If   "Y",  the  user   can  select  the  protocol.
                         Otherwise they can't.

     Choice Key:         The key the user will use to select the protocol.

     Upload:             The  command to upload a mail packet to MTQWK.  If
                         the  utility  is  not  an  EXE,  you  specify  the
                         extension.  Also, if  it is not in your  path, you
                         must specify the path.

     Download:           The command to send a mail packet to the user.

                         Either of these commands can contain the following
                         sequences:

                         "%1" -    comm port
                         "%2" -    callers bps (or their real baud rate)
                         "%4" -    The file to be sent.
                         "%9" -    The locked  baud rate.   If you  are not
                                   using locked bauds,  do not use this  as
                                   MTQWK will not pass a valid valiue.

                         NOTE: MTQWK will change to the temporary directory
                         during the file transfer.

     Screen Filenames
     ----------------

     Hello Screen File:  Most readers display  this after they've  unpacked
                         the QWK packet and before the user reads messages.
                         This can  have a .ASC  or .ANS extension  and must
                         reside in Mutant's screen directory.

     News Screen File:   This  is some sort of news  file.  I can be either
                         .ASC  or  .ANS  and  must reside  in  the  screens
                         directory.

     Goodbye Scrn File:  Like above, and is usually displayed when the user
                         decides to stop reading the packet.

     Bulletin Name:      You can define up to 10 bulletins.  These can have
                         a .ASC  or .ANS extension  and must reside  in the
                         screens directory.  If these are sent to the user,
                         MTQWK only sends those  which are dated later than
                         the last time the user logged on.  Therefore, this
                         should  be bulletins  that are  updated with  some
                         frequency such as top download lists, etc.




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----           Page 7

     Packer Configuration
     --------------------
          This  is where  you  define the  archivers/unarchivers which  the
     users can use.

     Name:               The  name of  the  archive format.   For  example,
                         Pkzip,  Lharc, etc.   If  you  are using  Pkzip, I
                         recommend setting up both Pkzip 2.0+ and Pkzip 1.1
                         to accomodate both users.

     Active:             If  set to  "Y", the user  can select  the archive
                         utility.

     Choice Key:         The key the user must press to select the utility.

     Pack:               The name and command line to pack files.

     Unpack:             The name and command line to unpack files.

                         These should include:

                         "%1" -    the packet filename.
                         "%2" -    what  to pack  or  where  to unpack  to.
                                   MTQWK  adds  a  trailing  backslash  for
                                   Lharc users.

     Edit Users
     ----------
          Selecting "--- New  User ---" will  create a new user.   Hitting,
     DELete  on  a  user will  delete  the  user.    The letters  given  in
     parentheses  below  are  the  keys  the  user  uses  in  MTQWK's  user
     configuration screen.

     User Name:          Only change this if for some reason you change the
                         user's name in  Mutant.  This  must be their  user
                         name, not their real name.

     Protocol (P):       This is the "choice key" of the selected protocol.

     Packer (A):         This is  the "choice key" of  the selected archive
                         utility.

                         Because  only  the  keys  are  stored,   I  highly
                         recommend  you  don't  change  protocols/archivers
                         once users have used MTQWK.

     Maximum Msgs (M):   The maximum messages the  user wants to receive in
                         their  packet.  The user is not allowed to enter a
                         value  which exceeds  the value  specified  in the




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----           Page 8

                         configuration.

     Max per Conf (C):   The maximum  messages per message area.   The user
                         is not allowed to enter  a value which exceeds the
                         value specified in the configuration.

     Send Screens (S):   If  you  allowed "Ask",  the  user  is allowed  to
                         change the value.  Otherwise, MTQWK  uses whatever
                         you specified in the configuration.

     Send Bulletins (B): Same as screens, but applies to bulletins.

     New Files List (N): Like screens,  but applies to generation  of a new
                         file listing.

     Last Used MtQwk:    Shows  the last time  the user used  the door. You
                         can't change this value easily.

     Recv Own Msgs (O):  If  set to Yes,  messages the user  posted will be
                         allowed to be sent back to the user.

     Active Conferences: Hit ENTER  to pull up  a list of  conferences, and
                         then   you  can   use  ENTER   to  select/deselect
                         conferences.   If  you select  one which  the user
                         doesn't  have access to,  it will be  ignored.  If
                         the user is a new user and if you selected any net
                         status networks, MTQWKCFG  will select those areas
                         in which the user has net status.

     Net Status Netwrks: Hit  ENTER  to  pull  up  the  list  of  networks.
                         Usually a user  will only be part  of one network,
                         but  you may  select  more.   If  the user  has  a
                         network  that matches  an areas network,  the user
                         has "net-status" access.

     Flag Mail as Rd(F): If the message  is to  the user and  this is  set,
                         MTQwk  will  mark  the message  as  received  upon
                         successul packet transmission.

     Rcv All Mail(Y):    If set to "Yes", MTQwk  will screen each area from
                         message one.   Otherwise, MTQwk will  start at the
                         user's lastread pointer.

     Rcv Zero Msg (Z):   If set to "No", and a mail packet doesn't have any
                         messages,  the packet  building  will be  stopped.
                         Setting to "Yes" will  allow receipt of bulletins,
                         and new file lists.




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----           Page 9

     Color Scrns/Bul(V): Controls whether  .ANS  or .ASC  screens  will  be
                         sent.   It  also removes color  from the  new file
                         list if set to No.

     Lo-Bit(L):          This is  the same as Mutant's  strip lo-bits flag.
                         Even  if this isn't set, MTQwk  will not send Fido
                         Kluge  lines.   Normally, Mutant  messages  do not
                         have control  characters,  but this  is there  for
                         completeness.

     Hi-Bit(H):          If  set to  "Yes", the user  will not  receive any
                         characters whose value is >127.

     Convert Ansi(T):    If  set to "Yes", all ESC's in the message will be
                         converted  to back apostrophes.   This is executed
                         before the Lo-Bit option above.

     Mutant Color(R):    Controls  how  Mutant's  CTRL-P  color  codes  are
                         treated.  If set to "No", they will be sent as is.
                         If  set  to  "Yes",  they  will  be  removed  from
                         messages.    If set  to  "Convert",  they will  be
                         converted  into ANSI color  codes. If  you convert
                         them, the convert ANSI flag is run afterwards.

     Add Origin:         This  applies to net-status users for an area.  If
                         this  is  "Yes",  MTQwk  will add  your  tear  and
                         tag/origin-line to the message.   If the area is a
                         FIDO echo base, MTQwk will  always add a tear  and
                         origin line.  You would normally leave this set to
                         "No".  It is  only useful if a system  calling you
                         doesn't generate the proper lines.

     Forced Exclude:     If set to "Yes", any message base which  is forced
                         ("Yes")  will be  converted to  "Ask".   You would
                         primarily do  this for net-users if you're forcing
                         your  normal users to  receive certain local areas
                         (such as E-Mail!)

     Attach Limit(I):    This is the maximum  size (in kilobytes) all files
                         attached to messages can be.  If the user tries to
                         modify  this over  the  configuration  limit,  the
                         configuration limit is used.




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----          Page 10

     Recv All Attaches:  If  "Yes", any files  attached to  public messages
                         will be sent  to the  user.  If  "No", only  those
                         files attached to messages  which are To: the user
                         will  be sent.    NOTE: Mutant  normally does  not
                         allow  file  attachments to  non-private messages,
                         but this  door allows for  it. (no  key in  config
                         since part of Attach limit command.)

     Wrap Text(W):       Mutant  stores  text  edited within  its  internal
                         editors  with  a  CRLF  only  at  the   end  of  a
                         paragraph.   Some  off-line readers  (such as  OLX
                         2.1) can't handle  this format while  others (such
                         as Blue  Wave 2.12) can.   By setting  this, MTQWK
                         will wrap the text with 78 columns per line.

     Quick Area Config
     -----------------
          This  allows  you  to  setup "default"  configurations  for  your
     message areas.  Use the cursor keys to select a default.

          ENTER -   Edit Default settings
                    These  are  the  same  as in  the  area  configuration.
                    "Name"  is a name you can  give the default in order to
                    recognize it later.
          SPACE -   Assign defaults to select areas.
                    This pulls up the  message area listing.  Hit  ENTER on
                    each area to which you wish to apply the defaults.  Hit
                    ESC when done.
          DELete-   Delete a default
          ESC   -   Quits




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----          Page 11

                                      -----
                                      MTQWK
                                      -----

     Running MTQWK
     -------------
     To run MTQWK, use:

          MTQWK [/Dx|/M|/P user name]

          "/Dx" -        Remove  duplicate message  info.   The 'x'  is the
                         number of days.  
          "/M" -         Scan "default_msg_area" for  invalid messages  and
                         the  MTQWK error  messages.   Any message  that is
                         found will  be moved to the  proper area specified
                         when  the  reply packet  was  uploaded.   It  also
                         removes MTQWK's error message text.  Use this once
                         you've  determined that  MTQWK  was  in error  for
                         thinking the message was bad.
          "/P" -         Pre-generate a QWK  packet for a  user.  See  pre-
                         generated packets below.

     If you  do not  specify /D,  /M or  /P, MTQWK  will display it's  logo
     screen, initialize, and then go to the main menu.

     If you do not  run MTQWK from within Mutant (why  would you do that?),
     you will need to set the  MTNTRUN environment variable which takes the
     form:

     MTNTRUN=d:\path\config.dat node

     where  the first  parameter  is the  full path  and  filename of  your
     configuration file and the second parameter is  the node number (0 for
     non-multinode).




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----          Page 12

     Main Menu
     ---------

     (D)ownload Mail:    MTQwk will  start scanning  the areas for  the new
                         messages,  generate a  file listings, etc.   Then,
                         the  user will be asked if the wish to receive the
                         packet.     If  so,   it  will  be   archived  and
                         transmission  will  commence.    If  you   are  on
                         locally, the  packet will  be copied to  the Local
                         Path  rather than  transmitted.   NOTE:  if  MTQwk
                         finds  a .QWK  in the  temporary directory  at the
                         start  of  this  command,    it  will  assume  the
                         download  failed  and ask  if  the  user wants  to
                         transmit it again.

     (U)pload Mail:      If on locally, MTQwk will look for the .REP packet
                         in  Local Path.   Otherwise,  if it  finds  a .REP
                         packet  in   the  temp  path,  it   will  use  it.
                         Otherwise, it will start the upload.

     (C)onfigure:        Takes the user to  the configuration screen.  (see
                         user editor above for keys)

     (A)uto Script:      Does upload, then download in one command.

     (S)elect Areas:     The  user  can  select/deselect  areas  which  are
                         available as  "ask" and in which  they meet access
                         requirements.   If they  select an area,  they can
                         also reset  their last read pointer  to a specific
                         message number.   NOTE:  the last read  pointer is
                         the  last  message  read  and  new  messages   are
                         messages after it.

     (I)nclude Help:     MTQ-USER.HLP  is  sent as  Bulletin 14  during the
                         next download.

     (R)eset Lastread:   The user can either set all lastread pointers to a
                         specific message  number or receive  the last  'x'
                         amount of messages.  If the specific number is out
                         of range for an area, it is set to the last number
                         of  an area.  If  the last amount  is out of range
                         for an area, it is set to 0.

     (G)oodbye:          Should Log the user off the door AND the BBS.

     (Q)uit:             Quits back to the BBS




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----          Page 13

                                     ------
                                     Cavets
                                     ------

     Limitations of QWK
     ------------------
          QWK format has may limitations in relation to Mutant.   I'll list
     what they are and how MTQwk handles (or doesn't handle) them.

     1. 25 Character Names -  MTQwk does nothing about this except truncate
                              a long name.   I would  warn users with  long
                              names that  they may have  problems receiving
                              their mail or using MTQwk.

     2. Only one username -   MTQwk uses  the user name for  the most part.
                              If you've specified that a base is Realnames,
                              there's  a good  chance  MTQwk will  use  the
                              user's real name instead of their user name.

     3. No anonymous support- Any replies made to an  anoymous message will
                              not get  back to  the original sender  of the
                              message.  The Sponsor Alias is not supported.
                              If you have "Anon 1|2" as your type, the user
                              can use the "Anon 1|2" string (provided  they
                              know  what it  is).   If  you specify  use an
                              alias, any  name is allowed.   If you specify
                              force an  alias, the  user can NOT  use their
                              user name.
     4. Pvte Netmail replies- As  MTQwk  can not  get  the  address of  the
                              original  echo  mail  message, the  reply  is
                              tossed as bad.
     5. Net Mail -            QWK  has no  support for  addresing, but  see
                              below.
     6. File Attaches -       As long as the  file is within attach limits,
                              it can be  sent with the  QWK packet.   MTQWK
                              allows  users to attach  files to ANY message
                              provided    they    meet   attach    security
                              requirements.   MTQWK  uses  the  Tomcat  (by
                              Mustang Software) file attach format.

     SACS
     ----
          Some  Security  Access Code  Strings  were  unable  to be  tested
     without extensive code additions.  Therefore, here  is a list of codes
     which  aren't supported or work differently.   Except for '~', I doubt
     you will really use any mentioned in your message/file areas.

     ~ -  As stated in MUTANT.TXT, this is True.
     L -  Last result not passed from Mutant.  Therefore, this value should




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----          Page 14

          be considered undefined.
     C -  MTQwk does not  parse the chat hours, and  therefore this code is
          not available.
     I -  These are never parsed out in to speed up execution.

     Net Mail
     --------
          MTQwk has  some support for  the use of  netmail in QWK  packets.
     When exporting messages,  MTQwk sets the subject  of the QWK  field to
     the  origin address in  the format  "@zone:net/node.point" and  adds a
     "Subj:" line in the message text.
          To  post a netmail message, enter the destiniation address in the
     subject as given above and optionally enter "Subj:" in the first  line
     of your  message.  Users can also optionally specify "CRASH" after the
     address and if they meet Crash SACS, the "crash" bit will be set.

     Add/Drop
     --------
          By sending a message to "MTQWK" in the desired area, the user can
     optionally  select/deselect areas  offline.  To  add an  area, specify
     "ADD"  in the  subject.   To  remove an  area, sepcify  "DROP" in  the
     subject.

                                   ----------
                                   Net-Status
                                   ----------

          Net-Status users are "special" users which allow  them transfer a
     bulk  of messages to/from MTQwk via the  door for networking.  A "net-
     status" user  can have  access to  conferences  which a  user may  not
     normally have access to.  Also, they may upload messages whose "From:"
     field is not checked.

     Creating a Net-Status User
     --------------------------

     1.   Setup the netwrosk for your message areas.
     2.   Create a new user in Mutant that can have access to MTQWK.
     3.   Create a new user in MTQwk  and set their networks.  For example,
          if  an  area has  Network A,J,U  set.   You  must set  the user's
          networks to  either A,  J,  and/or U  in order  for  them to  get
          access.
     4.   Select Active  Conferences.   When  you  do this,  MTQWKCFG  will
          automatically select those conferences for which the user has net
          access.  Deselect any the node didn't want to receive.
     5.   Setup  their other parmeters,  especially the strip  bits.  Also,
          the exclude forced so they don't get your forced bases.
     6.   You may wish to create a batch file, which runs as an event under
          Mutant, to pre-generate the QWK packet for them.




     ---- MTQwk Documentation (C) 1994 by Tom Johnson ----          Page 15

     Pre-Generating Packets
     ----------------------
     MTQWK has  the ability to pre-generate the QWK packet for a net-status
     user.   By pre-generating the  packet, the  user will not  have to  go
     through the scanning procedure when they call (saves $$$).

     The  packet  is  stored  in  the  MTQWK  directory  with  a   name  of
     "usernum.QWK" where "usernum" is Mutant's internal user number in Hex.

     When the calls to download, they will be sent the pre-generated packet
     if it is found.

     If  the user does  not call everyday  to get their  mail, the existing
     packet will be added to.

     Because of  the way MTQWK  handles mail  packets, you do  not have  to
     worry about the  user missing  messages if other  messages are  posted
     since the packet generation.

     As of this  version,  MTQWK will only generate one packet per-run.  If
     you have multiple net users, you will need  a batch file to call MTQWK
     with all of them.  For example,


     mtqwk /P board one
     mtqwk /P board two
     mtqwk /P board three
